Créer des environnements

Cet article explique comment créer des environnements pour Apigee hybrid. Pour plus d'informations, consultez la section À propos des environnements et des groupes d'environnements.

À propos de la création d'un environnement

La création d'un environnement est un processus en deux étapes :

  • Créez un environnement dans le plan de gestion à l'aide de l'interface utilisateur ou d'une API Apigee.
  • Ajoutez une configuration pour cet environnement à votre fichier de remplacement et appliquez-la au cluster.

La procédure d'ajout et de configuration d'un environnement est décrite à l'Étape 5 : Ajouter un environnement et Spécifier les remplacements de configuration.

Comment créer un environnement

  1. Créez un ou plusieurs environnements dans l'UI Apigee ou avec l'API Create Environments. Pour connaître la procédure de base, consultez l'Étape 5 : Ajouter un environnement.

  2. Ajoutez une définition d'environnement à la propriété envs[] dans votre fichier de remplacement. Notez que la propriété est un tableau. Par conséquent, vous pouvez y ajouter plusieurs définitions d'environnement. Donnez au nouvel environnement le même nom que celui que vous avez créé dans l'interface utilisateur. Par exemple, la configuration suivante définit deux environnements: test et prod:

    namespace: my-namespace
org: my-organization
...
envs:
  - name: test
    serviceAccountPaths:
      synchronizer: "your_keypath/synchronizer-manager-service-account.json
      udca: "your_keypath/analytic-agent-service-account.json

  - name: prod
    serviceAccountPaths:
      synchronizer: "your_keypath/synchronizer-manager-service-account.json
      udca: "your_keypath/analytic-agent-service-account.json
...
  3. Appliquez les modifications au cluster :

    Helm

    Avec les graphiques Helm, appliquez les modifications à chaque environnement en séquence à l'aide des commandes suivantes.

    Exemple :

    helm upgrade ENV_RELEASE_NAME apigee-env/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --set env=ENV_NAME \
  -f OVERRIDES_FILE \
  --dry-run=server

      ENV_RELEASE_NAME est un nom utilisé pour suivre l'installation et les mises à niveau du graphique apigee-env. Les noms des versions Helm doivent être uniques dans votre installation hybride Apigee. Si le nom de votre environnement est unique, il peut être identique à ENV_NAME. Toutefois, si vous utilisez le même nom pour votre environnement et votre groupe d'environnements, veillez à saisir un nom de version Helm unique pour chacun d'eux. Par exemple, si les deux sont nommés dev, vous pouvez utiliser dev-env-release et dev-envgroup-release.

      Pour en savoir plus sur les versions dans Helm, consultez la section Trois grands concepts dans la documentation Helm.

    Environnement test :

    helm upgrade test-release apigee-env/ \
  --namespace apigee \
  --atomic \
  --set env=test \
  -f OVERRIDES_FILE.yaml

    Environnement prod :

    helm upgrade prod-release apigee-env/ \
  --namespace apigee \
  --set env=prod \
  --atomic \
  -f OVERRIDES_FILE.yaml

    apigeectl

    Avec apigeectl, vous pouvez appliquer les modifications à chaque environnement individuellement avec l'option --env ENV_NAME, ou à tous les environnements en même temps avec l'option --all-envs. Exemple :

    $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE.yaml --all-envs

Pour en savoir plus sur la configuration de l'hôte virtuel, consultez Configurer des hôtes virtuels. Pour obtenir la liste complète des éléments de configuration des environnements, consultez la section envs dans la documentation de référence sur les propriétés de configuration.