구성은 Distributed Cloud CLI 속성을 조합하여 이름을 붙인 것입니다. 이러한 속성은 섹션으로 구성된 gdcloud CLI의 동작을 제어하는 키-값 쌍입니다.
일반적으로 구성에 저장되는 속성에는 조직 콘솔 URL과 프로젝트 ID가 포함됩니다. 구성을 통해 이러한 속성 및 기타 설정을 그룹으로 정의하고 사용할 수 있습니다.
구성 파일은 사용자 구성 디렉터리에 저장되며, 일반적으로 macOS 및 Linux에서는 ~/.config/gdcloud입니다. 또한 구성 디렉터리에 쓰기가 사용 설정되어 있어야 합니다.
구성 파일이 여러 개인 경우 구성을 전환하거나 --configuration 플래그를 사용하여 특정 구성을 사용하여 명령어를 실행할 수 있습니다. 구성 전환에 대해 자세히 알아보려면 구성 활성화 섹션을 참고하세요.
명령줄에서 구성과 사용 가능한 속성 및 해당 섹션의 전체 목록을 확인하려면 gdcloud topic
configurations를 실행하세요.
기본 구성
gdcloud CLI는 처음에 default라는 단일 구성을 만듭니다. gdcloud
init 명령어를 실행하거나 gdcloud config set를 직접 실행하여 구성에서 속성을 설정할 수 있습니다.
다중 구성
단일 default 구성은 대다수의 사용 사례에 적합합니다. 하지만 gdcloud config configurations activate를 사용하여 추가 구성을 만들고 필요에 따라 구성을 전환할 수도 있습니다. 초기 default 구성은 편의를 위해 만들어진 것으로서 사용하지 않아도 됩니다. 이 구성 및 다른 추가 구성의 이름을 원하는 대로 지정할 수 있습니다.
다음과 같은 경우에는 다중 구성이 유용합니다.
- 여러 프로젝트 사용: 프로젝트별로 구성을 만들고 필요에 따라 구성을 전환할 수 있습니다.
- 여러 조직 콘솔 URL 사용
- 일반적으로 독립된 작업 수행: 예를 들어, 구성 1개를 사용하여 한 프로젝트에서는 서비스 A 작업을 수행하고 다른 프로젝트에서는 관련 없는 서비스 B를 관리할 수 있습니다.
구성 만들기
구성을 만들려면 다음을 실행합니다.
gdcloud config configurations create NAME
새 구성을 만든 후 활성화해야 사용할 수 있습니다.
구성 활성화
한 번에 여러 구성 중 1개의 구성만 활성화할 수 있습니다. 활성 구성은 해당 속성이 gdcloud CLI의 동작을 제어하는 구성입니다.
새 구성을 활성화하거나 새 활성 구성으로 전환하려면 다음을 실행합니다.
gdcloud config configurations activate NAME
gdcloud config list는 항상 활성 구성의 속성을 표시합니다.
단일 명령어 호출의 활성 구성을 변경하려면 gdcloud CLI 명령어에 --configuration 플래그를 적용하세요.
gdcloud auth print-identity-token --configuration=CONFIGURATION
구성 나열
gdcloud CLI의 구성을 나열하려면 다음을 실행합니다.
gdcloud config configurations list
gdcloud CLI가 구성을 나열하고 활성화된 구성을 표시합니다.
NAME ISACTIVE PROPERTIES.CORE.PROJECT PROPERTIES.CORE.ORGANIZATIONCONSOLEURL
default False example-project-default https://console.default-org.example.com
config-project-1 False example-project-1 https://console.org-1.example.com
config-project-2 False example-project-2 https://console.org-2.example.com
구성 속성 설정
활성 구성의 속성을 설정 및 해제하려면 다음을 실행합니다.
gdcloud config set project PROJECT
구성 속성 보기
구성의 속성을 보려면 다음을 실행합니다.
gdcloud config configurations describe NAME
gdcloud CLI가 구성 속성을 인쇄합니다.
is_active: false
name: default
properties:
accessibility:
screen_reader: "false"
auth:
login_config_cert_path: /tmp/root-web-tls-ca.cert
core:
organization_console_url: https://console.example.com
project: example-project
활성 구성의 속성을 보려면 다음을 실행합니다.
gdcloud config list
구성 삭제
구성을 삭제하려면 다음을 실행합니다.
gdcloud config configurations delete NAME
활성 구성은 삭제할 수 없습니다. 삭제하기 전에 다른 구성으로 전환하려면 필요한 경우 gdcloud config configurations activate를 사용합니다.