Google Cloud SDK 문서

Google Cloud SDK는 Google Cloud Platform에서 호스팅되는 리소스와 애플리케이션을 관리하는 도구 모음으로, gcloud, gsutil, bq 명령줄 도구가 포함됩니다. gcloud 명령줄 도구는 Cloud SDK와 함께 다운로드됩니다. gcloud CLI에 대한 종합 가이드는 gcloud 명령줄 도구 개요에서 볼 수 있습니다.

또한 gcloud CLI 참조에는 gcloud CLI의 모든 기능이 수록되어 있습니다.

최신 Cloud SDK 버전 설치(245.0.0)

Linux
  1. 출시 버전 번호가 Python 2.7.9 이상인 Python 2가 시스템에 설치되어 있는지 확인합니다. 다른 버전의 Python도 설치된 상태로 둘 수 있습니다.

    python2 --version
  2. 다음 중 하나를 다운로드합니다.
  3. 플랫폼 패키지 크기 SHA-256 체크섬
    Linux 64비트

    (x86_64)

    google-cloud-sdk-245.0.0-linux-x86_64.tar.gz 27.0MB bdc66eea38a78ae5b00c7caaa4848965ef63bce73d4374fc806f94ddfd34f10f
    Linux 32비트

    (x86)

    google-cloud-sdk-245.0.0-linux-x86.tar.gz 26.6MB 3b836613d17d7f425464aaf231cf6163fd15cf353b40be47ad6a5fcc192c5183
  4. 원하는 파일 시스템 위치에 파일 콘텐츠 압축을 풉니다. 기존 설치를 바꾸려면 기존 google-cloud-sdk 디렉토리를 삭제하고 동일한 위치에 파일 압축을 풉니다.
  5. (선택사항) 설치 스크립트를 사용하여 경로에 Cloud SDK 도구를 추가합니다. 또한 셸 및 사용 통계 수집을 위한 명령어 완료 옵션을 선택할 수 있습니다. 이 명령어를 사용하여 스크립트를 실행합니다.
    ./google-cloud-sdk/install.sh
    
    변경사항이 적용되도록 새 터미널을 엽니다.
  6. gcloud init을 실행하여 SDK를 초기화합니다.
  7. ./google-cloud-sdk/bin/gcloud init
    
  8. (선택사항) 구성요소 관리자를 사용하여 추가 구성요소를 설치합니다.
Debian/Ubuntu

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

아직 서비스가 종료되지 않은 모든 공식 Ubuntu 출시 버전과 Wheezy 이후의 Debian 공개 출시 버전용 Debian/Ubuntu 패키지에서 Cloud SDK를 설치할 수 있습니다.

참고: Google Compute Engine에서 인스턴스를 사용하는 경우 Cloud SDK가 기본적으로 설치됩니다. 아래 안내에 따라 계속 Cloud SDK를 직접 설치할 수 있습니다.

  1. 올바른 배포를 위해 환경 변수를 만듭니다.
    export CLOUD_SDK_REPO="cloud-sdk-$(lsb_release -c -s)"
  2. 패키지 소스로 Cloud SDK 배포 URI를 추가합니다.
    echo "deb http://packages.cloud.google.com/apt $CLOUD_SDK_REPO main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list
    참고: apt-transport-https를 설치한 경우 이 단계에서 'http' 대신 'https'를 사용할 수 있습니다.
  3. Google Cloud 공개 키를 가져옵니다.
    curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -
    문제해결 팁: 키가 만료되어 최신 업데이트를 가져올 수 없는 경우에는 최신 apt-get.gpg 키 파일을 가져오세요.
  4. Cloud SDK를 업데이트하고 설치합니다.
    sudo apt-get update && sudo apt-get install google-cloud-sdk
    참고: 프롬프트 또는 연습 실행 중지 등의 추가 apt-get 옵션의 경우 apt-get 설명 페이지를 참조하세요.
  5. 필요한 경우 다음 추가 구성요소를 설치합니다.
    • 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-datalab
    • google-cloud-sdk-datastore-emulator
    • google-cloud-sdk-pubsub-emulator
    • google-cloud-sdk-cbt
    • google-cloud-sdk-cloud-build-local
    • google-cloud-sdk-bigtable-emulator
    • kubectl

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

    sudo apt-get install google-cloud-sdk-app-engine-java
  6. gcloud init을 실행하여 시작합니다.
    gcloud init
Red Hat/CentOS

Red Hat Enterprise Linux 7 및 CentOS 7 시스템에서 Cloud SDK는 설치용 패키지 형식으로 제공됩니다. 이 패키지에는 gcloud, gcloud alpha, gcloud beta, gsutil, bq 명령어만 포함됩니다. kubectl 명령어를 사용하여 애플리케이션을 배포하는 데 필요한 gcloud 또는 App Engine 확장 프로그램은 포함되지 않으며 별도로 설치해야 합니다.

참고: Google Compute Engine에서 인스턴스를 사용하는 경우 Cloud SDK가 기본적으로 설치됩니다.

  1. Cloud SDK 저장소 정보로 yum을 업데이트합니다.
    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=1
    gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg
           https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
    EOM
    

    중요: 표시된 바와 같이 gpgkey의 두 번째 줄을 들여 써야 합니다.

  2. Cloud SDK를 설치합니다.
    yum install google-cloud-sdk
    참고: 프롬프트 또는 테스트 실행 중지 등의 추가 yum 옵션의 경우, yum 설명 페이지를 참조하세요.
  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-datalab
    • google-cloud-sdk-datastore-emulator
    • google-cloud-sdk-cbt
    • google-cloud-sdk-cloud-build-local
    • google-cloud-sdk-pubsub-emulator
    • kubectl

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

    yum install google-cloud-sdk-app-engine-java
  4. gcloud init을 실행하여 시작합니다.
    gcloud init
macOS
  1. 최신 버전의 macOS에는 Google Cloud SDK에 필요한 적합한 버전의 Python이 포함되어 있습니다. Cloud SDK에는 출시 번호 Python 2.7.9 이상의 Python 2가 필요합니다. 추가로 설치된 Python 인터프리터는 Google Cloud SDK 설치와 충돌을 일으키지 않습니다.
  2. python -V
    
  3. 다음 중 하나를 다운로드합니다.
  4. 플랫폼 패키지 크기 SHA-256 체크섬
    macOS 64비트

    (x86_64)

    google-cloud-sdk-245.0.0-darwin-x86_64.tar.gz 19.6MB 78cbe75ebf17599217d4a6cb81897897faa72d6e5e0c515a8532c8827de59af7
    macOS 32비트

    (x86)

    google-cloud-sdk-245.0.0-darwin-x86.tar.gz 19.6MB 3ca3575f19a21a589a75d2ed3c2a62af7d1be12482ad4cf3efba87e071977a61
  5. 원하는 파일 시스템 위치에 파일 콘텐츠 압축을 풉니다. 기존 설치를 바꾸려면 기존 google-cloud-sdk 디렉토리를 삭제하고 동일한 위치에 파일 압축을 풉니다.
  6. (선택사항) 설치 스크립트를 사용하여 경로에 Cloud SDK 도구를 추가합니다. 또한 셸 및 사용 통계 수집을 위한 명령어 완료 옵션을 선택할 수 있습니다. 이 명령어를 사용하여 스크립트를 실행합니다.
    ./google-cloud-sdk/install.sh
    
    변경사항이 적용되도록 새 터미널을 엽니다.
  7. gcloud init을 실행하여 SDK를 초기화합니다.
  8. ./google-cloud-sdk/bin/gcloud init
    
  9. (선택사항) 구성요소 관리자를 사용하여 추가 구성요소를 설치합니다.
Windows
  1. Cloud SDK 설치 프로그램을 다운로드합니다. 설치 프로그램 서명자는 Google Inc.입니다.

  2. 설치 프로그램을 실행하고 안내 메시지를 따릅니다.

    Cloud SDK는 릴리스 버전이 Python 2.7.9 이상인 Python 2가 필요합니다. 설치 프로그램은 기본적으로 필요한 Python 버전을 포함하여 필요한 모든 종속 항목을 설치합니다. 이미 Python 2.xy가 설치되어 있고 기존 설치를 사용하려는 경우 번들 Python 설치 옵션을 선택 해제할 수 있습니다.

  3. 설치가 완료된 후 다음 옵션을 허용합니다.

    • Cloud SDK 셸 시작
    • gcloud init 실행

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

  5. 기본 설치에는 gcloud 명령어를 사용하여 애플리케이션을 배포하는 데 필요한 App Engine 확장 프로그램이 포함되지 않습니다. 이러한 구성요소는 Cloud SDK 구성요소 관리자를 사용하여 설치할 수 있습니다.

참고: Windows Server를 실행하는 Google Compute Engine 인스턴스에서는 Internet Explorer가 보안 강화 구성으로 설정됩니다. 이렇게 설정되면 위의 설치 프로그램이 실행되지 않습니다. 먼저 보안 강화 구성을 사용 중지하고 Internet Explorer를 다시 시작한 다음 설치 프로그램을 실행하세요. Windows 도움말 및 지원을 열고 'IE ESC'를 검색하여 Windows Server 인스턴스에서 보안 강화 구성을 사용 중지하는 방법을 확인하세요.

최신 Google Cloud 클라이언트 라이브러리 설치

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

추가 정보

이 페이지가 도움이 되었나요? 평가를 부탁드립니다.

다음에 대한 의견 보내기...

Cloud SDK 문서