gcloud alpha deployment-manager deployments create Stay organized with collections Save and categorize content based on your preferences.
- NAME
- gcloud alpha deployment-manager deployments create - create a deployment
- SYNOPSIS
gcloud alpha deployment-manager deployments createDEPLOYMENT_NAME(--composite-type=COMPOSITE_TYPE|--config=CONFIG|--template=TEMPLATE)[--create-policy=CREATE_POLICY; default="create-or-acquire"][--credential=CREDENTIAL][--description=DESCRIPTION][--labels=[KEY=VALUE,…]][--preview][--properties=[PROPERTIES,…]][--async|--automatic-rollback-on-error][GCLOUD_WIDE_FLAG …]
- DESCRIPTION
(ALPHA)This command inserts (creates) a new deployment based on aprovided config file.- EXAMPLES
- To create a new deployment from a top-level YAML file, run:
gcloudalphadeployment-managerdeploymentscreatemy-deployment--config=config.yaml--description="My deployment"To create a new deployment from a top-level template file, run:
gclouddeployment-managerdeploymentscreatemy-deployment--template=template.{jinja|py}--properties="string-key:'string-value',integer-key:12345"To create a new deployment directly from a composite type, run:
gclouddeployment-managerdeploymentscreatemy-deployment--composite-type=<project-id>/composite:<type-name>--properties="string-key:'string-value',integer-key:12345"To preview a deployment without actually creating resources, run:
gcloudalphadeployment-managerdeploymentscreatemy-new-deployment--config=config.yaml--previewTo instantiate a deployment that has been previewed, issue an update command forthat deployment without specifying a config file.
More information is available athttps://cloud.google.com/deployment-manager/docs/configuration/.
- POSITIONAL ARGUMENTS
DEPLOYMENT_NAME- Deployment name.
- REQUIRED FLAGS
- Exactly one of these must be specified:
--composite-type=COMPOSITE_TYPE- Name of a composite type to deploy. For an example of creating and deploying acomposite type, see:https://cloud.google.com/deployment-manager/docs/configuration/templates/create-composite-types#examplecompositetype
--config=CONFIG- Filename of a top-level yaml config that specifies resources to deploy. For aguide to creating a configuration, refer tohttps://cloud.google.com/deployment-manager/docs/configuration/create-basic-configuration
--template=TEMPLATE- Filename of a top-level jinja or python config template.
- Exactly one of these must be specified:
- OPTIONAL FLAGS
--create-policy=CREATE_POLICY; default="create-or-acquire"- Create policy for resources that have changed in the update.
CREATE_POLICYmust be one of:acquire,create,create-or-acquire. --credential=CREDENTIAL- Set the default credential that Deployment Manager uses to call underlying APIsof a deployment. Use PROJECT_DEFAULT to set deployment credential same as thecredential of its owning project. Use serviceAccount:email to set defaultcredential using provided service account.
--description=DESCRIPTION- Optional description of the deployment to insert.
--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. --preview- Preview the requested create without actually instantiating the underlyingresources. (default=False)
--properties=[PROPERTIES,…]- A comma separated, key:value, map to be used when deploying a template file orcomposite type directly.
- At most one of these can be specified:
--async- Return immediately, without waiting for the operation in progress to complete.
--automatic-rollback-on-error- If the create request results in a deployment with resource errors, delete thatdeployment immediately after creation. (default=False)
- 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 helpfor details. - NOTES
- This command is currently in alpha and might change without notice. If thiscommand fails with API permission errors despite specifying the correct project,you might be trying to access an API with an invitation-only early accessallowlist. These variants are also available:
gclouddeployment-managerdeploymentscreategcloudbetadeployment-managerdeploymentscreate
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-05-07 UTC.