gdcloud CLI 사용

gdcloud CLI는 Google Distributed Cloud (GDC) 에어갭 리소스를 만들고 관리하기 위한 도구 모음입니다. 이러한 도구를 사용하여 명령줄에서 또는 스크립트 및 자동화를 통해 일반적인 작업을 수행합니다. gdcloud CLI를 사용하면 인프라를 부트스트랩하고, 인증을 관리하고, 로컬 구성을 맞춤설정할 수 있습니다.

이 문서는 에어 갭 하드웨어 및 소프트웨어 워크플로를 관리하기 위해 GDC의 전용 CLI를 설정해야 하는 모든 대상 그룹을 대상으로 합니다. 자세한 내용은 GDC 오프라인 문서의 대상을 참고하세요.

시작하기 전에

  • GDC 콘솔에 액세스할 수 있는지 확인하고 조직의 URL을 기록합니다. 자세한 내용은 GDC 콘솔 액세스를 참고하세요.

  • 시스템의 신뢰할 수 있는 인증서 저장소에 설치된 인증 기관 (CA) 인증서가 있는지 확인합니다. 자세한 내용은 GDC 신뢰 번들 가져오기를 참고하세요.

  • 조직 외부의 특정 CIDR에서 아티팩트 레지스트리로 트래픽을 허용하는 조직 네트워크 정책이 있는지 확인합니다. 예를 들어 OrganizationNetworkPolicy 리소스에서 서비스 이름 all을 구성합니다. 자세한 내용은 조직 네트워크 정책 만들기를 참고하세요.

  • 기기에 브라우저가 설치되어 있는지 확인합니다.

gdcloud CLI 설정

gdcloud CLI를 설정하려면 다음 단계를 완료하세요.

  1. 브라우저에 조직의 전역 또는 영역 URL을 입력하여 GDC 콘솔을 엽니다.

  2. 홈페이지에서 CLI 번들 다운로드를 선택합니다.

  3. Linux 플랫폼과 GDC 환경에 해당하는 gdcloud CLI 번들 버전을 선택합니다.

    Linux가 아닌 플랫폼을 선택하는 경우 구성 단계가 약간 다를 수 있습니다. 일부 비 Linux gdcloud CLI 번들은 gdcloud 명령어의 일부만 제공합니다. 자세한 내용은 사용 가능한 gdcloud CLI 번들을 참고하세요.

  4. 다운로드를 클릭합니다.

  5. 기기에서 Downloads 폴더로 이동합니다.

    cd ~/Downloads

  6. gdcloud CLI 번들의 콘텐츠를 추출합니다.

    tar -xf ./gdcloud_cli.tar.gz

  7. 경로에 gdcloud CLI 번들을 추가합니다.

    eval echo 'export GDCLOUD_PATH=$(pwd)/google-distributed-cloud-hosted-cli' >> ~/.bashrc
echo 'export PATH="$GDCLOUD_PATH/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

  8. gdcloud CLI가 올바르게 설치되었는지 확인합니다.

    gdcloud version

    출력은 다음과 비슷합니다.

    gdcloud version: 1.15.0-gdch.380608

  9. gdcloud CLI를 초기화합니다.

    gdcloud init

  10. 프롬프트에 표시된 두 속성을 제공하여 초기화를 완료합니다.

    • organization_console_url: 현재 GDC 조직의 콘솔 URL입니다. 이 URL은 전역 또는 영역일 수 있습니다. 예를 들면 https://console.org-1.google.gdch.test/입니다.

    • project: GDC 프로젝트의 이름입니다. 기존 프로젝트가 없으면 default을 사용하세요.

    초기화 후 gdcloud CLI 구성을 업데이트하려면 gdcloud CLI 구성 관리를 참고하세요.

  11. gdcloud-k8s-auth-plugin 구성요소를 설치합니다.

    gdcloud components install gdcloud-k8s-auth-plugin

  12. gdcloud CLI로 인증하여 로그인합니다.

    gdcloud auth login

    브라우저로 리디렉션되어 신원을 선택하고 로그인합니다.

  13. gdcloud CLI 설정이 GDC 환경에 연결되어 있는지 확인합니다.

    gdcloud compute images list

    출력은 다음과 비슷합니다.

    METADATA.NAME               METADATA.NAMESPACE SPEC.OPERATINGSYSTEM.NAME SPEC.MINIMUMDISKSIZE
rocky-8-v20250809-gdch      vm-system          rocky-linux-8             12G
ubuntu-20.04-v20250809-gdch vm-system          ubuntu-2004               12G
ubuntu-22.04-v20250809-gdch vm-system          ubuntu-2204               12G
ubuntu-24.04-v20250809-gdch vm-system          ubuntu-2404               12G

다음 단계