gcluster create

NAME

gcluster create - creates a new deployment folder.

SYNOPSIS

gcluster create BLUEPRINT_PATH [FLAGS]

DESCRIPTION

The gcluster create command reads an environment blueprint YAML file and generates a deployment folder containing the necessary Terraform and Packer configurations to deploy your cluster to Google Cloud.

After creating the deployment folder, you can deploy the resources by using gcluster deploy.

FLAGS

  • -o, --out OUTPUT_DIR: The directory where the deployment folder is created.
  • -w, --overwrite-deployment: Lets you overwrite an existing deployment directory.
  • --force: Forces an overwrite without prompting.
  • -d, --deployment-file DEPLOYMENT_FILE: A deployment file to override blueprint variables and backend configuration.
  • --vars VARS: A comma-separated list of name=value variables to override YAML configuration. Can be used multiple times.
  • --backend-config BACKEND_CONFIG: A comma-separated list of name=value variables to set Terraform backend configuration. Can be used multiple times.
  • -l, --validation-level LEVEL: Sets the validation level to one of ERROR, WARNING, or IGNORE. The default value is ERROR.
  • --skip-validators VALIDATORS: A comma-separated list of validators to skip during validation.
  • --add-creator-label: Adds the ghpc_creator label with the user identity to the expanded blueprint. Enabled by default for @google.com accounts; pass the value --add-creator-label=false to disable this behavior.

EXAMPLES

To create a deployment directory from a blueprint YAML file:

gcluster create blueprint.yaml -o ./my-deployment

To create a deployment directory and override specific variables:

gcluster create blueprint.yaml \
    -o ./my-deployment \
    --vars project_id=my-project,zone=us-central1-a

To overwrite an existing deployment directory:

gcluster create blueprint.yaml -o ./my-deployment --overwrite-deployment