Paso 1: Definir las variables de entorno

Estás viendo la documentación de Apigee X.
Consulta la documentación de Apigee Edge.

Qué se hace en este paso

En esta sección, se describe cómo configurar diversas variables de entorno que se usan en toda la documentación (y, en especial, en este instructivo de configuración). Google te recomienda que los uses para que puedas ingresar los comandos como se muestra.

Este es el primero de dos pasos que realizarás en la línea de comandos antes de iniciar el asistente de aprovisionamiento de Apigee.

Realiza el paso

Para definir variables de entorno en la línea de comandos:

  1. Define las siguientes variables de entorno para el proyecto actual:
    PROJECT_ID="YOUR_PROJECT_ID"
    PROJECT_NUMBER=$(gcloud projects describe $PROJECT_ID --format="value(projectNumber)")
    RUNTIME_LOCATION="YOUR_RUNTIME_LOCATION"
    ANALYTICS_REGION="YOUR_ANALYTICS_REGION"
    APPKEY_LOCATION="APPKEY_LOCATION"
    APPKEY_KEY_RING_NAME="APPKEY_KEY_RING_NAME"
    APPKEY_KEY_NAME="APPKEY_KEY_NAME"
    DISK_KEY_RING_NAME="DISK_KEY_RING_NAME"
    DISK_KEY_NAME="DISK_KEY_NAME"
    

    Aquí:

    • PROJECT_ID es el ID del proyecto de Cloud que creaste como parte de los requisitos. Si no estás seguro de cuál es tu ID del proyecto, usa Cloud Console o el comando gcloud projects list para encontrarlo.
    • PROJECT_NUMBER es el número de proyecto de Cloud que creaste como parte de los requisitos. En este ejemplo, se emite un comando gcloud para obtener el número del proyecto. Como alternativa, puedes encontrarlo en el panel de proyecto de Google Cloud Console o usar el comando gcloud projects list para buscarlo.
    • RUNTIME_LOCATION es la ubicación física en la que se encuentra la instancia. Los valores válidos son cualquier región de Compute Engine (para organizaciones de pago) o de zona de Compute Engine (para organizaciones de evaluación). Para obtener más información, consulta Ubicaciones de Compute Engine.

    • ANALYTICS_REGION es la ubicación física en la que almacenas tus datos de estadísticas.

      Los valores válidos son un subconjunto de las regiones de Compute Engine. Los valores posibles son los siguientes:

      • asia-northeast1
      • asia-south1
      • europe-west1
      • us-central1
      • us-east1
      • us-west1
      • australia-southeast1
      • europe-west2

      Tanto las cuentas de pago y las de evaluación usan regiones para la ubicación de estadísticas. Por lo tanto, para las organizaciones de pago, su valor puede ser el mismo que el RUNTIME_LOCATION (también es una región). Pero el valor de ANALYTICS_REGION no tiene que ser igual a RUNTIME_LOCATION. Sin embargo, puede haber un beneficio de rendimiento si son iguales.

      Para las cuentas de evaluación, la ubicación de las estadísticas es una región, pero la ubicación del entorno de ejecución es una zona, por lo que no serán iguales.

    • RUNTIME_LOCATION es la ubicación física en la que se almacenan el llavero de claves y la clave de la aplicación. Apigee usa una clave de aplicación para encriptar datos de aplicación, como las KVM, la caché y los secretos del cliente, que luego se almacenan en la base de datos.

      Al igual que la región de estadísticas, los valores válidos son un subconjunto de las regiones de Compute Engine. El valor puede ser el mismo que el $RUNTIME_LOCATION (también es una región), pero no es necesario que lo sea. Sin embargo, puede haber un beneficio de rendimiento si son iguales.

    • RUNTIME_LOCATION es el nombre del llavero de claves en el que se almacena la clave de aplicación. El nombre del llavero de claves debe ser único para tu organización. Si creas regiones adicionales, los nombres de llaveros de claves de esas regiones no pueden ser los mismos que los nombres de llaveros de claves existentes.
    • APPKEY_KEY_NAME es el nombre de la clave de aplicación. Los nombres de clave de aplicación deben ser únicos dentro de un llavero de claves dado.
    • DISK_KEY_RING_NAME es el nombre del llavero de claves del disco. El nombre del llavero de claves del disco debe ser diferente del nombre de la clave de aplicación. Crearás el llavero de claves del disco en la misma ubicación que tu $RUNTIME_LOCATION.
    • DISK_KEY_NAME es el nombre de la clave de encriptación de disco, que Apigee usa para encriptar los datos de instancia del entorno de ejecución antes de que se escriban en el disco.

    En el siguiente ejemplo, se definen las variables de entorno para una organización paga:

    PROJECT_ID="my-cloud-project"
    PROJECT_NUMBER=$(gcloud projects describe $PROJECT_ID --format="value(projectNumber)")
    RUNTIME_LOCATION="us-west1"
    ANALYTICS_REGION="us-west1"
    APPKEY_LOCATION="us-west1"
    APPKEY_KEY_RING_NAME="us-west1"
    APPKEY_KEY_NAME="us-west1"
    DISK_KEY_RING_NAME="us-west1"
    DISK_KEY_NAME="us-west1"
    .

    Si se trataba de una organización de evaluación, RUNTIME_LOCATION se establecerá en una zona en lugar de en una región.

    Usarás los nombres de las variables, como $PROJECT_ID como literales de string en tus comandos.

    Ten en cuenta que no puedes usar todas estas variables de entorno durante el aprovisionamiento y la configuración.

  2. (Opcional) Para verificar su trabajo, repita los valores que acaba de configurar. Ten en cuenta que cuando quieras usar una variable en tus comandos, deberás colocar un signo de dólar antes de su nombre ($).
    echo $PROJECT_ID
    echo $PROJECT_NUMBER
    echo $ANALYTICS_REGION
    echo $APPKEY_LOCATION
    echo $APPKEY_KEY_RING_NAME
    echo $APPKEY_KEY_NAME
    echo $DISK_KEY_RING_NAME
    echo $DISK_KEY_NAME
    

    Las respuestas a tus comandos echo deberían verse de la siguiente manera:

    Authorization: Bearer ya29.a123456678940B63hPSAMPLEsampleKKYVsample0f3pWDWZDuH2-hENkNa
    TvgZ1PD977TMvv6edBQPJezdHw040880Ol_LoD5ZDkt-i-knizia_KhA9L20sSvztL81-SAMPLE42ELPMASk2_
    1CxN
    my-cloud-project
    1234567890
    us-west1
    us-west1
    us-west1
    my-app-key-ring
    my-app-key
    my-disk-key-ring
    my-disk-key
    

Si encuentras errores durante esta parte del proceso, consulta Solución de problemas.


1 A CONTINUACIÓN: Habilita las API 3 4 5 6 7 8 9