This is a Cloud Foundry CLI plugin for v3 of the CF Cloud Controller API. Both it and the V3 api are currently under active development, so stability isn't guaranteed. Please use caution when using this plugin and the V3 api in general.

Pushes, maps a route, and starts the zipped app as a V3 app and associated V3 processes. Currently tries to push to the default domain of your currently targeted Cloud Foundry.

Pushes, maps a route, and starts the provided docker image as a V3 app and associated V3 processes. Currently tries to push to the default domain of your currently targeted Cloud Foundry.

-b : Custom buildpack by name (e.g. my-buildpack) or Git URL

Deletes the specified V3 app

Shows v3 apps running in the currently targeted space.

Shows all v3 processes and v2 apps running in the currently targeted space.

Tails logs for all processes of the specified V3 app.

Shows tasks for the specified V3 app.

Run a task for an app.

Cancel a task for an app.

Binds a service instance to a v3 app.

Examples are for Mac, replace the URL extension with the appropriate (windows, linux) one.

cf install-plugin https://github.com/cloudfoundry/v3-cli-plugin/releases/download/0.6.8/v3-cli-plugin.osx

If you have already installed the plugin, you must uninstall it before installing an updated version

cf uninstall-plugin v3_beta

If you love copy-pasting and want all the things

cf uninstall-plugin v3_beta; cf install-plugin https://github.com/cloudfoundry/v3-cli-plugin/releases/download/0.6.8/v3-cli-plugin.osx -f

Members of the CF CAPI team should have access. If you do end up making changes, please follow these steps:

1. Make your changes
2. Bump the version number in v3.go
3. Commit your changes

Releases are made by the team and uploaded to https://github.com/cloudfoundry/v3-cli-plugin/releases when necessary.

1. Install Ginkgo
2. Run ginkgo -r in the root directory

Build the plugin using the following commands.

GOOS=linux GOARCH=amd64 go build -o v3-cli-plugin.linux &&
GOOS=windows GOARCH=amd64 go build -o v3-cli-plugin.exe &&
GOOS=darwin GOARCH=amd64 go build -o v3-cli-plugin.osx

Draft a new release in github using the compiled plugins.