def Args(parser):
_Args(parser)
group = parser.add_mutually_exclusive_group()
_AddAdditionalZonesFlag(group, deprecated=True)
flags.AddNodeLocationsFlag(group)
flags.AddAlphaAddonsFlags(parser)
flags.AddClusterAutoscalingFlags(parser)
flags.AddMaxPodsPerNodeFlag(parser)
flags.AddEnableAutoRepairFlag(parser, for_create=True)
flags.AddEnableBinAuthzFlag(parser)
flags.AddEnableKubernetesAlphaFlag(parser)
flags.AddEnableLegacyAuthorizationFlag(parser)
flags.AddIPAliasFlags(parser)
flags.AddIstioConfigFlag(parser)
flags.AddLabelsFlag(parser)
flags.AddLocalSSDAndLocalSSDVolumeConfigsFlag(parser)
flags.AddMaintenanceWindowFlag(parser)
flags.AddMasterAuthorizedNetworksFlags(parser)
flags.AddMinCpuPlatformFlag(parser)
flags.AddWorkloadMetadataFromNodeFlag(parser)
flags.AddNetworkPolicyFlags(parser)
flags.AddAutoprovisioningFlags(parser, hidden=False)
flags.AddAutoscalingProfilesFlag(parser, hidden=True)
flags.AddNodeTaintsFlag(parser)
flags.AddPreemptibleFlag(parser)
flags.AddPodSecurityPolicyFlag(parser)
flags.AddAllowRouteOverlapFlag(parser)
flags.AddPrivateClusterFlags(parser, with_deprecated=True, with_alpha=True)
flags.AddClusterNodeIdentityFlags(parser)
flags.AddTpuFlags(parser, hidden=False, enable_tpu_service_networking=True)
flags.AddEnableStackdriverKubernetesFlag(parser)
flags.AddManagedPodIdentityFlags(parser)
flags.AddWorkloadIdentityFlags(parser)
flags.AddResourceUsageExportFlags(parser)
flags.AddAuthenticatorSecurityGroupFlags(parser)
flags.AddVerticalPodAutoscalingFlag(parser)
flags.AddSecurityProfileForCreateFlags(parser)
flags.AddInitialNodePoolNameArg(parser, hidden=False)
flags.AddEnablePrivateIpv6AccessFlag(parser, hidden=True)
flags.AddEnableShieldedContainersFlags(parser)
versioning_groups = parser.add_mutually_exclusive_group("""\
`--release-channel` cannot be specified if `--cluster-version` or
`--node-version` are specified.
""")
flags.AddReleaseChannelFlag(versioning_groups)
cluster_version_group = versioning_groups.add_group()
flags.AddClusterVersionFlag(cluster_version_group)
flags.AddNodeVersionFlag(cluster_version_group)
flags.AddEnableAutoUpgradeFlag(parser, default=True)
kms_flag_overrides = {
'kms-key': '--database-encryption-key',
'kms-keyring': '--database-encryption-key-keyring',
'kms-location': '--database-encryption-key-location',
'kms-project': '--database-encryption-key-project'
}
kms_resource_args.AddKmsKeyResourceArg(
parser, 'cluster', flag_overrides=kms_flag_overrides)
def _Args(parser):
"""Register flags for this command.
Args:
parser: An argparse.ArgumentParser-like object. It is mocked out in order
to capture some information, but behaves like an ArgumentParser.
"""
parser.add_argument(
'name',
metavar='NAME',
help='The name of the cluster to upgrade.')
flags.AddClusterVersionFlag(
parser,
help="""\
The Kubernetes release version to which to upgrade the cluster's nodes.
If provided, the --cluster-version must be no greater than the cluster
master's minor version (x.*X*.x), and must be a latest patch version
(x.x.*X*).
You can find the list of allowed versions for upgrades by running:
$ gcloud container get-server-config
""")
parser.add_argument(
'--node-pool',
help='The node pool to upgrade.')
parser.add_argument(
'--master',
help='Upgrade the cluster\'s master to the latest version of Kubernetes'
' supported on Container Engine. Nodes cannot be upgraded at the same'
' time as the master.',
action='store_true')
flags.AddAsyncFlag(parser)
flags.AddImageTypeFlag(parser, 'cluster/node pool')
def Args(parser):
_Args(parser)
flags.AddClusterAutoscalingFlags(parser)
flags.AddLocalSSDFlag(parser)
flags.AddEnableKubernetesAlphaFlag(parser)
flags.AddClusterVersionFlag(parser, 'master and nodes')
flags.AddPreemptibleFlag(parser)
def Args(parser):
_Args(parser)
_AddAdditionalZonesFlag(parser, deprecated=True)
flags.AddNodeLocationsFlag(parser)
flags.AddAddonsFlags(parser)
flags.AddClusterAutoscalingFlags(parser)
flags.AddMaxPodsPerNodeFlag(parser)
flags.AddEnableAutoRepairFlag(parser, for_create=True)
flags.AddEnableBinAuthzFlag(parser)
flags.AddEnableKubernetesAlphaFlag(parser)
flags.AddEnableCloudRunAlphaFlag(parser)
flags.AddEnableStackdriverKubernetesFlag(parser)
flags.AddEnableLegacyAuthorizationFlag(parser)
flags.AddIPAliasFlags(parser)
flags.AddLabelsFlag(parser)
flags.AddLocalSSDFlag(parser)
flags.AddMaintenanceWindowGroup(parser, hidden=False,
recurring_windows_hidden=True)
flags.AddMainAuthorizedNetworksFlags(parser)
flags.AddMinCpuPlatformFlag(parser)
flags.AddNetworkPolicyFlags(parser)
flags.AddNodeTaintsFlag(parser)
flags.AddPreemptibleFlag(parser)
flags.AddClusterNodeIdentityFlags(parser)
flags.AddPrivateClusterFlags(
parser, with_deprecated=False, with_alpha=False)
flags.AddClusterVersionFlag(parser)
flags.AddNodeVersionFlag(parser)
flags.AddEnableAutoUpgradeFlag(parser, default=True)
flags.AddEnableIntraNodeVisibilityFlag(parser)
flags.AddTpuFlags(parser, hidden=False)
flags.AddAutoprovisioningFlags(parser, hidden=False, for_create=True,
ga=True)
flags.AddResourceUsageExportFlags(parser)
flags.AddVerticalPodAutoscalingFlag(parser)
def _Args(parser):
"""Register flags for this command.
Args:
parser: An argparse.ArgumentParser-like object. It is mocked out in order
to capture some information, but behaves like an ArgumentParser.
"""
parser.add_argument('name',
metavar='NAME',
help='The name of the cluster to upgrade.')
flags.AddClusterVersionFlag(parser,
help="""\
The Kubernetes release version to which to upgrade the cluster's nodes.
If desired cluster version is omitted, *node* upgrades default to the current
*master* version and *master* upgrades default to the default cluster version,
which can be found in the server config.
You can find the list of allowed versions for upgrades by running:
$ gcloud container get-server-config
""")
parser.add_argument('--node-pool', help='The node pool to upgrade.')
parser.add_argument(
'--master',
help='Upgrade the cluster\'s master to the latest version of Kubernetes'
' supported on Kubernetes Engine. Nodes cannot be upgraded at the same'
' time as the master.',
action='store_true')
flags.AddAsyncFlag(parser)
flags.AddImageTypeFlag(parser, 'cluster/node pool')
flags.AddImageFlag(parser, hidden=True)
flags.AddImageProjectFlag(parser, hidden=True)
def Args(parser):
_Args(parser)
_AddAdditionalZonesFlag(parser, deprecated=True)
flags.AddNodeLocationsFlag(parser)
flags.AddAddonsFlags(parser)
flags.AddClusterAutoscalingFlags(parser)
flags.AddMaxPodsPerNodeFlag(parser)
flags.AddEnableAutoRepairFlag(parser, for_create=True)
flags.AddEnableKubernetesAlphaFlag(parser)
flags.AddEnableStackdriverKubernetesFlag(parser)
flags.AddEnableLegacyAuthorizationFlag(parser)
flags.AddIPAliasFlags(parser)
flags.AddLabelsFlag(parser)
flags.AddLocalSSDFlag(parser)
flags.AddMaintenanceWindowFlag(parser)
flags.AddMasterAuthorizedNetworksFlags(parser)
flags.AddMinCpuPlatformFlag(parser)
flags.AddNetworkPolicyFlags(parser)
flags.AddNodeTaintsFlag(parser)
flags.AddPreemptibleFlag(parser)
flags.AddClusterNodeIdentityFlags(parser)
flags.AddPrivateClusterFlags(parser,
with_deprecated=False,
with_alpha=False)
flags.AddClusterVersionFlag(parser)
flags.AddNodeVersionFlag(parser)
flags.AddEnableAutoUpgradeFlag(parser)
flags.AddTpuFlags(parser, hidden=False)
flags.AddResourceUsageExportFlags(parser)
def Args(parser):
_Args(parser)
group = parser.add_mutually_exclusive_group()
_AddAdditionalZonesFlag(group, deprecated=True)
flags.AddNodeLocationsFlag(group)
flags.AddAlphaAddonsFlags(parser)
flags.AddClusterAutoscalingFlags(parser)
flags.AddMaxPodsPerNodeFlag(parser)
flags.AddEnableAutoRepairFlag(parser, for_create=True)
flags.AddEnableBinAuthzFlag(parser)
flags.AddEnableKubernetesAlphaFlag(parser)
flags.AddEnableLegacyAuthorizationFlag(parser)
flags.AddIPAliasFlags(parser)
flags.AddIstioConfigFlag(parser)
flags.AddLabelsFlag(parser)
flags.AddLocalSSDAndLocalSSDVolumeConfigsFlag(parser)
flags.AddMaintenanceWindowGroup(parser, emw_hidden=True, add_emw_flags=True)
flags.AddMasterAuthorizedNetworksFlags(parser)
flags.AddMinCpuPlatformFlag(parser)
flags.AddWorkloadMetadataFromNodeFlag(parser)
flags.AddNetworkPolicyFlags(parser)
flags.AddAutoprovisioningFlags(parser, hidden=False, for_create=True)
flags.AddAutoscalingProfilesFlag(parser, hidden=True)
flags.AddNodeTaintsFlag(parser)
flags.AddPreemptibleFlag(parser)
flags.AddPodSecurityPolicyFlag(parser)
flags.AddAllowRouteOverlapFlag(parser)
flags.AddPrivateClusterFlags(parser, with_deprecated=True, with_alpha=True)
flags.AddClusterNodeIdentityFlags(parser)
flags.AddTpuFlags(parser, hidden=False, enable_tpu_service_networking=True)
flags.AddEnableStackdriverKubernetesFlag(parser)
flags.AddManagedPodIdentityFlags(parser)
flags.AddWorkloadIdentityFlags(parser)
flags.AddResourceUsageExportFlags(parser)
flags.AddAuthenticatorSecurityGroupFlags(parser)
flags.AddVerticalPodAutoscalingFlag(parser)
flags.AddSecurityProfileForCreateFlags(parser)
flags.AddInitialNodePoolNameArg(parser, hidden=False)
flags.AddEnablePrivateIpv6AccessFlag(parser, hidden=True)
flags.AddEnableIntraNodeVisibilityFlag(parser)
flags.AddEnableShieldedNodesFlags(parser)
flags.AddDisableDefaultSnatFlag(parser, for_cluster_create=True)
versioning_groups = parser.add_mutually_exclusive_group("""\
`--release-channel` cannot be specified if `--cluster-version` or
`--node-version` are specified.
""")
flags.AddReleaseChannelFlag(versioning_groups)
cluster_version_group = versioning_groups.add_group()
flags.AddClusterVersionFlag(cluster_version_group)
flags.AddNodeVersionFlag(cluster_version_group)
flags.AddEnableAutoUpgradeFlag(parser, default=True)
flags.AddDatabaseEncryptionFlag(parser)
flags.AddSurgeUpgradeFlag(parser)
flags.AddMaxUnavailableUpgradeFlag(parser)
flags.AddLinuxSysctlFlags(parser)
flags.AddShieldedInstanceFlags(parser)
flags.AddNodeConfigFlag(parser)
def Args(parser):
_Args(parser)
flags.AddClusterAutoscalingFlags(parser)
flags.AddLocalSSDFlag(parser)
flags.AddEnableKubernetesAlphaFlag(parser)
flags.AddClusterVersionFlag(parser, 'master and nodes')
flags.AddPreemptibleFlag(parser)
flags.AddEnableAutoRepairFlag(parser, suppressed=True)
flags.AddEnableAutoUpgradeFlag(parser)
def Args(parser):
_Args(parser)
flags.AddClusterAutoscalingFlags(parser, hidden=True)
flags.AddLocalSSDFlag(parser)
flags.AddEnableKubernetesAlphaFlag(parser)
flags.AddClusterVersionFlag(parser)
flags.AddPreemptibleFlag(parser)
flags.AddEnableAutoRepairFlag(parser, suppressed=True)
flags.AddEnableAutoUpgradeFlag(parser)
flags.AddServiceAccountFlag(parser)
def Args(parser): _Args(parser) flags.AddClusterAutoscalingFlags(parser) flags.AddLocalSSDFlag(parser) flags.AddEnableKubernetesAlphaFlag(parser) flags.AddClusterVersionFlag(parser) flags.AddPreemptibleFlag(parser) flags.AddEnableAutoRepairFlag(parser) flags.AddEnableAutoUpgradeFlag(parser) flags.AddServiceAccountFlag(parser) flags.AddMasterAuthorizedNetworksFlags(parser, hidden=True) flags.AddEnableLegacyAbacFlag(parser)
def _AddReleaseChannelGroup(parser):
"""Add flag group for release channels."""
versioning_groups = parser.add_mutually_exclusive_group("""\
--release-channel cannot be specified if Custom Version Flags
(--cluster-version or --node-version) are used.
""")
flags.AddReleaseChannelFlag(versioning_groups)
custom_version_group = versioning_groups.add_group("""\
Custom Version Flags:
""")
flags.AddClusterVersionFlag(custom_version_group)
flags.AddNodeVersionFlag(custom_version_group)
def Args(parser):
_Args(parser)
group = parser.add_mutually_exclusive_group()
_AddAdditionalZonesFlag(group, deprecated=True)
flags.AddNodeLocationsFlag(group)
flags.AddBetaAddonsFlags(parser)
flags.AddClusterAutoscalingFlags(parser)
flags.AddMaxPodsPerNodeFlag(parser)
flags.AddEnableAutoRepairFlag(parser, for_create=True)
flags.AddEnableBinAuthzFlag(parser)
flags.AddEnableKubernetesAlphaFlag(parser)
flags.AddEnableLegacyAuthorizationFlag(parser)
flags.AddIPAliasFlags(parser)
flags.AddIstioConfigFlag(parser)
flags.AddLabelsFlag(parser)
flags.AddLocalSSDFlag(parser)
flags.AddMaintenanceWindowFlag(parser)
flags.AddMasterAuthorizedNetworksFlags(parser)
flags.AddMinCpuPlatformFlag(parser)
flags.AddWorkloadMetadataFromNodeFlag(parser)
flags.AddNetworkPolicyFlags(parser)
flags.AddNodeTaintsFlag(parser)
flags.AddPreemptibleFlag(parser)
flags.AddPodSecurityPolicyFlag(parser)
flags.AddAllowRouteOverlapFlag(parser)
flags.AddClusterNodeIdentityFlags(parser)
flags.AddPrivateClusterFlags(parser,
with_deprecated=True,
with_alpha=False)
flags.AddEnableStackdriverKubernetesFlag(parser)
flags.AddTpuFlags(parser, hidden=False)
flags.AddAutoprovisioningFlags(parser)
flags.AddVerticalPodAutoscalingFlag(parser)
flags.AddResourceUsageExportFlags(parser)
flags.AddAuthenticatorSecurityGroupFlags(parser)
flags.AddEnableIntraNodeVisibilityFlag(parser)
flags.AddWorkloadIdentityFlags(parser)
flags.AddEnableShieldedNodesFlags(parser)
flags.AddClusterVersionFlag(parser)
flags.AddNodeVersionFlag(parser)
flags.AddEnableAutoUpgradeFlag(parser, default=True)
kms_flag_overrides = {
'kms-key': '--database-encryption-key',
'kms-keyring': '--database-encryption-key-keyring',
'kms-location': '--database-encryption-key-location',
'kms-project': '--database-encryption-key-project'
}
kms_resource_args.AddKmsKeyResourceArg(
parser, 'cluster', flag_overrides=kms_flag_overrides)
def _Args(parser):
"""Register flags for this command.
Args:
parser: An argparse.ArgumentParser-like object. It is mocked out in order
to capture some information, but behaves like an ArgumentParser.
"""
parser.add_argument(
'name',
metavar='NAME',
help='The name of the cluster to upgrade.')
flags.AddClusterVersionFlag(
parser,
help="""\
The Kubernetes release version to which to upgrade the cluster's nodes.
When upgrading nodes, the minor version (*X.Y*.Z) must be no greater than the
cluster master's minor version (i.e. if the master's version is 1.2.34, the
nodes cannot be upgraded to 1.3.45). For any minor version, only the latest
patch version (X.Y.*Z*) is allowed (i.e. if there exists a version 1.2.34, the
nodes cannot be upgraded to 1.2.33). Omit to upgrade to the same version as the
master.
When upgrading master, the only valid value is the latest supported version.
Omit to have the server automatically select the latest version.
You can find the list of allowed versions for upgrades by running:
$ gcloud container get-server-config
""")
parser.add_argument(
'--node-pool',
help='The node pool to upgrade.')
parser.add_argument(
'--master',
help='Upgrade the cluster\'s master to the latest version of Kubernetes'
' supported on Kubernetes Engine. Nodes cannot be upgraded at the same'
' time as the master.',
action='store_true')
flags.AddAsyncFlag(parser)
flags.AddImageTypeFlag(parser, 'cluster/node pool')
flags.AddImageFlag(parser, hidden=True)
flags.AddImageProjectFlag(parser, hidden=True)
def _Args(parser):
"""Register flags for this command.
Args:
parser: An argparse.ArgumentParser-like object. It is mocked out in order
to capture some information, but behaves like an ArgumentParser.
"""
parser.add_argument('name', help='The name of this cluster.')
# Timeout in seconds for operation
parser.add_argument('--timeout',
type=int,
default=1800,
help=argparse.SUPPRESS)
flags.AddAsyncFlag(parser)
parser.add_argument(
'--num-nodes',
type=arg_parsers.BoundedInt(1),
help=
'The number of nodes to be created in each of the cluster\'s zones.',
default=3)
parser.add_argument(
'--machine-type',
'-m',
help='The type of machine to use for nodes. Defaults to n1-standard-1.'
)
parser.add_argument(
'--subnetwork',
help='The name of the Google Compute Engine subnetwork '
'(https://cloud.google.com/compute/docs/subnetworks) to which the '
'cluster is connected. If specified, the cluster\'s network must be a '
'"custom subnet" network.'
''
'Can not be used with the "--create-subnetwork" option.')
parser.add_argument(
'--disable-addons',
type=arg_parsers.ArgList(choices=[
api_adapter.INGRESS, api_adapter.HPA, api_adapter.DASHBOARD
]),
help='List of cluster addons to disable. Options are {0}'.format(
', '.join(
[api_adapter.INGRESS, api_adapter.HPA,
api_adapter.DASHBOARD])))
parser.add_argument(
'--network',
help='The Compute Engine Network that the cluster will connect to. '
'Google Container Engine will use this network when creating routes '
'and firewalls for the clusters. Defaults to the \'default\' network.')
parser.add_argument(
'--cluster-ipv4-cidr',
help='The IP address range for the pods in this cluster in CIDR '
'notation (e.g. 10.0.0.0/14). Prior to Kubernetes version 1.7.0 '
'this must be a subset of 10.0.0.0/8; however, starting with version '
'1.7.0 can be any RFC 1918 IP range.')
parser.add_argument(
'--password',
help='The password to use for cluster auth. Defaults to a '
'server-specified randomly-generated string.')
parser.add_argument(
'--enable-cloud-endpoints',
action='store_true',
default=True,
help='Automatically enable Google Cloud Endpoints to take advantage of '
'API management features.')
parser.add_argument('--enable-cloud-logging',
action='store_true',
default=True,
help='Automatically send logs from the cluster to the '
'Google Cloud Logging API.')
parser.set_defaults(enable_cloud_logging=True)
parser.add_argument(
'--enable-cloud-monitoring',
action='store_true',
default=True,
help='Automatically send metrics from pods in the cluster to the '
'Google Cloud Monitoring API. VM metrics will be collected by Google '
'Compute Engine regardless of this setting.')
parser.set_defaults(enable_cloud_monitoring=True)
parser.add_argument(
'--disk-size',
type=int,
help='Size in GB for node VM boot disks. Defaults to 100GB.')
parser.add_argument('--username',
'-u',
help='The user name to use for cluster auth.',
default='admin')
parser.add_argument(
'--max-nodes-per-pool',
type=arg_parsers.BoundedInt(100, api_adapter.MAX_NODES_PER_POOL),
help='The maximum number of nodes to allocate per default initial node '
'pool. Container Engine will automatically create enough nodes pools '
'such that each node pool contains less than '
'--max-nodes-per-pool nodes. Defaults to {nodes} nodes, but can be set '
'as low as 100 nodes per pool on initial create.'.format(
nodes=api_adapter.MAX_NODES_PER_POOL))
flags.AddImageTypeFlag(parser, 'cluster')
flags.AddNodeLabelsFlag(parser)
flags.AddTagsFlag(
parser, """\
Applies the given Compute Engine tags (comma separated) on all nodes in the new
node-pool. Example:
$ {command} 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.
""")
flags.AddClusterVersionFlag(parser)
flags.AddDiskTypeFlag(parser, suppressed=True)
parser.display_info.AddFormat(util.CLUSTERS_FORMAT)
def _Args(parser):
"""Register flags for this command.
Args:
parser: An argparse.ArgumentParser-like object. It is mocked out in order
to capture some information, but behaves like an ArgumentParser.
"""
parser.add_argument('name', help='The name of this cluster.')
# Timeout in seconds for operation
parser.add_argument(
'--timeout',
type=int,
default=1800,
hidden=True,
help='THIS ARGUMENT NEEDS HELP TEXT.')
flags.AddAsyncFlag(parser)
parser.add_argument(
'--num-nodes',
type=arg_parsers.BoundedInt(1),
help='The number of nodes to be created in each of the cluster\'s zones.',
default=3)
parser.add_argument(
'--machine-type', '-m',
help='The type of machine to use for nodes. Defaults to n1-standard-1.')
parser.add_argument(
'--subnetwork',
help="""\
The Google Compute Engine subnetwork
(https://cloud.google.com/compute/docs/subnetworks) to which the cluster is
connected. The subnetwork must belong to the network specified by --network.
Cannot be used with the "--create-subnetwork" option.
""")
parser.add_argument(
'--network',
help='The Compute Engine Network that the cluster will connect to. '
'Google Kubernetes Engine will use this network when creating routes '
'and firewalls for the clusters. Defaults to the \'default\' network.')
parser.add_argument(
'--cluster-ipv4-cidr',
help='The IP address range for the pods in this cluster in CIDR '
'notation (e.g. 10.0.0.0/14). Prior to Kubernetes version 1.7.0 '
'this must be a subset of 10.0.0.0/8; however, starting with version '
'1.7.0 can be any RFC 1918 IP range.')
parser.add_argument(
'--enable-cloud-logging',
action='store_true',
default=True,
help='Automatically send logs from the cluster to the '
'Google Cloud Logging API.')
parser.set_defaults(enable_cloud_logging=True)
parser.add_argument(
'--enable-cloud-monitoring',
action='store_true',
default=True,
help='Automatically send metrics from pods in the cluster to the '
'Google Cloud Monitoring API. VM metrics will be collected by Google '
'Compute Engine regardless of this setting.')
parser.set_defaults(enable_cloud_monitoring=True)
parser.add_argument(
'--disk-size',
type=int,
help='Size in GB for node VM boot disks. Defaults to 100GB.')
flags.AddBasicAuthFlags(parser)
parser.add_argument(
'--max-nodes-per-pool',
type=arg_parsers.BoundedInt(100, api_adapter.MAX_NODES_PER_POOL),
help='The maximum number of nodes to allocate per default initial node '
'pool. Kubernetes Engine will automatically create enough nodes pools '
'such that each node pool contains less than '
'--max-nodes-per-pool nodes. Defaults to {nodes} nodes, but can be set '
'as low as 100 nodes per pool on initial create.'.format(
nodes=api_adapter.MAX_NODES_PER_POOL))
flags.AddImageTypeFlag(parser, 'cluster')
flags.AddImageFlag(parser, hidden=True)
flags.AddImageProjectFlag(parser, hidden=True)
flags.AddImageFamilyFlag(parser, hidden=True)
flags.AddNodeLabelsFlag(parser)
flags.AddTagsFlag(parser, """\
Applies the given Compute Engine tags (comma separated) on all nodes in the new
node-pool. Example:
$ {command} 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.
""")
flags.AddClusterVersionFlag(parser)
# TODO(b/36071127): unhide this flag after we have enough ssd.
flags.AddDiskTypeFlag(parser, suppressed=True)
flags.AddEnableAutoUpgradeFlag(parser)
parser.display_info.AddFormat(util.CLUSTERS_FORMAT)
flags.AddNodeVersionFlag(parser)
flags.AddIssueClientCertificateFlag(parser)
def Args(parser):
_Args(parser)
flags.AddClusterAutoscalingFlags(parser, suppressed=True)
flags.AddLocalSSDFlag(parser)
flags.AddEnableKubernetesAlphaFlag(parser)
flags.AddClusterVersionFlag(parser, 'master and nodes')
def _Args(parser):
"""Register flags for this command.
Args:
parser: An argparse.ArgumentParser-like object. It is mocked out in order
to capture some information, but behaves like an ArgumentParser.
"""
parser.add_argument('name', help='The name of this cluster.')
# Timeout in seconds for operation
parser.add_argument('--timeout',
type=int,
default=1800,
help=argparse.SUPPRESS)
flags.AddAsyncFlag(parser)
parser.add_argument(
'--num-nodes',
type=arg_parsers.BoundedInt(1),
help=
'The number of nodes to be created in each of the cluster\'s zones.',
default=3)
parser.add_argument('--additional-zones',
type=arg_parsers.ArgList(min_length=1),
metavar='ZONE',
help="""\
The set of additional zones in which the specified node footprint should be
replicated. All zones must be in the same region as the cluster's primary zone.
If additional-zones is not specified, all nodes will be in the cluster's primary
zone.
Note that `NUM_NODES` nodes will be created in each zone, such that if you
specify `--num-nodes=4` and choose one additional zone, 8 nodes will be created.
Multiple locations can be specified, separated by commas. For example:
$ {command} example-cluster --zone us-central1-a --additional-zones us-central1-b,us-central1-c
""")
parser.add_argument(
'--machine-type',
'-m',
help='The type of machine to use for nodes. Defaults to n1-standard-1.'
)
parser.add_argument(
'--subnetwork',
help='The name of the Google Compute Engine subnetwork '
'(https://cloud.google.com/compute/docs/subnetworks) to which the '
'cluster is connected. If specified, the cluster\'s network must be a '
'"custom subnet" network.'
''
'Can not be used with the "--create-subnetwork" option.')
parser.add_argument(
'--disable-addons',
type=arg_parsers.ArgList(
choices=[api_adapter.INGRESS, api_adapter.HPA]),
help='List of cluster addons to disable. Options are {0}'.format(
', '.join([api_adapter.INGRESS, api_adapter.HPA])))
parser.add_argument(
'--network',
help='The Compute Engine Network that the cluster will connect to. '
'Google Container Engine will use this network when creating routes '
'and firewalls for the clusters. Defaults to the \'default\' network.')
parser.add_argument(
'--cluster-ipv4-cidr',
help='The IP address range for the pods in this cluster in CIDR '
'notation (e.g. 10.0.0.0/14). Prior to Kubernetes version 1.7.0 '
'this must be a subset of 10.0.0.0/8; however, starting with version '
'1.7.0 can be any RFC 1918 IP range.')
parser.add_argument(
'--password',
help='The password to use for cluster auth. Defaults to a '
'server-specified randomly-generated string.')
parser.add_argument('--scopes',
type=arg_parsers.ArgList(min_length=1),
metavar='SCOPE',
help="""\
Specifies scopes for the node instances. The project's default
service account is used. Examples:
$ {{command}} example-cluster --scopes https://www.googleapis.com/auth/devstorage.read_only
$ {{command}} 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:
[format="csv",options="header"]
|========
Alias,URI
{aliases}
|========
""".format(aliases=compute_constants.ScopesForHelp()))
parser.add_argument(
'--enable-cloud-endpoints',
action='store_true',
default=True,
help='Automatically enable Google Cloud Endpoints to take advantage of '
'API management features.')
parser.add_argument('--enable-cloud-logging',
action='store_true',
default=True,
help='Automatically send logs from the cluster to the '
'Google Cloud Logging API.')
parser.set_defaults(enable_cloud_logging=True)
parser.add_argument(
'--enable-cloud-monitoring',
action='store_true',
default=True,
help='Automatically send metrics from pods in the cluster to the '
'Google Cloud Monitoring API. VM metrics will be collected by Google '
'Compute Engine regardless of this setting.')
parser.set_defaults(enable_cloud_monitoring=True)
parser.add_argument(
'--disk-size',
type=int,
help='Size in GB for node VM boot disks. Defaults to 100GB.')
parser.add_argument('--username',
'-u',
help='The user name to use for cluster auth.',
default='admin')
parser.add_argument(
'--max-nodes-per-pool',
type=arg_parsers.BoundedInt(100, api_adapter.MAX_NODES_PER_POOL),
help='The maximum number of nodes to allocate per default initial node '
'pool. Container Engine will automatically create enough nodes pools '
'such that each node pool contains less than '
'--max-nodes-per-pool nodes. Defaults to {nodes} nodes, but can be set '
'as low as 100 nodes per pool on initial create.'.format(
nodes=api_adapter.MAX_NODES_PER_POOL))
flags.AddImageTypeFlag(parser, 'cluster')
flags.AddNodeLabelsFlag(parser)
flags.AddTagsFlag(
parser, """\
Applies the given Compute Engine tags (comma separated) on all nodes in the new
node-pool. Example:
$ {command} 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.
""")
flags.AddClusterVersionFlag(parser)
flags.AddDiskTypeFlag(parser, suppressed=True)
parser.display_info.AddFormat(util.CLUSTERS_FORMAT)