Release Notes

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

​

Latest Versions

• CLI

  • Date: July 11, 2025

  • Version Info

    • npm: 3.5.6

  • Installation Instructions

​

Known Issues

• CLI

  • Windows

    • Autocomplete functionality is not available. A workaround is available for cygwin.

​

CLI v3.5.6 Release

• Date: July 11, 2025

• Version Info

  • npm: 3.5.6

• Patch Changes

  • Validate org name after parsing service account token during profile update.
  • Decode docker secret data if it is in base64 format.
  • Handle securityContext in K8s converter.
  • Decode dictionary secret values if the data is base64.
  • Fix helm list max limit being applied before processing revisions.
  • Show the helm release name not the secret name if the resource doesn’t belong to the release being installed.
  • Add cpln workload cron stop to be an alias of replica stop command.

​

CLI v3.5.5 Release

• Date: June 6, 2025

• Version Info

  • npm: 3.5.5

• Patch Changes

  • Fix issue where the cpln port-forward command session disconnects after 1 hour.

​

CLI v3.5.4 Release

• Date: June 5, 2025

• Version Info

  • npm: 3.5.4

• Patch Changes

  • Fix issue where the workload’s ready status was not displayed correctly when running the cpln workload get command.

​

CLI v3.5.3 Release

• Date: May 23, 2025

• Version Info

  • npm: 3.5.3

• Patch Changes

  • Fix issue where Helm release was uninstalled on cpln helm upgrade when history limit was reached.

​

CLI v3.5.2 Release

• Date: May 9, 2025

• Version Info

  • npm: 3.5.2

• Patch Changes

  • Add —state-tag argument to cpln helm install & cpln helm upgrade.
  • Fix tags in helm release resources during cpln helm install & cpln helm upgrade.

​

CLI v3.5.1 Release

• Date: May 5, 2025

• Version Info

  • npm: 3.5.1

• Patch Changes

  • Hot fix for cpln image build command.

​

CLI v3.5.0 Release

• Date: May 5, 2025

• Version Info

  • npm: 3.5.0

• Minor Changes

  • Add YAML document separator for CRD list items.
  • Separate helm release deployments into individual secrets.
  • Prevent Helm release upgrades via cpln helm install; use cpln helm upgrade instead.
  • Add a limit to the release name length.
  • Add cpln helm get all subcommand.
  • Add cpln helm get notes subcommand.

​

CLI v3.4.5 Release

• Date: April 14, 2025

• Version Info

  • npm: 3.4.5

• Patch Changes

  • Add K8s CRD as an output option. (--output crd)
  • Fix agent default image.
  • Map health probe port to the number defined by the container port name in the cpln convert command.
  • Limit concurrent streams for the cpln cp command.
  • Measure upload/download speed instantaneously in the cpln cp command.
  • Allow rollback to deployed deployment in the cpln helm rollback command.
  • Remove unnecessary apostrophe at the end of the applied template link in the cpln helm command.
  • Avoid applying a resource with its GVC property in the cpln helm command.
  • Remove the requirement for the ‘type’ property within a K8s Secret in the cpln convert command.
  • Ensure unique names for PVCs defiend inside a StatefulSet workload in the cpln convert command.

​

CLI v3.4.4 Release

• Date: March 28, 2025

• Version Info

  • npm: 3.4.4

• Patch Changes

  • Add cpln operator command.
  • Fix broken agent image issue affecting cpln agent up command.
  • Disable remote port validation in the cpln port-forward command.
  • Convert CPU and memory requests when no limits are specified in the Kubernetes converter.
  • Add CPLN_SKIP_UPDATE_CHECK environment variable to optionally bypass automatic update checks.
  • Fix typo for the defaulted location in the cpln connect / cpln exec commands.
  • Change cpln helm output to always display full links.

​

CLI v3.4.3 Release

• Date: March 17, 2025

• Version Info

  • npm: 3.4.3

• Patch Changes

  • Update the cpln port-forward command to correctly handle refresh tokens.

​

CLI v3.4.2 Release

• Date: March 14, 2025

• Version Info

  • npm: 3.4.2

• Patch Changes

  • Submit a ticket to record a one-time audit trail entry for the cpln port-forward command.
  • Automatically connect to a different replica for each session when no specific replica is provided to the cpln port-forward command.

​

CLI v3.4.1 Release

• Date: February 28, 2025

• Version Info

  • npm: 3.4.1

• Patch Changes

  • Improve cpln port-forward command.

​

CLI v3.4.0 Release

• Date: February 25, 2025

• Version Info

  • npm: 3.4.0

• Minor Changes

  • Add cpln port-forward command.

​

CLI v3.3.2 Release

• Date: February 17, 2025

• Version Info

  • npm: 3.3.2

• Patch Changes

  • Add --build option for stack commands.

​

CLI v3.3.1 Release

• Date: January 23, 2025

• Version Info

  • npm: 3.3.1

• Patch Changes

  • Convert user email characters to lowercase when inviting users.

  • Fix referencing existing secrets within workloads in Helm.

​

CLI v3.3.0 Release

• Date: January 1, 2025

• Version Info

  • npm: 3.3.0

• Minor Changes

  • Add loadBalancer to cpln workload update command.

  • Add shared to volume set create command.

  • Add ipset command.

  • In cpln helm, avoid applying GVC related resources if GVC does not exist.

  • In cpln helm, avoid updating unchanged resources.

  • In cpln helm, introduce cpln/secret: tag when applying a Helm chart to update workloads that reference secrets.

  • Call the K8s converter logging service.

  • Print and highlight ignored properties of K8s objects when doing cpln convert with the --verbose option.

  • Disable nearest year rounding in table format.

​

CLI v3.2.1 Release

• Date: December 2, 2024

• Version Info

  • npm: 3.2.1

• Patch Changes

  • Fix yaml output for cpln convert.

  • Handle tar errors and warnings.

  • Fix cpln cp for Windows.

  • Inject more cpln context to helm template.

  • Convert individual K8s Jobs.

​

CLI v3.2.0 Release

• Date: November 1, 2024

• Version Info

  • npm: 3.2.0

• Minor Changes

  • Add ‘names’ as a new output option.

  • Enhance cpln cp reliability and performance.

  • Add progress indicator for cpln cp.

  • Fix priority resource deletion order in cpln helm uninstall.

  • Add --all option to cpln helm get values.

​

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

• Date: August 19, 2024

• Version Info

  • npm: 3.1.0

• Major Changes:

  • Refactor of cpln workload exec command:The cpln workload exec command has been updated to align with the functionality of kubectl exec.For more details, refer to the cpln workload exec guide.

    • Stdin and TTY Handling: Previously, stdin and TTY were enabled by default. Now, these must be explicitly set:

      • Use the -i option to send stdin to the workload.

      • Use the -t option to treat stdin as TTY.

• Minor Changes:

  • Improve cpln convert command to convert ConfigMaps, Persistent Volume Claims and pull secrets.

  • Add --encoding option to cpln secret create-opaque command.

  • Fix path syntax for cpln mk8s kubeconfig command on Widnows.

  • Use the first location of a GVC if the --location option is not specified for cpln workload exec, cpln workload connect and cpln cp commands. Specifying a location is no longer required.

​

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