Questa pagina è stata tradotta dall'API Cloud Translation.

Passaggio 8: promuovi un archivio in produzione

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

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

Segui i passaggi descritti in Creare un ambiente per eseguire le seguenti operazioni:
1. Crea un nuovo ambiente prod nella tua organizzazione Apigee, attivando Archivio 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 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 paio di minuti prima di passare al passaggio successivo. Nel frattempo, puoi controllare lo stato dell'operazione come prima.

Crea un nuovo ambiente prod nel tuo ambiente di sviluppo locale:
1. In Apigee in VS Code, posiziona il cursore sulla cartella environments nella sezione Apigee e fai clic su .
  
  Viene visualizzata la procedura guidata Crea ambiente.
2. Inserisci prod come nome dell'ambiente e premi Invio.
  L'ambiente è stato creato.
3. Espandi la cartella dell'ambiente prod nella sezione Apigee per visualizzarne i contenuti.
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 si apre nell'editor. Il file è stato aggiornato per includere il proxy API helloworld nell'array di deployment proxies, come mostrato di seguito:
```
{
  "proxies": [
     "helloworld"
  ],
  "sharedflows": []
}
```

Esegui il deployment di un archivio della configurazione del proxy API nell'ambiente prod della tua organizzazione Apigee.

Nella scheda Terminale di Apigee VS Code, vai alla directory myapigeeworkspace.
```
cd myapigeeworkspace
```

Esegui questo comando:

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

Di seguito è riportato un esempio di risposta:

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

Esegui il seguente comando per controllare lo stato dell'operazione, sostituendo $OPERATION_ID con l'ID operazione restituito nella chiamata precedente:

gcloud beta apigee operations describe $OPERATION_ID

Di seguito è riportato un esempio di 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

Ripeti il passaggio precedente finché state non è impostato su FINISHED, a indicare che il deployment dell'archivio è stato completato.

Esegui il seguente comando per visualizzare tutti i deployment dell'archivio nell'ambiente prod:

gcloud beta apigee archives list --environment=prod

Di seguito è riportato un esempio di 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 correttamente l'archivio API in un ambiente di produzione Apigee.