NAME
    gcloud beta deployment-manager deployments create - create a deployment

SYNOPSIS
    gcloud beta deployment-manager deployments create DEPLOYMENT_NAME
        (--composite-type=COMPOSITE_TYPE | --config=CONFIG
          | --template=TEMPLATE)
        [--create-policy=CREATE_POLICY; default="create-or-acquire"]
        [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] [--preview]
        [--properties=[PROPERTIES,...]]
        [--async | --automatic-rollback-on-error] [GCLOUD_WIDE_FLAG ...]

DESCRIPTION
    (BETA) This command inserts (creates) a new deployment based on a provided
    config file.

EXAMPLES
    To create a new deployment from a top-level YAML file, run:

        $ gcloud beta deployment-manager deployments create my-deployment \
            --config=config.yaml --description="My deployment"

    To create a new deployment from a top-level template file, run:

        $ gcloud deployment-manager deployments create my-deployment \
            --template=template.{jinja|py} \
            --properties="string-key:'string-value',integer-key:12345"

    To create a new deployment directly from a composite type, run:

        $ gcloud deployment-manager deployments create my-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:

        $ gcloud beta deployment-manager deployments create \
            my-new-deployment --config=config.yaml --preview

    To instantiate a deployment that has been previewed, issue an update
    command for that deployment without specifying a config file.

    More information is available at
    https://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 a composite 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 a guide to creating a configuration, refer to
          https://cloud.google.com/deployment-manager/docs/configuration/create-basic-configuration

       --template=TEMPLATE
          Filename of a top-level jinja or python config template.

OPTIONAL FLAGS
     --create-policy=CREATE_POLICY; default="create-or-acquire"
        Create policy for resources that have changed in the update.
        CREATE_POLICY must be one of: acquire, create, create-or-acquire.

     --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, and numbers. Values must
        contain only hyphens (-), underscores (_), lowercase characters, and
        numbers.

     --preview
        Preview the requested create without actually instantiating the
        underlying resources. (default=False)

     --properties=[PROPERTIES,...]
        A comma separated, key:value, map to be used when deploying a template
        file or composite 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 that deployment 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 help for details.

NOTES
    This command is currently in beta and might change without notice. These
    variants are also available:

        $ gcloud deployment-manager deployments create

        $ gcloud alpha deployment-manager deployments create

