README
¶
ServiceManagement CF CLI Plugin
This is a Cloud Foundry CLI plugin designed to make it easier when using the Service Management service in Cloud Foundry. It uses the service manager REST API to get details of service instances that the service management service has created.
Requirements
Installed CloudFoundry CLI - ensure that CloudFoundry CLI is installed and working. For more information about installation of CloudFoundry CLI, please visit the official CloudFoundry documentation.
Download and Installation
Check whether you have a previous version installed, using the command: cf plugins. If the ServiceManagement plugin is already installed, you need to uninstall it first and then to install the new version. You can uninstall the plugin using command cf uninstall-plugin ServiceManagement.
CF Community Plugin Repository
Hopefully the ServiceManagement CF CLI Plugin will soon be available on the CF Community Repository. To install the latest available version of the ServiceManagement CLI Plugin execute the following:
cf install-plugin ServiceManagement
If you do not have the community repository in your CF CLI you can add it first by executing:
cf add-plugin-repo CF-Community https://plugins.cloudfoundry.org
Manual Installation
Alternatively you can install any version of the plugin by manually downloading it from the releases page and installing the binaries for your specific operating system.
Download
The latest version of the plugin can also be downloaded from the project's releases. Download the plugin for your platform (Darwin, Linux, Windows). The name for the correct plugin for each platform can be found in the table below.
| Mac OS X 64 bit | Windows 64 bit | Linux 64 bit |
|---|---|---|
| ServiceManagement.osx | ServiceManagement.win64 | ServiceManagement.linux64 |
Installation
Install the plugin, using the following command:
cf install-plugin <path-to-the-plugin> -f
Note: if you are running on a Unix-based system, you need to make the plugin executable before installing it. In order to achieve this, execute the following commad chmod +x <path-to-the-plugin>
Usage
The ServiceManagement CF plugin supports the following commands:
| Command Name | Command Description |
|---|---|
service-manager-service-instances smsi |
Show service manager service instances for a service offering and plan. The default service offering is hana and the default service plan is hdi-shared. Defaults can be overriden with the -offeringand/or -planflags. Use the -credentials flag to show login credentials and certificates. Use the -o flag to show results in JSON, SQLTools or Txt format. It's possible to pipe the information to a file as shown in the examples below. When using -o SQLTools the -credentials flag will be set automatically. |
Usage:
cf service-manager-service-instances <SERVICE_MANAGER_INSTANCE> [-offering <SERVICE_OFFERING>] [-plan <SERVICE_PLAN>] [-credentials] [-json]
Examples:
cf service-manager-service-instances my-sm
cf service-manager-service-instances my-sm -o SQLTools
cf service-manager-service-instances my-sm -credentials
cf smsi my-sm -credentials -o JSON
cf smsi my-sm -credentials -o JSON > my-results.json
cf smsi my-sm -o SQLTools > settings.json
cf smsi my-sm -credentials > my-results.txt
cf smsi my-sm -credentials -o JSON -offering hanatrial -plan schema
For more information, see the command help output available via cf [command] --help or cf help [command].
Further Information
Tutorials:
License
This project is licensed under the Apache Software License, v. 2 except as noted otherwise in the LICENSE file.
Documentation
¶
There is no documentation for this package.
Source Files