IBM Cloud Docs
CLI version history

CLI version history

Find a summary of changes for each version of IBM Cloud® Code Engine CLI plug-in. Be sure to keep your CLI up-to-date so that you can use all the available commands and their options.

Changes in the IBM Cloud Code Engine CLI
Version Release date Changes
1.49.10 2024-04-25
  • Fixed various bugs.
1.49.9 2024-04-18
  • Fixed various bugs.
1.49.8 2024-04-11
  • Fixed various bugs.
1.49.7 2024-03-21
  • Fixed various bugs.
1.49.6 2024-03-14
  • Fixed various bugs.
1.49.5 2024-02-22
  • Updated the output for the app create, app update, job create, job update, and buildrun submit commands to provide more information about checking logs and events.
  • Fixed various bugs.
1.49.4 2024-02-05
  • Fixed various bugs.
1.49.3 2024-01-25
  • Fixed various bugs.
1.49.2 2024-01-12
  • Fixed various bugs.
1.49.1 2023-12-06
  • Fixed various bugs.
1.49.0 2023-12-01
  • Added the --array-size-variable-override option the jobrun submit and jobrun resubmit commands. Use this option to specify a custom value for the JOB_ARRAY_SIZE environment variable. See Processing a subset of data by dynamically assigning work to parallel job run instances.
  • Renamed the --instances option to --array-size for the job create, job update, jobrun submit, and jobrun resubmit commands. Note that --instances is still valid as an alias for --array-size.
  • Fixed various bugs.
1.48.0 2023-11-09
  • Updated the --build-size option for the app create, app update, job create, and job update commands to add support for xxlarge build sizes. The --size option on the build create, build update, and buildrun submit commands was also updated to add support for the xxlarge build size.
  • Added the --ignore-not-found option to the subscription kafka delete command.
  • Fixed various bugs.
1.47.1 2023-10-19
  • Added support for the --scale-down-delay option and for the endpoint --visibility option for functions on the function create and function update commands.
  • Added support for custom domain mappings for functions with the CLI.
  • Fixed various bugs.
1.46.1 2023-10-09
  • Fixed various bugs.
1.46.0 2023-09-21
1.45.4 2023-09-12
  • Upgraded to Go 1.21.0.
  • Fixed various bugs.
1.45.3 2023-07-26
  • Fixed various bugs.
1.45.2 2023-07-19
  • Fixed various bugs.
1.45.1 2023-07-06
  • Fixed various bugs.
1.45.0 2023-06-29
1.44.0 2023-06-22
  • Added support for the --scale-down-delay option on the app create and app update commands.
  • Fixed various bugs.
1.43.7 2023-06-08
  • Fixed various bugs.
1.43.5 2023-05-16
  • Fixed various bugs.
  • Updated translations for the CLI.
1.43.4 2023-04-27
  • Fixed various bugs.
1.43.3 2023-04-14
  • Fixed configuration error (Windows only).
1.43.1 2023-04-12
  • Fixed various bugs.
1.43.0 2023-03-23
1.42.0 2023-03-16
  • Important: This version updates support for secrets in the CLI such that you can define and work with various formats of secrets with the secret command group. Formats of secrets include basic authentication, generic, registry, SSH, and TLS. While you can continue to use the registry and repo command groups, take advantage of the unified secret command group. See Working with secrets and Code Engine CLI reference (secret command).
  • Fixed various bugs.
  • Updated translations for the CLI.
1.41.3 2023-03-02
  • Fixed various bugs.
1.41.2 2023-02-23
  • Fixed various bugs.
1.41.1 2023-02-17
  • Fixed various bugs.
  • Updated translations for the CLI.
1.41.0 2023-02-09
  • Upgraded to Go 1.20.0.
  • Updated translations for the CLI.
1.40.8 2023-02-03
  • Fixed various bugs.
1.40.7 2023-01-26
  • Fixed various bugs.
1.40.6 2023-01-20
  • Fixed various bugs.
1.40.5 2023-01-12
  • Fixed various bugs.
1.40.4 2023-01-14
  • Fixed various bugs.
1.40.3 2022-12-07
  • Fixed various bugs.
1.40.2 2022-12-01
  • Updated the output of the project get command to display the resource quota for custom domain mappings for a project.
  • Fixed various bugs.
  • Updated translations for the CLI.
1.40.1 2022-11-10
  • Fixed various bugs.
  • Updated translations for the CLI.
1.40.0 2022-10-27
1.39.6 2022-10-20
  • Fixed various bugs.
  • Updated translations for the CLI.
1.39.5 2022-10-06
  • Fixed various bugs.
1.39.3 2022-09-15
  • Fixed various bugs.
  • Updated translations for the CLI.
1.39.2 2022-08-31
  • Fixed various bugs.
  • Upgraded to Go 1.19.0.
1.39.1 2022-08-18
  • Updated the --maxexecutiontime option for the job create, job update, jobrun submit, and jobrun resubmit commands to change the maximum execution time from 43200 seconds (12 hours) to 86400 seconds (24 hours).
  • Fixed various bugs.
1.38.2 2022-08-04
  • Fixed various bugs.
1.38.1 2022-07-28
1.38.0 2022-07-21
  • Added support for the --binding-resource-group-id option on the project update command. Use this option to configure service binding access for all service instances in a resource group by specifying the ID of the resource group.
  • Fixed various bugs.
1.37.0 2022-07-14
  • Added support for running a Code Engine job indefinitely so that the job does not time out by specifying --mode daemon. Support for daemon mode jobs applies for the following commands: job create, job update, job get, job list, jobrun submit, jobrun resubmit, jobrun get, and jobrun list.
  • When you specify the --build-source option with the app create, app update, job create, or job update commands, Code Engine now runs a build run without first creating a build. For the apps or jobs that are created with this change, the associated get command output is updated correspondingly.
  • Added the --git-repo-secret-clear option to the build update command. Similarly, added the --build-git-repo-secret-clear option to the app update and job update commands.
  • Added the --commit-clear option to the build update command. Similarly, added the --build-commit-clear option to the app update and job update commands.
  • Fixed various bugs.
  • Updated translations for the CLI.
  • Upgraded to Go 1.18.4.
1.36.0 2022-06-23
  • Added support for Kafka event subscriptions. You can now use the subscription kafka commands to create, update, list, delete, and get information about Kafka event subscriptions.
  • Fixed various bugs.
1.35.0 2022-06-16
  • Added support for Linux 64 bit ARM for Code Engine CLI.
  • Fixed various bugs.
  • Updated translations for the CLI.
1.34.0 2022-06-09

Important: This version introduces support for running builds from local or repository source code with a single CLI command. You can now use the buildrun submit command to run one build run without the need to reference a build configuration.

  • The --build option to reference a build configuration is no longer required on the buildrun submit command. You can specify the --name option with other build options to run a single build with the buildrun submit command. The --build option is still available if you are referencing a build configuration.
  • Added the following build options to the buildrun submit command: --commit, --context-dir, --dockerfile, --git-repo-secret, --registry-secret, --size, and --strategy.
  • The subscription cron, and subscription cos commands are grouped into their subscription types (cron and cos) in the Code Engine CLI Reference. There are no changes to the commands themselves.
  • Fixed various bugs.
1.33.1 2022-06-02
  • Fixed various bugs.
  • Upgraded to Go 1.18.3.
1.33.0 2022-05-26
  • Updated the build create command so that the --image and --registry-secret options are no longer required. This update means that you can choose to let Code Engine take care of building the image for you from your source and storing the image in IBM Cloud Container Registry with automatic access, or you can choose to specify registry details with a registry access secret for your build output.
  • Fixed various bugs.
1.32.0 2022-05-19
  • Added support for Mac OS M1 for Code Engine CLI.
  • Fixed various bugs.
1.31.1 2022-05-12
  • Fixed various bugs.
  • Updated translations for the CLI.
  • Upgraded to Go 1.18.2.
1.31.0 2022-05-05
  • Updated the following commands to support a progress indicator when you create or update an app or job from local or repository source: app create, app update, job create, and job update.
  • Updated the following commands to support specifying a prefix when you reference a full configmap or secret by using the --env-from-configmap or --env-from-secret option: app create, app update, job create, job update, jobrun submit, and jobrun resubmit.
  • Updated the app get, job get, and jobrun get commands to indicate whether a full configmap or full secret reference was specified with a prefix.
  • Fixed various bugs.
1.30.0 2022-04-27

Important: This version introduces support for deploying apps and configuring jobs from local or repository source code with a single command.

  • Updated the app create, app update, job create, and job update commands to support the following build options: --build-commit, --build-context-dir, --build-dockerfile, --build-git-repo-secret, --build-size, --build-source, --build-strategy, and --build-timeout.
  • Added the --build-clear and --rebuild options to the app update, and job update commands.
  • Added --wait, --no-wait, and --wait-timeout options to the job create, and job update commands.
  • Fixed various bugs.
1.29.4 2022-04-21
  • Fixed various bugs.
1.29.3 2022-04-14
  • Fixed various bugs.
  • Upgraded to Go 1.18.1.
1.29.2 2022-04-12
  • Fixed various bugs.
1.29.1 2022-04-07
  • Fixed various bugs.
1.29.0 2022-04-01
  • Updated the --from-env-file option on the secret create, secret update, configmap create, and configmap update commands so that any lines in the specified file that are empty or begin with # are ignored.
  • Fixed various bugs.
1.28.1 2022-03-23
  • Fixed various bugs.
  • Updated translations for the CLI.
1.28.0 2022-03-18
  • Added support for --max-scale=0 on the app create and app update commands. If you set this value to 0, the application scales as needed and is limited only by the resource quota for the project of your app.
  • Fixed various bugs.
  • Updated translations for the CLI.
  • Upgraded to Go 1.18.0
1.27.1 2022-03-04
  • Fixed various bugs.
  • Upgraded to Go 1.17.8.
1.27.0 2022-03-02
  • CLI 1.27.0 introduces an improved service binding implementation, which is used for all new service bindings. Existing applications and jobs continue to function normally. However, if you want to bind an additional service instance to an app or job, you must first delete any existing service bindings from that app or job. You can then re-create those service bindings with the improved service binding implementation.
  • Added the --service-instance-id option to the app bind and job bind commands.
  • Updated the default timeout value for the --wait-timeout option from 300 seconds to 600 seconds for the app create, app delete, and app update commands.
  • Fixed various bugs.
1.26.1 2022-02-24
  • Fixed various bugs.
1.26.0 2022-02-17
  • Added support for choosing different names for keys that are referenced as environment variables from secrets or configmaps with the --env-from-secret and --env-from-configmap options.
  • Fixed various bugs.
  • Updated translations for the CLI.
  • Upgraded to Go 1.17.7.
1.25.4 2022-02-10
  • Fixed various bugs.
1.25.3 2022-02-03
  • Fixed various bugs.
1.25.2 2022-01-27
  • Fixed various bugs.
1.25.0 2022-01-20
  • Added support for creating a build that pulls source from a local directory. Added the --build-type option to the build create command, with values of git or local. The default for this option is git. Added the --source option to the buildrun submit command, which is valid when the build-type is local.
  • Fixed various bugs.
1.24.0 2022-01-13
  • Added the application restart and jobrun restart commands to restart running app and job run instances.
  • Added the buildrun cancel command to stop a running build run.
  • Added support for working with configuration maps and secrets with jobs and job runs as mounted files. For this support, added the --mount-configmap and --mount-secret options to the job create, job update, jobrun submit, and jobrun resubmit commands. Added the --mount-rm option to the job update and jobrun resubmit commands to remove the contents of the configmap or secret from the file system for the job or job run. Updated the output for the job get and jobrun get commands to add a Mounts section to display information about mounted files.
  • Updated description of kubecfg option for the project select command to clarify that the KUBECONFIG environment variable can be used to override the Kubernetes configuration file.
  • Fixed various bugs.
  • Updated translations for the CLI.
  • Upgraded to Go 1.17.6.
1.23.3 2021-12-15
  • Fixed various bugs.
  • Updated translations for the CLI.
  • Upgraded to Go 1.17.5.
1.23.2 2021-12-01
  • Fixed various bugs.
  • Updated translations for the CLI.
1.23.1 2021-11-19
  • Fixed various bugs.
1.23.0 2021-11-15
  • Added support for private endpoints, which includes support for private.cloud.ibm.com when you are running within a virtual private endpoint (VPE) and a virtual server instance (VSI). Added the --endpoint option with values private and public on the project create and project update commands. Added the --visibility option with values private, project, and public on the app create and app update commands.
  • Updated the output for the buildrun get command to display the source of the build run, the output image digest, and if available, display the output image size.
  • Fixed various bugs.
  • Upgraded to Go 1.17.3.
1.22.0 2021-11-04
  • Updated to verify the event extension name length. The maximum length of an extension name is 253 alphanumeric characters. When you use the --extension option on the sub cos create, sub cos update, sub cron create, or sub cron update commands, the event extension name length is validated.
  • Added support for the . (period) character in a Git group name when you use the --source URL with the build create or build update commands. For example, you can use my.name in the following --source option: --source git@us-south.git.cloud.ibm.com:my.name/helloworld.git.
  • Fixed various bugs.
1.21.1 2021-10-27
  • Fixed various bugs.
1.21.0 2021-10-21
  • Added the --output option value of project-url to the app create, app update, and app get commands. You can use --option project-url to obtain the project-only (cluster-local) URL for your app.
  • Updated translations for the CLI.
1.20.1 2021-10-07
  • Updated translations for the CLI.
1.20.0 2021-10-04
  • Updated the project delete and reclamation delete commands so that if the project is in hard deletion failed status, the user can retry the commands.
  • Updated the build create command to change the default value for the --commit option from main to empty. This update enables the system to determine the default branch at run time.
  • Fixed a bug with the job create, job update, jobrun submit, and jobrun resubmit commands so that when the --instances=1 option is specified, this value becomes array-indices=0 instead of array-indices=1 because array-indices are zero-based.
  • Fixed various bugs.
1.19.1 2021-09-23
  • Fixed various bugs.
1.19.0 2021-09-16
  • Added the --password-from-json-file option to the registry create and registry update commands. This option supports referencing an entire IAM API key JSON file and you can use the apikey field in the file as the registry password.
  • Added references to logs and events commands to the outputs for app get, jobrun get, and buildrun get commands.
1.18.0 2021-09-09
  • Added a prompt to confirm deletion to the reclamation delete command. Added the --force option to the reclamation delete command to force the deletion without confirmation.
  • Added the --all-resource-groups option to the project list and reclamation list commands to display projects from all resource groups instead of just the currently targeted resource group.
  • Updated the output of the project get command to display the resource quota for all projects, not just the currently selected project.
  • Updated the output of the reclamation get and reclamation list commands to display information about time to hard deletion.
  • Updated the output for the application get command to display the Cluster Local URL information.
  • Updated the output for all commands with the --output json option to display JSON in pretty-printed format.
  • Updated the --wait-timeout option for the project create command to increase the default value to 600 seconds (10 minutes).
1.17.0 2021-08-31
  • Added the reclamation delete, reclamation get, reclamation list, and reclamation restore commands for managing project reclamations.
1.16.1 2021-08-24
  • Fixed various bugs.
1.16.0 2021-08-17
  • Added --wait, --no-wait, and --wait-timeout options to the project create command.
  • Updated the default timeout value for the project create command from 3 minutes (180 seconds) to 5 minutes (300 seconds).
  • Updated the project get command output to change the format of the memory and ephemeral storage values to display in gigabytes.
  • Updated translations for the CLI.
1.15.0 2021-08-16
  • Renamed the subscription ping commands to subscription cron. The CLI subscription ping is now an alias for the subscription cron commands, so the subscription ping commands continue to work.
  • Updated the job get and job list commands to display information about the last job run.
  • Updated the build get and build list commands to display information about the last build run.
  • Changed the app update command to always create a new revision regardless of whether changes are made to the application configuration.
  • Updated the --image option on the app create, app update, job create, job update, and jobrun submit commands to accept both a tag and digest on the image reference.
1.14.0 2021-08-06
  • Added the --all option to the secret list command to display all secret types.
  • Updated the build create and build update commands to not allow a URL in http or https format for the --source option when the --git-repo-secret option is provided.
  • Fixed various bugs.
1.13.0 2021-07-30
  • Added the project restore command to restore projects that were previously soft deleted to an active state.
  • Added the --raw option to the app logs, buildrun logs, jobrun logs commands.
1.12.0 2021-07-22
  • Updated the following CLI commands to support image digests when you use the --image option: app create, app update, job create, job update, and jobrun submit.
1.11.0 2021-07-15
  • Added the revision events command to display the events of application revision instances. Added the revision logs command to display the logs of application revision instances.
  • Added support for the --output option to the create and update subcommands for app, build, configmap, job, registry, repo, secret, subscription cos, and subscription ping commands. This option was also added to the buildrun submit, project create, jobrun submit, and jobrun resubmit commands.
  • Added support for verifying that the --registry-secret exists unless the --force option is specified for the following commands: app create, app update, job create, job update, and jobrun submit. Similarly, added support for verifying that the --registry-secret and the --git-repo-secret exist unless the --force option is specified for the build create and build update commands. The --force option specifies to avoid verification of the existence of the registry secret and the Git repo secret (as applicable).
  • Updated the output of the project list and project get commands to display whether a project is enabled or disabled. If the status of your IBM Cloud account is disabled, then the status of any Code Engine projects in that account are disabled.
  • Updated the output of the project current command.
  • Fixed various bugs.
1.10.0 2021-06-23
  • Updated list commands to display a warning when the quota is reached for that resource. For example, the app list command displays a warning when the application quota is reached.
  • Added the project tag command. Use this command to add and remove tags for a single project.
  • Updated the revision get command to display information for events and instances.
  • Updated the jobrun list and jobrun delete commands to filter by --job. You can use the --job filter to list or delete job runs that reference a specified job configuration.
  • Updated the buildrun list and buildrun delete commands to filter by --build. You can use the --build filter to list or delete build runs that reference a specified build configuration.
1.9.0 2021-06-15
  • Added support for the --instances option with the job create, job update, jobrun submit, and jobrun resubmit commands. Use this option to specify the number of instances for the job or job run.
  • Added the --ignore-not-found option on all Code Engine delete commands, except for the project delete command. This option specifies that if the resource is not found, do not fail the delete.
  • Updated the behavior of the app create, app update, job create, job update, jobrun submit, jobrun resubmit commands to fail if a referenced configmap or secret does not exist. Added the --force option on these commands to avoid verification of the existence of the configmap or secret with these commands.
  • Added domain information to the output of the project current command.
  • Fixed various bugs.
1.8.0 2021-06-09
  • Important: Introduced a breaking change with Code Engine memory and CPU combinations. With this version, applications and batch jobs are required to use a specific set of memory and CPU combinations for resource allocations. Existing running workloads are not impacted, but new and updated workloads are required to follow these requirements. For more information, see Supported memory and CPU combinations.
  • Added support for the --service-account option with the app create, app update, job create, job update, jobrun submit, jobrun resubmit, and buildrun submit commands. Added support for the --service-account-clear option with the app update, job update, and jobrun resubmit commands.
  • Added the --output option to the project current command.
  • Improved the output of the build get, build list, buildrun get, and buildrun list commands to display the name of the output image.
  • Added b as an alias for the build command group.
  • Updated the output of job run instances with their various statuses such that the output is listed in the order of progression instead of alphabetically.
  • Fixed various bugs.
1.7.0 2021-05-27
  • Added support for the --quiet option globally across Code Engine commands.
  • Increased the unbind wait time default value from 120 seconds to 300 seconds for the app unbind and job unbind commands.
  • Fixed various minor bugs.
1.6.0 2021-05-17
  • Added the --revision-name option to the app create and app update commands to specify a name for an app revision.
  • Increased the polling frequency for following logs by using the --follow option with the app logs, buildrun logs, and jobrun logs commands.
  • Added support for the environment variable IBMCLOUD_QUIET. When this variable is set to true, the CLI reduces the amount of output.
1.5.0 2021-05-10
  • Added the revision delete, revision get, and revision list commands for managing application revisions.
  • Added the --show-all-revisions option to the application get command to display all revisions for the specified app.
  • Added revision Tag information to the application get command.
  • Changed application revision name generation. For example, an app revision that is created before CLI 1.5.0 is of the format myapp-abc12-1. An app revision that is created starting from CLI 1.5.0 is of the format myapp-00001.
  • Updated the yaml output for the secret get and secret list commands to show Code Engine generic secrets as type Opaque.
1.4.0 2021-04-29
  • Added the registry update and repo update commands.
  • Added the --decode option on the registry get, repo get, and secret get commands to show data as decoded.
  • Updated the build list and build get command output to replace kaniko with dockerfile.
  • Updated the output of get and list commands so that if the --output yaml or --output json option is used with these commands, then the command output no longer displays managedFields information.
1.3.0 2021-04-21
  • Added --wait, --no-wait, and --wait-timeout options to the project delete command.
  • Added support for CloudEvent extensions on subscription COS and subscription ping commands. This support adds the --extensions option to the subscription COS create, subscription COS update, subscription ping create, and subscription ping update commands. Also, adds the --extensions-rm option to the subscription COS update and subscription ping update commands to remove CloudEvent extensions.
  • Updated the project status on the output for the project get and the project list commands. The status of provisioning is changed to creating, and the status of pending reclamation is changed to soft deleted.
  • Fixed various minor bugs.
1.2.0 2021-04-13
  • New! Subscription support for jobs as a beta function. Added support for jobs as event destinations. Use the --destination-type option with the subscription ping create, subscription ping update, subscription cos create, and subscription cos update commands to specify the event destination. Valid values for this option are app and job.
  • Updated the project get command to display project quota information.
1.1.0 2021-04-07
  • Increased the polling frequency when build runs and job runs are waiting to complete.
  • Updated the project delete command such that if a project was previously deleted without specifying the --hard option, a subsequent project delete command must use the --hard option.
  • Updated the project select command such that a project must be in active status before it can be selected.
  • Updated the output for the project list and project get commands to display projects that are in pending_reclamation status.
1.0.0 2021-03-30

This version is the generally available release of Code Engine CLI.- Important Introduced a breaking change to Code Engine service binding functions. Service bindings that were created with releases of the CLI earlier than release 1.0.0 will no longer work after you update to the CLI 1.0.0 release. Unbind pre-existing service bindings before you update to CLI 1.0.0.

  • Updated service bindings to use a new naming convention. Binding names are now autogenerated to ensure uniqueness.
  • Updated the app unbind and job unbind commands to accept the --binding option. The --binding option replaces the --service-instance option.
  • Renamed the service binding VCAP_SERVICES environment variable, which is injected into running containers, to CE_SERVICES.
  • Updated application and job service bindings to support multiple service bindings to the same service instance.
  • Updated support for service bindings such that service bindings that are created without existing service credentials always generate a new, unique service credential.
  • Added more information to the output for bad request errors encountered by the CLI.
0.6.3 2021-03-26
  • Updated translations for the CLI.