Get startedSign in

Plural CD CLI Quickstart

Deploying your services using the Plural CLI.


This guide goes over how to deploy your services with the Plural CLI. At the end of this tutorial, you will have:

  • Provisioned new clusters, and/or deployed the Plural Deployment Operator on your existing clusters.
  • Imported the Git repositories containing your code and manifests.
  • Deployed your code onto your clusters of choice.
  • Optionally updated any configurations and permissions for the clusters and services.

Onboard to Plural and install the Plural Console

If you haven't already, you'll need to follow the Plural guide to install Console. You can use the guide for the in-browser Cloud Shell or the CLI to get started.


plural cd is an alias for plural deployments, and can be used interchangeably within the CLI.

Set Environment Variables

If you haven't already, you'll need to set your Console URL and Console token. Set them with:


Create Clusters

To deploy additional clusters, use the plural cd clusters create command. As an example:

plural cd clusters create --handle <CLUSTER_HANDLE> --version <K8s_VERSION> CLUSTER_NAME

To import an existing cluster, see the guide for existing clusters.

Import Git Repositories and Deploy services

You'll need to then import the Git repository containing your service and the associated Kubernetes manifests. To do so, use plural cd repositories create:

plural cd repositories create --url <REPO_URL>

Optionally add flags for Github authorization if necessary.

To then deploy your service, find the repo ID for the service you want to deploy using plural cd repositories list.

You can then use the plural cd services create command:

plural cd services create --name <SERVICE_NAME> --namespace <SERVICE_NAMESPACE> --repo-id <REPO_ID> --git-ref <GIT_REF> --git-folder <GIT_FOLDER> CLUSTER_ID

See deployed services with the plural cd services list command. Your service should populate initially as Stale until your components are Ready, at which point they will flip to Healthy.

Congratulations! You've deployed your first service with Plural.