cloudfoundry/v3-cli-plugin

Name: v3-cli-plugin

Owner: Cloud Foundry

Description: CF CLI plugin for v3 of the CF Cloud Controller API

Created: 2015-07-29 23:23:03.0

Updated: 2016-10-28 20:49:29.0

Pushed: 2017-05-12 16:33:34.0

Homepage:

Size: 66365

Language: Go

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

V3_beta

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.

Commands

v3-push Syntax: cf v3-push APPNAME /path/to/app.zip

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.

Syntax: cf v3-push APPNAME -di “path/to/docker/image”

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.

Other Options:

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

v3-delete Syntax: cf v3-delete APPNAME

Deletes the specified V3 app

v3-apps Syntax: cf v3-apps

Shows v3 apps running in the currently targeted space.

v3-processes Syntax: cf v3-processes

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

v3-logs Syntax: cf v3-logs APPNAME

Tails logs for all processes of the specified V3 app.

v3-tasks Syntax: cf v3-tasks APPNAME

Shows tasks for the specified V3 app.

v3-run-task Syntax: cf v3-run-task APPNAME TASKNAME COMMAND

Run a task for an app.

v3-cancel-task Syntax: cf v3-cancel-task APPNAME TASKNAME

Cancel a task for an app.

v3-bind-service Syntax: cf v3-bind-service APPNAME SERVICEINSTANCE [-c PARAMETERS_AS_JSON]

Binds a service instance to a v3 app.

Installing

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

nstall-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

ninstall-plugin v3_beta

If you love copy-pasting and want all the things

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

Contributing

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.

Running tests

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

Creating a Release

Build the plugin using the following commands.

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

Draft a new release in github using the compiled plugins.