Google Cloud CLI

어떤 작업에 사용하는 도구인가

Google Cloud CLI는 Google Cloud에 있는 서버, 저장소, 데이터베이스와 애플리케이션을 명령으로 관리하는 도구다. 중심 명령은 gcloud이며, 웹 콘솔에서 수행하는 관리 작업을 터미널과 스크립트로 처리할 수 있다.

여러 프로젝트를 운영하는 관리자, 배포 절차를 반복하는 개발자, 정기적으로 리소스 목록을 확인하는 운영 담당자에게 적합하다. 명령과 옵션을 익혀야 하므로 클라우드 구조를 처음 살펴보는 단계에서는 웹 콘솔을 함께 사용하는 편이 이해하기 쉽다.

지원 환경과 버전 검토

공식 홈페이지와 설치 문서는 macOS·Linux·Windows를 지원 환경으로 안내한다. macOS용으로 Intel x86_64와 Apple silicon ARM64 패키지가 제공되므로 자신의 CPU에 맞는 파일을 선택한다.

2026년 10월 8일 확인한 설치 페이지는 588.0.0을 안내하며, 릴리스 노트의 배포일은 2026년 10월 6일이다. 제공된 제품 정보의 587.0.0은 현재 안내 버전과 차이가 있어 검토가 필요하다. 제품 전체의 지원 종료 공지는 확인한 자료에서 발견되지 않았으며 업데이트가 이어지고 있다. 다만 개별 구성요소는 제거될 수 있으므로 기존 자동화 환경에서는 릴리스 노트의 호환성 변경을 확인한다.

macOS 설치와 첫 조회 순서

먼저 Google Cloud 계정과 접근 가능한 프로젝트를 준비한다. uname -m으로 CPU 종류를 확인하고 공식 설치 페이지에서 맞는 압축 파일을 내려받아 해제한 뒤 ./google-cloud-sdk/install.sh를 실행한다. 설치 과정에서 PATH 등록과 명령 자동완성을 설정할 수 있다. 현재 문서의 Python 지원 범위는 3.10~3.15이며 설치기는 기본적으로 Python 3.14 설치를 안내한다.

PATH를 변경했다면 새 터미널을 열고 gcloud init으로 브라우저 인증과 기본 프로젝트 선택을 진행한다. 이어 gcloud version, gcloud auth list, gcloud config list로 버전·활성 계정·프로젝트를 확인한다. 첫 작업은 변경 명령보다 기존 리소스 조회로 시작하면 대상을 점검하기 쉽다.

실무 예시와 반복 작업

운영 프로젝트의 가상 머신 목록을 점검할 때는 gcloud compute instances list --project=PROJECT_ID --format=json으로 인스턴스 정보를 JSON 형태로 조회할 수 있다. PROJECT_ID는 실제 프로젝트 ID로 바꾼다. 이 결과를 정기 점검 스크립트에서 처리하면 콘솔 화면을 반복해서 열지 않고 목록을 비교할 수 있다.

목록 명령에는 필터·정렬·개수 제한 옵션도 있다. 개발과 운영 프로젝트를 오간다면 각각 이름이 있는 설정을 만들고 gcloud config configurations activate 설정이름으로 전환한다. 중요한 작업에는 --project를 명시하고 활성 계정도 확인해 실행 대상을 분명히 한다.

무료 사용과 클라우드 비용의 차이

공식 제품 페이지는 Google Cloud 계정 사용자에게 CLI 자체를 무료로 제공한다고 명시한다. CLI로 만드는 가상 머신이나 사용하는 저장소·쿼리 등의 비용은 해당 클라우드 서비스의 요금 조건을 따른다.

Google Cloud 무료 프로그램에는 신규 고객용 300달러 크레딧과 일부 제품의 월별 무료 사용량이 안내되어 있다. 무료 범위는 고객 자격과 제품별 한도에 따라 달라지므로 CLI 사용만으로 모든 작업이 무료가 되는 것은 아니다. 리소스 생성이나 배포 전에는 대상 서비스의 결제 요구사항과 무료 한도를 확인한다.

문제가 생겼을 때 확인할 순서

gcloud 명령을 찾지 못하면 설치 경로의 PATH 등록과 새 터미널 적용 여부를 확인한다. 실행 중 Python 문제가 나면 지원 버전과 gcloud info의 환경 정보를 살펴본다. 접근 오류는 gcloud auth list와 gcloud config list로 계정·프로젝트를 확인한 뒤 해당 작업의 IAM 권한과 API 활성화 상태를 점검한다. 회사망에서 연결이 실패하면 프록시·방화벽 설정을 확인한다.

CLI 명령은 되는데 로컬 애플리케이션만 인증에 실패한다면 인증 구분을 확인한다. gcloud auth login과 클라이언트 라이브러리용 gcloud auth application-default login은 별개다. ADC를 사용할 때는 GOOGLE_APPLICATION_CREDENTIALS 환경변수가 다른 인증 파일을 지정하고 있는지도 살펴본다.

다른 도구와 선택 기준

웹 콘솔은 화면에서 설정과 리소스를 탐색할 때, 로컬 CLI는 반복 조회와 스크립트 실행에 적합하다. 설치 없이 명령을 실행하려면 gcloud가 미리 설치된 브라우저 기반 Cloud Shell을 고려할 수 있다.

BigQuery 쿼리 중심 작업에는 bq, Kubernetes 내부 리소스 관리에는 kubectl을 함께 사용한다. 공식 설치 문서는 일부 배포 방식에서 kubectl과 App Engine 확장 구성요소를 별도로 설치해야 한다고 안내하므로 모든 도구가 기본 포함된다고 가정하지 않는다. 애플리케이션 코드에서 API를 호출하는 목적이라면 언어별 클라이언트 라이브러리도 선택 대상이다.

공식 안내

• Google Cloud Command Line Interface (gcloud CLI) · 확인 2026-10-08
• Install the Google Cloud CLI · 확인 2026-10-08
• Google Cloud CLI - Release Notes · 확인 2026-10-08
• Managing gcloud CLI configurations · 확인 2026-10-08
• gcloud compute instances list · 확인 2026-10-08
• gcloud auth application-default login · 확인 2026-10-08
• Configuring the gcloud CLI for use behind a proxy/firewall · 확인 2026-10-08
• The gcloud CLI cheat sheet · 확인 2026-10-08
• Free Trial and Free Tier Services and Products · 확인 2026-10-08