Étape 1 : Définissez des variables d'environnement

Cette page s'applique à Apigee et à Apigee hybrid.

Consultez la documentation d'Apigee Edge.

Procédure de cette étape

Cette section explique comment définir plusieurs variables d'environnement qui sont utilisées dans la documentation (et en particulier dans ce tutoriel sur la configuration). Google vous recommande vivement d'utiliser ces variables d'environnement pour pouvoir saisir les commandes comme indiqué.

Cette étape est la première d'une série de deux étapes que vous effectuerez en ligne de commande avant de lancer l'assistant de provisionnement Apigee.

Réaliser cette étape

Pour définir des variables d'environnement sur la ligne de commande, procédez comme suit :

  1. Définissez les variables d'environnement suivantes pour le projet en cours :
    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"

    Où :

    • PROJECT_ID est l'ID du projet CloudCP que vous avez créé dans la section Prérequis. Si vous ne connaissez pas l'ID de votre projet, utilisez Cloud Console ou la commande gcloud projects list pour le trouver.
    • PROJECT_NUMBER est le numéro du projet Cloud que vous avez créé dans la section Prérequis. Dans cet exemple, la commande gcloud récupère le numéro de projet automatiquement. Vous pouvez également le trouver dans le tableau de bord du projet dans Google Cloud Console ou à l'aide de la commande gcloud projects list.

    • RUNTIME_LOCATION est l'emplacement physique dans lequel se trouve votre instance. Les valeurs valides sont les régions Compute Engine (pour les organisations payantes) ou les zones Compute Engine (pour les organisations d'évaluation). Pour plus d'informations, consultez la page Emplacements Compute Engine.

    • ANALYTICS_REGION est l'emplacement physique où vous stockez vos données d'analyse.

      Les valeurs valides constituent un sous-ensemble des régions Compute Engine. Les valeurs possibles sont les suivantes :

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

      Les comptes d'évaluation et payants utilisent des régions pour l'emplacement d'analyse. Par conséquent, pour les organisations payantes, sa valeur peut être identique à celle de RUNTIME_LOCATION (également une région). Toutefois, la valeur de ANALYTICS_REGION ne doit pas nécessairement être identique à RUNTIME_LOCATION. Toutefois, si elles sont identiques, cela peut améliorer les performances.

      Pour les comptes d'évaluation, l'emplacement d'analyse est une région, mais l'emplacement d'exécution est une zone. Par conséquent, ils ne sont pas identiques.

    • RUNTIME_LOCATION est l'emplacement physique où sont stockés le trousseau de clés et la clé de l'application. Apigee utilise une clé d'application pour chiffrer les données d'application, telles que les KVM, le cache et les codes secrets des clients, qui sont ensuite stockées dans la base de données.

      Comme la région de données analytiques, les valeurs valides constituent un sous-ensemble des régions Compute Engine. La valeur peut être identique à la valeur $RUNTIME_LOCATION (également une région), mais ce n'est pas une obligation. Si elles sont identiques, cela peut améliorer les performances.

    • RUNTIME_LOCATION est le nom du trousseau de clés dans lequel la clé d'application est stockée. Le nom du trousseau de clés doit être unique au sein de votre organisation. Si vous créez des régions supplémentaires, les noms des trousseaux de clés associés à ces régions ne peuvent pas être identiques à ceux des trousseaux de clés existants.
    • APPKEY_KEY_NAME est le nom de la clé d'application. Les noms des clés d'application doivent être uniques au sein d'un trousseau de clés donné.
    • DISK_KEY_RING_NAME est le nom du trousseau de clés du disque. Le nom du trousseau de clés du disque doit être différent de celui de la clé d'application. Vous allez créer le trousseau de clés du disque au même emplacement que votre $RUNTIME_LOCATION.
    • DISK_KEY_NAME est le nom de la clé de chiffrement du disque utilisée par Apigee pour chiffrer les données de l'instance d'exécution avant qu'elles soient écrites sur le disque.

    L'exemple suivant définit les variables d'environnement pour une organisation payante. 

    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"

    S'il s'agissait d'une organisation d'évaluation, le champ RUNTIME_LOCATION serait défini sur une zone plutôt que sur une région.

    Vous utiliserez les noms des variables, tels que $PROJECT_ID, en tant que littéraux de chaîne dans vos commandes.

    Notez que vous ne pouvez pas utiliser toutes ces variables d'environnement lors du provisionnement et de la configuration.

  2. (Facultatif) Vérifiez votre travail en répercutant les valeurs que vous venez de définir. Notez que lorsque vous souhaitez utiliser une variable dans vos commandes, faites précéder le nom de la variable d'un signe dollar ($). 
    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

    Les réponses à vos commandes echo doivent se présenter comme suit :

    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 vous rencontrez des erreurs au cours de cette étape du processus, consultez la page Dépannage.

1SUIVANT : Activer des API345678