구성이란 무엇인가요?
구성은 SDK 속성을 조합하여 이름을 붙인 것입니다. 이러한 속성은 gcloud 명령줄 도구 및 기타 SDK 도구의 동작을 제어하는 키-값 쌍입니다.
일반적으로 구성에 저장되는 속성에는 기본 Google Compute Engine 영역(zone), 상세 수준, 사용량 보고, 프로젝트 ID, 활성 사용자 또는 서비스 계정이 포함됩니다. 구성을 통해 이러한 속성 및 기타 설정을 그룹으로 정의하고 사용할 수 있습니다.
구성이 여러 개 있는 경우, 다른 구성으로 전환하거나 특정 구성을 사용하여 명령어를 실행할 수 있습니다(--configuration
플래그 사용). 구성 전환을 자세히 알아보려면 아래의 구성 활성화 섹션을 참조하세요.
명령줄에서 구성을 확인하려면(사용 가능한 속성의 전체 목록 포함) gcloud topic configurations
를 실행하세요.
기본 구성
SDK를 처음 시작하면 default
라는 단일 구성이 제공됩니다. gcloud init
명령어를 실행하거나 gcloud config set
를 직접 실행하여 구성 속성을 설정할 수 있습니다.
예를 들어 스크립트 메시지 표시를 중지하려면 다음을 실행합니다.
gcloud config set disable_prompts true
다중 구성
단일 default
구성은 대다수의 사용 사례에 적합합니다. 하지만 추가 구성을 만들고 gcloud config configurations activate
를 사용하여 필요에 따라 구성을 전환할 수도 있습니다.
초기 default
구성은 편의를 위해 만들어진 것으로서 특별한 내용이 없습니다. 이 구성 및 다른 추가 구성의 이름을 원하는 대로 지정할 수 있습니다.
다음과 같은 경우에는 다중 구성이 유용합니다.
- 여러 프로젝트 사용: 프로젝트별로 구성을 만들고 필요에 따라 구성을 전환할 수 있습니다.
- 여러 승인 계정 사용
- 일반적으로 독립된 작업 수행: 예를 들어, 구성 1개를 사용하여 한 프로젝트에서는 Google App Engine 애플리케이션 작업을 수행하고 다른 프로젝트에서는 관련 없는 Compute Engine 인스턴스를 관리할 수 있습니다.
구성 만들기
구성을 만들려면 gcloud config configurations create
를 실행합니다.
gcloud config configurations create [NAME]
새 구성을 만든 후 활성화해야 사용할 수 있습니다.
구성 활성화
한 번에 여러 구성 중 1개의 구성만 활성화할 수 있습니다. 활성 구성은 해당 속성이 SDK 도구의 동작을 제어하는 구성입니다.
새 구성을 활성화하거나 새 활성 구성으로 전환하려면 gcloud config configurations activate
를 실행합니다.
gcloud config configurations activate [NAME]
gcloud config list
는 항상 활성 구성의 속성을 표시합니다.
단일 명령어 호출의 활성 구성을 변경하려면 어떠한 gcloud CLI 명령어에서든 --configuration
플래그를 사용하면 됩니다.
gcloud auth list --configuration=[CONFIGURATION_NAME]
현재 터미널에서 모든 명령어에 대한 활성 구성을 변경하려면, 사용하려는 구성 이름으로 환경 변수 CLOUDSDK_ACTIVE_CONFIG_NAME
을 설정하면 됩니다.
구성 전환 자동화
원활한 구성 변경을 위해 direnv 및 ondir과 같은 도구를 활용하여, 작업 디렉토리 전환 시 구성을 자동으로 전환할 수 있습니다.
이를 수행하는 한 가지 방법은 프로젝트의 루트 디렉토리에 있는 .envrc 파일에서 필요한 환경 변수(예: CLOUDSDK_ACTIVE_CONFIG_NAME
)를 설정하는 것입니다.
구성 나열
Cloud SDK 설치 구성을 나열하려면 gcloud config configurations list
를 실행합니다.
gcloud config configurations list
gcloud CLI가 구성을 나열하고 현재 활성화된 구성을 표시합니다.
NAME IS_ACTIVE ACCOUNT PROJECT DEFAULT_ZONE DEFAULT_REGION default False user@gmail.com example-project-1 us-east1-b us-east1 project-1 False user@gmail.com example-project-2 us-east1-c us-east1 project-2 True user@gmail.com example-project-3 us-east1-b us-east1
구성 속성 설정
활성 구성의 속성을 설정 및 설정 해제하려면 gcloud config set
와 gcloud config unset
를 실행합니다.
gcloud config set project [PROJECT]
gcloud config unset disable_usage_reporting
구성 속성 보기
구성 속성을 보려면 gcloud config configurations describe
를 실행합니다.
gcloud config configurations describe [NAME]
또는 활성 구성의 속성을 보려면 다음을 실행합니다.
gcloud config list
gcloud CLI가 다음과 같은 구성 속성을 보여줍니다.
is_active: false name: default properties: compute: region: us-east1 zone: us-east1-b core: account: user@google.com project: example-project
구성 삭제
구성을 삭제하려면 gcloud config configurations delete
를 실행합니다.
gcloud config configurations delete [NAME]
활성 구성은 삭제할 수 없습니다. 삭제하기 전에 다른 구성으로 전환해야 하는 경우에는 gcloud config configurations activate
를 사용합니다.
다음 단계
- 속성에 대해 자세히 알아보려면 SDK 속성을 참조하세요.