promote

code-push prerequisites need to be met in order to run this command

Description

  • Promote a CodePush release to a different deployment name and/or native application versions.

Syntax

ern code-push promote

Options

--description/--des

  • Description of the changes made to the app with this release. If omitted, the description from the release being promoted will be used.

  • Default Empty string

--disableDuplicateReleaseError

  • When this flag is set, promoting a package that is identical to the latest release on the target deployment will produce a warning instead of an error

  • Default false

--force/-f

  • Bypass all compatibility checks and force OTA update through CodePush. USE AT YOUR OWN RISK

  • Default false

--label/-l

  • Promote the release matching this specific label.

  • Default The latest release matching sourceDescriptor/sourceDeploymentName pair will be promoted.

--mandatory/-m

  • Specify that the promoted release is mandatory (will be immediately downloaded and installed).

  • Default false

--reuseReleaseBinaryVersion

  • Indicates whether to reuse the target binary version that was used for the initial release

  • If omitted, and targetBinaryVersion is not set, the promotion will target the exact version of the descriptor

  • This option is mutually exclusive with targetBinaryVersion

--rollout/-r <percentage>

  • Specify the percentage of users who will have access to this release.

  • Default 100

--skipConfirmation/-s

  • Skip confirmation prompts

  • Default false

--skipNativeDependenciesVersionAlignedCheck/-n

  • Skip the check to compare native dependencies version alignment

  • This flag helps skipping native dependencies check for promoting same bundle label to multiple target versions

  • Default false

--sourceDeploymentName

  • The deployment name of the release to promote (Staging for example).

  • Default The command will prompt to input the deployment name, or display a list of deployment names stored in the Cauldron, to choose from.

--sourceDescriptor <descriptor>

  • Specify the native application version from which to promote a release in the form of a complete native application descriptor.

  • The release to be promoted will be the latest non disabled release of this native application version.

  • Default The command will list all released native applications versions stored in the Cauldron and will prompt to select a target native application version from the list.

--targetBinaryVersion/-t <targetBinaryVersion>

  • Semver expression that specifies the binary app version this promotion is targeting

  • If omitted, and reuseReleaseBinaryVersion is not set, the promotion will target the exact version of the descriptor

  • If versionModifier is specified in the codePush config, it will be applied

  • For using targetBinaryVersion option users must target only 1 descriptor

  • For using targetBinaryVersion option users cannot use semVerDescriptor

  • This option is mutually exclusive with reuseReleaseBinaryVersion

--targetDeploymentName

  • The deployment name to promote the release to (Production for example).

  • Default The command will prompt to input the deployment name, or display a list of deployment names stored in the Cauldron, to choose from.

--targetDescriptors <descriptors..>

  • Specify one or more target native application version to promote the release to, in the form of a complete native application descriptor list (separated by spaces).

  • The target descriptor can be the same as the source descriptor if the promotion is only changing the deployment name (for example promoting a release from Staging to Production for the same native application version).

--targetSemVerDescriptor <descriptor>

  • A native descriptor using a semantic version string for its version. The promotion will target all native application versions matching the semver.

  • If no targetDescriptors nor a targetSemVerDescriptor is specified, the command will list all released native application versions stored in the Cauldron and will display a prompt to select one or more target native application version(s) for the promotion.