Paso 1: Define las variables del entorno

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

Consulta la documentación de Apigee Edge.

Qué vas a hacer en este paso

En esta sección se describe cómo definir varias variables de entorno que se usan en toda la documentación (y, en concreto, en este tutorial de configuración). Google te recomienda encarecidamente que los uses para poder introducir los comandos tal como se muestran.

Este es el primero de los dos pasos que debes seguir en la línea de comandos antes de iniciar el asistente de aprovisionamiento de Apigee.

Sigue el paso

Para definir variables de entorno en la línea de comandos, sigue estos pasos:

  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"
RUNTIMEDBKEY_LOCATION="RUNTIMEDB_LOCATION"
APPKEY_KEY_RING_NAME="RUNTIMEDB_KEY_RING_NAME"
APPKEY_KEY_NAME="RUNTIMEDB_KEY_NAME"
DISK_KEY_RING_NAME="DISK_KEY_RING_NAME"
DISK_KEY_NAME="DISK_KEY_NAME"

    Donde:

    • PROJECT_ID es el ID del proyecto de Cloud que has creado en los requisitos. Si no sabes cuál es el ID de tu proyecto, usa la consola de Cloud o el comando gcloud projects list para encontrarlo.
    • PROJECT_NUMBER es el número del proyecto de Cloud que has creado como parte de los requisitos previos. En este ejemplo, se envía un comando gcloud para obtener el número de proyecto. También puedes encontrarlo en el panel de control del proyecto de la consola de Google Cloud o usar el comando gcloud projects list.

    • RUNTIME_LOCATION es la ubicación física en la que se encuentra tu instancia. Los valores válidos son cualquier región de Compute Engine (para organizaciones de pago) o zona de Compute Engine (para organizaciones de evaluación). Para obtener más información, consulta las ubicaciones de Compute Engine.

    • ANALYTICS_REGION es la ubicación física en la que almacena sus datos de analíticas.

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

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

      Tanto las cuentas de evaluación como las de pago usan regiones para la ubicación de analíticas. Por lo tanto, en las organizaciones de pago, su valor puede ser el mismo que el de RUNTIME_LOCATION (que también es una región). Sin embargo, el valor de ANALYTICS_REGION no tiene por qué ser el mismo que el de RUNTIME_LOCATION. Sin embargo, puede que haya una mejora del rendimiento si son iguales.

      En las cuentas de evaluación, la ubicación de analíticas es una región, pero la ubicación del tiempo de ejecución es una zona, por lo que no serán iguales.

    • RUNTIME_LOCATION es la ubicación física donde se almacenan el conjunto de claves y la clave de tu aplicación. Apigee usa una clave de aplicación para cifrar datos de aplicaciones, como KVMs, caché y secretos de cliente, que se almacenan en la base de datos.

      Al igual que en el caso de la región de analíticas, los valores válidos son un subconjunto de las regiones de Compute Engine. El valor puede ser el mismo que el de $RUNTIME_LOCATION (que también es una región), pero no tiene por qué serlo. Puede haber una mejora del rendimiento si son iguales.

    • RUNTIME_LOCATION es el nombre del conjunto de claves en el que se almacena la clave de aplicación. El nombre del conjunto de claves debe ser único en tu organización. Si creas regiones adicionales, los nombres de los conjuntos de claves de esas regiones no pueden ser los mismos que los de los conjuntos de claves que ya tengas.
    • APPKEY_KEY_NAME es el nombre de la clave de aplicación. Los nombres de las claves de aplicación deben ser únicos en un conjunto de claves determinado.
    • DISK_KEY_RING_NAME es el nombre del conjunto de claves de disco. It El nombre del conjunto de claves de disco debe ser diferente del nombre de la clave de aplicación. Crearás el conjunto de claves de disco en la misma ubicación que tu $RUNTIME_LOCATION.
    • DISK_KEY_NAME es el nombre de la clave de cifrado de disco que usa Apigee para cifrar los datos de la instancia de tiempo de ejecución antes de escribirlos en el disco.

    En el siguiente ejemplo se definen variables de entorno para una organización de pago. 

    PROJECT_ID="my-cloud-project"
PROJECT_NUMBER=$(gcloud projects describe $PROJECT_ID --format="value(projectNumber)")
RUNTIME_LOCATION="us-west1"
ANALYTICS_REGION="us-west1"
RUNTIMEDBKEY_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 tratara de una organización de evaluación, el valor de RUNTIME_LOCATION sería una zona en lugar de una región.

    Usará los nombres de las variables, como $PROJECT_ID, como literales de cadena en sus comandos.

    Ten en cuenta que es posible que no uses todas estas variables de entorno durante el aprovisionamiento y la configuración.

  2. (Opcional) Comprueba tu trabajo repitiendo los valores que acabas de definir. Ten en cuenta que, si quieres usar una variable en tus comandos, debes poner el signo de dólar ($) delante del nombre de la variable. 
    echo $PROJECT_ID
echo $PROJECT_NUMBER
echo $ANALYTICS_REGION
echo $RUNTIMEDBKEY_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 tener el siguiente aspecto:

    Authorization: Bearer ya29.a123456678940B63hPSAMPLEsampleKKYVsample0f3pWDWZDuH2-hENkNa
TvgZ1PD977TMvv6edBQPJezdHw040880Ol_LoD5ZDkt-i-knizia_KhA9L20sSvztL81-SAMPLE42ELPMASk2_
1CxN
my-cloud-project
1234567890
us-west1
us-west1
us-west1
$RUNTIMEDB_KEY_RING_NAME
$RUNTIMEDB_KEY_NAME
$DISK_KEY_RING_NAME
$DISK_KEY_NAME

Si se produce algún error durante esta parte del proceso, consulta la sección Solución de problemas.

1 SIGUIENTE: Habilita las APIs 3 4 5 6 7 8