로컬 개발 환경 설정

Google Cloud의 로컬 개발 환경을 구성하는 방법을 알아봅니다. 이 문서에서는 Google Cloud 서비스로 애플리케이션을 빌드, 테스트, 실행하는 데 필요한 핵심 도구를 다룹니다.

  • gcloud CLI: 클라우드 리소스를 관리하고, 프로젝트를 구성하고, 로컬 애플리케이션 기본 사용자 인증 정보 (ADC)를 설정합니다.
  • Cloud 클라이언트 라이브러리: 선호하는 프로그래밍 언어의 관용적인 라이브러리를 사용하여 Google Cloud API에 프로그래매틱 방식으로 액세스합니다.

이 문서에서는 google-cloud-developer 플러그인을 설치하여 다양한 에이전트에서 Google Cloud 작업 및 코딩에 도움을 받는 방법도 보여줍니다.

Google Cloud의 다른 도구 및 인터페이스에 대한 개요는 Google Cloud와 상호작용하는 방법을 참고하세요.

시작하기 전에

조직 관리자에게 다음 기본 요건을 완료하도록 요청하세요.

  • 사용자 ID 프로비저닝: Cloud ID 또는 Google Workspace 계정을 할당합니다.
  • 프로젝트 액세스 권한 및 IAM 역할 부여: 프로젝트에 필요한 Identity and Access Management (IAM) 역할을 할당합니다.
  • 결제 사용 설정: 프로젝트에 Cloud Billing이 사용 설정되어 있는지 확인합니다.

조직 전체 설정은 Google Cloud 설정 안내 흐름을 참고하세요.

gcloud CLI 및 인증 설정

리소스를 관리하고 로컬 환경을 인증하도록 gcloud CLI (gcloud)를 구성합니다.

  1. 로컬 워크스테이션에 gcloud CLI를 설치합니다.
  2. 터미널에서 gcloud init을 실행하여 로그인하고 기본 프로젝트를 선택합니다.
  3. gcloud auth application-default login를 실행하여 애플리케이션 기본 사용자 인증 정보 (ADC)를 구성합니다. ADC를 사용하면 로컬 클라이언트 라이브러리가 프로젝트에 대해 자동으로 인증할 수 있습니다.

Cloud 클라이언트 라이브러리 설치

애플리케이션 코드에서 프로그래매틱 방식으로 Google Cloud 서비스에 액세스하려면 다음 단계를 따르세요.

  1. 프로젝트에 필요한 Cloud API를 사용 설정합니다.
  2. 프로그래밍 언어 (예: Java, Python, Go)용 Cloud 클라이언트 라이브러리를 설치합니다. 코드는 ADC를 사용하여 자동으로 인증됩니다.

google-cloud-developer 플러그인 설치:

Claude Code CLI, Antigravity CLI, Codex CLI와 같은 에이전트를 사용하여 개발 작업을 지원하는 경우 google-cloud-developer 플러그인을 설치하여 Google Cloud 작업 및 코딩에 도움을 받을 수 있습니다. 이 플러그인에는 다음이 포함됩니다.

  • 계정 생성, 결제 설정, 프로젝트 관리, Google Cloud 서비스 및 API 인증에 도움이 되는 기술
  • 필요에 따라 적절한 Google 제품 스킬을 찾아 실행하므로 Google 스킬을 미리 로드할 필요가 없는 finding-google-skills 스킬
  • 개발자 지식 원격 MCP 서버: Google의 공식 개발자 문서를 검색하고 Google Cloud, Firebase, Android, 지도 등 Google 제품의 정보를 검색하는 기능을 제공합니다.

에이전트에 따라 다음 안내를 사용하여 google-cloud-developer 플러그인을 설치합니다.

Antigravity CLI

  1. Google 에이전트 스킬 저장소에서 위치를 지정하여 플러그인을 설치합니다.

    agy plugin install https://github.com/google/skills/plugins/cloud/google-cloud-developer

  2. gcloud CLI를 사용하여 Google Cloud 프로젝트에서 Developer Knowledge API를 사용 설정합니다.

    gcloud services enable developerknowledge.googleapis.com --project=YOUR_PROJECT_ID

Claude Code CLI

  1. Google 플러그인 마켓플레이스를 추가한 후 플러그인을 설치합니다.

    claude plugin marketplace add google/skills
claude plugin install google-cloud-developer@google-plugins

  2. gcloud CLI를 사용하여 Google Cloud 프로젝트에서 Developer Knowledge API를 사용 설정합니다.

    gcloud services enable developerknowledge.googleapis.com --project=YOUR_PROJECT_ID

  3. API 키 만들기 및 보안 유지의 안내에 따라 Developer Knowledge API의 API 키를 만듭니다. 생성한 키를 안전한 위치에 저장합니다.

  4. Claude Code CLI를 시작하기 전에 API 키를 환경으로 내보냅니다.

    export DEVELOPERKNOWLEDGE_API_KEY=YOUR_API_KEY

Codex CLI

  1. Google 플러그인 마켓플레이스를 추가한 후 플러그인을 설치합니다.

    codex plugin marketplace add google/skills
codex plugin add google-cloud-developer@google-plugins

  2. gcloud CLI를 사용하여 Google Cloud 프로젝트에서 Developer Knowledge API를 사용 설정합니다.

    gcloud services enable developerknowledge.googleapis.com --project=YOUR_PROJECT_ID

  3. API 키 만들기 및 보안 유지의 안내에 따라 Developer Knowledge API의 API 키를 만듭니다. 생성한 키를 안전한 위치에 저장합니다.

  4. 다음 줄을 포함하도록 ~/.codex/config.toml (또는 프로젝트의 .codex/config.toml)를 업데이트하여 개발자 지식 MCP 서버에 대한 인증된 액세스를 사용 설정합니다.

    [mcp_servers.developer-knowledge]
  url = "https://developerknowledge.googleapis.com/mcp"
  env_http_headers = { "X-Goog-Api-Key" = "DEVELOPERKNOWLEDGE_API_KEY" }

  5. Codex를 시작하기 전에 API 키를 환경으로 내보냅니다.

    export DEVELOPERKNOWLEDGE_API_KEY=YOUR_API_KEY

대체 도구 및 환경

워크플로에 특정 개발 환경이나 인프라 도구가 필요한 경우 다음을 고려하세요.

다음 단계