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

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.3MB a9561d76ee0fcbceff4caa8dc84376a5b1586d1bd25cc7f89f29fdb2a4e92ed4
    Linux 64비트

    (Arm)

    		 google-cloud-cli-linux-arm.tar.gz 61.1 MB 8bf879c65b2ca542150943e17b74ea41a006e900cb23283831476eeb4ced4544
    Linux 32비트

    (x86)

    		 google-cloud-cli-linux-x86.tar.gz 61.2 MB 1f0f69ad802e3e945745fa2976e3753d5055bebc71cc8d100efd12d5e10af977
    macOS 64비트

    (x86_64)

    		 google-cloud-cli-darwin-x86_64.tar.gz 61.3 MB ad36a0750439eeaf15d8c2fb16720d4874a1713539de08271a3d1db9df6c1634
    macOS 64비트

    (arm64)

    		 google-cloud-cli-darwin-arm.tar.gz 61.2 MB dd88182311d3936c2b6fc7cf315db82d56e2a98c7f4b2d89a12c74b897eb6ff0
    macOS 32비트

    (x86)

    		 google-cloud-cli-darwin-x86.tar.gz 59.6 MB 33a8cc483ecbbb87697ae6b6094763229697dc356d67cd06dec45b6cc58e417d
    Windows 64비트

    (x86_64)

    		 google-cloud-cli-windows-x86_64.zip 84.2MB 2d21145d1b912840d3ca5934712cda38da98dc4a1681460d5fb5091f21db1209
    Windows 64비트

    (x86_64), Python 포함

    		 google-cloud-sdk-576.0.0-windows-x86_64-bundled-python.zip 110.5MB fd7b7525caa459b299e1add5b93256c77b25714471b035193a9daf845cbd62b8
    Windows 32비트

    (x86)

    		 google-cloud-cli-windows-x86.zip 84.1MB be37dcd69316dea598a8c6a1516ce9752ffd394deeb7c9e0d43cbe88164446fc
    Windows 32비트

    (x86), Python 포함

    		 google-cloud-sdk-576.0.0-windows-x86-bundled-python.zip 107.7MB 667abc8875a6bec8c775d7060c290d0527852ecf9990fe30a8194626e466230f

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