imjasonh/gcloud-help
1
0
Fork 0
mirror of https://github.com/imjasonh/gcloud-help synced 2026-07-21 22:49:22 +00:00
Code Activity

gcloud: Tue Jan 20 11:05:01 UTC 2026

Browse source
This commit is contained in:
Automated 2026-01-20 11:05:01 +00:00
parent bdd724fcf3
commit 582f364023
247 changed files with 5698 additions and 1205 deletions
Download patch file Download diff file Expand all files Collapse all files

3
gcloud/alpha/design-center/operations/help
View file

@ -27,6 +27,9 @@ COMMANDS
list
(ALPHA) List operations.
wait
(ALPHA) Wait for an operation to complete.
NOTES
This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct

70
gcloud/alpha/design-center/operations/wait Normal file
View file

@ -0,0 +1,70 @@
NAME
gcloud alpha design-center operations wait - wait for an operation to
complete
SYNOPSIS
gcloud alpha design-center operations wait
(OPERATION : --location=LOCATION) [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(ALPHA) Wait for an operation to complete
EXAMPLES
To wait for the operation myOperation to complete in project my-project and
location us-central1, run:
$ gcloud alpha design-center operations wait myOperation \
--project=my-project --location=us-central1
POSITIONAL ARGUMENTS
Operation resource - The name of the operation resource to wait on. The
arguments in this group can be used to specify the attributes of this
resource. (NOTE) Some attributes are not given arguments in this group but
can be set in other ways.
To set the project attribute:
◆ provide the argument operation on the command line with a fully
specified name;
◆ provide the argument --project on the command line;
◆ set the property core/project.
This must be specified.
OPERATION
ID of the operation or fully qualified identifier for the operation.
To set the operation attribute:
▸ provide the argument operation on the command line.
This positional argument must be specified if any of the other
arguments in this group are specified.
--location=LOCATION
The location id of the operation resource.
To set the location attribute:
▸ provide the argument operation on the command line with a fully
specified name;
▸ provide the argument --location on the command line.
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.
API REFERENCE
This command uses the designcenter/v1alpha API. The full documentation for
this API can be found at:
http://cloud.google.com/application-design-center/docs
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. This variant is also available:
$ gcloud design-center operations wait

7
gcloud/alpha/design-center/spaces/applications/create
View file

@ -26,7 +26,7 @@ SYNOPSIS
: --criticality-level=CRITICALITY_LEVEL
--criticality-mission-critical] [--environment-type=ENVIRONMENT_TYPE
: --environment=ENVIRONMENT]]
[--gke-deployment-target-cluster-self-link=GKE_DEPLOYMENT_TARGET_CLUSTER_SELF_LINK --gke-deployment-target-kubernetes-service-account=GKE_DEPLOYMENT_TARGET_KUBERNETES_SERVICE_ACCOUNT --gke-deployment-target-namespace=GKE_DEPLOYMENT_TARGET_NAMESPACE]
[--gke-deployment-target-cluster-self-link=GKE_DEPLOYMENT_TARGET_CLUSTER_SELF_LINK --gke-deployment-target-kubernetes-service-account=GKE_DEPLOYMENT_TARGET_KUBERNETES_SERVICE_ACCOUNT --gke-deployment-target-namespace=GKE_DEPLOYMENT_TARGET_NAMESPACE : --gke-deployment-target-kubernetes-service-account-creation]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
@ -401,6 +401,11 @@ OPTIONAL FLAGS
This flag argument must be specified if any of the other
arguments in this group are specified.
--gke-deployment-target-kubernetes-service-account-creation
Whether to create the provided KSA. If true, the KSA will be
created in the namespace provided above. If false, the KSA is
expected to already exist in the namespace provided above.
GCLOUD WIDE FLAGS
These flags are available to all commands: --access-token-file, --account,
--billing-project, --configuration, --flags-file, --flatten, --format,

97
gcloud/alpha/design-center/spaces/applications/deploy
View file

@ -4,9 +4,9 @@ NAME
SYNOPSIS
gcloud alpha design-center spaces applications deploy
(APPLICATION : --location=LOCATION --space=SPACE) [--async] [--replace]
[--service-account=SERVICE_ACCOUNT] [--worker-pool=WORKER_POOL]
[GCLOUD_WIDE_FLAG ...]
(APPLICATION : --location=LOCATION --space=SPACE) [--async]
[--create-sa] [--replace] [--service-account=SERVICE_ACCOUNT]
[--worker-pool=WORKER_POOL] [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(ALPHA) Deploy an application in a space.
@ -16,13 +16,13 @@ EXAMPLES
my-project and location us-central1, run:
$ gcloud alpha design-center spaces applications deploy \
my-application --space=my-space --project=my-project \
--location=us-central1
my-application --space=my-space --project=my-project \
--location=us-central1
Or run:
$ gcloud alpha design-center spaces applications deploy \
projects/my-project/locations/us-central1/spaces/my-space/\
projects/my-project/locations/us-central1/spaces/my-space/\
applications/my-application
To deploy the application my-application in space my-space, project
@ -30,35 +30,59 @@ EXAMPLES
run:
$ gcloud alpha design-center spaces applications deploy \
my-application --space=my-space --project=my-project \
--location=us-central1 --replace
my-application --space=my-space --project=my-project \
--location=us-central1 --replace
To deploy the application my-application in space my-space, project
my-project and location us-central1 using a worker pool
projects/my-project/locations/us-central1/workerPools/my-worker-pool, run:
$ gcloud alpha design-center spaces applications deploy \
my-application --space=my-space --project=my-project \
--location=us-central1 \
--worker-pool=projects/my-project/locations/us-central1/\
my-application --space=my-space --project=my-project \
--location=us-central1 \
--worker-pool=projects/my-project/locations/us-central1/\
workerPools/my-worker-pool
To deploy the application my-application and create a new service account
for the deployment, run:
$ gcloud alpha design-center spaces applications deploy \
my-application --space=my-space --project=my-project \
--location=us-central1 --create-sa
To deploy the application my-application and create a new service account
and create a specific service account for the deployment, run:
$ gcloud alpha design-center spaces applications deploy \
my-application --space=my-space --project=my-project \
--location=us-central1 --create-sa \
--service-account=my-service-account@my-project.iam.gserviceacco\
unt.com
To deploy the application my-application and use a specific service account
for the deployment, run:
$ gcloud alpha design-center spaces applications deploy \
my-application --space=my-space --project=my-project \
--location=us-central1 \
--service-account=projects/my-project/serviceAccounts/\
my-service-account@my-project.iam.gserviceaccount.com
To deploy the application my-application in space my-space, project
my-project and location us-central1 asynchronously, run:
$ gcloud alpha design-center spaces applications deploy \
my-application --space=my-space --project=my-project \
--location=us-central1 --async
my-application --space=my-space --project=my-project \
--location=us-central1 --async
POSITIONAL ARGUMENTS
Application resource - The application name. Format:
projects/$project/locations/$location/spaces/$space/applications/$application
The arguments in this group can be used to specify the attributes of this
resource. (NOTE) Some attributes are not given arguments in this group but
can be set in other ways.
Application resource - The application to deploy IaC. The arguments in
this group can be used to specify the attributes of this resource. (NOTE)
Some attributes are not given arguments in this group but can be set in
other ways.
To set the project attribute:
◆ provide the argument application on the command line with a fully
◆ provide the argument APPLICATION on the command line with a fully
specified name;
◆ provide the argument --project on the command line;
◆ set the property core/project.
@ -70,24 +94,24 @@ POSITIONAL ARGUMENTS
application.
To set the application attribute:
▸ provide the argument application on the command line.
▸ provide the argument APPLICATION on the command line.
This positional argument must be specified if any of the other
arguments in this group are specified.
--location=LOCATION
The location id of the application resource.
The Cloud location for the application.
To set the location attribute:
▸ provide the argument application on the command line with a fully
▸ provide the argument APPLICATION on the command line with a fully
specified name;
▸ provide the argument --location on the command line.
--space=SPACE
The space id of the application resource.
The ID of the space.
To set the space attribute:
▸ provide the argument application on the command line with a fully
▸ provide the argument APPLICATION on the command line with a fully
specified name;
▸ provide the argument --space on the command line.
@ -96,24 +120,34 @@ FLAGS
Return immediately, without waiting for the operation in progress to
complete.
--create-sa
Create a new service account for the deployment.
--replace
Flag to update the existing deployment. If not set or false, deploy
will fail if application state is in the DEPLOYED state.
--service-account=SERVICE_ACCOUNT
The email address of the service account to use for this deployment.
The service account to use for this deployment.
◆ If provided, this service account will be used to execute the
deployment process, taking precedence over any service_account
specified on the Application resource.
◆ The caller must have the 'iam.serviceAccounts.actAs' permission on
◆ The caller must have the "iam.serviceAccounts.actAs" permission on
this service account.
◆ If this field is omitted, the system will use the 'service_account'
◆ If this field is omitted, the system will use the "service_account"
defined within the Application resource.
◆ If this field is omitted with --create-sa flag, the system will
create a new and unique service_account and use it for the
deployment.
◆ We recommend that you provide a service account here or on the
Application resource. If you don't provide a service account, the
deployment will fail. Format:
projects/{PROJECT}/serviceAccounts/{EMAIL_ADDRESS}
deployment will fail.
◆ If the --create-sa flag is also provided, this value is the ID of a
new service account to be created (e.g., my-new-sa).
Format: projects/{PROJECT}/serviceAccounts/{EMAIL_ADDRESS} (when not
using --create-sa)
--worker-pool=WORKER_POOL
The user-specified Worker Pool resource in which the Cloud Build job
@ -132,11 +166,6 @@ GCLOUD WIDE FLAGS
Run $ gcloud help for details.
API REFERENCE
This command uses the designcenter/v1alpha API. The full documentation for
this API can be found at:
http://cloud.google.com/application-design-center/docs
NOTES
This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct

2
gcloud/alpha/design-center/spaces/applications/help
View file

@ -39,7 +39,7 @@ COMMANDS
(ALPHA) List applications.
preview
(ALPHA) Preview an application.
(ALPHA) Preview a Design Center application.
register
(ALPHA) Register resources with a deployed application in App Hub.

95
gcloud/alpha/design-center/spaces/applications/preview
View file

@ -1,12 +1,12 @@
NAME
gcloud alpha design-center spaces applications preview - preview an
application
gcloud alpha design-center spaces applications preview - preview a Design
Center application
SYNOPSIS
gcloud alpha design-center spaces applications preview
(APPLICATION : --location=LOCATION --space=SPACE) [--async]
[--service-account=SERVICE_ACCOUNT] [--worker-pool=WORKER_POOL]
[GCLOUD_WIDE_FLAG ...]
[--create-sa] [--service-account=SERVICE_ACCOUNT]
[--worker-pool=WORKER_POOL] [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(ALPHA) Preview an application in a space.
@ -16,13 +16,13 @@ EXAMPLES
my-project and location us-central1, run:
$ gcloud alpha design-center spaces applications preview \
my-application --space=my-space --project=my-project \
--location=us-central1
my-application --space=my-space --project=my-project \
--location=us-central1
Or run:
$ gcloud alpha design-center spaces applications preview \
projects/my-project/locations/us-central1/spaces/my-space/\
projects/my-project/locations/us-central1/spaces/my-space/\
applications/my-application
To preview the application my-application in space my-space, project
@ -30,27 +30,51 @@ EXAMPLES
projects/my-project/locations/us-central1/workerPools/my-worker-pool, run:
$ gcloud alpha design-center spaces applications preview \
my-application --space=my-space --project=my-project \
--location=us-central1 \
--worker-pool=projects/my-project/locations/us-central1/\
my-application --space=my-space --project=my-project \
--location=us-central1 \
--worker-pool=projects/my-project/locations/us-central1/\
workerPools/my-worker-pool
To preview the application my-application and create a new service account
for the preview, run:
$ gcloud alpha design-center spaces applications preview \
my-application --space=my-space --project=my-project \
--location=us-central1 --create-sa
To preview the application my-application and create a new provided service
account for the preview, run:
$ gcloud alpha design-center spaces applications preview \
my-application --space=my-space --project=my-project \
--location=us-central1 --create-sa \
--service-account=my-service-account@my-project.iam.gserviceacco\
unt.com
To preview the application my-application and use a specific existing
service account for the preview, run:
$ gcloud alpha design-center spaces applications preview \
my-application --space=my-space --project=my-project \
--location=us-central1 \
--service-account=projects/my-project/serviceAccounts/\
my-service-account@my-project.iam.gserviceaccount.com
To preview the application my-application in space my-space, project
my-project and location us-central1 asynchronously, run:
$ gcloud alpha design-center spaces applications preview \
my-application --space=my-space --project=my-project \
--location=us-central1 --async
my-application --space=my-space --project=my-project \
--location=us-central1 --async
POSITIONAL ARGUMENTS
Application resource - The application name in the following format:
projects/$project/locations/$location/spaces/$space/applications/$application
The arguments in this group can be used to specify the attributes of this
resource. (NOTE) Some attributes are not given arguments in this group but
can be set in other ways.
Application resource - The application to preview IaC. The arguments in
this group can be used to specify the attributes of this resource. (NOTE)
Some attributes are not given arguments in this group but can be set in
other ways.
To set the project attribute:
◆ provide the argument application on the command line with a fully
◆ provide the argument APPLICATION on the command line with a fully
specified name;
◆ provide the argument --project on the command line;
◆ set the property core/project.
@ -62,24 +86,24 @@ POSITIONAL ARGUMENTS
application.
To set the application attribute:
▸ provide the argument application on the command line.
▸ provide the argument APPLICATION on the command line.
This positional argument must be specified if any of the other
arguments in this group are specified.
--location=LOCATION
The location id of the application resource.
The Cloud location for the application.
To set the location attribute:
▸ provide the argument application on the command line with a fully
▸ provide the argument APPLICATION on the command line with a fully
specified name;
▸ provide the argument --location on the command line.
--space=SPACE
The space id of the application resource.
The ID of the space.
To set the space attribute:
▸ provide the argument application on the command line with a fully
▸ provide the argument APPLICATION on the command line with a fully
specified name;
▸ provide the argument --space on the command line.
@ -88,21 +112,29 @@ FLAGS
Return immediately, without waiting for the operation in progress to
complete.
--create-sa
Create a new service account for the preview.
--service-account=SERVICE_ACCOUNT
The email address of the service account to use for this preview
operation.
The service account to use for this preview.
◆ If provided, this service account will be used to execute the
preview process, taking precedence over any service_account specified
on the Application resource.
◆ The caller must have the 'iam.serviceAccounts.actAs' permission on
◆ The caller must have the "iam.serviceAccounts.actAs" permission on
this service account.
◆ If this field is omitted, the system will use the 'service_account'
◆ If this field is omitted, the system will use the "service_account"
defined within the Application resource.
◆ If this field is omitted with --create-sa flag, the system will
create a new and unique service_account and use it for the preview.
◆ We recommend that you provide a service account here or on the
Application resource. If you don't provide a service account, the
preview will fail. Format:
projects/{PROJECT}/serviceAccounts/{EMAIL_ADDRESS}
preview will fail.
◆ If the --create-sa flag is also provided, this value is the ID of a
new service account to be created (e.g., my-new-sa).
Format: projects/{PROJECT}/serviceAccounts/{EMAIL_ADDRESS} (when not
using --create-sa)
--worker-pool=WORKER_POOL
The user-specified Worker Pool resource in which the Cloud Build job
@ -121,11 +153,6 @@ GCLOUD WIDE FLAGS
Run $ gcloud help for details.
API REFERENCE
This command uses the designcenter/v1alpha API. The full documentation for
this API can be found at:
http://cloud.google.com/application-design-center/docs
NOTES
This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct

11
gcloud/alpha/design-center/spaces/applications/update
View file

@ -39,7 +39,7 @@ SYNOPSIS
--criticality-type=CRITICALITY_TYPE
--environment=ENVIRONMENT --environment-type=ENVIRONMENT_TYPE]
[--clear-deployment-target
--gke-deployment-target-cluster-self-link=GKE_DEPLOYMENT_TARGET_CLUSTER_SELF_LINK --gke-deployment-target-kubernetes-service-account=GKE_DEPLOYMENT_TARGET_KUBERNETES_SERVICE_ACCOUNT --gke-deployment-target-namespace=GKE_DEPLOYMENT_TARGET_NAMESPACE]
--gke-deployment-target-cluster-self-link=GKE_DEPLOYMENT_TARGET_CLUSTER_SELF_LINK --gke-deployment-target-kubernetes-service-account=GKE_DEPLOYMENT_TARGET_KUBERNETES_SERVICE_ACCOUNT --[no-]gke-deployment-target-kubernetes-service-account-creation --gke-deployment-target-namespace=GKE_DEPLOYMENT_TARGET_NAMESPACE]
[--clear-scope --scope-type=SCOPE_TYPE]
[--clear-source
--source-application-template-revision=SOURCE_APPLICATION_TEMPLATE_REVISION | --source-shared-template-revision-uri=SOURCE_SHARED_TEMPLATE_REVISION_URI]
@ -617,6 +617,15 @@ FLAGS
The kubernetes service account that is created within the
namespace provided above. Example: default or node-sa
--[no-]gke-deployment-target-kubernetes-service-account-creation
Whether to create the provided KSA. If true, the KSA will be
created in the namespace provided above. If false, the KSA is
expected to already exist in the namespace provided above. Use
--gke-deployment-target-kubernetes-service-account-creation to
enable and
--no-gke-deployment-target-kubernetes-service-account-creation to
disable.
--gke-deployment-target-namespace=GKE_DEPLOYMENT_TARGET_NAMESPACE
The namespace where the application is deployed.