This page will be updated regularly. Check back often for the latest features, updates, and changes.

Latest Versions

Known Issues

CLI v3.2.0 Release

  • Date: November 1, 2024

  • Version Info

    • npm: 3.2.0
  • Minor Changes

CLI v3.1.1 Release

  • Date: August 26, 2024

  • Version Info

    • npm: 3.1.1
  • Patch Changes:

    • Fix a bug causing invalid target links in policies when converting K8s files using the cpln convert.
    • Add tags that are passed to cpln helm install to the state as well.

CLI v3.1.0 Release

CLI v3.0.0 Release

  • Date: July 22, 2024
  • Version Info
    • npm: 3.0.0
  • Notes:
    • Fix cpln cp.
    • Allow identity name for policy binding.

CLI v2.4.0 Release

  • Date: July 15, 2024
  • Version Info
    • npm: 2.4.0
  • Notes:
    • Use cpln://reference to reference fieldRef for K8s Converter.
    • Add BYOK location support.
    • Allow setting profile’s default org and gvc to empty.
    • Optimize the performance of the cpln helm list command.
    • Add cpln cp command.
    • Directly stream stdin to the workload replica when using the cpln workload exec and cpln workload run commands.

CLI v2.3.1 Release

  • Date: June 9, 2024
  • Version Info
    • npm: 2.3.1
  • Notes:
    • Fix stdin null issue on macOS.

CLI v2.3.0 Release

  • Date: June 7, 2024
  • Version Info
    • npm: 2.3.0
  • Notes:
    • Query by GVC if —gvc option is specified.
    • Fix stack capture of command & args.
    • Retry requests upon hitting rate limits.
    • Remove maxContentLength limit.
    • Handle standard input (stdin) in workload exec.
    • Enhance error handling for Helm deployment API call failures.
    • Add —no-cache argument to image build command.

CLI v2.2.2 Release

  • Date: May 28, 2024
  • Version Info
    • npm: 2.2.2
  • Notes:
    • Notify users of a new CLI version once a day.
    • Prevent a helm release from managing a resource that belongs to a different release.

CLI v2.2.1 Release

  • Date: May 15, 2024
  • Version Info
    • npm: 2.2.1
  • Notes:
    • Add retry to internal API requests.
    • Helm: Skip resource deletion if specified.

CLI v2.2.0 Release

  • Date: May 15, 2024
  • Version Info
    • npm: 2.2.0
  • Notes:
    • Additional k8s converter functionionality.

CLI v2.1.0 Release

  • Date: April 24, 2024
  • Version Info
    • npm: 2.1.0
  • Notes:
    • Truncate description text if length > 40 characters.
    • Add alias and update location table view for mk8s.

CLI v2.0.2 Release

  • Date: April 1, 2024
  • Version Info
    • npm: 2.0.2
  • Notes:
    • Fix terminal interrupt handlers.
    • Provide user with a manual delete command to delete workload if workload run fails.
    • Fix generate name bug in helm.
    • Modify priority order in order for policy to be created before workload.

CLI v2.0.1 Release

  • Date: March 18, 2024
  • Version Info
    • npm: 2.0.1
  • Notes:
    • Add CRON get command.
    • Add fetch pages to CRON get and snapshot get.
    • Limit cron get and snapshot get output to —max.
    • Add release notes page to readme.
    • Add delete and get volume commands.
    • Enforce valid naming in stack command.
    • Require location for workload connect/exec command.
    • Add resize terminal feature to workload run interactive.
    • Fix protocol override in k8s converter.
    • Add stop replica command.
    • Add helm rollback and helm history.
    • Add helm upgrade command.
    • Remove clone command from volumeset.
    • Upgrade default buildpacks to builder:22.

CLI v1.6.0 Release

  • Date: February 7, 2024
  • Version Info
    • npm: 1.6.0
  • Notes:
    • Print workload cron start command output as a table.
    • Add container override arguments to the workload cron start command.
    • Fix file option to load from stdin when file option is optional.
    • Update description for: clone, Expand volume set, snapshot.
    • Fix command snapshot date formats.
    • For snapshot, Update column name from Created to Snapshot Created.
    • Logs: add -f as alias to -t.
    • Fix delete in workload run command.
    • Add external id to AWS and ECR secrets.
    • Update dependencies.

CLI v1.5.4 Release

  • Date: January 23, 2024
  • Version Info
    • npm: 1.5.4
  • Notes:
    • Add ACTIVE column for profiles.
    • Modify helm list to display release names only.
    • Print NOTES.txt on helm install.
    • Sort helm template output before applying.
    • Add helm wait option.
    • Helm —wait option to wait 5m if —timeout is not provided.
    • Fix for terminal resizing.
    • Inject GVC into the helm template command as a value.
    • Add volume set and snapshot commands.
    • Add cron and replica sub-commands to workload.

CLI v1.5.2 Release

  • Date: December 6, 2023
  • Version Info
    • npm: 1.5.2
  • Notes:
    • Fix workload connect prompt length and line wraps.
    • Improve workload connect prompt issue.
    • Resizing terminal on the initial connection.
    • Change login port to 48794.
    • Add check for latest release.
    • Add stack command.
    • Add helm command.
    • Add —replace flag.

CLI v1.4.0 Release

  • Date: November 21, 2023
  • Version Info
    • npm: 1.4.0
  • Notes:
    • Fix prompt length and line wrap when connecting to workload + Improve volumeset deletion.
    • Force delete command.
    • Fix SAML login.
    • Add tags enabled for the workload run command.

CLI v1.3.2 Release

  • Date: October 30, 2023
  • Version Info
    • npm: 1.3.2
  • Notes:
    • Remove deploy timestamp tag from slimmed objects.
    • Add account get and org create.
    • Add token server.

CLI v1.2.6 Release

  • Date: October 16, 2023
  • Version Info
    • npm: 1.2.6
  • Notes:
    • Remove deploy timestamp tag from slimmed output.
    • Connect to first replica if multiple are present.
    • Add ready flag to apply command.
    • Add remove tag flag.
    • Adding useful error messages to auto-completion installation.

CLI v1.2.5 Release

  • Date: September 28, 2023
  • Version Info
    • npm: 1.2.5
  • Notes:
    • Fix bug in setting sleep for ubuntu image on run cmd.
    • Deprecate container port property. Use ports going forward.
    • Inform user on verbose mode when CPLN_ORG, CPLN_GVC, CPLN_ENDPOINT or CPLN_PROFILE is being used.
    • Add mk8s command.
    • Fix GVC add/remove location commands when resource doesn’t contain a location property.
    • Improved slim output format.
    • Add recursive folder support for apply command.
    • Add Terraform output option.
    • Add retry logic to the workload run command.

CLI v1.1.0 Release

  • Date: July 9, 2023
  • Version Info
    • npm: 1.1.0 / Build: 925739349 / Version: 9784f19
  • Notes:
    • Added json-slim and yaml-slim output options.

CLI v1.0.0 Release

  • Date: June 27, 2023
  • Version Info
    • npm: 1.0.0 / Build: 912602973 / Version: bddd583
  • Notes:
    • Logs: maxBodySize not set when reading.
    • Inform user when the environment variable CPLN_TOKEN is being used for authentication.
    • Updates to cpln workload run command.

CLI v0.0.90 Release

  • Date: May 5, 2023
  • Version Info
    • npm: 0.0.90 / Build: 859056052 / Version: b58459f
  • Notes:
    • Update HTML on cpln login browser page.

CLI v0.0.82-89 Release

  • Date: April 21, 2023
  • Version Info
    • npm: 0.0.89 / Build: 844733757 / Version: ba7245d
  • Notes:
    • Fix get all workloads from all GVCs.
    • Update image copy command to use a destination profile.
    • Workload run command.
    • Allow --tag to accept an optional value.

CLI v0.0.82 Release

  • Date: March 15, 2023
  • Version Info
    • npm: 0.0.82 / Build: 807750891 / Version: 99792cd
  • Notes:
    • Added image copy command.

CLI v0.0.73-81 Release

  • Notes:
    • K8s converter not creating identity and policy if not required.
    • Added prestop hook for k8s converter.
    • Added GVC environment variables and container inherit environment variables.
    • Added active deadline seconds to workload update command.
    • Fixed token for fetching logs, exec, and connect.
    • Fixed long websocket connections.
    • Added SAML login.
    • Fix workload create for standard workload type.
    • Added workload ready status to workload get command.
    • Command: Only enable raw mode if it’s TTY.

CLI v0.0.72 Release

  • Date: November 7, 2022
  • Version Info
    • npm: 0.0.72 / Build: 687290579 / Version: 718968f
  • Notes:
    • Added docker store and erase commands. Fixes issue when using both cpln image and docker login commands.

CLI v0.0.71 Release

  • Date: November 2, 2022
  • Version Info
    • npm: 0.0.71 / Build: 683695375 / Version: 3124c60
  • Notes:
    • Added instructions to create an Azure Connector Cloud Account.
    • Added delete resource from files command cpln delete.
    • Added k8s manifest to Control Plane manifest converter command cpln convert.
    • Added stop/start/suspend commands to cpln workload.
    • Added cpln workload exec command.
  • Installation Instructions

CLI v0.0.61 Release

  • Date: August 30, 2022
  • Version Info
    • npm: 0.0.61 / Build: 626945486 / Version: 2f98cdd
  • Notes:
    • Updated agent image version.
    • Added standard workload.

CLI v0.0.60 Release

  • Date: August 24, 2022
  • Version Info
    • npm: 0.0.60 / Build: 621247366 / Version: cd5c35e
  • Notes:
    • Updated agent image version.

CLI v0.0.59 Release

  • Date: July 28, 2022
  • Version Info
    • npm: 0.0.59 / Build: 599431645 / Version: 4ebdf36
  • Notes:
    • Added NGS Cloud Account.
    • Added NATS Account Secret type.
    • Removed GVC domain.
    • Upgrade buildpacks to version 0.27.0.

CLI v0.0.57 Release

  • Date: May 23, 2022
  • Version Info
    • npm: 0.0.57 / Build: 545699003 / Version: e16bbbf
  • Notes:
    • Add default of 50 maximum records.
    • Fix issue when using a value < 1 to return all records.
    • Fix issue when updating container memory.
    • Add additional set flags for the workload update command.

CLI v0.0.55 Release

  • Date: February 21, 2022
  • Version Info
    • npm: 0.0.55 / Build: 475892711 / Version: 6b87320
  • Notes:
    • Add —psp flag for agent manifest command to configure a pod security policy.
    • Enable the k8s agent to run as a privileged pod.

Previous Versions

CLI v0.0.54 Release

  • Date: February 10, 2022
  • Version Info
    • npm: 0.0.54 / Build: 467951861 / Version: 7c17ca8
  • Notes:
    • Fix issues with the k8s Agent.
    • Fix issue when building images on ARM64 machines.

CLI v0.0.52 Release

  • Date: January 20, 2022
  • Version Info
    • npm: 0.0.52 / Build: 452736596 / Version: bffc420
  • Notes:
    • Updated login page.
    • Fix issue persisting profile default GVC when using the —token flag.

CLI v0.0.50 Release

  • Date: December 28, 2021
  • Version Info
    • npm: 0.0.50 / Build: 438151551 / Version: f1586e9
  • Notes:
    • Update pack to version 0.23.0.
    • Added ARM64 support for pack.

CLI v0.0.49 Release

  • Date: November 30, 2021
  • Version Info
    • npm: 0.0.49 / Build: 419000724 / Version: cdc6af5
  • Notes:
    • Fix issue building an image using an ARM processor.

CLI v0.0.48 Release

  • Date: November 18, 2021
  • Version Info
    • npm: 0.0.48 / Build: 411017996 / Version: d1b67a5
  • Notes:
    • Updated k8s agent version.

CLI v0.0.47 Release

  • Date: November 11, 2021
  • Version Info
    • npm: 0.0.47 / Build: 407265118 / Version: 140e31f
  • Notes:
    • Added cpln agent manifest command to allow running an agent on a k8s cluster.

CLI v0.0.46 Release

  • Date: October 11, 2021
  • Version Info
    • npm: 0.0.46 / Build: 386067508 / Version: 7ca3dd7
  • Notes:
    • Update error handling:
      • All errors are outputted to stderr.
      • If the -o flag is set to json or yaml, the output will be in the respective format. If -o is set to text, only the output of the .message property from response object will be outputted. Otherwise, output the error.message property from the exception.
      • If there are multiple actions, any errors will be included in the output.
      • The exit code will be 1 if at least one action failed.
    • Added force-redeployment subcommand to the workload command.

CLI v0.0.44 Release

  • Date: September 10, 2021
  • Version Info
    • npm: 0.0.44 / Build: 368794552 / Version: 6435502
  • Notes:
    • New workload subcommands:
      • connect: Connect to a replica of the workload.
      • get-replicas: Get the replicas of the referenced workload in a given location.

CLI v0.0.43 Release

  • Date: September 7, 2021
  • Version Info
    • npm: 0.0.43 / Build: 365437960 / Version: f3f59d1
  • Notes:
    • New secret type: azure-connector

CLI v0.0.42 Release

  • Date: July 16, 2021
  • Version Info
    • npm: 0.0.42 / Build: 338229644 / Version: db33b86
  • Notes:
    • CLI can work without CPLN_ENDPOINT
    • Allow environment variables without a value
    • Add mount volumes to workload

CLI v0.0.41 Release

  • Date: July 14, 2021
  • Version Info
    • npm: 0.0.41 / Build: 336244315 / Version: b864944
  • Notes:
    • Create ~/.docker during cpln image docker-login

CLI v0.0.40 Release

  • Date: June 30, 2021
  • Version Info
    • npm: 0.0.40 / Build: 329714271 / Version: 4c67950
  • Notes:
    • Infers container name from image name unless defined using the —container-name argument.
    • Set internal firewall to same-org when the --public flag is used during the creation of a workload.

CLI v0.0.39 Release

  • Date: June 22, 2021
  • Version Info
    • npm: 0.0.39 / Build: 325071193 / Version: acbc925
  • Notes:
    • Added ‘smart’ reveal to secret output format
    • Added multi-document sources for the apply command

CLI v0.0.38 Release

  • Date: June 16, 2021
  • Version Info
    • npm: 0.0.38 / Build: 321518748 / Version: aa315ea
  • Notes:
    • Remove account subcommand and references
    • Update buildpacks to version 0.19.0
    • Add create-ecr secret command
    • Fix create command for Cloud Account to include additional error messages
    • Fix issue when shell would close when running cpln login

CLI v0.0.36 Release

  • Date: June 7, 2021
  • Version Info
    • npm: 0.0.36 / Build: 315420524 / Version: cb4cb4f
  • Notes:
    • For the binary package, include the executable docker-credential-cpln in the same archive as the CLI

CLI v0.0.34 Release

  • Date: May 31, 2021
  • Version Info
    • npm: 0.0.34 / Build: 312124373 / Version: 0a44b37
  • Notes:
    • Make profile optional if at least —endpoint & —token flags are set
    • When there is a profile present, honor the environment variables ‘CPLN_ORG’, ‘CPN_GVC’, ‘CPLN_ENDPOINT’, and ‘CPLN_TOKEN’
    • Install auto-completion for non-interactive installation

CLI v0.0.33 Release

  • Date: May 6, 2021
  • Version Info
    • npm: 0.0.33 / Build: 298694423 / Version: 30dc6d4
  • Notes:
    • Added task as a policy target kind
    • Resume cpln logs stream on disconnect
    • Refresh authentication token before getting logs
    • Fix for missing Docker config.json file

CLI v0.0.31 Release

  • Date: May 1, 2021
  • Version Info
    • npm: 0.0.31 / Build: 295632825 / Version: 01e4461
  • Notes:
    • Added cpln agent info command

CLI v0.0.30 Release

  • Date: April 27, 2021
  • Version Info
    • npm: 0.0.30 / Build: 293303600 / Version: 81bde51
  • Notes:
    • Fix for the closing of a command or PowerShell shell in Windows 10 if the cpln login command is executed.
    • Updated axios to version 0.21.1