cdsctl

CDS Command line utility

Synopsis

Download

You can find the cdsctl version corresponding to your CDS version on the UI: Menu -> Settings -> Command line cdsctl. You’ll also find the instructions to configure your cdsctl according to your CDS instance.

The latest release is available on GitHub Releases.

Authentication

Per default, the command line cdsctl uses your keychain on your os:

• OSX: Keychain Access
• Linux System: Secret-tool (libsecret)

You can use a “sign in” token attached to a consumer:

CDS_API_URL="https://instance.cds.api" CDS_TOKEN="token-consumer" cdsctl [command]

Want to debug something? You can use CDS_VERBOSE environment variable.

CDS_VERBOSE=true cdsctl [command]

If you’re using a self-signed certificate on CDS API, you probably want to use CDS_INSECURE variable.

CDS_INSECURE=true cdsctl [command]

Advanced usages:

• you can use a session-token instead of a token:

  CDS_API_URL=“https://instance.cds.api” CDS_USER=“username” CDS_SESSION_TOKEN=“yourtoken” cdsctl [command]

• you define a maximum number of retries for HTTP calls:

  CDS_API_URL=“https://instance.cds.api” CDS_SESSION_TOKEN=“yourtoken” CDS_HTTP_MAX_RETRY=10 cdsctl [command]

• you can override CDN url if needed using the variable CDS_CDN_URL:

  CDS_API_URL=“https://instance.cds.api” CDS_TOKEN=“yourtoken” CDS_CDN_URL=“https://instance.cds.cdn” cdsctl [command]

cdsctl [flags]

Options

  -c, --context string   cdsctl context name
  -f, --file string      set configuration file
      --insecure         (SSL) This option explicitly allows curl to perform "insecure" SSL connections and transfers.
  -n, --no-interactive   Set to disable interaction with ctl
      --verbose          Enable verbose output

SEE ALSO

• cdsctl action - Manage CDS action
• cdsctl admin - Manage CDS (admin only)
• cdsctl application - Manage CDS application
• cdsctl completion - Generate the autocompletion script for the specified shell
• cdsctl consumer - Manage CDS auth consumers
• cdsctl context - Manage cdsctl config file
• cdsctl encrypt - Encrypt variable into your CDS project
• cdsctl environment - Manage CDS environment
• cdsctl events - Listen CDS Events
• cdsctl experimental - CDS Experimental commands
• cdsctl group - Manage CDS group
• cdsctl health - Check CDS health
• cdsctl login - Login to CDS
• cdsctl pipeline - Manage CDS pipeline
• cdsctl preview - CDS feature preview
• cdsctl project - Manage CDS project
• cdsctl queue - CDS Queue
• cdsctl reset-password - Reset CDS user password
• cdsctl session - Manage CDS auth sessions
• cdsctl shell - cdsctl interactive shell
• cdsctl signup - Signup on CDS
• cdsctl template - Manage CDS workflow template
• cdsctl tools - Some tooling for CDS
• cdsctl update - Update cdsctl from CDS API or from CDS Release
• cdsctl user - Manage CDS user
• cdsctl version - show cdsctl version
• cdsctl worker - Manage CDS worker
• cdsctl workflow - Manage CDS workflow