빠른 시작: Cloud SDK 시작하기

이 빠른 시작에서는 gcloud 명령줄 도구가 포함된 Cloud SDK를 설치 및 초기화하고 몇 가지 코어 gcloud 도구 명령어를 실행하여 시작하는 과정을 설명합니다. Cloud Shell을 사용하여 Cloud SDK를 설치하지 않고도 사용할 수 있습니다. 이 대안에 대한 안내는 Cloud SDK 대화형 튜토리얼을 참조하세요.

최신 Cloud SDK 버전(365.0.1) 설치

Linux
  1. 지원되는 Python 버전이 있는지 확인합니다. Cloud SDK에는 Python 3(3.5~3.8, 3.7 권장) 및 Python 2(2.7.9 이상)가 필요합니다. Python 인터프리터를 선택하고 구성하는 방법에 대한 자세한 내용은 gcloud topic startup를 참조하세요.
  2. 다음 중 하나를 다운로드합니다.
    플랫폼 패키지 크기 SHA-256 체크섬
    Linux 64비트

    (x86_64)

    google-cloud-sdk-365.0.1-linux-x86_64.tar.gz 20MB 17003cdba67a868c2518ac16efa60dc6175533b7a9fb87304459784308e30fb0
    Linux 64비트

    (arm)

    google-cloud-sdk-365.0.1-linux-arm.tar.gz 90.1MB fbe88d385e2648ac21bd67586c669e824160424627ac2f9c3fd17c79c765286b
    Linux 32비트

    (x86)

    google-cloud-sdk-365.0.1-linux-x86.tar.gz 90.1MB 9cf354476192935d9d43db455f777e43daf2b59bb9110ff3f21d533e550916cf

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

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

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

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

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

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

    다음 명령어를 사용하여 압축을 푼 폴더의 루트에서 스크립트를 실행합니다.

    ./google-cloud-sdk/install.sh
    
    이 경우 환경설정을 플래그로 제공하여 비대화형(예: 스크립트 사용)으로도 수행할 수 있습니다. 명령어는 다음과 같습니다.
    ./google-cloud-sdk/install.sh --help
    
    변경사항이 적용되도록 새 터미널을 엽니다.
  7. SDK를 초기화하려면 gcloud init을 실행합니다.
  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를 설치하기 전에 운영체제가 다음 요구사항을 충족하는지 확인합니다.

  • 지원 종료에 도달하지 않은 Ubuntu 출시 버전 또는 지원 종료에 도달하지 않은 Debian 안정화 출시 버전
  • apt-transport-https가 설치됩니다.
    sudo apt-get install apt-transport-https ca-certificates gnupg
설치
  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

    배포판에서 서명 옵션을 지원하지 않는 경우 다음 명령어를 실행합니다.

    echo "deb https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list
  2. Google Cloud 공개 키를 가져옵니다. 배포판의 apt-key 명령어가 --keyring 인수를 지원하는 경우 다음 명령어를 실행합니다.
    curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key --keyring /usr/share/keyrings/cloud.google.gpg add -

    배포판의 apt-key 명령어가 --keyring 인수를 지원하지 않는 경우 다음 명령어를 실행합니다.

    curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -

    키가 만료되어 최신 업데이트를 가져올 수 없는 경우에는 최신 apt-get.gpg 키 파일을 가져오세요.

  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를 업데이트합니다. 다음 샘플 명령어는 Red Hat Enterprise Linux 8 호환 설치용입니다. Red Hat Enterprise Linux 7 호환 설치의 경우 baseUrl 값에서 el8el7로 바꿉니다.
    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-el8-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. 지원되는 Python 버전이 있는지 확인합니다.
    • 지원되는 버전은 Python 3(3.5~3.8, 권장 3.7) 및 Python 2(2.7.9 이상)입니다.
    • 최신 버전의 macOS에는 Cloud SDK에 필요한 적절한 Python 버전이 포함되어 있습니다. 현재 Python 버전을 확인하려면 python -V를 실행합니다.
    • Cloud SDK 출시 버전 352.0.0 이상의 경우 기본 설치 스크립트는 Intel 기반 Mac에 CPython의 Python 3.7을 설치하도록 제공합니다.
    • Python 인터프리터를 선택하고 구성하는 방법에 대한 자세한 내용은 gcloud topic startup를 참조하세요.
  2. 다음 중 하나를 다운로드합니다.
  3. 플랫폼 패키지 크기 SHA-256 체크섬
    macOS 64비트

    (x86_64)

    google-cloud-sdk-365.0.1-darwin-x86_64.tar.gz 93.2MB 4ae8a3274eb9b6fca5761ef2eed713bc3486256d11268575febe3351e9e4d902
    macOS 64비트

    (arm64, Apple M1 실리콘)

    google-cloud-sdk-365.0.1-darwin-arm.tar.gz 93.2MB 636591e597730649011f510fc8c78e2b133ef8b417992f8d923a87a528dc6d5e
    macOS 32비트

    (x86)

    google-cloud-sdk-365.0.1-darwin-x86.tar.gz 97.0MB b3b04f7f5577347d5c30277d4bf6aa2d1a182c1ff8f9cc04edf0dee6f0b8c4a9

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

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

    2. 선택사항. 설치 스크립트를 사용하여 PATH에 Cloud SDK 도구를 추가합니다.

      또한 셸 및 사용 통계 수집에 명령어 완성 옵션을 선택하고 선택적으로 Python 3.7을 설치할 수도 있습니다.

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

      ./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입니다.

    스크린 리더를 사용하는 경우 스크린 리더 모드 설정 체크박스를 선택합니다. 이 옵션은 유니코드 스피너 대신 상태 추적기를 사용하고, 진행 상태를 백분율로 표시하고, 테이블을 평면화하도록 gcloud를 구성합니다. 자세한 내용은 가용성 기능 가이드를 참조하세요.

  3. Cloud SDK에는 Python이 필요합니다. 지원되는 버전은 Python 3(권장, 3.5~3.8) 및 Python 2(2.7.9 이상)입니다. Cloud SDK는 기본적으로 Python 3가 번들로 함께 제공됩니다. Cloud SDK를 사용하려면 운영체제가 지원되는 Python 버전을 실행할 수 있어야 합니다.

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

  4. 설치가 완료되면 설치 프로그램이 시작 메뉴 및 바탕화면 바로가기를 만들고, Cloud SDK 셸을 시작하고 Cloud SDK를 구성할 수 있는 옵션을 제공합니다. 셸을 시작하고 설치를 구성하는 옵션은 선택한 상태로 두세요. 설치 프로그램이 터미널 창을 시작하고 gcloud init 명령어를 실행합니다.

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

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

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

Cloud SDK 초기화

gcloud init 명령어를 사용하여 몇 가지 일반적인 Cloud SDK 설정 작업을 수행합니다. 여기에는 Cloud SDK 도구가 사용자 계정 사용자 인증 정보를 사용하여 Google Cloud에 액세스하도록 승인하고 기본 구성을 설정하는 작업이 포함됩니다.

Cloud SDK를 초기화하려면 다음 안내를 따르세요.

  1. 명령 프롬프트에서 다음 명령어를 입력합니다.

    gcloud init
    

  2. Google 사용자 계정을 사용하여 로그인하는 옵션을 수락합니다.

    To continue, you must log in. Would you like to log in (Y/n)? Y
    
  3. 브라우저에서 메시지가 표시되면 Google 사용자 계정에 로그인하고 허용을 클릭하여 Google Cloud 리소스에 액세스할 수 있는 권한을 부여합니다.

  4. 명령 프롬프트에서 소유자, 편집자 또는 뷰어 권한이 있는 프로젝트 목록의 Google Cloud 프로젝트를 선택합니다.

    Pick cloud project to use:
     [1] [my-project-1]
     [2] [my-project-2]
     ...
     Please enter your numeric choice:
    

    프로젝트가 하나만 있는 경우 gcloud init가 프로젝트를 선택합니다.

    200개가 넘는 프로젝트에 액세스할 수 있는 경우 프로젝트 ID를 입력하거나 새 프로젝트를 만들거나 프로젝트를 나열하라는 메시지가 표시됩니다.

    This account has a lot of projects! Listing them all can take a while.
     [1] Enter a project ID
     [2] Create a new project
     [3] List projects
    Please enter your numeric choice:
    
  5. Google Compute Engine API를 사용 설정한 경우 gcloud init를 사용하여 기본 Compute Engine 영역을 선택할 수 있습니다.

    Which compute zone would you like to use as project default?
     [1] [asia-east1-a]
     [2] [asia-east1-b]
     ...
     [14] Do not use default zone
     Please enter your numeric choice:
    

    gcloud init은 설정 단계를 성공적으로 완료했음을 확인합니다.

    gcloud has now been configured!
    You can use [gcloud config] to change more gcloud settings.
    
    Your active configuration is: [default]
    
  6. (선택사항) 스크린 리더 환경을 더욱 간소화할 수 있도록 gcloud 도구가 accessibility/screen_reader 속성과 함께 제공됩니다.

    이 속성을 사용하려면 다음을 실행합니다. gcloud config set accessibility/screen_reader true

    gcloud 도구와 함께 제공되는 접근성 기능에 대한 자세한 내용은 접근성 기능 사용 설정 가이드를 참조하세요.

코어 명령어 실행

SDK 설치에 대한 정보를 보려면 gcloud 도구 명령어를 실행합니다.

  1. 사용자 인증 정보가 로컬 시스템에 저장된 계정을 나열하려면 다음 명령어를 입력합니다.

    gcloud auth list
    

    gcloud 도구는 사용자 인증 정보 계정 목록을 표시합니다.

    Credentialed Accounts
    ACTIVE             ACCOUNT
    *                  example-user-1@gmail.com
                       example-user-2@gmail.com
    
  2. 활성 Cloud SDK 구성의 속성을 나열하려면 다음 명령어를 입력합니다.

     gcloud config list
    

    gcloud 도구는 속성 목록을 표시합니다.

    [core]
    account = example-user-1@gmail.com
    disable_usage_reporting = False
    project = example-project
    
  3. Cloud SDK 설치 및 활성 구성에 대한 정보를 보려면 다음 명령어를 입력합니다.

    gcloud info
    

    gcloud 도구는 Cloud SDK 설치에 대한 요약 정보를 표시합니다. 여기에는 시스템, 설치된 구성요소, 활성 사용자 계정과 현재 프로젝트, 활성 구성의 속성이 포함됩니다.

  4. 명령줄에서 gcloud 명령어와 기타 항목에 대한 정보를 보려면 다음 명령어를 입력합니다.

    gcloud help
    

    예를 들어 gcloud compute instances create의 도움말을 보려면 다음 명령어를 입력합니다.

    gcloud help compute instances create
    

    gcloud 도구는 명령어에 대한 설명, 명령 플래그와 인수 목록, 사용 방법 예시를 포함한 도움말 항목을 표시합니다.

다음 단계

  • gcloud 도구 가이드에서 간략한 주요 개념 소개, 명령어 규칙, 유용한 팁 등 gcloud 도구의 개요 읽기
  • gcloud 도구 참조 가이드에서 Google Cloud를 통해 다양한 작업을 수행하는 데 사용할 수 있는 설명, 플래그, 예시 등 각 gcloud 도구 명령어의 세부정보 페이지 읽기
  • 일반적으로 사용되는 명령어와 주요 개념 목록은 gcloud 도구 요약본을 참조하세요.
  • Cloud SDK 구성요소 관리자를 사용하여 App Engine 에뮬레이터 또는 kubectl 등의 추가 구성요소 설치

직접 사용해 보기

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

무료로 시작하기