SDK 속성 관리

속성이란 무엇인가요?

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

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

속성과 신고

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

구성

구성은 SDK 속성을 조합하여 이름을 붙인 것입니다. 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를 실행합니다.

gcloud config set project [PROJECT]

core 속성 섹션에 없는 속성을 설정하려면 섹션 다음에 슬래시를 지정한 후 속성 이름을 지정해야 합니다.

gcloud config set compute/zone us-east1-b

속성 설정 해제

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

gcloud config unset disable_usage_reporting

속성 유형

SDK 속성은 속성 목록을 볼 때 편의를 위해 관련 속성을 그룹화한 섹션으로 구성됩니다.

Core 속성

core 섹션에는 gcloud 명령어에 대한 구성 속성이 포함되어 있습니다.

이름 설명
account 승인을 위해 gcloud CLI와 다른 SDK 도구가 사용하는 사용자 계정 또는 서비스 계정입니다.
disable_color True로 설정되면 gcloud CLI는 메시지가 터미널에 컬러로 보이지 못하도록 합니다.
disable_prompts True로 설정되면 모든 gcloud CLI 명령어에 대한 메시지가 표시되지 않고 기본 답변으로 간주됩니다. 명령어에 사용자 입력이 필요하고 기본값을 사용할 수 없는 경우 gcloud CLI가 오류로 신고합니다. 전역 --quiet 플래그와 동일합니다.
disable_usage_reporting True로 설정되면 SDK 사용에 대한 익명 통계 수집이 중지됩니다. SDK 설치 시 이 값을 설정할 수 있고 언제든지 변경할 수 있습니다.
log_http True로 설정되면 로그에 대한 HTTP 요청 및 응답 작성이 사용됩니다. 터미널에서 이러한 메시지를 보려는 경우, verbosity 속성이나 전역 --verbosity 플래그를 사용하여 상세 설정을 조정합니다.
project 현재 Cloud Platform 프로젝트의 프로젝트 ID입니다. 전역 --project 플래그를 사용하여 이 값을 재정의할 수 있습니다.
trace_token 문제 조사 목적으로 서비스 요청의 추적 경로를 관리하기 위해 Google에서 제공하는 토큰입니다.
user_output_enabled 단말기에 표준 출력 및 표준 오류로 명령어 출력을 인쇄할 수 있습니다. False로 설정되면 출력이 나타나지 않습니다.
verbosity gcloud CLI 명령어에 대한 상세 로깅입니다. gcloud CLI는 다음과 같은 표준 상세 수준을 지원합니다.
  • debug
  • info
  • warning
  • error
  • critical
  • none
전역 --verbosity 플래그 사용과 동일합니다.

구성요소 관리자 속성

component_manager 섹션에는 SDK 구성요소 관리 시 사용되는 속성이 포함되어 있습니다.

이름 설명
component_manager/additional_repositories 구성요소를 확인하기 위해 추가 저장소를 쉼표로 구분하여 나타낸 목록입니다. 이 속성은 gcloud components repositories 명령어 그룹의 명령어로 자동 관리됩니다.
component_manager/disable_update_check True이면 SDK가 업데이트를 자동으로 확인하지 않습니다.

App Engine 속성

app 섹션에는 gcloud app deploy 명령어에 대한 동작을 지정하는 속성이 포함되어 있습니다.

이름 설명
app/stop_previous_version True이면 새 버전의 애플리케이션 배포 시 이전에 배포된 버전이 중지됩니다. False이면 배포 전에 이전 버전을 직접 중지해야 합니다.

Compute Engine 속성

compute 섹션에는 Google Compute Engine 리소스에서 작동하는 gcloud CLI 명령어가 사용하는 속성이 포함되어 있습니다.

이름 설명
compute/region Compute Engine 리소스로 작업 시 사용되는 기본 리전입니다. gcloud CLI 명령어에 --region 플래그가 필요하지만 제공되지 않는 경우 이 값이 사용됩니다.
compute/zone Compute Engine 리소스로 작업 시 사용되는 기본 영역(zone)입니다. gcloud CLI 명령어에 --zone 플래그가 필요하지만 제공되지 않는 경우 이 값이 사용됩니다.

Kubernetes Engine 속성

container 섹션에는 Google Kubernetes Engine 클러스터에서 작동하는 gcloud CLI 명령어가 사용하는 속성이 포함되어 있습니다.

이름 설명
container/cluster 기본적으로 사용되는 클러스터 이름입니다.

네트워크 프록시 속성

proxy 섹션에는 gcloud 명령어가 사용하는 네트워크 프록시와 관련된 속성이 포함되어 있습니다.

이름 설명
proxy/type 프록시 서버의 유형입니다. 지원되는 프록시 유형은 다음과 같습니다.
  • http
  • http_no_tunnel
  • socks4
  • socks5
proxy/address 프록시 서버의 호스트 이름 또는 IP 주소입니다.
proxy/port 프록시 서버에 연결 시 사용할 포트입니다.
proxy/username 필요한 경우 프록시 서버에 연결 시 사용할 사용자 이름입니다.
proxy/password 필요할 경우 프록시 서버에 연결 시 사용할 비밀번호입니다.
proxy/rdns 참(기본값)이면 DNS 쿼리가 로컬로 이행되지 않고 확인할 프록시로 넘겨집니다.

다음 단계

  • SDK 구성을 읽고 구성에 대해 자세히 알아보세요.