버전이 지정된 보관 파일에서 설치

gcloud CLI는 각 출시 버전마다 다운로드 가능하며 버전이 지정된 보관 파일을 제공합니다. 버전이 지정된 각 보관 파일의 google-cloud-sdk 디렉터리에 gcloud CLI의 독립적인 설치 파일이 포함되어 있으며, 파일 시스템의 모든 위치로 복사할 수 있습니다.

버전이 지정된 보관 파일에서 설치하기 위한 최상의 사용 방법

버전이 지정된 보관 파일은 대화형 방식이 아닌 특정 버전의 gcloud CLI 설치를 위해 설계되었으며 다음 경우에 유용합니다.

  • 특정 버전의 gcloud CLI가 필요합니다. 예를 들면 다음과 같습니다.

    • gcloud CLI 또는 다른 gcloud CLI 구성요소로 스크립팅하고 있으며 gcloud CLI 업데이트로 인해 스크립트가 중단되지 않도록 하려 합니다.
    • CI(지속적 통합) 프로세스 또는 프로덕션 시스템의 일부로 gcloud CLI를 사용하고 있으며 시스템의 요소가 호환되도록 종속 항목을 관리하려 합니다.
    • 동기화되어야 하는 많은 머신에 gcloud CLI 자동 배포를 수행하고 있습니다.
    • 인터넷에 액세스하기 위해 추가 구성이 필요한 프록시 또는 방화벽을 사용하고 있습니다.

  • 대화형 설치를 수행하지 않으려는 경우

설치 안내

버전이 지정된 보관 파일로부터 gcloud CLI의 최신 출시 버전을 설치하는 방법은 다음과 같습니다.

  1. OS가 실행 중인 버전(64비트 또는 32비트)을 확인합니다.

    • Linux/macOS: 명령줄에서 getconf LONG_BIT 실행
    • Windows: 제어판 > 시스템 > 시스템 유형

    또한 macOS의 경우 머신 하드웨어 이름(x86_64, arm64 또는 x86)을 확인하려면 uname -m을 실행합니다.

  2. 해당 버전과 호환되는 적절한 보관 파일을 다운로드합니다.

    플랫폼 패키지 크기 SHA256 체크섬
    Linux 64비트

    (x86_64)

    		 google-cloud-cli-linux-x86_64.tar.gz 149.9 MB 30cf75811fd60752cecf01a6e51b3b660d55194f4a585d48dbf4faeb2302898e
    Linux 64비트

    (Arm)

    		 google-cloud-cli-linux-arm.tar.gz 56.5 MB 0e0e017961f0c9bb1bce80b5b2b92e64df1b78eb5380868a7153a45f429e0e7c
    Linux 32비트

    (x86)

    		 google-cloud-cli-linux-x86.tar.gz 56.5 MB d8f06879fe5fead20fd9ef498300f0e8f3069e25c40fe732e268a656cc1adc5e
    macOS 64비트

    (x86_64)

    		 google-cloud-cli-darwin-x86_64.tar.gz 56.6 MB e4b34d0a089f0afb13fab79b7a02b7c8b4e4018dad0b6e02752dd250fa946b9c
    macOS 64비트

    (arm64)

    		 google-cloud-cli-darwin-arm.tar.gz 56.5 MB f2b1d74fe8a4997f9e699f349282f69a23f11e9e37eb9d48e9d164f7a08ecd1d
    macOS 32비트

    (x86)

    		 google-cloud-cli-darwin-x86.tar.gz 55.0 MB 4e650d333d6326516ca4b83077a28c7d2dc5aa4d4eb2448fc53bff8518a86d32
    Windows 64비트

    (x86_64)

    		 google-cloud-cli-windows-x86_64.zip 77.6MB 6487d39f7022cf75c8985ac7b9aa5e09478b3198845a965c07eaf35e8d43a89e
    Windows 64비트

    (x86_64), Python 포함

    		 google-cloud-sdk-532.0.0-windows-x86_64-bundled-python.zip 101.0MB 32563bc86c10d0cc8ce3ec10757843ab2f853808b811ad9884385da6548aec17
    Windows 32비트

    (x86)

    		 google-cloud-cli-windows-x86.zip 77.5 MB 6aef336548d1063f5a1b5dbfae899bcbc731c26d8cc68b6ffb02524af4522c9e
    Windows 32비트

    (x86), Python 포함

    		 google-cloud-sdk-532.0.0-windows-x86-bundled-python.zip 98.6MB 08793e8790aaa20a91d35ac5459b2a930f811ee104d16eb010344e0c69fc550a

  3. 원하는 파일 시스템 위치에 파일 콘텐츠 압축을 풉니다. 이 위치는 홈 폴더일 수 있습니다.

  4. gcloud CLI 도구를 경로에 추가하려면 압축을 푼 폴더의 루트에서 설치 스크립트를 실행합니다. 또한 이 스크립트를 실행하면 bash 셸(Linux 및 macOS만 해당)에서 명령어 완성을 사용 설정하고 사용 보고를 사용 설정하기 위한 안내가 생성됩니다.

    • Linux 또는 macOS의 경우:

      ./google-cloud-sdk/install.sh

      스크린 리더 모드가 설정된 상태에서 설치 스크립트를 실행하려면 다음 안내를 따르세요.

      ./google-cloud-sdk/install.sh --screen-reader=true

    • Windows의 경우:

      .\google-cloud-sdk\install.bat

    설치를 비대화형으로 실행할 수 있는 플래그를 포함하여 이 스크립트에 전달할 수 있는 플래그 목록을 보려면 install.sh --help 또는 install.bat --help를 실행합니다.

  5. gcloud CLI를 초기화하려면 gcloud init를 실행합니다.

    • Linux 또는 macOS:

      ./google-cloud-sdk/bin/gcloud init

    • Windows:

      .\google-cloud-sdk\bin\gcloud init

이전 버전

gcloud CLI의 이전 버전은 Cloud Storage의 다운로드 보관 파일에서 제공됩니다. https://storage.googleapis.com/cloud-sdk-release/<archive_name>을 통해 바로 액세스할 수 있습니다.