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

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 150.5 MB 31000673c1f9e18ec7b38823748031c58949cb0479d36ede999ae8cad6097ae3
    Linux 64비트

    (Arm)

    		 google-cloud-cli-linux-arm.tar.gz 57.1 MB a1c1a88274e8bf11561771b9373b566cbb044f1cb3884e454625ec9449ea33f2
    Linux 32비트

    (x86)

    		 google-cloud-cli-linux-x86.tar.gz 57.1 MB 32ff2bea65cd5c79aa86b948219c1e861a0434cc99011f4d977c4a9810e595de
    macOS 64비트

    (x86_64)

    		 google-cloud-cli-darwin-x86_64.tar.gz 57.2 MB b24a11aa4f1816bff3122b3560c909c1eb7109bf8979821251d8bc5679582f10
    macOS 64비트

    (arm64)

    		 google-cloud-cli-darwin-arm.tar.gz 57.1 MB b4d2b8b63593ad226cf1c4da0667ffa4a9cb923bd41ec269e67891491aeb126a
    macOS 32비트

    (x86)

    		 google-cloud-cli-darwin-x86.tar.gz 55.7 MB 6e66bdc92029fd3a3856e6a9bc03f2799079184ff3fe436c7ade1ef1a8f03452
    Windows 64비트

    (x86_64)

    		 google-cloud-cli-windows-x86_64.zip 78.5MB 11d2dc9ec51c83370884bdb4b1a6cdf1955c0435e1ea1ee98062077eb2d9ec40
    Windows 64비트

    (x86_64), Python 포함

    		 google-cloud-sdk-543.0.0-windows-x86_64-bundled-python.zip 102.0MB b2c75454f4ad1ceb4b95dce1637a22be835dca0167285ebdc2f85aaf96dc693a
    Windows 32비트

    (x86)

    		 google-cloud-cli-windows-x86.zip 78.4 MB 044727ef05e7ae24e382b369984b28f59f09e9e04e989b9f45df68e2e9d5585c
    Windows 32비트

    (x86), Python 포함

    		 google-cloud-sdk-543.0.0-windows-x86-bundled-python.zip 99.6MB 91e699272c1aabd9109acd62a51f3b4c7c45ef0869bbeb6f5f00ac226c10ffbe

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