Créer des environnements

Cette rubrique explique comment créer des environnements. 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

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

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
...

Ajoutez une propriété virtualhosts qui mappe routingRules à l'environnement.

virtualhosts:
  - name: default
    hostAliases: ["api.example.com"]
    sslCertPath: ./certs/fullchain.pem
    sslKeyPath: ./certs/privkey.pem
    routingRules:
      - env: test

Appliquez les modifications au cluster : Si vous avez modifié les propriétés envs[] et virtualhosts[], appliquez les modifications avec la commande suivante:
```
apigeectl apply -f overrides-file.yaml -c synchronizer,udca,runtime
```
Si vous ne modifiez que la propriété virtualhosts, appliquez ces modifications de configuration avec l'option --settings:
```
apigeectl apply -f overrides-file.yaml --settings virtualhosts
```

Pour plus d'informations sur la configuration des hôtes virtuels, y compris sur la configuration de plusieurs règles de routage de basepath, consultez la page 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.