Control Plane (cpln): Installation & Configuration

Installation

The Pulumi Control Plane (cpln) provider is available as a package in all Pulumi languages:

• JavaScript/TypeScript: @pulumiserve/cpln
• Python: pulumiverse-cpln
• Go: github.com/pulumiverse/pulumi-cpln/sdk/go/cpln
• .NET: Pulumiverse.cpln

Setup

To provision resources with the Pulumi Control Plane (cpln) provider, you need to authenticate with one of the available options.

1. CLI
   • Install the CLI and execute the command cpln login. After a successful login, the Pulumi provider will use the default profile to authenticate. To use a different profile, set the profile variable when initializing the provider or set the CPLN_PROFILE environment variable.
2. Token
   • The token variable can be set when initializing the provider or by setting the CPLN_TOKEN environment variable.
   • The value of token can be either:
     • The output of running the command cpln profile token PROFILE_NAME, or
     • In the case of a Service Account, the value of one of it’s keys
3. Refresh Token
   • The refreshToken variable is used when the provider is required to create an org or update the authConfig property using the Org resource. The refreshToken variable can be set when initializing the provider or by setting the CPLN_REFRESH_TOKEN environment variable.
   • When creating an org, the refreshToken must belong to a user that has the org_creator role for the associated account.
   • When updating the org authConfig property, the refreshToken must belong to a user that was authenticated using SAML.
   • The refreshToken can be obtained by following these steps:
     • Using the CLI, authenticate with a user account by executing cpln login.
     • Browser to the path ~/.config/cpln/profiles. This path will contain JSON files corresponding to the name of the profile (i.e., default.json).
     • The contents of the JSON file will contain a key named refreshToken. Use the value of this key for the refreshToken variable.

To perform automated tasks using Pulumi, the preferred method is to use a Service Account and one of it’s keys as the token value.

Configuration Options

Use pulumi config set cpln:<option>.