gcloud alpha container hub scopes create - create a new fleet scope

gcloud alpha container hub scopes createSCOPE[--async][--labels=[KEY=VALUE,…]][--namespace-labels=[KEY=VALUE,…]][--default-upgrade-soaking=DEFAULT_UPGRADE_SOAKING--upstream-scope=UPSTREAM_SCOPE--add-upgrade-soaking-override=ADD_UPGRADE_SOAKING_OVERRIDE--upgrade-selector=[name=NAME],[version=VERSION]][GCLOUD_WIDE_FLAG …]

Scope resource - The fleet scope resourse to be created. This represents a Cloudresource. (NOTE) Some attributes are not given arguments in this group but canbe set in other ways.

To set theproject attribute:

• provide the argumentscope 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 argumentscope on the command line with a fullyspecified name;
• global is the only supported location.

This must be specified.

SCOPE

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

To set thescope attribute:

• provide the argumentscope on the command line.

--async

Return immediately, without waiting for the operation in progress to complete.

--labels=[KEY=VALUE,…]

List of label KEY=VALUE pairs to add.

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

--namespace-labels=[KEY=VALUE,…]

List of scope-level label KEY=VALUE pairs to add.

Rollout Sequencing

These flags are not compatible with the--async flag.

--default-upgrade-soaking=DEFAULT_UPGRADE_SOAKING

Configures the default soaking duration for each upgrade propagating through thecurrent scope to become "COMPLETE". Soaking begins after all clusters in thescope are on the target version, or after 30 days if all cluster upgrades arenot complete. Once an upgrade state becomes "COMPLETE", it will automatically bepropagated to the downstream scope. Max is 30 days.

See$gcloud topicdatetimes for information on duration formats.

To configure Rollout Sequencing for a given scope,SCOPE_NAME, this attribute must be set. Todo this while specifying a default soaking duration of 7 days, run:

gcloudalphacontainerhubscopescreateSCOPE_NAMEdefault-upgrade-soaking=7d

--upstream-scope=UPSTREAM_SCOPE

Full resource name of the upstream scope in the format ofprojects/{project}/locations/{location}/scopes/{scope}. GKE will finish upgradeson the upstream scope before applying the same upgrades to the current scope.

To configure the upstream scope forSCOPE_NAME, run:

gcloudalphacontainerhubscopescreateSCOPE_NAME--upstream-scope=projects/{upstream_project}/locations/global/scopes/{upstream_scope}

Upgrade soaking override.

Defines a specific soaking time override for a particular upgrade propagatingthrough the current scope that supercedes the default soaking durationconfigured by--default-upgrade-soaking.

To set an upgrade soaking override of 12 hours for the upgrade with name,k8s_control_plane, and version,1.23.1-gke.1000, run:

gcloudalphacontainerhubscopescreateSCOPE_NAME--add-upgrade-soaking-override=12h--upgrade-selector=name="k8s_control_plane",version="1.23.1-gke.1000"

--add-upgrade-soaking-override=ADD_UPGRADE_SOAKING_OVERRIDE

Overrides the soaking time for a particular upgrade name and version propagatingthrough the current scope. Set soaking to 0 days to bypass soaking andfast-forward the upgrade to the downstream scope.

See$gcloud topicdatetimes for information on duration formats.

This flag argument must be specified if any of the other arguments in this groupare specified.

--upgrade-selector=[name=NAME],[version=VERSION]

Name and version of the upgrade to be overridden where version is a full GKEversion. Currently, name can be eitherk8s_control_plane ork8s_node.

This flag argument must be specified if any of the other arguments in this groupare specified.

Run$gcloud help for details.