Spring Cloud Services CLI Plugin
This repository provides a Cloud Foundry CLI plugin for Spring Cloud Services.
For information on plugin development, see Developing a plugin.
To build the plugin, install go and govendor (see the Go Development guide for instructions) and issue:
$ rm $GOPATH/bin/spring-cloud-services-cli-plugin $ cd $GOPATH/src/github.com/pivotal-cf/spring-cloud-services-cli-plugin $ govendor install -ldflags="-X main.pluginVersion=$(cat version)" +local
This builds the plugin with the current version number in the version file.
Note: if an invalid version number is provided, the build will succeed, but the plugin will fail to install (with exit status code 64).
To print the version number of the built plugin, run it as a stand-alone executable, for example:
$ $GOPATH/bin/spring-cloud-services-cli-plugin This program is a plugin which expects to be installed into the cf CLI. It is not intended to be run stand-alone. Plugin version: 0.0.8
To install the plugin in the
cf CLI, first build it and then issue:
$ cf install-plugin -f $GOPATH/bin/spring-cloud-services-cli-plugin
You can also install the plugin from the Cloud Foundry cf-cli plugins repository:
$ cf install-plugin -r CF-Community "spring-cloud-services"
The plugin's commands may then be listed by issuing
To update the plugin, uninstall it as follows and then re-install the plugin as above:
$ cf uninstall-plugin spring-cloud-services
The Spring Cloud Services CLI plugin command docs can be generated by running the following commands:
$ cd docs $ ./generate-cli-docs-from-help.bash
This needs to be done whenever commands are added, modified, or deleted. Note that the script contains a list of commands which needs to be kept in step with the available commands.
The generated docs may be viewed here.
See the Go Development guide. (If you just want to build and install the plugin, simply install go and govendor.)
Run the tests as follows:
$ cd $GOPATH/src/github.com/pivotal-cf/spring-cloud-services-cli-plugin $ govendor test +local
The Spring Cloud Services CLI plugin is Open Source software released under the Apache 2.0 license.
Contributions are welcomed. Please refer to the Contributor's Guide.