gcloud beta app-lifecycle-manager unit-operations create

NAME

gcloud beta app-lifecycle-manager unit-operations create - create a unit operation

SYNOPSIS

gcloud beta app-lifecycle-manager unit-operations create UNIT_OPERATION --unit=UNIT [--cancel] [--labels=[LABELS,…]] [--location=LOCATION] [--parent-unit-operation=PARENT_UNIT_OPERATION] [--rollout=ROLLOUT] [--schedule-start-time=SCHEDULE_START_TIME] [--deprovision     | --flag-update=FLAG_UPDATE     | --provision --provision-input-variables=[type=TYPE],[value=VALUE],[variable=VARIABLE] --provision-release=PROVISION_RELEASE     | --upgrade --upgrade-input-variables=[type=TYPE],[value=VALUE],[variable=VARIABLE] --upgrade-release=UPGRADE_RELEASE] [GCLOUD_WIDE_FLAG …]

DESCRIPTION

(BETA) Create an App Lifecycle Manager unit operation.

A unit operation encapsulates the intent to change or interact with the service component represented by a specific unit. For example, a unit operation can provision, upgrade, or deprovision the unit. Multiple unit operations can be requested and scheduled, but only one runs at a time.

EXAMPLES

To create a unit operation named my-unit-operation in location us-central1 that provisions the unit my-unit with the release my-release, run:

gcloud beta app-lifecycle-manager unit-operations create my-unit-operation --location=us-central1 --unit=my-unit --provision --provision-release=my-release

To create a unit operation named my-unit-operation that deprovisions the unit my-unit, run:

gcloud beta app-lifecycle-manager unit-operations create my-unit-operation --location=us-central1 --unit=my-unit --deprovision

To create a unit operation named my-unit-operation that upgrades the unit my-unit to the release my-new-release with the input variable instance_name set to my-instance, scheduled to start at 2099-01-01T10:00:00Z, run:

gcloud beta app-lifecycle-manager unit-operations create my-unit-operation --location=us-central1 --unit=my-unit --upgrade --upgrade-release=my-new-release --upgrade-input-variables=variable=instance_name,value=my-instance,type=string --schedule-start-time=2099-01-01T10:00:00Z

POSITIONAL ARGUMENTS

UnitOperation resource - Unit operation to create. This represents a Cloud 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 unit_operation on the command line with a fully specified name;
• provide the argument --project on the command line;
• set the property core/project.

To set the location attribute:

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

This must be specified.

UNIT_OPERATION

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

To set the unit_operation attribute:

• provide the argument unit_operation on the command line.

REQUIRED FLAGS

Unit resource - Unit that the unit operation acts upon. The unit cannot be changed after the unit operation is created. This represents a Cloud 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 --unit on the command line with a fully specified name;
• provide the argument --project on the command line;
• set the property core/project.

To set the location attribute:

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

This must be specified.

--unit=UNIT

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

To set the unit attribute:

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

OPTIONAL FLAGS

--cancel

Attempt to cancel the operation. Cancellation might fail if the operation is already running.

--labels=[LABELS,…]

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)

--location=LOCATION

For resources [flag-update, parent-unit-operation, provision-release, rollout, unit, unit_operation, upgrade-release], provides fallback value for resource location attribute. When the resource's full URI path is not provided, location will fallback to this flag value.

ParentUnitOperation resource - Parent unit operation. If an operation creates child operations as part of its workflow, set this flag on each child operation to the parent unit operation for tracing. This represents a Cloud 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 --parent-unit-operation on the command line with a fully specified name;
• provide the argument --project on the command line;
• set the property core/project.

To set the location attribute:

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

--parent-unit-operation=PARENT_UNIT_OPERATION

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

To set the unit-operation attribute:

• provide the argument --parent-unit-operation on the command line.

RolloutId resource - Rollout that created this unit operation. The rollout cannot be changed after it is set and is used only for filtering. If a dependent unit and unit operation are created as part of another unit operation, they use the same rollout. This represents a Cloud 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 on the command line with a fully specified name;
• provide the argument --project on the command line;
• set the property core/project.

To set the location attribute:

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

--rollout=ROLLOUT

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

To set the rollout attribute:

• provide the argument --rollout on the command line.

Time specification to schedule the operation.

--schedule-start-time=SCHEDULE_START_TIME

Start time of the operation. If not set, the start of the next maintenance window is used.

Unit operation type.

At most one of these can be specified:

Deprovision operation, which deprovisions the underlying resources represented by the unit. The operation can run only if the unit is provisioned.

--deprovision

Deprovision the unit.

Flag update operation, which pushes new flag values to units.

FlagRelease resource - Flag release applied by the unit operation. This represents a Cloud 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 --flag-update on the command line with a fully specified name;
• provide the argument --project on the command line;
• set the property core/project.

To set the location attribute:

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

--flag-update=FLAG_UPDATE

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

To set the flag-release attribute:

• provide the argument --flag-update on the command line.

Provision operation, which provisions the underlying resources represented by the unit. The operation can run only if the unit is not provisioned.

--provision

Provision the unit.

--provision-input-variables=[type=TYPE],[value=VALUE],[variable=VARIABLE]

Input variables for the provision operation. A maximum of 100 input variables can be specified.

type

Name of a supported variable type. Supported types are string, int, bool, struct, and list.

value

String-encoded value for the variable. Values of type struct or list must be JSON-encoded strings.

variable

Required, Name of the variable from the actuation configuration.

Shorthand Example:

--provision-input-variables=type=string,value=string,variable=string --provision-input-variables=type=string,value=string,variable=string

JSON Example:

--provision-input-variables='[{"type": "string", "value": "string", "variable": "string"}]'

File Example:

--provision-input-variables=path_to_file.(yaml|json)

Release resource - Release to use for the unit. This represents a Cloud 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 --provision-release on the command line with a fully specified name;
• provide the argument --project on the command line;
• set the property core/project.

To set the location attribute:

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

--provision-release=PROVISION_RELEASE

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

To set the release attribute:

• provide the argument --provision-release on the command line.

Upgrade operation, which upgrades a provisioned unit, possibly including the underlying resources represented by the unit. The operation can run only if the unit is provisioned.

--upgrade

Upgrade the unit.

--upgrade-input-variables=[type=TYPE],[value=VALUE],[variable=VARIABLE]

Input variables for the upgrade operation. A maximum of 100 input variables can be specified.

type

Name of a supported variable type. Supported types are string, int, bool, struct, and list.

value

String-encoded value for the variable. Values of type struct or list must be JSON-encoded strings.

variable

Required, Name of the variable from the actuation configuration.

Shorthand Example:

--upgrade-input-variables=type=string,value=string,variable=string --upgrade-input-variables=type=string,value=string,variable=string

JSON Example:

--upgrade-input-variables='[{"type": "string", "value": "string", "variable": "string"}]'

File Example:

--upgrade-input-variables=path_to_file.(yaml|json)

Release resource - Release to use for the unit. This represents a Cloud 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 --upgrade-release on the command line with a fully specified name;
• provide the argument --project on the command line;
• set the property core/project.

To set the location attribute:

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

--upgrade-release=UPGRADE_RELEASE

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

To set the release attribute:

• provide the argument --upgrade-release on the command line.

GCLOUD WIDE FLAGS

These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, --help, --impersonate-service-account, --log-http, --project, --quiet, --trace-token, --user-output-enabled, --verbosity.

Run $ gcloud help for details.

API REFERENCE

This command uses the saasservicemgmt/v1beta1 API. The full documentation for this API can be found at: https://docs.cloud.google.com/app-lifecycle-manager

NOTES

This command is currently in beta and might change without notice.