gsutil 설치

기본 요건: Python 버전 관리자 (pyenv)를 설치하고 적절한 Python 버전을 설치합니다.

1. 글로벌 Python 버전을 설정합니다.
   • Python 3.12.x를 글로벌 버전으로 설정하려면 다음 단계를 따르세요.

     pyenv global 3.12.x

   • 또는 특정 프로젝트 폴더의 Python 버전을 로컬에서 설정합니다.

     pyenv local 3.12.x

2. 올바른 Python 버전이 사용 중인지 확인합니다.

   python --version

   다음과 같이 표시됩니다.

   Python 3.12.x

1. 지원되는 Python 버전이 있는지 확인합니다. Google Cloud CLI에는 Python 3.8~3.13이 필요합니다. x86_64 Linux 패키지에는 기본적으로 선호되는 번들 Python 인터프리터가 포함되어 있습니다. Python 인터프리터를 선택하고 구성하는 방법에 대한 자세한 내용은 gcloud topic startup를 참조하세요.
2. 다음 중 하나를 다운로드합니다.

   플랫폼	패키지 이름	크기	SHA256 체크섬
   Linux 64비트 (x86_64)	google-cloud-cli-linux-x86_64.tar.gz	131.6MB	beb7c8ef61c46ede9295bf68bfb331fbd158575cc3343db585d37b891c890336
   Linux 64비트 (Arm)	google-cloud-cli-linux-arm.tar.gz	53.9 MB	44eb95fd169f92c197f88df527c3aa27d5db9aa977c2fa2d28fa1cf506b00c9f
   Linux 32비트 (x86)	google-cloud-cli-linux-x86.tar.gz	53.9 MB	10303f55226fac633761ae52e1dbcbcaf7c59fe11232f8196e6e361fc38e2e77

   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 패키지 이름으로 바꿉니다.

3. 파일 콘텐츠를 파일 시스템(홈 디렉터리 추천)에 추출하려면 다음 명령어를 실행합니다.

   tar -xf google-cloud-cli-linux-x86_64.tar.gz

   (선택사항) 기존 설치를 대체하려면 기존 google-cloud-sdk 디렉터리를 삭제하고 동일한 위치에 보관 파일 압축을 풉니다.
4. gcloud CLI를 경로에 추가합니다. 다음 명령어를 사용하여 압축을 푼 폴더의 루트에서 설치 스크립트를 실행합니다.

   ./google-cloud-sdk/install.sh

   이 경우 환경설정을 플래그로 제공하여 비대화형(예: 스크립트 사용)으로도 수행할 수 있습니다. 사용 가능한 플래그를 보려면 다음을 실행합니다.

   ./google-cloud-sdk/install.sh --help

   (선택사항)
   • gcloud CLI 개선을 위해 익명 사용 통계를 보내려면 메시지가 표시될 때 Y로 응답합니다.
   • PATH에 gcloud CLI를 추가하고 명령어 완성을 사용 설정하려면 메시지가 표시될 때 Y로 응답합니다.
5. 변경사항이 적용되도록 새 터미널을 엽니다.
6. gcloud CLI를 초기화하려면 gcloud init를 실행합니다.

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

7. 선택사항: 구성요소 관리자를 사용하여 추가 구성요소를 설치합니다.

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

1. 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 키 파일을 가져오세요.

2. 패키지 소스로 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

3. 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
         

4. (선택 사항) 다음 추가 구성요소를 설치합니다.
   • 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

5. 시작하려면 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 확장 프로그램은 포함되지 않으며, 이 섹션의 뒷부분에 설명된 대로 별도로 설치할 수 있습니다.

1. 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

2. Fedora 34 또는 35에 설치하는 경우 libxcrypt-compat.x86_64를 설치합니다.

   sudo dnf install libxcrypt-compat.x86_64

3. gcloud CLI 설치

   sudo dnf install google-cloud-cli

4. (선택 사항) 다음 추가 구성요소를 설치합니다.
   • 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

5. 시작하려면 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입니다.