Skip to content

Latest commit

 

History

History
80 lines (63 loc) · 1.53 KB

README.md

File metadata and controls

80 lines (63 loc) · 1.53 KB

cfmetadata-plugin

A CF cli plugin to view and modify metadata

Installation

  1. git clone the repo to your desktop
  2. In the repo, run go build to compile a binary
  3. run cf install-plugin <path-to-binary>

Known Issue

Resolved in CLI v6.43.0. The CF cli has a bug that causes the user token to periodically expire. This will manifest as not found errors for resources that exist. To resolve run a normal cli command and then rerun the command from this plugin.

Supported Resources

  • Organizations
  • Spaces
  • Apps

Usage

View all metadata

cf metadata app my-app

cf metadata space my-space

cf metadata organization my-org

View labels

cf labels app my-app

cf labels space my-space

cf labels organization my-org

View annotations

cf annotations app my-app

cf annotations space my-space

cf annotations organization my-org

Manage labels

  • Add environment label, modify stable label, remove beta label
cf labels app my-app environment=production stable=true beta-

Manage annotations

same as labels

Select resources based on labels

The CC API docs describe valid selectors.

cf select apps 'production=true' 

cf select orgs 'production=true,cost_center=123' 

cf select spaces 'production=true,cost_center=123'