dcloud deploy deployments create

Start a deployment of an app

IAM deploy:DeployAppChanges stateAsks before it deletes (-y skips)

imageRef deploys that image this once without changing the app. An image in this organization’s registry is resolved to a digest first. fromDeploymentId runs what that deployment ran; with trigger rollback it also restores the environment that deployment started with (restoreEnvironment, default true for a rollback, needs deploy:ManageEnv as well).

Synopsis

dcloud deploy deployments create id [flags]

Arguments

  • <id>Required

    string

    Also accepted as --id. Constraints: uuid

Flags

  • --triggerOptional

    enum

    rollback marks the deployment as a rollback and, with fromDeploymentId, restores that deployment’s environment by default

    One of: manual, rollback

    Default: "manual"

  • --git-commit-shaOptional

    string

    Commit to build; omitted, the head of the app’s branch

    Constraints: 7-64 chars

  • --image-refOptional

    string

    Image to run for this deployment only; the app’s own image is not changed

    Constraints: 1-512 chars, /^[a-z0-9]([a-z0-9._-]*[a-z0-9])?(:[0-9]+)?(\/[a-z0-9]([a-z0-9._-]*[a-z0-9])?)*(:[A-Za-z0-9._-]+|@sha256:[a-f0-9]{64})?$/

  • --from-deployment-idOptional

    string

    An earlier deployment of this app to run again: its image or pinned compose file, commit and release command

  • --reasonOptional

    string

    Why, shown on the deployment timeline beside who started it

    Constraints: 1-500 chars

  • --restore-environmentOptional

    boolean (--restore-environment / --no-restore-environment)

    With fromDeploymentId: also put back the environment that deployment started with; default true for a rollback, false otherwise

Example

dcloud deploy deployments create id

Generated from the API description, the same one the API checks requests against and the CLI is built from.