Control Plane offers a Command Line Interface (CLI) for all major operating systems. The CLI is an abstraction layer over the Control Plane API and gives you access to all the features of the platform.
It is recommended to install the CLI in order to perform a handful of operations that are not available from the console (e.g., containerizing a microservice).
This quick start will demonstrate how to:
copynpm install -g @controlplane/cli
After a successful installation, run the following command to view the installed version:
The latest version can be viewed here and cross referenced with the output from the --version flag.
The CLI requires you to be logged in before calling any commands.
Open a new shell and execute this command to log in:
The default browser will launch displaying the login page. Select the single sign-on (SSO) provider that is connected to your email address.
After a successful log in, the brower can be closed. The shell will display
the profile named
default that was created and mapped to your email address.
Get all your Orgscopycpln org get
Get all your GVCscopycpln gvc get --org ORG_NAME
Get all your Workloadscopycpln workload get --org ORG_NAME --gvc GVC_NAME
To view all the commands that the CLI offers, run:
Each command displayed in the --help output also has a --help output. To view, run:
copycpln COMMAND --help
copycpln profile update default --org ORG_NAME --gvc GVC_NAME
By installing the CLI, you have the ability to easily interact with the platform and execute commands quickly.
Visit the CLI reference page for details and examples of each command.