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 프로젝트. API 사양을 개발하는 데 Gemini Code Assist를 사용하기 위해 프로젝트에서 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 채팅용 Gemini Code Assist에서 프로젝트가 누락됨

      Cloud Code의 Apigee 섹션 내에서 Google Cloud 에 사용할 프로젝트를 선택하려면 API 허브 섹션을 펼치고 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 사용을 시작합니다.