Configurare la gestione delle API Apigee in Cloud Code per VS Code

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Questa pagina fornisce istruzioni per creare un ambiente di sviluppo locale Apigee API Management in Cloud Code per VS Code, che supporta Gemini Code Assist per la progettazione e lo sviluppo di specifiche OpenAPI. Consulta la Panoramica dello sviluppo locale con Apigee per informazioni sulle funzionalità nell'ambiente di sviluppo locale.

La procedura di configurazione richiede il completamento di entrambe le sezioni di questa guida:

A seconda dei casi d'uso, completa anche una o entrambe le sezioni seguenti:

Prima di iniziare

Per configurare e utilizzare Apigee in VS Code, devi disporre di:

  1. Un Google Cloud progetto a cui accedere nel tuo ambiente di sviluppo locale. Per utilizzare Gemini Code Assist per sviluppare specifiche API, non è necessario eseguire il provisioning del progetto per Apigee, ma è necessario eseguire il provisioning per Apigee per creare uno spazio di lavoro locale Apigee in cui puoi sviluppare e testare i proxy API. Il provisioning di Apigee è necessario anche per visualizzare le API di hub API Apigee nella sezione Apigee di Cloud Code.
  2. (Consigliato) Hub API eseguito il provisioning nel progetto. L'hub API è obbligatorio per le seguenti funzionalità: Se non vuoi aggiungere API Hub al tuo progetto, puoi associarlo a un altro progetto in cui è attivato API Hub. Per informazioni su come collegare un progetto a un hub API, consulta Collegare un progetto di runtime a un hub API.
  3. I ruoli obbligatori per utilizzare Gemini Code Assist in Apigee per le azioni che prevedi di eseguire. Per poter configurare Gemini Code Assist nel progetto, devi disporre del ruolo Amministratore utilizzo servizio nel tuo account utente.
  4. Familiarità con VS Code, come gestire VS Code e come eseguire azioni comuni come accedere alle impostazioni e installare estensioni. Consulta la documentazione di VS Code.

Installa VS Code e l'estensione Cloud Code

Questa sezione fornisce le istruzioni di installazione di VS Code e dell'estensione Cloud Code in VS Code. Questo è il primo passaggio per configurare lo sviluppo locale per Apigee ed è necessario per utilizzare qualsiasi funzionalità di sviluppo locale di Apigee, inclusa Gemini Code Assist.

Per installare VS Code e l'estensione Cloud Code:

  1. Se non è già installato, scarica e installa Visual Studio Code (VS Code) sulla tua macchina locale.
  2. Installa l'estensione Cloud Code, come descritto in Installa l'estensione Cloud Code. Se prevedi di gestire proxy API nel tuo ambiente locale, installa Docker durante la procedura.
  3. (Consigliato) Attiva gli aggiornamenti automatici per l'estensione Cloud Code. In Impostazioni, cerca Estensioni: aggiornamento automatico e attivalo per tutte le estensioni o singolarmente per l'estensione Cloud Code.
  4. Riavvia VS Code.

Configurare Gemini Code Assist per Apigee

Segui questi passaggi per configurare Gemini Code Assist per Apigee nel tuo ambiente di sviluppo locale. Tieni presente i ruoli obbligatori per utilizzare Gemini Code Assist in Apigee.

  1. Assicurati di aver completato i passaggi descritti in Installa VS Code e l'estensione Cloud Code, se non l'hai già fatto.
  2. Installa l'estensione Gemini Code Assist in VS Code.
  3. (Consigliato) Abilita gli aggiornamenti automatici per l'estensione Gemini Code Assist. In Impostazioni, cerca Estensioni: aggiornamento automatico e attivalo per tutte le estensioni o singolarmente per l'estensione Gemini Code Assist.
  4. Se non è già installato, installa gcloud CLI.
  5. Abilita l'API Gemini for Google Cloud per il progetto. Per eseguire questo passaggio, devi disporre del ruolo Amministratore utilizzo servizio. 
    gcloud services enable cloudaicompanion.googleapis.com --project=YOUR_PROJECT
  6. In VS Code, accedi al tuo Google Cloud progetto in entrambe le estensioni Gemini Code Assist e Cloud Code. Puoi farlo utilizzando uno dei seguenti metodi:
    • Aggiungi manualmente il progetto nel file settings.json: 
      {
  "cloudcode.apigee.gemini.options": {
      "cloudcode.project": "YOUR_PROJECT",
      "geminicodeassist.project": "YOUR_PROJECT"
    ...
    }
  }
    • Seleziona il progetto quando richiesto:

      Se apri la chat di Gemini Code Assist e non hai eseguito l'accesso a un progetto con Gemini attivo, visualizzerai un messaggio in tal senso con un modo per accedere. Seleziona seleziona un Google Cloud progetto per aggiungere il progetto.
      Progetto mancante di Gemini Code Assist per la chat di Gemini Code Assist

      Per selezionare un progetto per Google Cloud dall'interno della sezione Apigee di Cloud Code, espandi la sezione Hub API e fai clic su Cloud Code - No Project selected:
      Google Cloud no project

      In alternativa, fai clic sul nome del progetto nella barra di stato di Cloud Code e seleziona il nuovo progetto: Barra di stato di Cloud Code che mostra il progetto Apigee
  7. Aggiungi al tuo account utente gli eventuali ruoli necessari per utilizzare Gemini Code Assist in Apigee.
  8. Se vuoi essere in grado di creare un bundle di proxy API da una specifica OpenAPI e gestirlo nel tuo ambiente di sviluppo locale, completa i passaggi descritti in Configurare l'ambiente di sviluppo locale per lo sviluppo di proxy API.

Ruoli richiesti per utilizzare Gemini Code Assist in Apigee

Per eseguire i passaggi di progettazione e test delle API utilizzando Gemini Code Assist, sono necessari i ruoli elencati di seguito:

Attività Ruoli richiesti
Progettare le API utilizzando Gemini Code Assist Utente di Gemini for Google Cloud
Consumatore di utilizzo del servizio

Vedi Concedi ruoli IAM in un progetto Google Cloud per Gemini Code Assist.
Utilizza il contesto aziendale delle tue API esistenti nell'hub API quando progetti le API Visualizzatore di Cloud API Hub
Modificare le API hub Editor o amministratore di Cloud API Hub
Pubblicare le API nell'hub API Editor o amministratore di Cloud API Hub
Configura e gestisci un server simulato remoto per testare le API Amministratore del registry di elementi
Account di servizio Cloud Build
Amministratore di Cloud Run
Amministratore dell'utilizzo dei servizi

Consulta la documentazione di riferimento dei ruoli IAM di base e predefiniti.

Devi anche avere installato gcloud CLI.

Configurare lo sviluppo di proxy API per lo sviluppo locale di Apigee

Completa i passaggi di questa sezione se vuoi utilizzare il tuo ambiente di sviluppo locale per lo sviluppo e il test dei proxy API Apigee. Completa anche questi passaggi per poter creare un proxy API da una specifica OpenAPI.

  1. Crea uno spazio di lavoro Apigee.
  2. Installa l'emulatore Apigee.
  3. Aggiungi un contenitore per il deployment in Apigee Emulator.

Passaggi successivi

Dopo aver completato i passaggi di installazione e configurazione, inizia a utilizzare Cloud Code: