Google Cloud CLI 설치
이 빠른 시작에서는 Google Cloud CLI를 설치 및 초기화하고 몇 가지 코어 gcloud CLI 명령어를 실행하는 과정을 안내합니다.
이 가이드의 안내를 따르기 전에 Trusted Cloud용 Google Cloud CLI 설정을 읽어보세요.시작하기 전에
-
In the Trusted Cloud console, on the project selector page, select or create a Trusted Cloud project.
-
Make sure that billing is enabled for your Trusted Cloud project.
이 문서에 설명된 태스크를 완료했으면 만든 리소스를 삭제하여 청구가 계속되는 것을 방지할 수 있습니다. 자세한 내용은 삭제를 참조하세요.
gcloud CLI 최신 버전 (530.0.0) 설치
- 지원되는 Python 버전이 있는지 확인합니다. Google Cloud CLI에는 Python 3.9~3.13이 필요합니다. x86_64 Linux 패키지에는 기본적으로 선호되는 번들 Python 인터프리터가 포함되어 있습니다. Python 인터프리터를 선택하고 구성하는 방법에 대한 자세한 내용은
gcloud topic startup
를 참조하세요. - 다음 중 하나를 다운로드합니다.
플랫폼 패키지 이름 크기 SHA256 체크섬 Linux 64비트 (x86_64)
google-cloud-cli-linux-x86_64.tar.gz 149.7 MB 1ec7d351de14277c00c430f9fb939255c4b63940417da2f24ff6413a9e221c2f Linux 64비트 (Arm)
google-cloud-cli-linux-arm.tar.gz 56.3MB e6153461e3154ebce61d35b73005bdd14a0ecacd42e5008f66e25b4ad231e5c9 Linux 32비트 (x86)
google-cloud-cli-linux-x86.tar.gz 56.3MB 09690f1b126ccc8e777c4a1ef2c0b74a08103d89329b03856d688071baa9fc07 Linux 보관 파일을 다운로드하려면 다음 명령어를 실행합니다.
curl -O https://storage.s3nsapis.fr/cloud-sdk-release/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
디렉터리를 삭제하고 동일한 위치에 보관 파일 압축을 풉니다. - (선택사항)
PATH
에 gcloud CLI를 추가합니다. 셸 및 사용 통계 수집에 명령어 완성 옵션을 선택할 수도 있습니다. 다음 명령어를 사용하여 설치 스크립트를 실행(마지막 단계에서 추출한 폴더의 루트에서)합니다. 이 경우 환경설정을 플래그로 제공하여 비대화형(예: 스크립트 사용)으로도 수행할 수 있습니다. 사용 가능한 플래그를 보려면 다음을 실행합니다../google-cloud-sdk/install.sh
./google-cloud-sdk/install.sh --help
- gcloud CLI 개선을 위해 익명 사용 통계를 보내려면 메시지가 표시될 때
Y
로 응답합니다. PATH
에 gcloud CLI를 추가하고 명령어 완성을 사용 설정하려면 메시지가 표시될 때Y
로 응답합니다.
- gcloud CLI 개선을 위해 익명 사용 통계를 보내려면 메시지가 표시될 때
- 이전 단계에서
PATH
를 업데이트한 경우 변경사항이 적용되도록 새 터미널을 엽니다. - gcloud CLI를 초기화하려면
gcloud init
를 실행합니다. - (선택사항)구성요소 관리자를 사용하여 추가 구성요소를 설치합니다.
./google-cloud-sdk/bin/gcloud init
-
지원되는 Python 버전이 있는지 확인합니다.
-
현재 Python 버전을 확인하려면
python3 -V
또는python -V
를 실행합니다. 지원되는 버전은 Python 3.9~3.13입니다. -
기본 설치 스크립트는 CPython의 Python 3.12를 설치하도록 제공합니다.
- Python을 설치하려면 Xcode 명령줄 도구가 필요합니다.
xcode-select -p
을 실행하여 Xcode 명령줄 도구가 설치되어 있는지 확인합니다.- Xcode 명령줄 도구가 설치되어 있지 않으면
sudo xcode-select --install
를 실행하여 설치합니다.
- 그렇지 않고 지원되는 Python 버전을 설치하려면 Python.org macOS용 Python 출시 버전을 방문하세요.
- 머신에 여러 Python 인터프리터가 설치된 경우 셸 내에서 선호하는 인터프리터의 경로를 가리키도록 CLOUDSDK_PYTHON 환경 변수를 설정합니다.
-
Python 인터프리터를 선택하고 구성하는 방법에 대한 자세한 설명은
gcloud topic startup
를 참조하세요.
-
현재 Python 버전을 확인하려면
- 다음 중 하나를 다운로드합니다.
-
파일 시스템의 임의 위치(예: 홈 디렉터리)에 보관 파일 압축을 풉니다. macOS에서는 다운로드된
.tar.gz
보관 파일을 원하는 위치에서 열어 압축을 풀 수 있습니다. 또는 다음 명령어를 실행합니다.tar -xf google-cloud-cli-darwin-arm.tar.gz
선택사항: 기존 설치를 대체하려면 기존
google-cloud-sdk
디렉터리를 삭제하고 동일한 위치에 보관 파일 압축을 풉니다. - 다음 명령어를 사용하여 설치 스크립트를 실행(마지막 단계에서 추출한 폴더의 루트에서)합니다.
./google-cloud-sdk/install.sh
스크립트가 Python 3.12 및 특정 추천 모듈을 설치하라는 메시지를 표시합니다.
이 설치는 환경설정을 플래그로 제공하여 비대화형(예: 스크립트 사용)으로도 수행할 수 있습니다. 사용 가능한 플래그를 설명하려면 다음을 실행합니다. 스크린 리더 모드가 설정된 상태에서 설치 스크립트를 실행하려면 다음 안내를 따르세요../google-cloud-sdk/install.sh --help
선택사항:./google-cloud-sdk/install.sh --screen-reader=true
- gcloud CLI 개선을 위해 익명 사용 통계를 보내려면 메시지가 표시될 때
Y
로 응답합니다. PATH
에 gcloud CLI를 추가하고 명령어 완성을 사용 설정하려면 메시지가 표시될 때Y
로 응답합니다.
- gcloud CLI 개선을 위해 익명 사용 통계를 보내려면 메시지가 표시될 때
- 이전 단계에서
PATH
를 업데이트한 경우 변경사항이 적용되도록 새 터미널을 엽니다. -
gcloud CLI를 초기화하려면
gcloud init
를 실행합니다. - 선택사항. 구성요소 관리자를 사용하여 추가 구성요소를 설치합니다.
플랫폼 | 패키지 | 크기 | SHA256 체크섬 |
---|---|---|---|
macOS 64비트
(x86_64) |
google-cloud-cli-darwin-x86_64.tar.gz | 56.4 MB | 0c0101a65f3473a5db6a2ebc1867c3294cdbd88fef34da91050869f76149a822 |
macOS 64비트
(ARM64, Apple silicon) |
google-cloud-cli-darwin-arm.tar.gz | 56.4 MB | 80cfba6da278d0ce8a8a0625bec9648ea5a39ea42daf2536068f19edb175dc70 |
macOS 32비트
(x86) |
google-cloud-cli-darwin-x86.tar.gz | 54.9 MB | 53c23a16a66a2d38966fc7080cd2e29afe1d5c85b1c52985c19f7fd2c09f995a |
./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://storage.s3nsapis.fr/cloud-sdk-release/GoogleCloudSDKInstaller.exe", "$env:Temp\GoogleCloudSDKInstaller.exe") & $env:Temp\GoogleCloudSDKInstaller.exe
-
설치 프로그램을 실행하고 안내 메시지를 따릅니다. 설치 프로그램 서명자는 Google LLC입니다.
스크린 리더를 사용하는 경우 스크린 리더 모드 설정 체크박스를 선택합니다. 이 옵션은 유니코드 스피너 대신 상태 추적기를 사용하고, 진행 상태를 백분율로 표시하고, 테이블을 평면화하도록
gcloud
를 구성합니다. 자세한 내용은 가용성 기능 가이드를 참조하세요. -
Google Cloud CLI에는 Python이 필요하며 지원되는 버전은 Python 3.9~3.13입니다. 기본적으로 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를 다시 설치하려면 먼저 시스템을 재부팅해야 합니다.
- 압축을 풀 수 없다면 설치 프로그램을 관리자로 실행합니다.
선택사항: 최신 Cloud 클라이언트 라이브러리 설치
지원되는 언어로 Cloud 클라이언트 라이브러리를 다운로드할 수 있습니다.
gcloud CLI 초기화
gcloud init
명령어를 사용하여 몇 가지 일반적인 gcloud CLI 설정 태스크를 수행합니다. 여기에는 gcloud CLI가 사용자 계정 사용자 인증 정보를 사용하여 Trusted Cloud 에 액세스하도록 승인하고 기본 구성을 설정하는 작업이 포함됩니다.
gcloud CLI를 초기화합니다.
gcloud init
Google 사용자 계정을 사용하여 로그인하는 옵션을 수락합니다.
To continue, you must log in. Would you like to log in (Y/n)? Y
브라우저에서 메시지가 표시되면 Google 사용자 계정에 로그인하고 허용을 클릭하여 Trusted Cloud 리소스에 액세스할 수 있는 권한을 부여합니다.
명령 프롬프트에서 소유자, 편집자 또는 뷰어 권한이 있는 프로젝트 목록에서 Trusted 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:
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
은 설정 단계를 성공적으로 완료했음을 확인합니다.Run `gcloud help config` to learn how to change individual settings This gcloud configuration is called [default]. You can create additional configurations if you work with multiple accounts and/or projects. Run `gcloud topic configurations` to learn more. Some things to try next: * Run `gcloud --help` to see the Cloud Platform services you can interact with. And run `gcloud help COMMAND` to get help on any gcloud command. * Run `gcloud topic --help` to learn about advanced features of the SDK like arg files and output formatting * Run `gcloud cheat-sheet` to see a roster of go-to `gcloud` commands.
(선택사항) 스크린 리더 환경을 향상시키려면
accessibility/screen_reader
속성을 사용 설정합니다.gcloud config set accessibility/screen_reader true
gcloud CLI와 함께 제공되는 접근성 기능에 대한 자세한 내용은 접근성 기능 사용 설정 가이드를 참조하세요.
코어 명령어 실행
코어 명령어를 실행하여 gcloud CLI 설치에 대한 정보를 확인합니다.
사용자 인증 정보가 로컬 시스템에 저장된 계정을 나열합니다.
gcloud auth list
gcloud CLI는 사용자 인증 정보 계정 목록을 표시합니다.
Credentialed Accounts ACTIVE ACCOUNT * example-user-1@gmail.com example-user-2@gmail.com
활성 gcloud CLI 구성의 속성을 나열합니다.
gcloud config list
gcloud CLI는 속성 목록을 표시합니다.
[core] account = example-user-1@gmail.com disable_usage_reporting = False project = example-project
gcloud CLI 설치 및 활성 구성에 대한 정보를 봅니다.
gcloud info
gcloud CLI에서 설치에 대한 요약 정보를 표시합니다. 여기에는 시스템, 설치된 구성요소, 활성 사용자 계정과 현재 프로젝트, 활성 구성의 속성이 포함됩니다.
gcloud
명령어 및 기타 주제에 대한 정보를 확인합니다.gcloud help
예를 들어
gcloud compute instances create
의 도움말을 보려면 다음 명령어를 입력합니다.gcloud help compute instances create
gcloud CLI에서 명령어에 대한 설명, 명령어 플래그와 인수 목록, 명령어 사용 방법 예시를 포함한 도움말 항목을 표시합니다.
삭제
이 페이지에서 사용한 리소스 비용이 Trusted Cloud 계정에 청구되지 않도록 하려면 다음 단계를 수행합니다.
- In the Trusted Cloud console, go to the Manage resources page.
- In the project list, select the project that you want to delete, and then click Delete.
- In the dialog, type the project ID, and then click Shut down to delete the project.
다음 단계
- gcloud CLI 가이드에서 간략한 주요 개념 소개, 명령어 규칙, 유용한 팁 등 gcloud CLI의 개요 읽기
- gcloud CLI 참조 가이드에서 Trusted Cloud에서 다양한 작업을 수행하는 데 사용할 수 있는 설명, 플래그, 예시 등 각 gcloud CLI 명령어의 세부정보 페이지 읽기
- gcloud CLI 요약본에서 일반적으로 사용되는 명령어 및 주요 개념 목록 참조
- gcloud CLI 구성요소 관리자를 사용해서 App Engine 에뮬레이터 또는
kubectl
과 같은 추가 구성요소 설치