Passaggio 7: esegui il deployment in un ambiente Apigee

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Dopo aver completato lo sviluppo e i test locali con Apigee in VS Code, puoi eseguire il deployment dell'API come archivio in un ambiente Apigee. In questo passaggio, creerai un ambiente Apigee che supporti il deployment dell'archivio ed eseguirai il deployment di un archivio della configurazione del proxy API nell'ambiente Apigee.

  1. Segui i passaggi descritti in Creare un ambiente per eseguire le seguenti operazioni:
    1. Crea un nuovo ambiente dev nella tua organizzazione Apigee, attivando Archivio come tipo di deployment. Utilizza l'interfaccia utente o l'API.

      Ad esempio:

      Finestra di dialogo Nuovo ambiente che mostra le impostazioni del tipo di deployment dell'archivio

    2. Collega l'ambiente a un'istanza di runtime utilizzando l'API di attacco delle istanze.

      Questo comando attiva un'operazione a lunga esecuzione. Prima di continuare, assicurati che l'ambiente sia stato collegato al runtime.

    3. Crea un gruppo di ambienti se non ne hai già uno utilizzando l'API Create environment groups.

      Assicurati che il gruppo di ambienti sia stato creato prima di continuare. Puoi controllare lo stato del nuovo gruppo utilizzando una richiesta come la seguente: 

      curl -i -H "$AUTH" -H "Content-Type:application/json" \
  "https://apigee.googleapis.com/v1/organizations/$PROJECT_ID/environments/ENVIRONMENT_NAME"
    4. Collega il nuovo ambiente al gruppo di ambienti utilizzando l'API di attacco del gruppo di ambienti.

      Se colleghi un ambiente al gruppo, i proxy al suo interno diventano inoltrabili tramite i nomi host del gruppo. Viene attivata un'operazione a lunga esecuzione che può richiedere diversi minuti. Ti consigliamo di attendere un minuto o due prima di passare al passaggio successivo. Nel frattempo, puoi controllare lo stato dell'operazione come prima.

  2. Esegui il deployment di un archivio della configurazione del proxy API nell'ambiente Apigee.
    1. Nella scheda Terminale di Apigee VS Code, vai alla directory myapigeeworkspace. 
      cd myapigeeworkspace

      Quando esegui ls, la directory deve contenere la cartella src.

    2. Esegui questo comando: 
      gcloud beta apigee archives deploy --environment=dev --labels=release=052021

      Di seguito è riportato un esempio di risposta: 

      Using Apigee organization dev
Waiting for operation [b64c2665-b5ac-43cc-9e2d-232e8895c2ed] to complete...done
  3. Esegui il seguente comando nella scheda Terminale per testare l'API: 
    curl https://INTERNAL_LOAD_BALANCER_IP/helloworld /
  -H "Host: ENV_GROUP_HOSTNAME"

    Per ulteriori informazioni sulle variabili in questo esempio e su come configurare l'accesso all'API, consulta Eseguire il deployment di un proxy di esempio.

    Viene visualizzato il seguente messaggio di errore: 

    {"fault":{"faultstring":"Failed to resolve API Key variable request.queryparam.apikey",
  "detail":{"errorcode":"steps.oauth.v2.FailedToResolveAPIKey"}}}

    Per ottenere una chiave API, devi creare un prodotto API che includa l'API helloworld, quindi creare e registrare uno sviluppatore con il prodotto API.

  4. Ottieni una chiave API.
    1. Crea un prodotto API utilizzando l'interfaccia utente di Apigee:
      1. Seleziona Pubblica > Prodotti API.
      2. Fai clic su + Crea.
      3. Inserisci i dettagli del prodotto per il tuo prodotto API.
      4. Inserisci le seguenti informazioni nei campi:
        Campo Impostazione
        Name: myproduct
        Display name: myproduct
        Environment: dev
        Access: Pubblica
        Quota: Lascia vuoto
        Allowed OAuth scope: Lascia vuoto
      5. Nella sezione Operazioni, fai clic su + Aggiungi un'operazione.
      6. In Origine, seleziona helloworld dal menu a discesa Proxy API.
      7. In Operazione, inserisci / nel campo Percorso.

        Lascia invariati i valori predefiniti degli altri campi.

      8. Fai clic su Salva per salvare l'operazione.
      9. Fai clic su Salva per salvare il prodotto API.
    2. Crea uno sviluppatore nella tua organizzazione:
      1. Seleziona Pubblica > Sviluppatori nel menu di navigazione.
      2. Fai clic su + Sviluppatore.
      3. Inserisci le seguenti informazioni nei campi:
        Campo Impostazione
        First Name: Alex
        Last Name: Hamilton
        Username: ahamilton
        Email: ahamilton@example.com
      4. Fai clic su Crea.
    3. Registra un'app:
      1. Seleziona Pubblica > App.
      2. Fai clic su + App.
      3. Inserisci le seguenti informazioni nei campi:
        Campo Impostazione
        Name: myapp
        Display name: myapp
        Developer: ahamilton@example.com
        Callback URL: Lascia vuoto
        Notes: Lascia vuoto
        Expiry: Mai
        Product:
        1. Fai clic su Aggiungi prodotto.
        2. Seleziona myproduct.
        3. Fai clic su Aggiungi.
        Custom attributes: Lascia vuoto
    4. Copia la chiave API.
      1. Nella pagina App (Pubblica > App), fai clic su myapp.
      2. Nella pagina myapp, fai clic su Mostra accanto a Chiave nella sezione Credenziali. Tieni presente che la chiave API è associata al prodotto API che hai creato.
      3. Seleziona e copia la chiave API.
  5. Esegui di nuovo la chiamata curl passando la chiave API utilizzando il parametro di query apikey, come segue: 
    curl -v https://$PUBLIC_FACING_IP/helloworld?apikey=ZQA5euYtNeJ7ZCGCJMpvd6F2BZOmxOzY

    Viene restituita la seguente risposta:

    {
  "root": {
    "city": "San Jose",
    "firstName": "John",
    "lastName": "Doe",
    "state": "CA"
  }
}

Complimenti! Hai eseguito correttamente il deployment dell'archivio API in un ambiente Apigee.

Nel passaggio successivo, promuoverai l'archivio API in un ambiente di produzione Apigee.

1 2 3 4 5 6 7 (AVANTI) Passaggio 8: promuovi un archivio in produzione