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

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 e571c68f173e691c400d435b929d204f94b29a634e36d5ffcd97140e802bb385
    Linux 64비트

    (Arm)

    		 google-cloud-cli-linux-arm.tar.gz 61.0 MB 25ffb8bf0bef33924ae2f273a4043a70dd39f9df9c8e6ec5ac285dc73e381ba1
    Linux 32비트

    (x86)

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

    (x86_64)

    		 google-cloud-cli-darwin-x86_64.tar.gz 61.2 MB 12f5205cc7be8c1cdea4180c8a0d6b5f6e1d9a3dc033024bc6f2edc8dce489fb
    macOS 64비트

    (arm64)

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

    (x86)

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

    (x86_64)

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

    (x86_64), Python 포함

    		 google-cloud-sdk-575.0.0-windows-x86_64-bundled-python.zip 109.7 MB 47196c57123152ce99fe97a08381dc7cf94ae476ddbd240a92a585c9d9108d94
    Windows 32비트

    (x86)

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

    (x86), Python 포함

    		 google-cloud-sdk-575.0.0-windows-x86-bundled-python.zip 107.1 MB 22878520d72ac747613923a848fe7df082968c4b3d1b1697355fedea3300ccb1

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