Latest Versions
-
CLI
- Date: September 28, 2026
-
Version Info
- npm: 3.17.2
- Installation Instructions
CLI v3.17.2 Release
- Date: September 28, 2026
-
Version Info
- npm: 3.17.2
-
Patch Changes
- Fix
--waiton cpln helm install, cpln helm upgrade, and cpln helm rollback failing at--timeouton a suspended workload. A workload suspended in every location runs nothing and never becomes ready, so--waitno longer waits for it. - Fix the
START TIMEandCOMPLETION TIMEreported by cpln workload cron get. They showed when the run was requested and when its record last changed, and now show when the execution itself started and finished. - Fix the table output of cpln workload cron get and cpln workload cron start printing the command ID under
ACTIVE DEADLINE (s). The ID now appears underNAME OR COMMAND ID, andACTIVE DEADLINE (s)shows the run’s deadline when one is set.
- Fix
CLI v3.17.1 Release
- Date: September 18, 2026
-
Version Info
- npm: 3.17.1
-
Patch Changes
- Fix cpln apply with
--readyfailing after five minutes on a suspended workload. A suspended workload runs nothing and never becomes ready, so--readyno longer waits for it.
- Fix cpln apply with
CLI v3.17.0 Release
- Date: September 15, 2026
-
Version Info
- npm: 3.17.0
-
Minor Changes
- Add
cpln profile create <profile>as a command of its own. - Refuse a cpln helm upgrade or cpln helm rollback that would move a release out of a GVC, before anything is written. Pass
--delete-leftover-resourcesto delete what would be stranded and proceed. See Moving a release between GVCs. - Delete a GVC only when it holds nothing, and leave one the release no longer declares in place on cpln helm uninstall. Every skip is printed with its reason.
- Print the cleanup plan before an upgrade or rollback writes anything, so a surprising deletion is visible in time to cancel.
- Check the
cpln/releasetag before cleanup or an uninstall deletes a resource, and remove that tag from everything an uninstall leaves behind.
- Add
CLI v3.16.0 Release
- Date: August 12, 2026
-
Version Info
- npm: 3.16.0
-
Minor Changes
- Add
--build-argto cpln image build to set build-time variables, as--build-arg NAME=value, or--build-arg NAMEto take the value from your environment. Repeat the option for each arg. It applies to local and--remotebuilds alike, and a build with no Dockerfile warns that the args were not consumed, since buildpack builds ignore them. - Add
--secretto cpln image build to expose a secret to a Dockerfile build, in the form--secret id=<id>[,src=<source>].srctakes a local file path, orcpln://secret/<name>[.<field>]to name a secret in your org, which the CLI reveals for the build alone and never bakes into the image. A--remotebuild accepts onlycpln://secret/...sources. Buildpack builds cannot consume secrets, so the option requires a Dockerfile. - Add
--dry-runto the commands that write a resource:create,update,patch,edit,clone,tag, cpln apply, and the subcommands that modify a resource, such asgvc add-location,group add-member,policy add-binding, andworkload start. The platform validates the request and returns the resource that would be written, and nothing is stored. Output defaults toyaml-slim, so the result reads as a manifest; pass--outputfor another format. Oncpln apply,--dry-runcannot be combined with--ready, since nothing is created to wait for. - Upgrade a standalone macOS install in place with cpln upgrade, which now installs the signed and notarized disk image for Intel and Apple silicon instead of printing manual instructions.
- Recognize bun and yarn berry installs in cpln upgrade: a global bun install upgrades with
bun add -g, and a project dependency installed by yarn berry is no longer read as a global install. The new-version notice now closes with the step that fits the install, pointing a project dependency at itspackage.jsoninstead of atcpln upgrade.
- Add
-
Patch Changes
- Stop cpln upgrade before it downloads a release when the install directory cannot be written to, and name the way out for the platform: re-run with
sudo, or from a terminal opened with “Run as administrator” on Windows. - Clear the scratch files a binary upgrade can leave in the install directory on Windows, where the executable in use cannot be deleted and is moved aside instead.
- Stop cpln upgrade before it downloads a release when the install directory cannot be written to, and name the way out for the platform: re-run with
CLI v3.15.0 Release
- Date: July 27, 2026
-
Version Info
- npm: 3.15.0
-
Minor Changes
- Add
--remoteto cpln image build to build remotely instead of through local Docker. The CLI uploads the--dirfolder, Control Plane detects how to build the source, and the image is pushed to the org’s private registry, so neither a Docker daemon nor--pushis needed. Build logs stream to the terminal, and interrupting the command leaves the build running remotely. - Build straight from a repository with
cpln image build --remote --repo <https-url>, optionally pinned to a--branch. GitHub and GitLab are supported; the first build of a private repository opens a browser once to connect the org’s git provider. - Add
--detachto cpln image build to start a remote build and return without following it. The image appears incpln image getonce the build pushes it. - Open the browser automatically during cpln login, while still printing the sign-in URL as a fallback for headless environments.
- Add
-
Patch Changes
- Keep digit-shaped values as typed in cpln image build and cpln cp, so an image tag, branch, directory, or container name such as
1.10no longer loses its trailing zero.
- Keep digit-shaped values as typed in cpln image build and cpln cp, so an image tag, branch, directory, or container name such as
CLI v3.14.1 Release
- Date: July 20, 2026
-
Version Info
- npm: 3.14.1
-
Patch Changes
- Fix cpln workload run failing on a healthy deployment that is slow to become ready — a transient platform message is no longer read as a stalled deployment. Pass
--verboseto see the deployment status while it waits.
- Fix cpln workload run failing on a healthy deployment that is slow to become ready — a transient platform message is no longer read as a stalled deployment. Pass
CLI v3.14.0 Release
- Date: July 20, 2026
-
Version Info
- npm: 3.14.0
-
Minor Changes
-
Add
cpln metrics query <promql>to run a PromQL query against your organization’s metrics. Runs an instant query by default; pass--from,--to,--since, and--stepfor a range query, or--timeto evaluate at a specific moment. -
Add
cpln upgrade(aliascpln update) to update the CLI in place. It detects whether the CLI was installed via npm, Homebrew, or a standalone binary and runs the matching upgrade. Pass--checkto compare the installed and latest versions without upgrading, or--forceto reinstall the latest even when already up to date. -
Add a
cpln versioncommand that prints the installed CLI version — the same output ascpln --version— and add-vas a short alias for--version. -
Accept relative durations in the
--fromand--toflags of cpln logs, in addition to absolute ISO 8601 timestamps. For example,--from 7d,--from now-30m, or--to 1h. -
Add
--nameto cpln workload cron run to run against a runner workload with an exact name, creating it if needed, instead of the generatedcpln-run-*runner. A stable name can be referenced elsewhere, such as a called service’s internal firewall allowlist. -
Honor
envFromin the K8s Converter, expanding each ConfigMap and Secret key into an environment variable. -
Infer
firewallConfig.internal.inboundAllowType: same-gvcfor converted workloads backed by a Kubernetes Service. -
Add the
cpln.io/workload-type,cpln.io/inherit-env, andcpln.io/internal-inbound-allow-typeannotations to control conversion. -
Convert
ReadWriteMany/ReadOnlyManyPVCs to shared volumesets, mountable by any workload type. -
Hint at the
cpln.io/workload-typeannotation whencpln apply --k8sfails withWorkload type may not be changed.
-
Add
-
Patch Changes
- Fail cpln workload run fast when a deployment stalls before becoming ready — for example, when it is paused because a referenced secret cannot be revealed — aborting with the platform’s reason instead of waiting for the readiness poll to time out. Terminal sessions now also exit non-zero on a transport or backend session error instead of reporting success.
- Retry cpln image build —push and cpln image copy on transient proxy and connection-closed errors before giving up. Permanent failures such as bad credentials or a missing image still fail immediately.
- Fix base64 secret
datanot being decoded when merged withstringData. - Surface K8s conversion warnings on
cpln convert -o yamland on failedcpln apply --k8s.
CLI v3.13.0 Release
- Date: July 14, 2026
-
Version Info
- npm: 3.13.0
-
Minor Changes
- Switch cpln login to a device-code flow. The command prints a sign-in URL and a confirmation code to enter in any browser, so logging in works from SSH sessions, containers, and other headless environments.
- Add
requestto cpln quota to manage quota increase requests:cpln quota request create <name> --requested-max <value>submits one,cpln quota request get <id>shows its status, andcpln quota request list [--status pending|approved|denied]reviews them. Requests within your account’s boundary are approved automatically; the rest await administrator approval.
-
Patch Changes
- Fix cpln sandbox connect SSH authentication against de-rooted sandbox images by connecting as
devuserinstead ofroot.
- Fix cpln sandbox connect SSH authentication against de-rooted sandbox images by connecting as
CLI v3.12.0 Release
- Date: July 3, 2026
-
Version Info
- npm: 3.12.0
-
Minor Changes
- Add
cpln sandbox connectcommand to connect to a running sandbox over an SSH tunnel using VS Code, Cursor, SSH, the browser IDE, or a terminal (--ide vscode|cursor|ssh|browser|terminal).
- Add
-
Patch Changes
- Restore the terminal’s stdin state after interactive exec sessions end.
CLI v3.11.0 Release
- Date: June 12, 2026
-
Version Info
- npm: 3.11.0
-
Minor Changes
- Add
healthsubcommand to cpln mk8s to show the health status of an mk8s cluster. - Determine workload readiness from the workload health object instead of deployments.
- Add
-
Patch Changes
- Fix cpln login popup authentication being blocked by Chrome’s Cross-Origin-Opener-Policy (COOP).
- Fix
--publishoption handling in the cpln agent up command. - Fix cpln port-forward crash when the IPv6 loopback address cannot be bound.
- Upgrade dependencies to resolve known security vulnerabilities and the
uuiddeprecation warning.
CLI v3.10.2 Release
- Date: May 6, 2026
-
Version Info
- npm: 3.10.2
-
Patch Changes
- Fix —arg and —header dropping option-shaped values
CLI v3.10.1 Release
- Date: April 3, 2026
-
Version Info
- npm: 3.10.1
-
Patch Changes
- Upgraded dependencies to resolve known security vulnerabilities.
- Add pagination to logs command to fetch beyond server limit.
- Fix ConfigMap and Secret name collision in k8s-converter.
CLI v3.10.0 Release
- Date: March 16, 2026
-
Version Info
- npm: 3.10.0
-
Minor Changes
- Add
--identityflag to cpln workload cron run subcommand, when given a new cron workload with that identity will be created or an existing one that has it will be used. - Add predictive autoscaling to volumeset create and update commands.
- Add cpln volumeset shrink command.
- Add
schedule-nameandactive-deadline-secondsargs to cpln workload cron start command.
- Add
CLI v3.9.1 Release
- Date: February 11, 2026
-
Version Info
- npm: 3.9.1
-
Patch Changes
- Revert cpln workload run to original standard workload-based execution
- Move cron-based run logic to new cpln workload cron run subcommand
CLI v3.9.0 Release
- Date: February 6, 2026
-
Version Info
- npm: 3.9.0
-
Minor Changes
-
Add
auditsubcommand to resource commands (e.g.,cpln workload audit,cpln gvc audit) to retrieve audit trail events. -
Refactor shell completion system to remove
tabtabdependency. - Refactor cpln workload run to use a persistent suspended cron workload.
-
Add
--unsetflag to the update command for removing properties and named array items. -
Add
requestRetryPolicyandextraspaths to cpln workload update with JSON support. -
Add
--timeoutSecondsoption to cpln volumeset expand command. -
Add pagination warning when more records are available beyond the default limit, guiding users to use
--max 0to fetch all records. - Add context-aware error message when the active profile points to a non-existent profile configuration.
- Add Domain conversion to K8s Converter.
-
Change default workload type to
standardin create and convert commands. -
Deprecate
--removeflag in favor of--remove-tagfor tag commands. -
Show
Nowinstead of0 minutes agofor recent timestamps. -
Fix incorrect
--relflag description in query options.
-
Add
-
Patch Changes
- Fix Helm release status not being marked as failed when resource link resolution fails, which could leave releases stuck in
pending-installorpending-upgradestatus. - Fix error formatting to display network errors (e.g., certificate failures) instead of showing an empty object.
- Fix numeric environment variable values breaking cpln helm install.
- Fix tilde (
~) expansion in user-provided file paths for commands like cpln agent up. - Fix cpln login blank page in binary distributions.
- Add fallback to legacy
docker buildwhendocker buildxis unavailable in cpln image build.
- Fix Helm release status not being marked as failed when resource link resolution fails, which could leave releases stuck in
CLI v3.8.2 Release
- Date: January 16, 2026
-
Version Info
- npm: 3.8.2
-
Patch Changes
- Fixed binary startup issues affecting cpln and docker-credential-cpln on macOS and other platforms.
CLI v3.8.1 Release
- Date: January 15, 2026
-
Version Info
- npm: 3.8.1
-
Patch Changes
- Fixed an issue where the cpln binary would fail to start on macOS and other platforms.
CLI v3.8.0 Release
- Date: January 15, 2026
-
Version Info
- npm: 3.8.0
-
Minor Changes
- Add
buildpack/b,env,envFile,trust-builderandtrust-extra-buildpacksargs to cpln image build command for building an image with Cloud Native Buildpacks. - Add
--platformarg to cpln image build command. - Auto-detect Dockerfile from —dir directory in cpln image build command.
- Fix package vulnerabilities.
- Add
CLI v3.7.5 Release
- Date: December 10, 2025
-
Version Info
- npm: 3.7.5
-
Patch Changes
- Enforce history limit post‑success and prune to configured depth in cpln helm command.
CLI v3.7.4 Release
- Date: December 4, 2025
-
Version Info
- npm: 3.7.4
-
Patch Changes
- Update buildpacks builder to build using platform
linux/amd64.
- Update buildpacks builder to build using platform
CLI v3.7.3 Release
- Date: December 4, 2025
-
Version Info
- npm: 3.7.3
-
Patch Changes
- Update buildpacks to
0.39.0.
- Update buildpacks to
CLI v3.7.2 Release
- Date: November 10, 2025
-
Version Info
- npm: 3.7.2
-
Patch Changes
- cpln image build now uses
docker buildx build.
- cpln image build now uses
CLI v3.7.1 Release
- Date: October 22, 2025
-
Version Info
- npm: 3.7.1
-
Patch Changes
- Update agent default image.
- Read
x-cplnstanza in docker-compose to override and extend workload spec. - Assume port protocol from port number in cpln convert command.
CLI v3.7.0 Release
- Date: September 12, 2025
-
Version Info
- npm: 3.7.0
-
Major Changes
- A chart path is now required when running any of the following commands:
-
Minor Changes
- Add
--repoflag to install/upgrade helm charts from OCI registries or Helm repositories. Refer to the cpln helm guide for more info. - Add
--installflag to cpln helm upgrade to automatically create and install a release with the given name if not present.
- Add
-
Patch Changes
- Enforce validation so non-CPLN resources cause install or upgrade to fail.
- Fix Helm notes rendering issue.
- Update default image for cpln workload run command to ubuntu:latest.
- Allow bare keys in
.envto default to empty values in cpln stack command.
CLI v3.6.1 Release
- Date: August 20, 2025
-
Version Info
- npm: 3.6.1
-
Patch Changes
- Fix resource not found during helm release migration to version 4.
CLI v3.6.0 Release
- Date: August 20, 2025
-
Version Info
- npm: 3.6.0
-
Minor Changes
- Add
--dependency-updateto cpln helm commands.
- Add
-
Patch Changes
- Fix typos and grammar mistakes.
- Fix the displayed release name on error if user attempts to override a resource of a different release in cpln helm.
- Fix cpln helm tag handling to persist only tags specified with —tag option and drop removed/unwanted ones.
- Return a non-zero code if a backend error occurred in cpln workload exec or cpln workload connect commands.
- Fix a cpln port-forward local server error for packaged binaries.
- Fix K8s Converter Logging service 400 status on submit with refresh token.
- Add public exposure detection to workload firewall in K8s K8s Converter.
- Fix command array parsing to correctly assign extra items to args in K8s Converter.
- Prevent
subPathto be appended to mount path during K8s conversion.
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.
- Add K8s CRD as an output option. (
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_CHECKenvironment 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
--buildoption for stack commands.
- Add
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
loadBalancerto cpln workload update command. -
Add
sharedto 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 convertwith the--verboseoption. - Disable nearest year rounding in table format.
-
Add
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
--alloption 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
-ioption to send stdin to the workload. -
Use the
-toption to treat stdin as TTY.
-
Use the
-
Stdin and TTY Handling: Previously, stdin and TTY were enabled by default. Now, these must be explicitly set:
-
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.
-
Minor Changes:
- Improve cpln convert command to convert ConfigMaps, Persistent Volume Claims and pull secrets.
-
Add
--encodingoption to cpln secret create-opaque command. - Fix path syntax for cpln mk8s kubeconfig command on Windows.
-
Use the first location of a GVC if the
--locationoption 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 listcommand. -
Add
cpln cpcommand. -
Directly stream stdin to the workload replica when using the
cpln workload execandcpln 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 functionality.
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
getcommand. - 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.
-
Add CRON
CLI v1.6.0 Release
- Date: February 7, 2024
-
Version Info
- npm: 1.6.0
-
Notes:
-
Print
workload cron startcommand output as a table. -
Add container override arguments to the
workload cron startcommand. - 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
CreatedtoSnapshot Created. -
Logs: add
-fas alias to-t. -
Fix
deleteinworkload runcommand. - Add external id to AWS and ECR secrets.
- Update dependencies.
-
Print
CLI v1.5.4 Release
- Date: January 23, 2024
-
Version Info
- npm: 1.5.4
-
Notes:
-
Add
ACTIVEcolumn for profiles. - Modify helm list to display release names only.
-
Print
NOTES.txton 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 setandsnapshotcommands. -
Add
cronandreplicasub-commands to workload.
-
Add
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 runcommand.
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:
maxBodySizenot set when reading. -
Inform user when the environment variable
CPLN_TOKENis being used for authentication. -
Updates to
cpln workload runcommand.
-
Logs:
CLI v0.0.90 Release
- Date: May 5, 2023
-
Version Info
- npm: 0.0.90 / Build: 859056052 / Version: b58459f
-
Notes:
- Update HTML on
cpln loginbrowser page.
- Update HTML on
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
runcommand. -
Allow
--tagto 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 imageanddocker logincommands.
- Added docker store and erase commands. Fixes issue when using both
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 execcommand.
- 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
NGSCloud Account. -
Added
NATS AccountSecret type. - Removed GVC domain.
- Upgrade buildpacks to version 0.27.0.
-
Added
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 updatecommand.
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 manifestcommand to allow running an agent on a k8s cluster.
- Added
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-redeploymentsubcommand to theworkloadcommand.
-
Update error handling:
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.
-
New workload subcommands:
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
- Create ~/.docker during
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-orgwhen the--publicflag 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
applycommand
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-ecrsecret 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-cplnin the same archive as the CLI
- For the binary package, include the executable
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’, ‘CPLN_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
taskas a policy target kind -
Resume
cpln logsstream on disconnect - Refresh authentication token before getting logs
- Fix for missing Docker config.json file
-
Added
CLI v0.0.31 Release
- Date: May 1, 2021
-
Version Info
- npm: 0.0.31 / Build: 295632825 / Version: 01e4461
-
Notes:
- Added
cpln agent infocommand
- Added
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 logincommand is executed. - Updated axios to version 0.21.1
-
Fix for the closing of a command or PowerShell shell in Windows 10 if the