Paso 8: Promover un archivo para la producción

Esta página se aplica a Apigee y Apigee Hybrid.

Consulta la documentación de Apigee Edge.

En este paso, promoverás un archivo de la configuración de proxy de tu API a un entorno de producción en tu organización de Apigee.

  1. Sigue los pasos que se indican en Crea un entorno para realizar lo siguiente:
    1. Crea un nuevo entorno de producción en tu organización de Apigee y habilita Archive como tipo de implementación. Usa la IU o la API.

      Por ejemplo:

      Nuevo diálogo de entorno que muestra la configuración de tipo de implementación de Archive

    2. Conecta el entorno a la instancia de entorno de ejecución con la API del adjunto de instancias.

      Este comando activa una operación de larga duración. Comprueba que el entorno se haya adjuntado al entorno de ejecución antes de continuar.

    3. Crea un grupo de entornos si aún no tienes uno con la API de creación de grupos de entornos.

      Asegúrate de que el grupo de entornos se haya creado antes de continuar. Puedes verificar el estado de tu grupo nuevo mediante una solicitud como la siguiente:

      curl -i -H "$AUTH" -H "Content-Type:application/json" \
        "https://apigee.googleapis.com/v1/organizations/$PROJECT_ID/environments/ENVIRONMENT_NAME"
    4. Adjunta el entorno nuevo al grupo con la API de adjunto de grupos de entorno.

      Adjuntar un entorno al grupo hace que los proxies de ese entorno se puedan enrutar a través de los nombres de host en el grupo. Esto activa una operación de larga duración que puede tardar varios minutos en completarse. Te recomendamos que esperes uno o dos minutos antes de continuar con el siguiente paso. Mientras tanto, puedes verificar el estado de la operación como antes.

  2. Crea un entorno de producción nuevo en tu entorno de desarrollo local:
    1. En Apigee VS Code, posiciona el cursor sobre la carpeta entornos en la sección Apigee y haz clic en Crear ícono.

      Se muestra + cuando colocas el cursor sobre la carpeta de entornos

      Se abrirá el asistente de creación de entornos.

    2. Ingresa prod como nombre del entorno y presiona Intro.

      Se crea el entorno.

    3. Expande la carpeta del entorno prod de la sección Apigee para ver su contenido.
    4. Coloca el cursor sobre el archivo deployments.json en la sección de API y haz clic en Icono de configuración.

      Se abrirá el asistente de implementaciones.

    5. Selecciona el proxy de API helloworld para agregarlo a la implementación y haz clic en OK.

      El archivo deployments.json se abre en el editor. El archivo se actualizó para incluir el proxy de la API helloworld en el array de implementación proxies, como se muestra a continuación:

      {
        "proxies": [
           "helloworld"
        ],
        "sharedflows": []
      }
  3. Implementa un archivo de la configuración del proxy de API en el entorno de prod de tu organización de Apigee.
    1. En la pestaña Terminal en Apigee VS Code, navegue al directorio myapigeeworkspace.
      cd myapigeeworkspace
    2. Ejecuta el siguiente comando:
      gcloud beta apigee archives deploy --environment=prod --labels=release=052021.1

      A continuación, se proporciona un ejemplo de la respuesta.

      Using Apigee organization dev
      Waiting for operation [$OPERATION_ID] to complete...⠹
    3. Ejecuta el siguiente comando para verificar el estado de la operación y reemplaza $OPERATION_ID por el ID de la operación que se mostró en la llamada anterior:
      gcloud beta apigee operations describe $OPERATION_ID

      A continuación, se proporciona un ejemplo de la respuesta. Ten en cuenta que state se configura como 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. Repite el paso anterior hasta que state se configure como FINISHED, lo que indica que el repositorio de archivos está completo.
    5. Ejecuta el siguiente comando para ver todas las implementaciones de archivo en el entorno prod:
      gcloud beta apigee archives list --environment=prod

      A continuación, se proporciona un ejemplo de la respuesta.

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

¡Felicitaciones! Promocionaste correctamente tu archivo de API a un entorno de producción de Apigee.