Release Notes
This page will be updated regularly. Check back often for the latest features, updates, and changes.
Latest Versions
- CLI
- Date: August 26, 2024
- Version Info
- npm: 3.1.1
- Installation Instructions
Known Issues
- CLI
- Windows
- Autocomplete functionality is not available. A workaround is available for
cygwin
.
- Autocomplete functionality is not available. A workaround is available for
- Windows
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.
- 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.
- Use the
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:
-
-
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
andcpln 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
.
- Add CRON
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
toSnapshot Created
. - Logs: add
-f
as alias to-t
. - Fix
delete
inworkload run
command. - 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
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
andsnapshot
commands. - Add
cron
andreplica
sub-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 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.
- 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 login
browser 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
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
anddocker login
commands.
- 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 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.
- 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 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.
- 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-redeployment
subcommand to theworkload
command.
- 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-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
- 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’, ‘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
- Added
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
- 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 login
command is executed. - Updated axios to version 0.21.1
- Fix for the closing of a command or PowerShell shell in Windows 10 if the