이 문서에서는 Google Distributed Cloud (GDC) 에어 갭 환경에서 gdcloud CLI를 다운로드하는 방법을 설명합니다. GDC는 다음과 같은 다양한 사용 사례에 맞는 여러 gdcloud CLI 번들 옵션을 제공합니다.
- 플랫폼: 로컬 환경에 해당하는 운영체제 (OS) 및 아키텍처를 선택합니다.
- GDC 버전: GDC 패치 버전에 해당하는 gdcloud CLI의 바이너리 버전을 선택합니다. 사용 가능한 최신 버전을 사용하는 것이 좋지만 특정 사용 사례에 맞게 보관처리된 버전을 다운로드할 수 있습니다.
유형: 필요에 따라 번들 유형을 선택합니다.
Full번들 유형에는 선택한 플랫폼에 지원되는 모든 gdcloud CLI 명령어가 포함됩니다.Lite번들 유형에는 더 작은 다운로드 크기를 제공하기 위해Full번들의 gdcloud CLI 명령어 하위 집합이 포함되어 있습니다.Full및Lite번들 보관 파일에는 모두storage-cli-dependencies와 같은 구성요소를 설치하기 위한bin/component_bundles/디렉터리가 포함되어 있습니다. 추출된 번들 디렉터리 외부에 복사된 독립형 gdcloud CLI 바이너리에는 구성요소 번들이 포함되지 않으며gdcloud components install를 실행할 수 없습니다.
사용 가능한 gdcloud CLI 번들을 사용하면 원하는 대로 CLI를 유연하게 실행할 수 있습니다. 자세한 내용은 사용 가능한 gdcloud CLI 번들을 참조하세요.
이 문서는 에어 갭 하드웨어 및 소프트웨어 워크플로에 전용 명령줄 인터페이스 도구를 사용해야 하는 GDC에서 작업하는 모든 잠재고객 그룹을 대상으로 합니다. 자세한 내용은 GDC 에어 갭 문서 대상을 참조하세요.
시작하기 전에
활성 GDC 환경에 대한 네트워크 액세스 권한이 있고 GDC 콘솔 URL (호스트 이름)을 알고 있는지 확인합니다. Google Cloud CLI와 달리 gdcloud CLI는 공개적으로 다운로드할 수 없습니다. GDC 콘솔에서 직접 번들을 다운로드합니다. 이 URL이 없으면 인프라 운영자 또는 플랫폼 관리자에게 문의하세요.
조직 외부의 특정 CIDR에서 아티팩트 레지스트리로의 트래픽을 허용하도록 조직 네트워크 정책을 구성합니다.
OrganizationNetworkPolicy리소스 구성에서 서비스all를 사용합니다.
gdcloud CLI 다운로드
GDC 콘솔에서 시스템에 gdcloud CLI 번들을 다운로드합니다.
로그인하고 GDC 시작 페이지에 액세스합니다.
CLI로 연결 섹션으로 이동합니다.

CLI 번들 다운로드를 클릭합니다.
관심 있는 지원 플랫폼을 선택합니다.

선택한 플랫폼에 해당하는 유형과 버전을 선택합니다.
다운로드를 클릭하여 gdcloud CLI 번들을 로컬 환경에 다운로드합니다. 또는 명령줄에서 다운로드를 시작하려면 번들 URL 복사를 선택하여 다운로드 URL을 복사할 수 있습니다.
gdcloud CLI 번들 추출
다운로드한 gdcloud CLI 번들의 콘텐츠를 파일 시스템의 원하는 위치에 추출합니다. bin/gdcloud가 bin/component_bundles/에서 구성요소 보관 파일을 찾을 수 있도록 추출된 google-distributed-cloud-hosted-cli 디렉터리를 그대로 유지합니다.
기존 설치를 대체하려면 기존 google-distributed-cloud-hosted-cli 디렉터리를 삭제하고 동일한 위치에 보관 파일 압축을 풉니다.
번들을 추출합니다.
tar -xf BUNDLE_PATH/CLI_TAR_FILE다음을 바꿉니다.
BUNDLE_PATH: gdcloud CLI 번들의 경로입니다. 번들 다운로드 경로가 의도적으로 변경되지 않는 한 기본 경로는~/Downloads입니다.CLI_TAR_FILE: 다운로드한 gdcloud CLI tar 파일의 이름입니다(예:gdcloud_cli_windows_amd64.tar.gz).