1
0
Fork 0
mirror of https://github.com/imjasonh/gcloud-help synced 2026-07-08 02:25:19 +00:00

gcloud: Wed Jul 12 10:20:16 UTC 2023

This commit is contained in:
Automated 2023-07-12 10:20:16 +00:00
parent f52bc665a7
commit b4c2508b12
300 changed files with 7469 additions and 3231 deletions

View file

@ -9,29 +9,31 @@ DESCRIPTION
To add tag my-tag to image busy-box referenced by digest abcxyz in
us-west1:
$ gcloud artifacts docker tags
us-west1-docker.pkg.dev/my-project/my-repository/busy-box@sha256:abcxyz
us-west1-docker.pkg.dev/my-project/my-repository/busy-box:my-tag
$ gcloud artifacts docker tags add \
us-west1-docker.pkg.dev/my-project/my-repository/\
busy-box@sha256:abcxyz \
us-west1-docker.pkg.dev/my-project/my-repository/busy-box:my-tag
To add tag my-tag to image busy-box referenced by tag latest in us-west1:
$ gcloud artifacts docker tags \
us-west1-docker.pkg.dev/my-project/my-repository/busy-box:latest
us-west1-docker.pkg.dev/my-project/my-repository/busy-box:my-tag
$ gcloud artifacts docker tags add \
us-west1-docker.pkg.dev/my-project/my-repository/\
busy-box:latest \
us-west1-docker.pkg.dev/my-project/my-repository/busy-box:my-tag
To delete tag my-tag from image busy-box in us-west1:
$ gcloud artifacts docker tags \
$ gcloud artifacts docker tags delete \
us-west1-docker.pkg.dev/my-project/my-repository/busy-box:my-tag
To list all tags in repository my-repository in us-west1:
$ gcloud artifacts docker tags \
$ gcloud artifacts docker tags list \
us-west1-docker.pkg.dev/my-project/my-repository
To list tags for image busy-box in us-west1:
$ gcloud artifacts docker tags \
$ gcloud artifacts docker tags list \
us-west1-docker.pkg.dev/my-project/my-repository/busy-box
GCLOUD WIDE FLAGS

View file

@ -0,0 +1,72 @@
NAME
gcloud artifacts repositories delete-cleanup-policies - delete cleanup
policies from an Artifact Registry repository
SYNOPSIS
gcloud artifacts repositories delete-cleanup-policies
(REPOSITORY : --location=LOCATION) --policynames=POLICYNAMES
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
Delete cleanup policies from an Artifact Registry repository.
This command can fail for the following reasons:
▪ The given repository does not exist.
▪ The active account does not have permission to update repositories.
EXAMPLES
To delete a cleanup policy named policy_a from the repository my-repo, run:
$ gcloud artifacts repositories delete-cleanup-policies my-repo \
--policynames=policy_a
POSITIONAL ARGUMENTS
Repository resource - The Artifact Registry repository to update. 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 repository on the command line with a fully
specified name;
◆ set the property core/project;
◆ provide the argument --project on the command line.
This must be specified.
REPOSITORY
ID of the repository or fully qualified identifier for the
repository.
To set the repository attribute:
▸ provide the argument repository on the command line.
This positional argument must be specified if any of the other
arguments in this group are specified.
--location=LOCATION
Location of the repository. Overrides the default artifacts/location
property value for this command invocation. To configure the default
location, use the command: gcloud config set artifacts/location.
To set the location attribute:
▸ provide the argument repository on the command line with a fully
specified name;
▸ provide the argument --location on the command line;
▸ set the property artifacts/location.
REQUIRED FLAGS
--policynames=POLICYNAMES
Comma-separated list of cleanup policy names to delete.
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 artifactregistry/v1 API. The full documentation for
this API can be found at: https://cloud.google.com/artifacts/docs/

View file

@ -59,6 +59,9 @@ COMMANDS
delete
Delete an Artifact Registry repository.
delete-cleanup-policies
Delete cleanup policies from an Artifact Registry repository.
describe
Describe an Artifact Registry repository.
@ -68,10 +71,16 @@ COMMANDS
list
List repositories in the specified project.
list-cleanup-policies
List cleanup policies of an Artifact Registry repository.
remove-iam-policy-binding
Remove an IAM policy binding from the IAM policy of an Artifact
Registry repository.
set-cleanup-policies
Set or update cleanup policies for an Artifact Registry repository.
set-iam-policy
Set the IAM policy for an Artifact Registry repository.

View file

@ -0,0 +1,66 @@
NAME
gcloud artifacts repositories list-cleanup-policies - list cleanup policies
of an Artifact Registry repository
SYNOPSIS
gcloud artifacts repositories list-cleanup-policies
(REPOSITORY : --location=LOCATION) [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
List cleanup policies of an Artifact Registry repository.
This command can fail for the following reasons:
▪ The specified repository does not exist.
▪ The active account does not have permission to list cleanup policies.
EXAMPLES
To list cleanup policies for the repository my-repo, run:
$ gcloud artifacts repositories list-cleanup-policies my-repo
POSITIONAL ARGUMENTS
Repository resource - The parent Artifact Registry repository for the list
of cleanup policies. 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 repository on the command line with a fully
specified name;
◆ set the property core/project;
◆ provide the argument --project on the command line.
This must be specified.
REPOSITORY
ID of the repository or fully qualified identifier for the
repository.
To set the repository attribute:
▸ provide the argument repository on the command line.
This positional argument must be specified if any of the other
arguments in this group are specified.
--location=LOCATION
Location of the repository. Overrides the default artifacts/location
property value for this command invocation. To configure the default
location, use the command: gcloud config set artifacts/location.
To set the location attribute:
▸ provide the argument repository on the command line with a fully
specified name;
▸ provide the argument --location on the command line;
▸ set the property artifacts/location.
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 artifactregistry/v1 API. The full documentation for
this API can be found at: https://cloud.google.com/artifacts/docs/

View file

@ -0,0 +1,94 @@
NAME
gcloud artifacts repositories set-cleanup-policies - set or update cleanup
policies for an Artifact Registry repository
SYNOPSIS
gcloud artifacts repositories set-cleanup-policies
(REPOSITORY : --location=LOCATION)
(--dry-run [--policy=POLICY : --overwrite]) [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
Set or update cleanup policies for an Artifact Registry repository.
This command can fail for the following reasons:
▪ The given repository does not exist.
▪ The active account does not have permission to update repositories.
▪ A valid cleanup policy format was not provided.
▪ The repository exceeds the maximum number of cleanup policies.
See
https://cloud.google.com/artifact-registry/docs/repositories/cleanup-policy
for details of the cleanup policy file format and contents.
EXAMPLES
To create a cleanup policy from a file with the name policy.json in the
repository my-repo, run:
$ gcloud artifacts repositories set-cleanup-policies my-repo \
--policy=policy.json
POSITIONAL ARGUMENTS
Repository resource - The parent Artifact Registry repository for the list
of cleanup policies. 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 repository on the command line with a fully
specified name;
◆ set the property core/project;
◆ provide the argument --project on the command line.
This must be specified.
REPOSITORY
ID of the repository or fully qualified identifier for the
repository.
To set the repository attribute:
▸ provide the argument repository on the command line.
This positional argument must be specified if any of the other
arguments in this group are specified.
--location=LOCATION
Location of the repository. Overrides the default artifacts/location
property value for this command invocation. To configure the default
location, use the command: gcloud config set artifacts/location.
To set the location attribute:
▸ provide the argument repository on the command line with a fully
specified name;
▸ provide the argument --location on the command line;
▸ set the property artifacts/location.
REQUIRED FLAGS
At least one of these must be specified:
--dry-run
Disable deleting images according to cleanup policies.
Setting Policies
--policy=POLICY
Path to a local JSON formatted file containing valid cleanup
policies.
This flag argument must be specified if any of the other arguments
in this group are specified.
--overwrite
Delete existing policies and replace with the specified set of
policies.
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 artifactregistry/v1 API. The full documentation for
this API can be found at: https://cloud.google.com/artifacts/docs/