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 : Appliquez les modifications à chaque environnement en ordre séquentiel.
    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
    

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.