gcloud beta app-lifecycle-manager unit-kinds create

NAME

gcloud beta app-lifecycle-manager unit-kinds create - create a unit kind

SYNOPSIS

gcloud beta app-lifecycle-manager unit-kinds create UNIT_KIND --saas=SAAS [--default-release=DEFAULT_RELEASE] [--dependencies=[alias=ALIAS],[unitKind=UNITKIND]] [--input-variable-mappings=[from=FROM],[to=TO],[variable=VARIABLE]] [--labels=[LABELS,…]] [--location=LOCATION] [--output-variable-mappings=[from=FROM],[to=TO],[variable=VARIABLE]] [--app-params-group=APP_PARAMS_GROUP --scope-type=SCOPE_TYPE] [GCLOUD_WIDE_FLAG …]

DESCRIPTION

(BETA) Create an App Lifecycle Manager unit kind.

A unit kind defines a type of managed component (unit) within a SaaS offering. Units of the same unit kind are managed together; for example, they follow the same release model and are typically rolled out together.

EXAMPLES

To create a unit kind named my-unit-kind for the SaaS offering my-saas in location us-central1, run:

gcloud beta app-lifecycle-manager unit-kinds create my-unit-kind --location=us-central1 --saas=my-saas

To create a unit kind named my-unit-kind that has the label env=prod, run:

gcloud beta app-lifecycle-manager unit-kinds create my-unit-kind --location=us-central1 --saas=my-saas --labels=env=prod

To create a unit kind named my-unit-kind that depends on the unit kind my-network-unit-kind under the alias net and maps the input variable vpc to the output variable vpc of that dependency, run:

gcloud beta app-lifecycle-manager unit-kinds create my-unit-kind --location=us-central1 --saas=my-saas --dependencies=unitKind=my-network-unit-kind,alias=net --input-variable-mappings="variable=vpc,from={dependency=net,outputVariable=vpc}"

POSITIONAL ARGUMENTS

UnitKind resource - Unit kind 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_kind 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_kind on the command line with a fully specified name;
• provide the argument --location on the command line.

This must be specified.

UNIT_KIND

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

To set the unit_kind attribute:

• provide the argument unit_kind on the command line.

REQUIRED FLAGS

Saas resource - SaaS offering that defines the product (managed service) that the service producer manages with App Lifecycle Manager. The SaaS offering cannot be changed after it is set. 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 --saas 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 --saas on the command line with a fully specified name;
• provide the argument --location on the command line.

This must be specified.

--saas=SAAS

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

To set the saas attribute:

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

OPTIONAL FLAGS

Release resource - Release to use by default when creating new units of this unit kind. If not specified, each new unit must explicitly reference the release to use for its creation. 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 --default-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 --default-release on the command line with a fully specified name;
• provide the argument --location on the command line.

--default-release=DEFAULT_RELEASE

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

To set the release attribute:

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

--dependencies=[alias=ALIAS],[unitKind=UNITKIND]

Other unit kinds that this unit kind depends on. Dependencies are automatically provisioned if not found. A maximum of 10 dependencies can be specified. Dependencies cannot be changed after the unit kind is created.

alias

Alias for the dependency, used for input variable mapping.

unitKind

Unit kind of the dependency.

Shorthand Example:

--dependencies=alias=string,unitKind=string --dependencies=alias=string,unitKind=string

JSON Example:

--dependencies='[{"alias": "string", "unitKind": "string"}]'

File Example:

--dependencies=path_to_file.(yaml|json)

--input-variable-mappings=[from=FROM],[to=TO],[variable=VARIABLE]

Input variables of this unit kind that are either retrieved from the output variables of a dependency or passed on to the input variables of a dependency. A maximum of 100 mappings can be specified.

from

Output variable of a dependency from which the variable gets its value.

dependency

Required, Alias of the dependency.

outputVariable

Required, Name of the output variable on the dependency.

to

Input variable of a dependency to which the value of the variable is passed on.

dependency

Required, Alias of the dependency that the variable passes its value to.

ignoreForLookup

If true, App Lifecycle Manager does not use the input variable as a lookup key when looking for an existing dependency unit.

inputVariable

Required, Name of the input variable on the dependency.

variable

Required, Name of the variable.

Shorthand Example:

--input-variable-mappings=from={dependency=string,outputVariable=string},to={dependency=string,ignoreForLookup=boolean,inputVariable=string},variable=string --input-variable-mappings=from={dependency=string,outputVariable=string},to={dependency=string,ignoreForLookup=boolean,inputVariable=string},variable=string

JSON Example:

--input-variable-mappings='[{"from": {"dependency": "string", "outputVariable": "string"}, "to": {"dependency": "string", "ignoreForLookup": boolean, "inputVariable": "string"}, "variable": "string"}]'

File Example:

--input-variable-mappings=path_to_file.(yaml|json)

--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 [default-release, saas, unit_kind], provides fallback value for resource location attribute. When the resource's full URI path is not provided, location will fallback to this flag value.

--output-variable-mappings=[from=FROM],[to=TO],[variable=VARIABLE]

Output variables of this unit kind that are passed to the output variables of the unit. A maximum of 100 mappings can be specified.

from

Output variable of a dependency from which the variable gets its value.

dependency

Required, Alias of the dependency.

outputVariable

Required, Name of the output variable on the dependency.

to

Input variable of a dependency to which the value of the variable is passed on.

dependency

Required, Alias of the dependency that the variable passes its value to.

ignoreForLookup

If true, App Lifecycle Manager does not use the input variable as a lookup key when looking for an existing dependency unit.

inputVariable

Required, Name of the input variable on the dependency.

variable

Required, Name of the variable.

Shorthand Example:

--output-variable-mappings=from={dependency=string,outputVariable=string},to={dependency=string,ignoreForLookup=boolean,inputVariable=string},variable=string --output-variable-mappings=from={dependency=string,outputVariable=string},to={dependency=string,ignoreForLookup=boolean,inputVariable=string},variable=string

JSON Example:

--output-variable-mappings='[{"from": {"dependency": "string", "outputVariable": "string"}, "to": {"dependency": "string", "ignoreForLookup": boolean, "inputVariable": "string"}, "variable": "string"}]'

File Example:

--output-variable-mappings=path_to_file.(yaml|json)

Parameters for creating an App Hub application.

--app-params-group=APP_PARAMS_GROUP

Grouping used to construct the name of the App Hub application. Multiple unit kinds can specify the same group to use the same application across their respective units. Corresponds to app_boundary_id in the Application Design Center composite application template. Defaults to the name of the unit kind.

Scope of the application.

--scope-type=SCOPE_TYPE

Scope type of the application. Corresponds to scope in the Application Design Center composite application template. Defaults to type-regional. SCOPE_TYPE must be one of:

type-global

Global scope.

type-regional

Regional scope.

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.