Google Cloud SDK 설치

이 페이지에는 Cloud SDK 설치를 선택하고 유지하기 위한 안내가 포함되어 있습니다.

설치 안내

Linux
  1. Cloud SDK에는 Python이 필요합니다. 지원되는 버전은 Python 3(권장, 3.5~3.8) 및 Python 2(2.7.9 이상)입니다.

    python --version
    Python 인터프리터를 선택하고 구성하는 방법에 대한 자세한 내용은 gcloud topic startup를 참조하세요.
  2. 다음 중 하나를 다운로드합니다.
  3. 플랫폼 패키지 크기 SHA-256 체크섬
    Linux 64비트

    (x86_64)

    google-cloud-sdk-337.0.0-linux-x86_64.tar.gz 84.6MB 04835064bd1b015ad1f6797f2df5f7d8c47522b3d47d7c283d0b8b46c970309d
    Linux 32비트

    (x86)

    google-cloud-sdk-337.0.0-linux-x86.tar.gz 82.0MB f65981cf48a9d0993454d00b455b9d36a93ef6c45ba32dc228cff0645cb62cca

  4. 또는 명령줄에서 Linux 64비트 보관 파일을 다운로드하려면 다음을 실행합니다.

    curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-sdk-337.0.0-linux-x86_64.tar.gz

    32비트 보관 파일의 경우 다음을 실행합니다.

    curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-sdk-337.0.0-linux-x86.tar.gz
  5. 원하는 파일 시스템 위치(예: 홈 디렉터리)에 파일 콘텐츠 압축을 풉니다. 기존 설치를 대체하려면 기존 google-cloud-sdk 디렉터리를 삭제하고 동일한 위치에 보관 파일 압축을 풉니다.
  6. 선택사항. 설치 스크립트를 사용하여 PATH에 Cloud SDK 도구를 추가합니다. 또한 셸 및 사용 통계 수집에 명령어 완료 옵션을 선택할 수 있습니다.

    다음 명령어를 사용하여(마지막 단계에서 추출한 폴더의 루트에서) 스크립트를 실행합니다.

    ./google-cloud-sdk/install.sh
    
    이 경우 환경설정을 플래그로 제공하여 비대화형(예: 스크립트 사용)으로도 수행할 수 있습니다. 명령어는 다음과 같습니다.
    ./google-cloud-sdk/install.sh --help
    
    변경사항이 적용되도록 새 터미널을 엽니다.
  7. gcloud init을 실행하여 SDK를 초기화합니다.
  8. ./google-cloud-sdk/bin/gcloud init
    
  9. 선택사항. 구성요소 관리자를 사용하여 추가 구성요소를 설치합니다.
Debian/Ubuntu

패키지 콘텐츠

Debian 및 Ubuntu 시스템에서 Cloud SDK는 설치용 패키지 형식으로 제공됩니다. 이 패키지에는 gcloud, gcloud alpha, gcloud beta, gsutil, bq 명령어만 포함됩니다. gcloud 명령어를 사용하여 애플리케이션을 배포하는 데 필요한 kubectl 또는 App Engine 확장 프로그램은 포함되지 않습니다. 이러한 구성요소를 사용하려면 이 섹션의 뒷부분에 설명된 대로 별도로 설치해야 합니다.

기본 요건

Cloud SDK를 설치하기 전에 운영체제가 다음 중 하나인지 확인하세요.

설치
  1. 패키지 소스로 Cloud SDK 배포 URI를 추가합니다.
    echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list
    apt-transport-https가 설치되어 있는지 확인하세요.
    sudo apt-get install apt-transport-https ca-certificates gnupg
  2. Google Cloud 공개 키를 가져옵니다.
    curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key --keyring /usr/share/keyrings/cloud.google.gpg add -
  3. Cloud SDK를 업데이트하고 설치합니다.
    sudo apt-get update && sudo apt-get install google-cloud-sdk
    프롬프트 사용 중지 또는 연습 실행과 같은 추가 apt-get 옵션에 대해서는 apt-get 설명 페이지를 참조하세요.

    Docker 팁: Docker 이미지 내에 Cloud SDK를 설치하는 경우 단일 RUN 단계를 사용하세요.

    RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] http://packages.cloud.google.com/apt cloud-sdk main" | tee -a /etc/apt/sources.list.d/google-cloud-sdk.list && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | apt-key --keyring /usr/share/keyrings/cloud.google.gpg  add - && apt-get update -y && apt-get install google-cloud-sdk -y
          

  4. 필요한 경우 다음 추가 구성요소를 설치합니다.
    • google-cloud-sdk-app-engine-python
    • google-cloud-sdk-app-engine-python-extras
    • google-cloud-sdk-app-engine-java
    • google-cloud-sdk-app-engine-go
    • google-cloud-sdk-bigtable-emulator
    • google-cloud-sdk-cbt
    • google-cloud-sdk-cloud-build-local
    • google-cloud-sdk-datalab
    • google-cloud-sdk-datastore-emulator
    • google-cloud-sdk-firestore-emulator
    • google-cloud-sdk-pubsub-emulator
    • kubectl

    예를 들어 google-cloud-sdk-app-engine-java 구성요소는 다음과 같이 설치할 수 있습니다.

    sudo apt-get install google-cloud-sdk-app-engine-java
  5. 시작하려면 gcloud init를 실행합니다.
    gcloud init

Cloud SDK 버전 다운그레이드

VERSION123.0.0 형식인 특정 버전의 Cloud SDK로 되돌려야 할 경우에는 다음을 실행합니다. sudo apt-get update && sudo apt-get install google-cloud-sdk=123.0.0-0 최신 출시 버전 10개가 저장소에서 항상 제공됩니다.

Red Hat/Fedora/CentOS

패키지 콘텐츠

Cloud SDK는 Red Hat Enterprise Linux 7, Red Hat Enterprise Linux 8, Fedora 33, CentOS 7 및 8 시스템에 설치할 수 있는 패키지 형식으로 제공됩니다. 이 패키지에는 gcloud, gcloud alpha, gcloud beta, gsutil, bq 명령어만 포함됩니다. 이 섹션의 후반부에 설명된 대로 별도로 설치할 수 있는 gcloud 명령어를 사용하여 애플리케이션을 배포하는 데 필요한 kubectl 또는 App Engine 확장 프로그램은 포함되지 않습니다.

설치
  1. Cloud SDK 저장소 정보로 DNF를 업데이트합니다.
    sudo tee -a /etc/yum.repos.d/google-cloud-sdk.repo << EOM
    [google-cloud-sdk]
    name=Google Cloud SDK
    baseurl=https://packages.cloud.google.com/yum/repos/cloud-sdk-el7-x86_64
    enabled=1
    gpgcheck=1
    repo_gpgcheck=0
    gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg
           https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
    EOM
    
  2. Cloud SDK를 설치합니다.
    sudo dnf install google-cloud-sdk
  3. 필요한 경우 다음 추가 구성요소를 설치합니다
      .
    • google-cloud-sdk-app-engine-python
    • google-cloud-sdk-app-engine-python-extras
    • google-cloud-sdk-app-engine-java
    • google-cloud-sdk-app-engine-go
    • google-cloud-sdk-bigtable-emulator
    • google-cloud-sdk-cbt
    • google-cloud-sdk-cloud-build-local
    • google-cloud-sdk-datalab
    • google-cloud-sdk-datastore-emulator
    • google-cloud-sdk-firestore-emulator
    • google-cloud-sdk-pubsub-emulator
    • kubectl

    예를 들어 google-cloud-sdk-app-engine-java 구성요소는 다음과 같이 설치할 수 있습니다.

    sudo dnf install google-cloud-sdk-app-engine-java
  4. 시작하려면 gcloud init를 실행합니다.
    gcloud init

Cloud SDK 버전 다운그레이드

VERSION123.0.0 형식인 특정 버전의 Cloud SDK로 되돌려야 할 경우에는 다음을 실행합니다. sudo dnf downgrade google-cloud-sdk-VERSION 최신 출시 버전 10개가 저장소에서 항상 제공됩니다.

macOS
  1. Cloud SDK에는 Python이 필요합니다. 지원되는 버전은 Python 3(권장, 3.5~3.8) 및 Python 2(2.7.9 이상)입니다. 최신 버전의 macOS에는 Cloud SDK에 필요한 적절한 Python 버전이 포함되어 있습니다.

    그러나 Cloud SDK를 사용하여 Python 3을 설치하려면 번들 Python 설치를 제공하는 macOS 64비트를 선택하면 됩니다.

    현재 Python 버전을 확인하려면 다음을 실행합니다.

      python -V
      
    Python 인터프리터를 선택하고 구성하는 방법에 대한 자세한 내용은 gcloud topic startup를 참조하세요.
  2. 다음 중 하나를 다운로드합니다.
  3. 플랫폼 패키지 크기 SHA-256 체크섬
    macOS 64비트

    (x86_64)

    google-cloud-sdk-337.0.0-darwin-x86_64.tar.gz 85.1MB f9828404af0f166afbaf4d9f00e8c1fab0d3a54b5a7f7cda0e0402712508e522
    macOS 64비트

    (arm64)

    google-cloud-sdk-337.0.0-darwin-arm.tar.gz 85.0MB 54bb70d2eca27ac550a431abc10e9030f2a748703cfca18f86510f9bc7849d0c
    번들 Python이 포함된 macOS 64비트

    (x86_64)

    google-cloud-sdk-337.0.0-darwin-x86_64-bundled-python.tar.gz 127.0MB e6c0c8c7f360be118c9416e7d990d0c92c73a2894cb75219e73bd703b73812d1
    macOS 32비트

    (x86)

    google-cloud-sdk-337.0.0-darwin-x86.tar.gz 88.9MB ae70b48ed51c4a025f606842213e7aaa7f40ada9d17df5578f8a7cb2383806a2

    1. 파일 시스템의 임의 위치(예: 홈 디렉터리)에 보관 파일 압축을 풉니다. macOS에서는 다운로드된 .tar.gz 보관 파일을 원하는 위치에서 열어 압축을 풀 수 있습니다.

      기존 설치를 대체하려면 기존 google-cloud-sdk 디렉터리를 삭제하고 동일한 위치에 보관 파일 압축을 풉니다.

    2. 선택사항. 설치 스크립트를 사용하여 PATH에 Cloud SDK 도구를 추가합니다. 또한 셸 및 사용 통계 수집에 명령어 완료 옵션을 선택할 수 있습니다.

      다음 명령어를 사용하여(마지막 단계에서 추출한 폴더의 루트에서) 스크립트를 실행합니다.

      ./google-cloud-sdk/install.sh
      
      이 경우 환경설정을 플래그로 제공하여 비대화형(예: 스크립트 사용)으로도 수행할 수 있습니다. 명령어는 다음과 같습니다.
      ./google-cloud-sdk/install.sh --help
      
      스크린 리더 모드가 설정된 상태에서 설치 스크립트를 실행하려면 다음 안내를 따르세요.
      ./google-cloud-sdk/install.sh --screen-reader=true
      
      변경사항이 적용되도록 새 터미널을 엽니다.
    3. gcloud init을 실행하여 SDK를 초기화합니다.
    4. ./google-cloud-sdk/bin/gcloud init
      
    5. 선택사항. 구성요소 관리자를 사용하여 추가 구성요소를 설치합니다.
Windows
  1. Cloud SDK 설치 프로그램을 다운로드합니다.

    또는 PowerShell 터미널을 열고 다음 PowerShell 명령어를 실행합니다.

    (New-Object Net.WebClient).DownloadFile("https://dl.google.com/dl/cloudsdk/channels/rapid/GoogleCloudSDKInstaller.exe", "$env:Temp\GoogleCloudSDKInstaller.exe")
    
    & $env:Temp\GoogleCloudSDKInstaller.exe
          

  2. 설치 프로그램을 실행하고 안내 메시지를 따릅니다. 설치 프로그램 서명자는 Google LLC입니다.

    스크린 리더 모드를 사용 설정하려면 더 간편한 스크린 리더 환경이 제공되는 스크린 리더 모드 사용 설정 옵션을 선택합니다. Cloud SDK 스크린 리더 환경에 관한 자세한 내용은 접근성 기능 가이드를 참조하세요.

    스크린 리더 모드를 사용 설정하는 체크박스가 표시된 Windows용 Google Cloud SDK 설정 시작 대화상자

  3. Cloud SDK에는 Python이 필요합니다. 지원되는 버전은 Python 3(권장, 3.5~3.8) 및 Python 2(2.7.9 이상)입니다.

    설치 프로그램은 필요한 Python 버전을 포함하여 필요한 모든 종속 항목을 설치합니다. Cloud SDK는 현재 Python 3을 기본적으로 사용하지만 필요한 경우 '번들 Python 설치' 옵션을 선택 해제하여 기존 Python 설치를 사용할 수 있습니다.

  4. 설치가 완료되면 설치 프로그램은 몇 가지 옵션을 제공합니다.

    Windows installer prompts

    다음 항목이 선택되었는지 확인합니다.

    • Google Cloud SDK 셸 시작
    • gcloud init 실행

    설치 프로그램이 터미널 창을 시작하고 gcloud init 명령어를 실행합니다.

  5. 기본 설치에는 gcloud 명령어를 사용하여 애플리케이션을 배포하는 데 필요한 App Engine 확장 프로그램이 포함되지 않습니다. 이러한 구성요소는 Cloud SDK 구성요소 관리자를 사용하여 설치할 수 있습니다.
문제 해결 팁:
  • 버전 274.0.0을 설치한 후 Cloud SDK를 실행하지 못하는 경우 이 추적 버그에서 최신 해결 방법을 참조하세요.
  • find 명령어가 인식되지 않아 설치에 실패하는 경우 find가 들어 있는 폴더를 포함하도록 PATH 환경 변수가 설정되어 있는지 확인합니다. 일반적으로는, C:\WINDOWS\system32;입니다.
  • Cloud SDK를 방금 제거한 경우 Cloud SDK를 다시 설치하기 전에 시스템을 재부팅해야 합니다.

선택사항: 최신 Google Cloud 클라이언트 라이브러리 설치

지원되는 언어로 Cloud 클라이언트 라이브러리를 다운로드할 수 있습니다.

기타 설치 옵션

개발 요구에 따라 권장되는 설치 대신 다른 방법으로 Cloud SDK를 설치할 수 있습니다.

  • 스크립트와 함께 Cloud SDK를 사용하거나 지속적 통합/배포를 수행하는 경우 특정 버전의 Cloud SDK의 비대화형 설치를 위해 버전이 지정된 보관 파일을 다운로드합니다.
  • Cloud SDK를 Docker 이미지로 실행해야 하는 경우 Cloud SDK 최신 출시 버전 또는 특정 버전용 Cloud SDK Docker 이미지를 사용합니다.
  • Ubuntu를 실행하고 자동 업데이트를 선호하나요? 스냅 패키지를 사용하여 Cloud SDK를 설치합니다.
  • Windows 및 macOS 대화형 설치와 다른 모든 사용 사례의 경우, 대화형 설치 프로그램을 실행하여 Cloud SDK의 최신 출시 버전을 설치합니다.

제품 구성

위의 모든 설치 방법은 gcloud, gsutil, bq 명령줄 도구를 포함한 기본 Cloud SDK 구성요소를 설치합니다.

gcloud components install 명령어를 사용하거나 적절한 deb 또는 RPM 패키지를 설치하여 추가 구성요소를 설치할 수 있습니다.

설치 관리

Cloud SDK를 설치한 후 gcloud components 명령어 그룹의 명령어를 사용하여 설치를 관리할 수 있습니다. 여기에는 설치된 구성요소 보기, 구성요소 추가 및 삭제, 새 버전의 Cloud SDK로 업그레이드(또는 특정 버전으로 다운그레이드)가 포함됩니다.

이전 버전의 Cloud SDK

이전 버전의 Cloud SDK로 되돌아가야 할 경우, 이 보관 파일에서 사용 가능한 모든 이전 출시 버전을 찾을 수 있습니다.

직접 사용해 보기

Google Cloud를 처음 사용하는 경우 계정을 만들고 Google 제품의 실제 성능을 평가해 보세요. 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.

무료로 시작하기