In the Google Cloud CLI, configurations enable you to set properties that
affect the behavior of the active gcloud
session. A default
configuration is
created when you initialize Google Cloud CLI and you can create other named
configurations.
A configuration can include default values for specific properties so that you do not need to specify them in your commands.
For more information about using configurations, see the gcloud config documentation.
Setting defaults
You can set a default project, repository, and repository location in the Google Cloud CLI active configuration so that you don't need to include them in commands where those values are required.
If you do specify a value for a project, repository, or repository location,
that value overrides the configured default. You can do this with the --repository
or --location
flag in your command.
If you're using repository modes other than standard mode, or frequently using repositories in different locations, setting default values might not be helpful.
Setting a default project
To set default project for all gcloud
commands, run the command:
gcloud
config
set
project
PROJECT
Replace PROJECT with the ID of the project or fully qualified identifier for the project.
To override the default, use the --project
flag in your command. For example
gcloud
artifacts
packages
list
--project =
my-project
Setting a default repository
To set a default repository, run the command:
gcloud
config
set
artifacts/repository
REPOSITORY
Replace REPOSITORY with the name of the repository, or fully qualified identifier for the repository.
To override the default, use the --repository
flag in your command. For example
gcloud
artifacts
packages
list
--repository =
my-repo
Setting a default location
To set a default repository location, run the command:
gcloud
config
set
artifacts/location
LOCATION
Replace LOCATION
with the regional or multi-regional location
of the repository.
To view a list of supported locations, run the command:
gcloud
artifacts
locations
list
To override the default, use the --location
flag in your command. For example
gcloud
artifacts
packages
list
--repository =
my-repo
--location =
us-central1
Removing default values
When you remove a default value for a configuration property, you must specify
it in gcloud
commands that require the property.
To unset the default project run the following command:
gcloud
config
unset
project
To unset the default repository, run the following command:
gcloud
config
unset
artifacts/repository
To unset the default location, run the following command:
gcloud
config
unset
artifacts/location
