Cloud SDK 설치

이 페이지에는 Google Cloud SDK 다운로드 및 설치에 대한 안내가 포함되어 있습니다.

시스템 요구사항

Cloud SDK는 Linux, Mac OS X, Windows에서 실행되며 Python 2.7.x가 필요합니다. Cloud SDK와 함께 제공되는 일부 도구에는 추가 요구사항이 있습니다. 예를 들어 Google App Engine 개발용 자바 도구는 자바 1.7 이상이 필요합니다.

설치 옵션

다음 중 한 가지 방법으로 Cloud SDK를 설치합니다.

  • 이전 출시 버전을 포함해 모든 출시 버전의 버전이 지정된 보관 파일을 다운로드합니다.
  • 대화형 설치 프로그램을 실행하여 최신 출시 버전을 다운로드하고 설치합니다.
  • apt-get(Debian 및 Ubuntu만 해당)을 사용하여 최신 출시 버전을 다운로드하고 설치합니다.
  • yum(Red Hat 및 CentOS)을 사용하여 최신 출시 버전을 다운로드하고 설치합니다.

이러한 설치 방법으로 gcloud, gsutil, bq 명령줄 도구가 포함된 기본 Cloud SDK 구성요소가 설치됩니다. gcloud components install 명령어를 사용하거나 적절한 deb 또는 RPM 패키지를 설치하면 추가 구성요소를 설치할 수 있습니다.

버전이 지정된 보관 파일

Cloud SDK는 각 출시 버전마다 다운로드 가능하며 버전이 지정된 보관 파일을 제공합니다. 버전이 지정된 각 보관 파일의 google-cloud-sdk 디렉토리에 Cloud SDK의 독립적인 설치 파일이 포함되어 있으며 파일 시스템의 모든 위치로 복사할 수 있습니다.

버전이 지정된 보관 파일은 대화형 방식이 아닌 특정 버전의 Cloud SDK 설치를 위해 설계되었으며 다음 경우에 유용합니다.

  • 예를 들어 다음 경우에 특정 버전의 Cloud SDK가 필요합니다.

    • gcloud 또는 기타 Cloud SDK 구성요소 중 하나로 스크립팅하고 있으며 Cloud SDK 업데이트로 인해 스크립트가 중단되지 않도록 하고 싶습니다.

    • CI(지속적인 통합) 프로세스 또는 프로덕션 시스템의 일부로 Cloud SDK를 사용하고 있으며 시스템의 요소 간에 호환성이 있도록 종속 항목을 관리하고 싶습니다.

    • 서로 동기화되어야 하는 여러 머신에 Cloud SDK의 자동 배포를 수행하고 있습니다.

  • 대화형 설치를 수행하고 싶지 않습니다.

버전이 지정된 보관 파일로부터 Cloud SDK의 최신 출시 버전을 설치하는 방법은 다음과 같습니다.

  1. 다음 중 하나를 다운로드합니다.

    플랫폼 패키지 크기 SHA-256 체크섬
    Linux 64비트

    (x86_64)

    google-cloud-sdk-183.0.0-linux-x86_64.tar.gz 18.3MB 6e5c76999ff3f14621d26e3c76967dc4c43613344947ab42fcc764311642c898
    Linux 32비트

    (x86)

    google-cloud-sdk-183.0.0-linux-x86.tar.gz 17.9MB 943faf4b47049e29f9a67f6e56a473486373b50876d5aeb31651eb2e327d5572
    Mac OS X 64비트

    (x86_64)

    google-cloud-sdk-183.0.0-darwin-x86_64.tar.gz 14.4MB 605332cb305a04d377572d61063db88433862521f1aa4887d3b3fbfaaf1519a2
    Mac OS X 32비트

    (x86)

    google-cloud-sdk-183.0.0-darwin-x86.tar.gz 14.4MB b10d8c097d1501624eeaf01c72f036d1333fe7ef672c2a2fbeb49fb3a239950c
    Windows 64비트

    (x86_64)

    google-cloud-sdk-183.0.0-windows-x86_64.zip 91.4MB c855014fc5105cbfffbb014bfd50828061ba30605bbfd37af52b3706e7a8aacd
    Windows 64비트

    (x86_64), Python 포함

    google-cloud-sdk-183.0.0-windows-x86_64-bundled-python.zip 129.8MB b30c06b885653951c0ef4330138537d40b9ead61fb85a693a1f469331a837ece
    Windows 32비트

    (x86)

    google-cloud-sdk-183.0.0-windows-x86.zip 91.6MB 6c194acb87e2f3d6fddb2aa67aa547e23b4677e3831b327a2a6e7af201bb8796
    Windows 32비트

    (x86), Python 포함

    google-cloud-sdk-183.0.0-windows-x86-bundled-python.zip 125.9MB fbdb5beabdf0c74887a0c21f587e9f4bba3e2a9ab17dd32b24e28e7a7425f3e5

  2. 파일 시스템의 원하는 위치에 파일의 압축을 풉니다.

  3. (선택사항) 설치 스크립트를 실행하여 경로에 Cloud SDK를 추가합니다. 이 스크립트를 실행하면 bash 셸의 명령어 완료 사용 설정(Linux 및 Mac OS만 해당) 및 사용 보고 사용 설정에 대한 안내도 생성됩니다.

    • Linux 또는 Mac OS X

      ./google-cloud-sdk/install.sh
      

      PATH에 Cloud SDK 명령줄 도구를 추가하려면 프로필에 /your/gcloud/filepath/path.bash.inc를 소스로 추가해야 합니다. 또는 프로필에 /your/gcloud/filepath/completion.bash.inc를 소스로 추가하여 gcloud에 대한 셸 명령어 완료를 사용 설정합니다.

    • Windows의 경우:

      .\google-cloud-sdk\install.bat
      

    이 스크립트에 전달할 수 있는 플래그 목록을 보려면 install.sh --help 또는 install.bat --help를 실행합니다.

  4. gcloud init을 실행하여 SDK를 초기화합니다.

    ./google-cloud-sdk/bin/gcloud init
    

이전 버전

Cloud SDK의 이전 버전은 Google Cloud Storage의 보관 파일 다운로드에서 제공됩니다. https://storage.googleapis.com/cloud-sdk-release/<archive_name>을 통해 바로 액세스할 수 있습니다.

대화형 설치 프로그램

Cloud SDK는 지원되는 각 플랫폼별로 대화형 설치 프로그램도 제공합니다. 설치 프로그램을 사용하면 최신 버전의 Cloud SDK를 대화형 모드로 신속하게 다운로드하고 설치 및 설정할 수 있습니다. 설치 프로그램을 실행하면 Cloud SDK 구성요소를 다운로드한 후 로컬 시스템에 설치합니다. 또한 PATH에 Cloud SDK 구성요소를 추가하고 셸에서 명령어 완료를 사용 설정하는 등의 추가 설정 작업도 수행합니다.

Linux
  1. 명령 프롬프트에 다음을 입력합니다.
    curl https://sdk.cloud.google.com | bash
  2. 셸을 다시 시작합니다.
    exec -l $SHELL
  3. gcloud init을 실행하여 gcloud 환경을 초기화합니다.
    gcloud init
Mac OS X
  1. 명령 프롬프트에 다음을 입력합니다.
    curl https://sdk.cloud.google.com | bash
  2. 셸을 다시 시작합니다.
    exec -l $SHELL
  3. gcloud init을 실행하여 gcloud 환경을 초기화합니다.
    gcloud init
Windows
  1. Cloud SDK 설치 프로그램을 다운로드합니다. 설치 프로그램 서명자는 Google Inc.입니다.

  2. 설치 프로그램을 실행하고 안내 메시지를 따릅니다. 시스템의 Python 2가 Python 2.7.9 이상의 출시 버전으로 설치되지 않은 경우 Bundled Python(Python 포함) 설치 옵션을 선택해야 합니다. Cloud SDK는 현재 Python 3을 지원하지 않습니다.

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

    • Cloud SDK 셸 시작
    • gcloud init 실행

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

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

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

또한 다운로드한 .zip 파일로부터 최신 버전을 설치할 수 있습니다.

  1. google-cloud-sdk.zip을 다운로드하고 콘텐츠의 압축을 풉니다. 다운로드한 파일을 마우스 오른쪽 버튼으로 클릭하고 압축 풀기를 선택하면 됩니다.

  2. google-cloud-sdk\install.bat 스크립트를 실행하고 설치 안내 메시지를 따릅니다.

  3. 설치가 완료되면 명령 프롬프트(cmd.exe)를 다시 시작합니다.

  4. gcloud init을 실행합니다.

    C:\> gcloud init

비대화형(자동) 배포

설치 프로그램에 플래그를 전달하면 아무 메시지 없이 Cloud SDK를 배포할 수 있습니다. 이 방식을 사용하면 Cloud SDK의 설치를 자동화할 수 있습니다.

Linux

  • --disable-prompts - 메시지를 사용 중지합니다.

  • --install-dir=DIRECTORY - 설치 루트 디렉토리를 DIRECTORY로 설정합니다. Cloud SDK가 DIRECTORY/google-cloud-sdk에 설치됩니다. 기본값은 $HOME입니다.

Windows

  • /S - 자동으로 설치합니다. 설치 프로그램 페이지가 표시되지 않습니다. 설치 설정을 변경하려면 플래그를 사용합니다.
  • /D - 기본 설치 디렉토리를 설정합니다. 명령줄에서 사용하는 마지막 매개변수여야 하며 경로에 공백이 포함된 경우에도 따옴표를 포함해서는 안 됩니다. 절대 경로(예: /D=C:\CloudSDK)만 지원됩니다.
  • /allusers - 모든 사용자용으로 설치합니다.
  • /singleuser - 현재 사용자용(기본값)으로 설치합니다.
  • /noreporting - 사용 보고를 사용 중지합니다. 기본값은 사용 보고를 전송하는 것입니다.
  • /nostartmenu - 시작 메뉴 바로가기를 만들지 않습니다. 기본값은 바로가기를 만드는 것입니다.
  • /nodesktop - 바탕화면 바로가기를 만들지 않습니다. 기본값은 바로가기를 만드는 것입니다.

설치 관리

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

아래 방법 중 하나로 Cloud SDK를 설치하는 경우 gcloud components를 사용한 구성요소 업데이트 및 삭제가 사용 중지됩니다.

apt-get(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 -
  4. Cloud SDK를 업데이트하고 설치합니다.
    sudo apt-get update && sudo apt-get install google-cloud-sdk
  5. 원하는 경우 다음 추가 구성요소를 설치합니다.
    • google-cloud-sdk-app-engine-python
    • 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-bigtable-emulator
    • kubectl

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

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

yum(Red Hat 및 CentOS)

Red Hat Enterprise Linux 7 및 CentOS 7 시스템에서 Cloud SDK가 설치용 패키지 형식으로 제공됩니다. 이 패키지에는 gcloud, gcloud alpha, gcloud beta, gsutil, bq 명령어만 포함됩니다. gcloud 명령어를 사용하여 애플리케이션을 배포하는 데 필요한 kubectl 또는 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
  3. 원하는 경우 다음 추가 구성요소를 설치합니다.
    • google-cloud-sdk-app-engine-python
    • 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-pubsub-emulator
    • kubectl

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

    yum install google-cloud-sdk-app-engine-java
  4. gcloud init을 실행하여 시작합니다.
    gcloud init
이 페이지가 도움이 되었나요? 평가를 부탁드립니다.

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

Cloud SDK 문서