VS Code용 Cloud Code에서 Apigee API 관리 설정

이 페이지는 Apigee 및 Apigee Hybrid에 적용됩니다.

Apigee Edge 문서 보기

이 페이지에서는 OpenAPI 사양 설계 및 개발을 위한 Gemini Code Assist를 지원하는 VS Code용 Cloud Code에서 Apigee API 관리 로컬 개발 환경을 만드는 방법을 설명합니다. 로컬 개발 환경의 기능에 관한 자세한 내용은 Apigee를 사용한 로컬 개발 개요를 참고하세요.

설정 프로세스에는 이 가이드의 다음 두 섹션을 모두 완료해야 합니다.

사용 사례에 따라 다음 섹션 중 하나 또는 둘 다를 완료합니다.

시작하기 전에

VS Code에서 Apigee를 설정하고 사용하려면 다음이 필요합니다.

  1. 로컬 개발 환경에서 로그인할 Google Cloud 프로젝트입니다. Gemini Code Assist를 사용하여 API 사양을 개발하려면 프로젝트를 Apigee에 프로비저닝할 필요가 없지만, API 프록시를 개발하고 테스트할 수 있는 Apigee 로컬 워크스페이스를 만들려면 Apigee에 프로비저닝해야 합니다. Cloud Code의 Apigee 섹션에 Apigee API 허브 API가 표시되려면 Apigee 프로비저닝도 필요합니다.
  2. (권장) 프로젝트에 프로비저닝된 API 허브 다음 기능에는 API 허브가 필요합니다. 프로젝트에 API 허브를 추가하고 싶지 않다면 대신 API 허브가 사용 설정된 다른 프로젝트와 프로젝트를 연결하면 됩니다. 프로젝트를 API 허브에 연결하는 방법에 관한 자세한 내용은 API 허브에 런타임 프로젝트 연결을 참고하세요.
  3. 수행하려는 작업에 필요한 Apigee에서 Gemini Code Assist를 사용하기 위한 필수 역할 프로젝트에서 Gemini Code Assist를 설정하려면 사용자 계정에 서비스 사용량 관리자 역할이 있어야 합니다.
  4. VS Code, VS Code 관리 방법, 설정에 액세스하고 확장 프로그램을 설치하는 등의 일반적인 작업을 실행하는 방법에 익숙해야 합니다. VS Code 문서를 참고하세요.

VS Code 및 Cloud Code 확장 프로그램 설치

이 섹션에서는 VS Code 및 VS Code의 Cloud Code 확장 프로그램을 설치하는 방법을 설명합니다. 이는 Apigee의 로컬 개발을 설정하는 첫 번째 단계이며 Gemini Code Assist를 비롯한 Apigee 로컬 개발 기능을 사용하려면 필요합니다.

VS Code 및 Cloud Code 확장 프로그램을 설치하려면 다음 단계를 따르세요.

  1. Visual Studio Code (VS Code)가 아직 설치되어 있지 않으면 로컬 머신에 다운로드하고 설치합니다.
  2. Cloud Code 확장 프로그램 설치에 설명된 대로 Cloud Code 확장 프로그램을 설치합니다. 로컬 환경에서 API 프록시를 관리하려는 경우 프로세스 중 Docker를 설치합니다.
  3. (권장) Cloud Code 확장 프로그램의 자동 업데이트를 사용 설정합니다. 설정에서 확장 프로그램: 자동 업데이트를 검색하고 모든 확장 프로그램 또는 Cloud Code 확장 프로그램에 개별적으로 사용 설정합니다.
  4. VS Code를 다시 시작합니다.

Apigee용 Gemini Code Assist 설정

다음 단계에 따라 로컬 개발 환경에서 Apigee용 Gemini Code Assist를 설정하세요. Apigee에서 Gemini Code Assist를 사용하기 위한 필수 역할을 참고하세요.

  1. 아직 완료하지 않은 경우 VS Code 및 Cloud Code 확장 프로그램 설치의 단계를 완료해야 합니다.
  2. VS Code에 Gemini Code Assist 확장 프로그램을 설치합니다.
  3. (권장) Gemini Code Assist 확장 프로그램의 자동 업데이트를 사용 설정합니다. 설정에서 확장 프로그램: 자동 업데이트를 검색하고 모든 확장 프로그램 또는 Gemini Code Assist 확장 프로그램에 개별적으로 사용 설정합니다.
  4. 아직 설치하지 않았다면 gcloud CLI를 설치합니다.
  5. 프로젝트에 Gemini for Google Cloud API를 사용 설정합니다. 이 단계를 수행하려면 서비스 사용량 관리자 역할이 필요합니다. 
    gcloud services enable cloudaicompanion.googleapis.com --project=YOUR_PROJECT
  6. VS Code에서 Gemini Code Assist 및 Cloud Code 확장 프로그램 둘 다에서 프로젝트에 로그인합니다. Google Cloud 다음 방법 중 하나를 사용하여 이 작업을 수행할 수 있습니다.
    • settings.json 파일에 프로젝트를 수동으로 추가합니다. 
      {
  "cloudcode.apigee.gemini.options": {
      "cloudcode.project": "YOUR_PROJECT",
      "geminicodeassist.project": "YOUR_PROJECT"
    ...
    }
  }
    • 메시지가 표시되면 프로젝트를 선택합니다.

      Gemini Code Assist 채팅을 열었으나 Gemini가 사용 설정된 프로젝트에 로그인하지 않은 경우 로그인 방법이 포함된 메시지가 표시됩니다. Google Cloud 프로젝트 선택을 선택하여 프로젝트를 추가합니다.
      Gemini Code Assist Chat용 Gemini Code Assist에 프로젝트가 없음

      Cloud Code의 Apigee 섹션에서 프로젝트를 선택하려면 Google Cloud API 허브 섹션을 펼치고 Cloud Code - No Project selected(Cloud Code - 프로젝트 선택 안함)를 클릭합니다.
      Google Cloud 프로젝트 없음

      또는 Cloud Code 상태 표시줄에서 프로젝트 이름을 클릭하고 새 프로젝트를 선택합니다. Apigee 프로젝트가 표시된 Cloud Code 상태 표시줄
  7. 필요한 Apigee에서 Gemini Code Assist를 사용하기 위한 필수 역할을 사용자 계정에 추가합니다.
  8. OpenAPI 사양에서 API 프록시 번들을 만들고 로컬 개발 환경에서 관리하려면 API 프록시 개발을 위한 로컬 개발 환경 설정의 단계를 완료하세요.

Apigee에서 Gemini Code Assist를 사용하기 위한 필수 역할

Gemini Code Assist를 사용하여 API 설계 및 테스트 단계를 수행하려면 아래에 나열된 역할이 필요합니다.

작업 필요한 역할
Gemini Code Assist를 사용하여 API 설계 Google Cloud를 위한 Gemini 사용자
서비스 사용량 소비자

Gemini Code Assist의 Google Cloud 프로젝트에서 IAM 역할 부여를 참조하세요.
API를 설계할 때 API 허브의 기존 API에서 엔터프라이즈 컨텍스트 사용 Cloud API Hub 뷰어
API 허브 API 수정 Cloud API 허브 편집자 또는 관리자
API 허브에 API 게시 Cloud API 허브 편집자 또는 관리자
API를 테스트하도록 원격 모의 서버 설정 및 관리 Artifact Registry 관리자
Cloud Build 서비스 계정
Cloud Run 관리자
서비스 사용량 관리자

IAM 기본 및 사전 정의된 역할 참조를 확인하세요.

gcloud CLI도 설치되어 있어야 합니다.

Apigee 로컬 개발을 위한 API 프록시 개발 설정

Apigee API 프록시 개발 및 테스트에 로컬 개발 환경을 사용하려면 이 섹션의 단계를 완료하세요. OpenAPI 사양에서 API 프록시를 만들 수 있도록 다음 단계도 완료하세요.

  1. Apigee 작업공간 만들기
  2. Apigee 에뮬레이터를 설치합니다.
  3. Apigee 에뮬레이터에 배포할 컨테이너를 만듭니다.

다음 단계

설치 및 설정 단계를 완료한 후 Cloud Code 사용을 시작합니다.