gcloud beta app-lifecycle-manager rollout-kinds update

gcloud beta app-lifecycle-manager rollout-kinds update - update a rollout kind

gcloud beta app-lifecycle-manager rollout-kinds update (ROLLOUT_KIND : --location=LOCATION) [--rollout-orchestration-strategy=ROLLOUT_ORCHESTRATION_STRATEGY] [--unit-filter=UNIT_FILTER] [--update-unit-kind-strategy=UPDATE_UNIT_KIND_STRATEGY] [--clear-error-budget --error-budget-allowed-count=ERROR_BUDGET_ALLOWED_COUNT --error-budget-allowed-percentage=ERROR_BUDGET_ALLOWED_PERCENTAGE] [--labels=[LABELS,…]     | --update-labels=[UPDATE_LABELS,…] --clear-labels     | --remove-labels=REMOVE_LABELS] [GCLOUD_WIDE_FLAG …]

gcloud beta app-lifecycle-manager rollout-kinds update my-rollout-kind --location=us-central1 --rollout-orchestration-strategy=Google.Cloud.Simple.AllAtOnce

To allow up to 10% of units to fail in a location and add or update the label env=prod on the rollout kind named my-rollout-kind, run:

gcloud beta app-lifecycle-manager rollout-kinds update my-rollout-kind --location=us-central1 --error-budget-allowed-percentage=10 --update-labels=env=prod

RolloutKindId resource - Rollout kind to update. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways.

To set the project attribute:

• provide the argument rollout_kind on the command line with a fully specified name;
• provide the argument --project on the command line;
• set the property core/project.

This must be specified.

ROLLOUT_KIND

ID of the rolloutKindId or fully qualified identifier for the rolloutKindId.

To set the rollout_kind attribute:

• provide the argument rollout_kind on the command line.

This positional argument must be specified if any of the other arguments in this group are specified.

--location=LOCATION

Location ID

To set the location attribute:

• provide the argument rollout_kind on the command line with a fully specified name;
• provide the argument --location on the command line.

--rollout-orchestration-strategy=ROLLOUT_ORCHESTRATION_STRATEGY

Strategy to use for executing rollouts. Supported values are Google.Cloud.Simple.AllAtOnce, Google.Cloud.Simple.OneLocationAtATime, Google.Cloud.Progressive.Gradual.v1, and Google.Cloud.Progressive.SingleLocation.v1.

--unit-filter=UNIT_FILTER

Filter, in Common Expression Language (CEL) format, that selects the eligible units. The filter can only reduce, not expand, the scope of the rollout. For more information about CEL, see https://github.com/google/cel-spec.

--update-unit-kind-strategy=UPDATE_UNIT_KIND_STRATEGY

Strategy for updating the unit kind. If not set, the unit kind is updated when the rollout starts. UPDATE_UNIT_KIND_STRATEGY must be one of:

never

Never update the unit kind.

on-start

Update the unit kind when the rollout starts.

Error budget settings.

Configuration for the error budget. If the number of failed units in a location exceeds the larger of --error-budget-allowed-count and --error-budget-allowed-percentage percent of the units, the rollout is paused. If not set, App Lifecycle Manager attempts to update all units, regardless of the number of failures.

--clear-error-budget

Set rolloutKind.errorBudget back to default value.

--error-budget-allowed-count=ERROR_BUDGET_ALLOWED_COUNT

Maximum number of failed units allowed in a location without pausing the rollout.

--error-budget-allowed-percentage=ERROR_BUDGET_ALLOWED_PERCENTAGE

Maximum percentage of units allowed to fail in a location without pausing the rollout. Must be greater than 0 and at most 100.

Update labels.

At most one of these can be specified:

--labels=[LABELS,…]

Set labels to new value. Labels on the resource, which can be used for categorization, similar to Kubernetes resource labels.

KEY

Keys must start with a lowercase character and contain only hyphens (-), underscores (_), lowercase characters, and numbers.

VALUE

Values must contain only hyphens (-), underscores (_), lowercase characters, and numbers.

Shorthand Example:

--labels=string=string

JSON Example:

--labels='{"string": "string"}'

File Example:

--labels=path_to_file.(yaml|json)

Or at least one of these can be specified:

--update-labels=[UPDATE_LABELS,…]

Update labels value or add key value pair. Labels on the resource, which can be used for categorization, similar to Kubernetes resource labels.

KEY

Keys must start with a lowercase character and contain only hyphens (-), underscores (_), lowercase characters, and numbers.

VALUE

Values must contain only hyphens (-), underscores (_), lowercase characters, and numbers.

Shorthand Example:

--update-labels=string=string

JSON Example:

--update-labels='{"string": "string"}'

File Example:

--update-labels=path_to_file.(yaml|json)

At most one of these can be specified:

--clear-labels

Clear labels value and set to empty map.

--remove-labels=REMOVE_LABELS

Remove existing value from map labels. Sets remove_labels value. Shorthand Example:

--remove-labels=string,string

JSON Example:

--remove-labels=["string"]

File Example:

--remove-labels=path_to_file.(yaml|json)

Run $ gcloud help for details.