Passaggio 8: promuovi un archivio in produzione

Questa pagina si applica a Apigee e Apigee ibrido.

Visualizza la documentazione di Apigee Edge.

Anteprima - Archive deployment

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

In questo passaggio promuoverai un archivio della configurazione del proxy API in un ambiente di produzione nella tua organizzazione Apigee.

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

      Ad esempio:

      

   2. Collega l'ambiente a un'istanza di runtime utilizzando l'API Instances Linking.

      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 Crea gruppi di ambienti.

      Assicurati che il gruppo di ambienti sia stato creato prima di continuare. Puoi controllare lo stato del tuo 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 per i collegamenti del gruppo di ambienti.

      Quando colleghi un ambiente al gruppo, i proxy al suo interno possono essere instradati tramite i nomi host del gruppo. Questo attiva un'operazione a lunga esecuzione il cui completamento può richiedere diversi minuti. Ti consigliamo di attendere un minuto o due prima di andare al passaggio successivo. Nel frattempo, puoi controllare lo stato dell'operazione come prima.

2. Crea un nuovo ambiente di produzione nel tuo ambiente di sviluppo locale:
   1. In Apigee in VS Code, posiziona il cursore sulla cartella ambienti nella sezione Apigee e fai clic su .

      

      Si apre la procedura guidata Crea ambiente.

   2. Inserisci prod come nome dell'ambiente e premi Invio.

      L'ambiente viene creato.

   3. Espandi la cartella dell'ambiente prod nella sezione Apigee per visualizzarne il contenuto.
   4. Posiziona il cursore sul file deployments.json nella sezione Apigee e fai clic su .

      Si apre la procedura guidata Deployment.

   5. Seleziona il proxy API helloworld per aggiungerlo al deployment e fai clic su OK.

      Il file deployments.json viene aperto nell'editor. Il file è stato aggiornato in modo da includere il proxy API helloworld nell'array di deployment proxies, come mostrato di seguito:

      {
        "proxies": [
           "helloworld"
        ],
        "sharedflows": []
      }

3. Esegui il deployment di un archivio della configurazione del proxy API nell'ambiente prod nella tua organizzazione Apigee.
   1. Nella scheda Terminale in Apigee VS Code, vai alla directory myapigeeworkspace.

      cd myapigeeworkspace

   2. Esegui questo comando:

      gcloud beta apigee archives deploy --environment=prod --labels=release=052021.1

      Di seguito viene fornito un esempio della risposta:

      Using Apigee organization dev
      Waiting for operation [$OPERATION_ID] to complete...⠹

   3. Esegui questo comando per verificare lo stato dell'operazione, sostituendo $OPERATION_ID con l'ID operazione restituito nella chiamata precedente:

      gcloud beta apigee operations describe $OPERATION_ID

      Di seguito viene fornito un esempio della risposta. Tieni presente che state è impostato su IN_PROGRESS.

      Using Apigee organization 'prod'
      done: true
      metadata:
        '@type': type.googleapis.com/google.cloud.apigee.v1.OperationMetadata
        operationType: INSERT
        state: IN_PROGRESS
        targetResourceName: uri
      name: organizations/prod/operations/$OPERATION_ID
      organization: prod
      response:
        '@type': type.googleapis.com/google.cloud.apigee.v1.CanaryEvaluation
        control: 1-5-0-20210319-071117-ghq74
        endTime: '2021-03-20T06:15:44.329363950Z'
        metricLabels:
          env: test
          location: us-central1
        name: uri
        startTime: '2021-03-20T06:14:44.306534584Z'
        treatment: 1-5-0-20210319-190954-if0wk
        verdict: NONE
      uuid: $OPERATION_ID

   4. Ripeti il passaggio precedente finché state non viene impostato su FINISHED, a indicare che l'eliminazione dell'archivio è stata completata.
   5. Esegui questo comando per visualizzare tutti i deployment di archiviazione nell'ambiente prod:

      gcloud beta apigee archives list --environment=prod

      Di seguito viene fornito un esempio della risposta:

      Using Apigee organization 'prod'
      ARCHIVE ID                        ENVIRONMENT   DEPLOYED AT           LABELS            OPERATION STATUS
      vrytwbhso558oil53m                prod          2021-04-20 21:20:53   release=052021.1  Deployed

Complimenti! Hai promosso il tuo archivio API a un ambiente di produzione Apigee.