mirror of
https://github.com/imjasonh/gcloud-help
synced 2026-07-14 08:55:34 +00:00
93 lines
3.4 KiB
Text
93 lines
3.4 KiB
Text
NAME
|
|
gcloud alpha compute instance-groups unmanaged set-named-ports - sets the
|
|
list of named ports for an instance group
|
|
|
|
SYNOPSIS
|
|
gcloud alpha compute instance-groups unmanaged set-named-ports NAME
|
|
--named-ports=[NAME:PORT,...] [--zone=ZONE] [GCLOUD_WIDE_FLAG ...]
|
|
|
|
DESCRIPTION
|
|
(ALPHA) Named ports are key:value pairs metadata representing the service
|
|
name and the port that it's running on. Named ports can be assigned to an
|
|
instance group, which indicates that the service is available on all
|
|
instances in the group. This information is used by the HTTP Load Balancing
|
|
service.
|
|
|
|
gcloud alpha compute instance-groups unmanaged set-named-ports sets the
|
|
list of named ports for all instances in an instance group.
|
|
|
|
Note: Running this command will clear all existing named ports.
|
|
|
|
EXAMPLES
|
|
For example, to apply the named ports to an entire instance group:
|
|
|
|
$ gcloud alpha compute instance-groups unmanaged set-named-ports \
|
|
example-instance-group --named-ports=example-service:1111 \
|
|
--zone=us-central1-a
|
|
|
|
The above example will assign a name 'example-service' for port 1111 to the
|
|
instance group called 'example-instance-group' in the us-central1-a zone.
|
|
The command removes any named ports that are already set for this instance
|
|
group.
|
|
|
|
To clear named ports from instance group provide empty named ports list as
|
|
parameter:
|
|
|
|
$ gcloud alpha compute instance-groups unmanaged set-named-ports \
|
|
example-instance-group --named-ports="" --zone=us-central1-a
|
|
|
|
POSITIONAL ARGUMENTS
|
|
NAME
|
|
Name of the instance group to operate on.
|
|
|
|
REQUIRED FLAGS
|
|
--named-ports=[NAME:PORT,...]
|
|
The comma-separated list of key:value pairs representing the service
|
|
name and the port that it is running on.
|
|
|
|
To clear the list of named ports pass empty list as flag value. For
|
|
example:
|
|
|
|
$ gcloud alpha compute instance-groups unmanaged set-named-ports \
|
|
example-instance-group --named-ports ""
|
|
|
|
OPTIONAL FLAGS
|
|
--zone=ZONE
|
|
Zone of the instance group to operate on. If not specified and the
|
|
compute/zone property isn't set, you might be prompted to select a zone
|
|
(interactive mode only).
|
|
|
|
To avoid prompting when this flag is omitted, you can set the
|
|
compute/zone property:
|
|
|
|
$ gcloud config set compute/zone ZONE
|
|
|
|
A list of zones can be fetched by running:
|
|
|
|
$ gcloud compute zones list
|
|
|
|
To unset the property, run:
|
|
|
|
$ gcloud config unset compute/zone
|
|
|
|
Alternatively, the zone can be stored in the environment variable
|
|
CLOUDSDK_COMPUTE_ZONE.
|
|
|
|
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 alpha and might change without notice. If this
|
|
command fails with API permission errors despite specifying the correct
|
|
project, you might be trying to access an API with an invitation-only early
|
|
access allowlist. These variants are also available:
|
|
|
|
$ gcloud compute instance-groups unmanaged set-named-ports
|
|
|
|
$ gcloud beta compute instance-groups unmanaged set-named-ports
|
|
|