gcloud CLI 속성 관리

속성이란 gcloud CLI의 동작을 제어하는 설정을 말합니다.

속성은 제품별 또는 서비스별 설정을 정의하는 데 사용될 수 있습니다. 예를 들면 gcloud CLI에서 승인을 위해 사용되는 계정 설정, Compute Engine 리소스로 작업 시 사용되는 기본 리전 설정 또는 자동 gcloud CLI 구성요소 업데이트를 해제하기 위한 옵션 설정 등이 있습니다. 또한 속성을 사용하여 gcloud CLI 명령어의 상세 수준 및 프롬프트 구성과 같은 gcloud CLI 환경설정을 정의할 수도 있습니다.

속성과 신고

gcloud CLI는 gcloud CLI 속성과 효과가 동일한 일부 전역 플래그와 명령어 플래그를 지원합니다. 예를 들어 gcloud CLI는 --project 플래그와 project 속성을 모두 지원합니다. 속성을 사용하면 명령어 실행에서 설정을 동일하게 유지할 수 있지만, 플래그는 각 호출 단위로 명령어 동작에 영향을 미칩니다. 두 가지 모두가 설정된 경우에는 플래그가 속성보다 우선 시 됩니다.

구성

구성은 gcloud CLI 속성을 조합하여 이름을 붙인 것입니다. gcloud CLI는 default라는 구성을 초기 활성 구성으로 사용합니다. default 구성은 대부분의 사용 사례에 적합합니다. 하지만 추가 구성을 만들고 필요에 따라 구성을 전환할 수도 있습니다.

속성 나열

활성 구성의 속성을 나열하려면 gcloud config list를 실행합니다.

gcloud config list

gcloud CLI는 속성 목록을 반환합니다.

[compute]
region = us-east1
zone = us-east1-d
[core]
account = user@google.com
disable_usage_reporting = False
project = example-project
[metrics]
command_name = gcloud.config.list

속성 설정

활성 구성의 속성을 설정하려면 gcloud config set을 실행합니다. 다음 예시에서는 project 속성을 설정합니다. 여기서 PROJECT_ID는 프로젝트의 고유 ID입니다.

gcloud config set project PROJECT_ID

core 속성 섹션에 없는 속성을 설정하려면 섹션 다음에 슬래시를 지정한 후 속성 이름을 지정해야 합니다. 다음 예시에서는 영역 이름을 us-east1-b로 설정합니다.

gcloud config set compute/zone us-east1-b

환경 변수를 사용한 속성 설정

환경 변수를 사용하여 속성을 설정할 수도 있습니다. 각 속성에는 속성을 설정하는 데 사용할 수 있는 해당 환경 변수가 있습니다. 환경 변수의 이름은 CLOUDSDK_SECTION_NAME_PROPERTY_NAME 패턴을 따릅니다. 예를 들어 다음과 같이 core/project 및 compute/zone 속성을 설정할 수 있습니다.

CLOUDSDK_CORE_PROJECT=PROJECT_NAME

CLOUDSDK_COMPUTE_ZONE=ZONE_NAME

속성 설정 해제

활성 구성의 속성을 설정 해제하려면 gcloud config unset를 사용합니다.

gcloud config unset disable_usage_reporting

사용 가능한 속성

모든 속성 목록은 gcloud topic configurations 또는 gcloud config set --help를 실행하고 사용 가능한 속성 섹션을 찾아 확인할 수 있습니다.

다음 단계