GCLOUD_CONTAINER_NODE-POOLS_CREATE(1)

NAME

gcloud container node-pools create - create a node pool in a running cluster

SYNOPSIS

gcloud container node-pools create NAME [--cluster=CLUSTER] [--disk-size=DISK_SIZE] [--no-enable-cloud-endpoints] [--image-type=IMAGE_TYPE] [--machine-type=MACHINE_TYPE, -m MACHINE_TYPE] [--node-labels=[NODE_LABEL,...]] [--num-nodes=NUM_NODES; default="3"] [--scopes=SCOPE,[SCOPE,...]] [--tags=TAG,[TAG,...]] [--zone=ZONE, -z ZONE] [GCLOUD_WIDE_FLAG ...]

DESCRIPTION
gcloud container node-pools create facilitates the creation of a node pool in a Google Container Engine cluster. A variety of options exists to customize the node configuration and the number of nodes created.

POSITIONAL ARGUMENTS

    NAME
        The name of the node pool to create.

FLAGS

    --cluster=CLUSTER
        The cluster to add the node pool to. Overrides the default container/cluster property value for this command invocation.

    --disk-size=DISK_SIZE
        Size in GB for node VM boot disks. Defaults to 100GB.

    --enable-cloud-endpoints
        Automatically enable Google Cloud Endpoints to take advantage of API management features. Enabled by default, use --no-enable-cloud-endpoints to disable.

    --image-type=IMAGE_TYPE
        The image type to use for the node pool. Defaults to server-specified. Image Type specifies the base OS that the nodes in the node pool will run on. If an image type is specified, that will be assigned to the node pool and all future upgrades will use the specified image type. If it is not specified the server will pick the default image type. The default image type and the list of valid image types are available using the following command.
        $ gcloud container get-server-config

    --machine-type=MACHINE_TYPE, -m MACHINE_TYPE
        The type of machine to use for nodes. Defaults to n1-standard-1

    --node-labels=[NODE_LABEL,...]
        Applies the given kubernetes labels on all nodes in the new node-pool. Example:
        $ gcloud container node-pools create node-pool-1 \
            --cluster=example-cluster \
            --node-labels=label1=value1,label2=value2
    New nodes, including ones created by resize or recreate, will have these labels on the kubernetes API node object and can be used in nodeSelectors. See http://kubernetes.io/docs/user-guide/node-selection/ for examples.

    --num-nodes=NUM_NODES; default="3"
        The number of nodes in the node pool in each of the cluster's zones.

    --scopes=SCOPE,[SCOPE,...]
        Specifies scopes for the node instances. The project's default service account is used. Examples:
        $ gcloud container node-pools create node-pool-1 \
            --cluster=example-cluster \
            --scopes https://www.googleapis.com/auth/devstorage.read_only
        $ gcloud container node-pools create node-pool-1 \
            --cluster=example-cluster \
            --scopes bigquery,storage-rw,compute-ro
    Multiple SCOPEs can specified, separated by commas. The scopes necessary for the cluster to function properly (compute-rw, storage-ro), are always added, even if not explicitly specified. SCOPE can be either the full URI of the scope or an alias. Available aliases are:
    Alias | URI
    bigquery | https://www.googleapis.com/auth/bigquery
    cloud-platform | https://www.googleapis.com/auth/cloud-platform
    cloud-source-repos | https://www.googleapis.com/auth/source.full_control
    cloud-source-repos-ro | https://www.googleapis.com/auth/source.read_only
    compute-ro | https://www.googleapis.com/auth/compute.readonly
    compute-rw | https://www.googleapis.com/auth/compute
    datastore | https://www.googleapis.com/auth/datastore
    default | https://www.googleapis.com/auth/cloud.useraccounts.readonly
     | https://www.googleapis.com/auth/devstorage.read_only
     | https://www.googleapis.com/auth/logging.write
     | https://www.googleapis.com/auth/monitoring.write
     | https://www.googleapis.com/auth/pubsub
     | https://www.googleapis.com/auth/service.management.readonly
     | https://www.googleapis.com/auth/servicecontrol
     | https://www.googleapis.com/auth/trace.append
    logging-write | https://www.googleapis.com/auth/logging.write
    monitoring | https://www.googleapis.com/auth/monitoring
    monitoring-write | https://www.googleapis.com/auth/monitoring.write
    service-control | https://www.googleapis.com/auth/servicecontrol
    service-management | https://www.googleapis.com/auth/service.management.readonly
    sql | https://www.googleapis.com/auth/sqlservice
    sql-admin | https://www.googleapis.com/auth/sqlservice.admin
    storage-full | https://www.googleapis.com/auth/devstorage.full_control
    storage-ro | https://www.googleapis.com/auth/devstorage.read_only
    storage-rw | https://www.googleapis.com/auth/devstorage.read_write
    taskqueue | https://www.googleapis.com/auth/taskqueue
    useraccounts-ro | https://www.googleapis.com/auth/cloud.useraccounts.readonly
    useraccounts-rw | https://www.googleapis.com/auth/cloud.useraccounts
    userinfo-email | https://www.googleapis.com/auth/userinfo.email
    DEPRECATION WARNING: 'https://www.googleapis.com/auth/sqlservice' account scope and sql alias do not provide SQL instance management capabilities and have been deprecated. Please, use 'https://www.googleapis.com/auth/sqlservice.admin' or sql.admin to manage your Google SQL Service instances.

    --tags=TAG,[TAG,...]
        Applies the given Compute Engine tags (comma separated) on all nodes in the new node-pool. Example:
        $ gcloud container node-pools create node-pool-1 \
            --cluster=example-cluster --tags=tag1,tag2
    New nodes, including ones created by resize or recreate, will have these tags on the Compute Engine API instance object and can be used in firewall rules. See https://cloud.google.com/sdk/gcloud/reference/compute/firewall-rules/create for examples.

    --zone=ZONE, -z ZONE
        The compute zone (e.g. us-central1-a) for the cluster. Overrides the default compute/zone property value for this command invocation.

GCLOUD WIDE FLAGS
These flags are available to all commands: --account, --configuration, --flatten, --format, --help, --log-http, --project, --quiet, --trace-token, --user-output-enabled, --verbosity. Run $ gcloud help for details.

EXAMPLES
To create a new node pool "node-pool-1" with the default options in the cluster "sample-cluster", run:
    $ gcloud container node-pools create node-pool-1 \
        --cluster=example-cluster
The new node pool will show up in the cluster after all the nodes have been provisioned. To create a node pool with 5 nodes, run:
    $ gcloud container node-pools create node-pool-1 \
        --cluster=example-cluster --num-nodes=5