이 페이지에는 Google Cloud CLI 설치를 선택하고 유지하기 위한 안내가 포함되어 있습니다. Google Cloud CLI에는 gcloud
, gsutil
, bq
명령줄 도구가 포함됩니다. gcloud CLI 기능 목록은 모든 기능을 참조하세요.
지원되는 프로그래밍 언어를 사용하여 Google Cloud API에 액세스하려면 Cloud 클라이언트 라이브러리를 다운로드할 수 있습니다.
설치 안내
다음은 Google Cloud CLI 설치 안내입니다. 알파 또는 베타 출시 수준의 gcloud CLI 명령어와 같은 추가 구성요소 설치에 대한 자세한 내용은 gcloud CLI 구성요소 관리를 참조하세요.
- 지원되는 Python 버전이 있는지 확인합니다. Google Cloud CLI에는 Python 3.8~3.12가 필요합니다. x86_64 Linux 패키지에는 기본적으로 선호되는 번들 Python 인터프리터가 포함되어 있습니다. Python 인터프리터를 선택하고 구성하는 방법에 대한 자세한 내용은
gcloud topic startup
를 참조하세요. - 다음 중 하나를 다운로드합니다.
플랫폼 패키지 이름 크기 SHA256 체크섬 Linux 64비트 (x86_64)
google-cloud-cli-linux-x86_64.tar.gz 130.5MB e3e354fcdcecd2eac8c6ed7f8b80a9a3637cc533a5d20df398c298b9623de11e Linux 64비트 (Arm)
google-cloud-cli-linux-arm.tar.gz 52.9MB 2b8f5c1d6a5e2b52fb5dc9e2fd279801d5a9cf647dc20f05ba655f2df5c55f91 Linux 32비트 (x86)
google-cloud-cli-linux-x86.tar.gz 52.9MB 139d3af0bdf4b9b0a3b5965eb8aa0f8de9779125f8a354e36182e1359509e450 Linux 보관 파일을 다운로드하려면 다음 명령어를 실행합니다.
curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-cli-linux-x86_64.tar.gz
위 표를 참조하고 google-cloud-cli-linux-x86_64.tar.gz을 구성에 적용되는
*.tar.gz
패키지 이름으로 바꿉니다. - 파일 콘텐츠를 파일 시스템(홈 디렉터리 추천)에 추출하려면 다음 명령어를 실행합니다.
(선택사항) 기존 설치를 대체하려면 기존tar -xf google-cloud-cli-linux-x86_64.tar.gz
google-cloud-sdk
디렉터리를 삭제하고 동일한 위치에 보관 파일 압축을 풉니다. - gcloud CLI를 경로에 추가합니다. 다음 명령어를 사용하여 압축을 푼 폴더의 루트에서 설치 스크립트를 실행합니다.
이 경우 환경설정을 플래그로 제공하여 비대화형(예: 스크립트 사용)으로도 수행할 수 있습니다. 사용 가능한 플래그를 보려면 다음을 실행합니다../google-cloud-sdk/install.sh
(선택사항)./google-cloud-sdk/install.sh --help
- gcloud CLI 개선을 위해 익명 사용 통계를 보내려면 메시지가 표시될 때
Y
로 응답합니다. PATH
에 gcloud CLI를 추가하고 명령어 완성을 사용 설정하려면 메시지가 표시될 때Y
로 응답합니다.
- gcloud CLI 개선을 위해 익명 사용 통계를 보내려면 메시지가 표시될 때
- 변경사항이 적용되도록 새 터미널을 엽니다.
- gcloud CLI를 초기화하려면
gcloud init
를 실행합니다. - (선택사항)구성요소 관리자를 사용하여 추가 구성요소를 설치합니다.
./google-cloud-sdk/bin/gcloud init
패키지 콘텐츠
Debian 및 Ubuntu 시스템에서 gcloud CLI는 설치용 패키지 형식으로 제공됩니다.
이 패키지에는 gcloud
, gcloud alpha
, gcloud beta
, gsutil
, bq
명령어만 포함됩니다. gcloud
명령어를 사용하여 애플리케이션을 배포하는 데 필요한 kubectl
또는 App Engine 확장 프로그램은 포함되지 않습니다. 이러한 구성요소를 사용하려면 별도로 설치해야 합니다.
gcloud CLI를 설치하기 전 운영체제가 다음 요구사항을 충족하는지 확인합니다.
- 지원 종료에 도달하지 않은 Ubuntu 출시 버전 또는 지원 종료에 도달하지 않은 Debian 안정적인 출시 버전
- 패키지가 최근에 업데이트되었습니다.
sudo apt-get update
apt-transport-https
가 있고curl
이 설치되어 있습니다.sudo apt-get install apt-transport-https ca-certificates gnupg curl
- Google Cloud 공개 키를 가져옵니다.
최신 배포판(Debian 9+ 또는 Ubuntu 18.04+)의 경우 다음 명령어를 실행합니다.
curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg
- 이전 배포판의 경우 다음 명령어를 실행합니다.
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 키 파일을 가져오세요.
- 패키지 소스로 gcloud CLI 배포 URI를 추가합니다.
- 최신 배포판(Debian 9+ 또는 Ubuntu 18.04+)의 경우 다음 명령어를 실행합니다.
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
- 최신 배포판(Debian 9+ 또는 Ubuntu 18.04+)의 경우 다음 명령어를 실행합니다.
- gcloud CLI를 업데이트하고 설치합니다.
프롬프트 사용 중지 또는 연습 실행과 같은 추가sudo apt-get update && sudo apt-get install google-cloud-cli
apt-get
옵션에 대해서는apt-get
메인 페이지를 참조하세요.Docker 팁: Docker 이미지 내에 gcloud CLI를 설치하는 경우 대신 단일 RUN 단계를 사용합니다.
RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://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 | sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg && apt-get update -y && apt-get install google-cloud-cli -y
gpg --dearmor
명령어를 지원하지 않는 이전의 기본 이미지의 경우:RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://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-cli -y
- (선택 사항) 다음 추가 구성요소를 설치합니다.
google-cloud-cli
google-cloud-cli-anthos-auth
google-cloud-cli-app-engine-go
google-cloud-cli-app-engine-grpc
google-cloud-cli-app-engine-java
google-cloud-cli-app-engine-python
google-cloud-cli-app-engine-python-extras
google-cloud-cli-bigtable-emulator
google-cloud-cli-cbt
google-cloud-cli-cloud-build-local
google-cloud-cli-cloud-run-proxy
google-cloud-cli-config-connector
google-cloud-cli-datastore-emulator
google-cloud-cli-firestore-emulator
google-cloud-cli-gke-gcloud-auth-plugin
google-cloud-cli-kpt
google-cloud-cli-kubectl-oidc
google-cloud-cli-local-extract
google-cloud-cli-minikube
google-cloud-cli-nomos
google-cloud-cli-pubsub-emulator
google-cloud-cli-skaffold
google-cloud-cli-spanner-emulator
google-cloud-cli-terraform-validator
google-cloud-cli-tests
kubectl
예를 들어
google-cloud-cli-app-engine-java
구성요소는 다음과 같이 설치할 수 있습니다.sudo apt-get install google-cloud-cli-app-engine-java
- 시작하려면
gcloud init
을 실행합니다.gcloud init
gcloud CLI 버전 다운그레이드
VERSION
이123.0.0
형식이고 gcloud CLI의 특정 버전으로 되돌리려면 다음 명령어를 실행합니다.
sudo apt-get update && sudo apt-get install google-cloud-cli=123.0.0-0
최신 출시 버전 10개가 저장소에서 항상 제공됩니다.
참고: 371.0.0 이전 출시 버전의 경우 패키지 이름이 google-cloud-sdk
입니다.
패키지 콘텐츠
gcloud CLI는 Red Hat Enterprise Linux 7, 8, 9, Fedora 33 및 34, CentOS 7 및 8 시스템에 설치할 수 있는 패키지 형식으로 제공됩니다.
이 패키지에는 gcloud
, gcloud alpha
, gcloud beta
, gsutil
, bq
명령어만 포함됩니다. gcloud
명령어를 사용하여 애플리케이션을 배포하는 데 필요한 kubectl
또는 App Engine 확장 프로그램은 포함되지 않으며, 이 섹션의 뒷부분에 설명된 대로 별도로 설치할 수 있습니다.
- gcloud CLI 저장소 정보로 DNF를 업데이트합니다.
다음 샘플 명령어는 Red Hat Enterprise Linux 9 호환 가능한 설치를 위한 것이지만 해당 구성의 필요에 따라 설정을 업데이트해야 합니다.
sudo tee -a /etc/yum.repos.d/google-cloud-sdk.repo << EOM [google-cloud-cli] name=Google Cloud CLI baseurl=https://packages.cloud.google.com/yum/repos/cloud-sdk-el9-x86_64 enabled=1 gpgcheck=1 repo_gpgcheck=0 gpgkey=https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg EOM
-
Fedora 34 또는 35에 설치하는 경우
libxcrypt-compat.x86_64
를 설치합니다.sudo dnf install libxcrypt-compat.x86_64
- gcloud CLI 설치
sudo dnf install google-cloud-cli
- (선택 사항) 다음 추가 구성요소를 설치합니다.
google-cloud-cli
google-cloud-cli-anthos-auth
google-cloud-cli-app-engine-go
google-cloud-cli-app-engine-grpc
google-cloud-cli-app-engine-java
google-cloud-cli-app-engine-python
google-cloud-cli-app-engine-python-extras
google-cloud-cli-bigtable-emulator
google-cloud-cli-cbt
google-cloud-cli-cloud-build-local
google-cloud-cli-cloud-run-proxy
google-cloud-cli-config-connector
google-cloud-cli-datastore-emulator
google-cloud-cli-firestore-emulator
google-cloud-cli-gke-gcloud-auth-plugin
google-cloud-cli-kpt
google-cloud-cli-kubectl-oidc
google-cloud-cli-local-extract
google-cloud-cli-minikube
google-cloud-cli-nomos
google-cloud-cli-pubsub-emulator
google-cloud-cli-skaffold
google-cloud-cli-spanner-emulator
google-cloud-cli-terraform-validator
google-cloud-cli-tests
kubectl
예를 들어
google-cloud-cli-app-engine-java
구성요소는 다음과 같이 설치할 수 있습니다.sudo dnf install google-cloud-cli-app-engine-java
- 시작하려면
gcloud init
을 실행합니다.gcloud init
gcloud CLI 버전 다운그레이드
VERSION
이 123.0.0
형식인 특정 버전의 gcloud CLI로 되돌려야 할 경우에는 다음을 실행합니다.
sudo dnf downgrade google-cloud-cli-VERSION
최신 출시 버전 10개가 저장소에서 항상 제공됩니다.
참고: 371.0.0 이전 출시 버전의 경우 패키지 이름이 google-cloud-sdk
입니다.
-
지원되는 Python 버전이 있는지 확인합니다.
-
현재 Python 버전을 확인하려면
python3 -V
또는python -V
를 실행합니다. 지원되는 버전은 Python 3.8~3.12입니다. - 기본 설치 스크립트는 CPython의 Python 3.11을 설치하도록 제공합니다.
- 그렇지 않고 지원되는 Python 버전을 설치하려면 Python.org macOS용 Python 출시 버전을 방문하세요.
- 머신에 여러 Python 인터프리터가 설치된 경우 셸 내에서 선호하는 인터프리터의 경로를 가리키도록 CLOUDSDK_PYTHON 환경 변수를 설정합니다.
-
Python 인터프리터를 선택하고 구성하는 방법에 대한 자세한 설명은
gcloud topic startup
를 참조하세요.
-
현재 Python 버전을 확인하려면
- 다음 중 하나를 다운로드합니다.
-
파일 시스템의 임의 위치(예: 홈 디렉터리)에 보관 파일 압축을 풉니다. macOS에서는 다운로드된
.tar.gz
보관 파일을 원하는 위치에서 열어 압축을 풀 수 있습니다.기존 설치를 대체하려면 기존
google-cloud-sdk
디렉터리를 삭제하고 동일한 위치에 보관 파일 압축을 풉니다. - (선택사항) 설치 스크립트를 사용하여 gcloud CLI 도구를
PATH
에 추가합니다. 또한 셸인 사용 통계 수집에 명령어 완성을 선택하고 Python 3.11을 설치합니다.다음 명령어를 사용하여(마지막 단계에서 추출한 폴더의 루트에서) 스크립트를 실행합니다.
이 경우 환경설정을 플래그로 제공하여 비대화형(예: 스크립트 사용)으로도 수행할 수 있습니다. 사용 가능한 플래그를 설명하려면 다음을 실행합니다../google-cloud-sdk/install.sh
스크린 리더 모드가 설정된 상태에서 설치 스크립트를 실행하려면 다음 안내를 따르세요../google-cloud-sdk/install.sh --help
변경사항이 적용되도록 새 터미널을 엽니다../google-cloud-sdk/install.sh --screen-reader=true
-
gcloud CLI를 초기화하려면
gcloud init
를 실행합니다. - (선택사항) 구성요소 관리자를 사용하여 추가 구성요소를 설치합니다.
플랫폼 | 패키지 | 크기 | SHA256 체크섬 |
---|---|---|---|
macOS 64비트
(x86_64) |
google-cloud-cli-darwin-x86_64.tar.gz | 53.0MB | 836d1eb955e21bc7cec859854ba593912e150cc0061a3d18e7ce7b36887e0df6 |
macOS 64비트
(ARM64, Apple M1 silicon) |
google-cloud-cli-darwin-arm.tar.gz | 52.9MB | 4036106a3262b2c737cb767a1d06be0e75c0ac3de6a31121248538530fe398b7 |
macOS 32비트
(x86) |
google-cloud-cli-darwin-x86.tar.gz | 51.7MB | ace3236591cb3f9feaf4e4ed78f1babb0828c75f520d1d7a9e2c7fcc2e406708 |
./google-cloud-sdk/bin/gcloud init
-
Google Cloud CLI는 Windows 8.1 이상 및 Windows Server 2012 이상에서 작동합니다.
-
Google Cloud CLI 설치 프로그램을 다운로드합니다.
또는 PowerShell 터미널을 열고 다음 PowerShell 명령어를 실행합니다.
(New-Object Net.WebClient).DownloadFile("https://dl.google.com/dl/cloudsdk/channels/rapid/", "$env:Temp\GoogleCloudSDKInstaller.exe") & $env:Temp\GoogleCloudSDKInstaller.exe
-
설치 프로그램을 실행하고 안내 메시지를 따릅니다. 설치 프로그램 서명자는 Google LLC입니다.
스크린 리더를 사용하는 경우 스크린 리더 모드 설정 체크박스를 선택합니다. 이 옵션은 유니코드 스피너 대신 상태 추적기를 사용하고, 진행 상태를 백분율로 표시하고, 테이블을 평면화하도록
gcloud
를 구성합니다. 자세한 내용은 가용성 기능 가이드를 참조하세요. -
Google Cloud CLI에는 Python이 필요하며 지원되는 버전은 Python 3.8~3.12입니다. 기본적으로 Windows 버전의 Google Cloud CLI는 Python 3과 함께 제공됩니다. Google Cloud CLI를 사용하려면 운영체제에서 지원되는 Python 버전을 실행할 수 있어야 합니다.
설치 프로그램은 필요한 Python 버전을 포함하여 필요한 모든 종속 항목을 설치합니다. Google Cloud CLI는 기본적으로 Python 3을 설치 및 관리하지만 필요한 경우 번들 Python 설치 옵션을 선택 해제하여 기존 Python 설치를 사용할 수 있습니다. 기존 Python 설치를 사용하는 방법은
gcloud topic startup
을 참조하세요. 설치가 완료되면 설치 프로그램에서 시작 메뉴 및 바탕화면 바로가기를 만들고, Google Cloud CLI 셸을 시작하고, gcloud CLI를 구성할 수 있는 옵션이 제공됩니다. 셸을 시작하고 설치를 구성하는 옵션은 선택한 상태로 두세요. 설치 프로그램이 터미널 창을 시작하고
gcloud init
명령어를 실행합니다.- 기본 설치에는
gcloud
명령어를 사용하여 애플리케이션을 배포하는 데 필요한 App Engine 확장 프로그램이 포함되지 않습니다. 이러한 구성요소는 gcloud CLI 구성요소 관리자를 사용해서 설치할 수 있습니다.
find
명령어가 인식되지 않아 설치에 실패하는 경우find
가 들어 있는 폴더를 포함하도록PATH
환경 변수가 설정되어 있는지 확인합니다. 일반적으로는,C:\WINDOWS\system32;
입니다.- gcloud CLI를 제거한 후 gcloud CLI를 다시 설치하려면 먼저 시스템을 재부팅해야 합니다.
- 압축을 풀 수 없다면 설치 프로그램을 관리자로 실행합니다.
기타 설치 옵션
개발 요구에 따라 권장되는 설치 대신 다른 방법으로 gcloud CLI를 설치할 수 있습니다.
- 스크립트 또는 지속적 통합/지속적 배포와 함께 gcloud CLI를 사용하나요? 특정 버전의 gcloud CLI의 비대화형 설치를 위해 버전이 지정된 보관 파일을 다운로드합니다.
- gcloud CLI를 Docker 이미지로 실행해야 하나요? gcloud CLI의 최신 출시 버전 또는 특정 버전용 gcloud CLI Docker 이미지를 사용합니다.
- Ubuntu를 실행하고 자동 업데이트를 선호하나요? snap 패키지를 사용하여 gcloud CLI를 설치합니다.
- Windows 및 macOS 대화형 설치와 다른 모든 사용 사례의 경우, 대화형 설치 프로그램을 실행하여 gcloud CLI의 최신 출시 버전을 설치합니다.
설치 관리
gcloud CLI를 설치한 후 gcloud components
명령어 그룹의 명령어를 사용해서 설치를 관리할 수 있습니다. 여기에는 설치된 구성요소 보기, 구성요소 추가 및 삭제, 새 버전의 gcloud CLI로 업그레이드(또는 특정 버전으로 다운그레이드)가 포함됩니다.
apt-get
또는 yum
을 사용한 경우 apt-get
또는 yum
을 사용하여 gcloud components
가 아닌 구성요소를 업데이트하거나 삭제해야 합니다.
gcloud CLI의 이전 버전
gcloud CLI의 다른 버전이 필요하면 이 페이지 앞부분에서 설명한 안내를 수행하여 현재 버전을 설치한 후 로그인합니다. 로그인한 후에 이전 출시 버전을 다운로드할 수 있습니다. 버전을 날짜별로 정렬하여 보려면 정렬 및 필터링을 사용 설정하고 생성됨 열을 클릭해야 합니다.
지원되는 Python 버전
Google Cloud CLI에는 Python 3.8~3.12가 필요합니다. Python 인터프리터를 선택하고 구성하는 방법에 대한 자세한 내용은 gcloud topic startup
를 참조하세요.
직접 사용해 보기
Google Cloud를 처음 사용하는 경우 계정을 만들고 Google 제품의 실제 성능을 평가해 보세요. 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.
무료로 시작하기