gcloud beta saas-runtime rollout-kinds create - create a Rollout Kind

gcloud beta saas-runtime rollout-kinds createROLLOUT_KIND--unit-kind=UNIT_KIND[--labels=[LABELS,…]][--location=LOCATION][--rollout-orchestration-strategy=ROLLOUT_ORCHESTRATION_STRATEGY][--unit-filter=UNIT_FILTER][--update-unit-kind-strategy=UPDATE_UNIT_KIND_STRATEGY][--error-budget-allowed-count=ERROR_BUDGET_ALLOWED_COUNT--error-budget-allowed-percentage=ERROR_BUDGET_ALLOWED_PERCENTAGE][GCLOUD_WIDE_FLAG …]

RolloutKindId resource - Identifier. The resource name (full URI of theresource) following the standard naming scheme:

"projects/{project}/locations/{location}/rolloutKinds/{rollout_kind_id}"ThisrepresentsaCloudresource.(NOTE)Someattributesarenotgivenargumentsinthisgroupbutcanbesetinotherways.

To set theproject attribute:

• provide the argumentrollout_kind on the command line with a fullyspecified name;
• provide the argument--project on the command line;
• set the propertycore/project.

To set thelocation attribute:

• provide the argumentrollout_kind on the command line with a fullyspecified name;
• provide the argument--location on the command line.

This must be specified.

ROLLOUT_KIND

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

To set therollout_kind attribute:

• provide the argumentrollout_kind on the command line.

UnitKind resource - UnitKind that this rollout kind corresponds to. Rolloutsstemming from this rollout kind will target the units of this unit kind. Inother words, this defines the population of target units to be upgraded byrollouts. This represents a Cloud resource. (NOTE) Some attributes are not givenarguments in this group but can be set in other ways.

To set theproject attribute:

• provide the argument--unit-kind on the command line with a fullyspecified name;
• provide the argument--project on the command line;
• set the propertycore/project.

To set thelocation attribute:

• provide the argument--unit-kind on the command line with a fullyspecified name;
• provide the argument--location on the command line.

This must be specified.

--unit-kind=UNIT_KIND

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

To set theunit_kind attribute:

• provide the argument--unit-kind on the command line.

--labels=[LABELS,…]

The labels on the resource, which can be used for categorization. similar toKubernetes resource labels.

KEY

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

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)

--location=LOCATION

For resources [rollout_kind, unit-kind], provides fallback value for resourcelocation attribute. When the resource's full URI path is not provided, locationwill fallback to this flag value.

--rollout-orchestration-strategy=ROLLOUT_ORCHESTRATION_STRATEGY

The strategy to use for executing rollouts.

--unit-filter=UNIT_FILTER

CEL(https://github.com/google/cel-spec) formatted filter string against Unit.The filter will be applied to determine the eligible unit population. Thisfilter can only reduce, but not expand the scope of the rollout.

--update-unit-kind-strategy=UPDATE_UNIT_KIND_STRATEGY

The config for updating the unit kind. By default, the unit kind will be updatedon the rollout start.UPDATE_UNIT_KIND_STRATEGY must beone of:

never

Never update the unit kind.

on-start

Update the unit kind strategy on the rollout start.

Arguments for the error budget.

The configuration for error budget. If the number of failed units exceedsmax(allowed_count, allowed_ratio * total_units), the rollout will be paused.

--error-budget-allowed-count=ERROR_BUDGET_ALLOWED_COUNT

The maximum number of failed units allowed in a location without pausing therollout.

--error-budget-allowed-percentage=ERROR_BUDGET_ALLOWED_PERCENTAGE

The maximum percentage of units allowed to fail (0, 100] within a locationwithout pausing the rollout.

Run$gcloud help for details.