구성은 Distributed Cloud CLI 속성을 조합하여 이름을 붙인 것입니다. 이러한 속성은 섹션으로 구성된 gdcloud CLI의 동작을 제어하는 키-값 쌍입니다.
일반적으로 구성에 저장되는 속성에는 조직 콘솔 URL 및 프로젝트 ID가 포함됩니다. 구성을 사용하면 이러한 설정과 기타 설정을 그룹으로 함께 정의하고 사용 설정할 수 있습니다.
구성은 사용자 구성 디렉터리에 저장됩니다. 일반적으로 Linux에서는 ~/.config/gdcloud, Mac에서는 $HOME/Library/Application Support/gdcloud, Windows에서는 %AppData%\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"
core:
organization_console_url: https://console.example.com
project: example-project
활성 구성에서 속성을 보려면 다음을 실행하세요.
gdcloud config list
구성 삭제
구성을 삭제하려면 다음을 실행하세요.
gdcloud config configurations delete NAME
활성 구성은 삭제할 수 없습니다. 삭제하기 전에 다른 구성으로 전환하려면 필요한 경우 gdcloud config configurations activate를 사용하세요.