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

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 88.1 MB 3727f6aba95108cffa64448cef5db8b4981d4c48d821b4482dbffbdaef344ed1
    Linux 64비트

    (Arm)

    		 google-cloud-cli-linux-arm.tar.gz 61.0 MB 047768995ce95f525c8e5af805f3697238438b7f48f7b3c5e0a9c3bd0d661810
    Linux 32비트

    (x86)

    		 google-cloud-cli-linux-x86.tar.gz 61.1 MB 7130c90d3cdc635824c845cb6b65357890558abcfab2caab34272f13a32d24bb
    macOS 64비트

    (x86_64)

    		 google-cloud-cli-darwin-x86_64.tar.gz 61.2 MB 123c47e410a9b274cd8a95f243277e19a32a8153972e425b16cc442d621b46ba
    macOS 64비트

    (arm64)

    		 google-cloud-cli-darwin-arm.tar.gz 61.1 MB 502901c8d19c21b23803b33d5cedd417dcb16b12c918f162fb37e08c4be27d92
    macOS 32비트

    (x86)

    		 google-cloud-cli-darwin-x86.tar.gz 59.5 MB 20c480e5a0c92128dd67a6304dc143545ab0558054de77fecd1b85d1fcbf66f3
    Windows 64비트

    (x86_64)

    		 google-cloud-cli-windows-x86_64.zip 84.3 MB 01b091921d8691e4e206aad7e4001296d2afbd1a6906ca3c279e341de4b25b49
    Windows 64비트

    (x86_64), Python 포함

    		 google-cloud-sdk-575.0.1-windows-x86_64-bundled-python.zip 110.6 MB d30c2d3f8af76d7d684672762d402aee8904b01691c36f60d4ecece0f942d340
    Windows 32비트

    (x86)

    		 google-cloud-cli-windows-x86.zip 84.3 MB 5e1da0bc6afe58137a9728129a1a6f4be35c2b1902e3f704a51a12897891ad62
    Windows 32비트

    (x86), Python 포함

    		 google-cloud-sdk-575.0.1-windows-x86-bundled-python.zip 107.9 MB 0fe5d91dbba27277f68b669fb34bdb9bb1cbfda90b18243a9e46f1d9d8f6808f

  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>을 통해 바로 액세스할 수 있습니다.