Variables d’environnement Cloud Manager

Les variables d’environnement standard peuvent être configurées et gérées via Cloud Manager. Elles sont fournies à l’environnement d’exécution et peuvent être utilisés dans des configurations OSGi. Les variables d’environnement peuvent être des valeurs spécifiques à un environnement ou des secrets d’environnement, en fonction de ce qui est modifié.

Présentation

Les variables d’environnement offrent de nombreux avantages aux utilisateurs d’AEM as a Cloud Service :

• Elles permettent au comportement de votre code et de votre application de varier en fonction du contexte et de l’environnement. Par exemple, elles peuvent être utilisées pour activer différentes configurations dans l’environnement de développement par rapport aux environnements de production ou d’évaluation, ceci afin d’éviter des erreurs coûteuses.
• Elles ne doivent être configurées et paramétrées qu’une seule fois, et peuvent être mises à jour et supprimées si nécessaire.
• Leurs valeurs peuvent être mises à jour à tout moment et prennent effet immédiatement sans qu’il faille apporter de modifications au code ni procéder à des déploiements.
• Elles peuvent séparer le code de la configuration et supprimer la nécessité d’inclure des informations sensibles dans le contrôle de version.
• Elles améliorent la sécurité de l’application AEM as a Cloud Service puisqu’elles se trouvent en dehors du code.

Les cas d’utilisation les plus courants des variables d’environnement incluent :

• La connexion de votre application AEM avec différents points d’entrée externes.
• L’utilisation d’une référence lors du stockage des mots de passe au lieu de le faire directement dans la base de code.
• Lorsque plusieurs environnements de développement existent dans un programme et que certaines configurations diffèrent d’un environnement à l’autre.

Ajouter des variables d’environnement

1. Connectez-vous à Adobe Cloud Manager à l’adresse my.cloudmanager.adobe.com.

2. Cloud Manager répertorie les différents programmes disponibles. Sélectionnez celui que vous souhaitez gérer.

3. Sélectionnez l’onglet Environnements pour le programme choisi, puis sélectionnez l’environnement pour lequel vous souhaitez créer une variable d’environnement dans le panneau de navigation de gauche.

4. Dans le détail de l’environnement, sélectionnez l’onglet Configuration, puis sélectionnez Ajouter pour ouvrir la boîte de dialogue Configuration de l’environnement.

   • Si vous ajoutez une variable d’environnement pour la première fois, le bouton Ajouter une configuration s’affiche au centre de la page. Vous pouvez utiliser ce bouton ou Ajouter pour ouvrir la boîte de dialogue Configuration de l’environnement.

   

5. Saisissez les détails de la variable.

   • Nom.
   • Valeur.
   • Service appliqué : définit le service (auteur/publication/prévisualisation) auquel la variable s’applique, ou si elle s’applique à tous les services.
   • Type : définit si la variable est une variable normale ou un secret.

   

6. Après avoir saisi la nouvelle variable, vous devez sélectionner Ajouter dans la dernière colonne de la ligne contenant la nouvelle variable.

   • Vous pouvez saisir plusieurs variables à la fois en saisissant une nouvelle ligne et en sélectionnant Ajouter.

   

7. Sélectionnez Enregistrer pour conserver vos variables.

Un indicateur avec le statut Mise à jour en cours s’affiche en haut du tableau et en regard de la variable nouvellement ajoutée pour indiquer que l’environnement est en cours de mise à jour avec la configuration. Une fois cette opération terminée, la nouvelle variable d’environnement est visible dans le tableau.

Mettre à jour les variables d’environnement

Une fois les variables d’environnement créées, vous pouvez les mettre à jour à l’aide du bouton Ajouter/mettre à jour pour lancer la boîte de dialogue Configuration de l’environnement.

1. Connectez-vous à Adobe Cloud Manager à l’adresse my.cloudmanager.adobe.com.

2. Cloud Manager répertorie les différents programmes disponibles. Sélectionnez celui que vous souhaitez gérer.

3. Sélectionnez l’onglet Environnements pour le programme choisi, puis sélectionnez l’environnement pour lequel vous souhaitez créer une variable d’environnement dans le panneau de navigation de gauche.

4. Dans le détail de l’environnement, sélectionnez l’onglet Configuration, puis sélectionnez Ajouter/mettre à jour dans le coin supérieur droit pour ouvrir la boîte de dialogue Configuration de l’environnement.

   

5. À l’aide du bouton représentant des points de suspension qui se trouve dans la dernière colonne de la ligne de la variable à modifier, sélectionnez Modifier ou Supprimer.

   

6. Modifiez la variable d’environnement selon vos besoins.

   • Lors de la modification, le bouton représentant des points de suspension est remplacé par des options permettant de revenir à la valeur initiale ou de confirmer votre modification.
   • Lors de la modification des secrets, les valeurs peuvent seulement être mises à jour, mais pas visualisées.

   

7. Une fois toutes les modifications de configuration requises effectuées, cliquez sur Enregistrer.

Comme lors de l’ajout de variables, un indicateur avec le statut Mise à jour sʼaffiche en haut du tableau et en regard de la ou des variables nouvellement mises à jour pour indiquer que l’environnement est mis à jour avec la configuration. Une fois l’opération terminée, la ou les variables d’environnement mises à jour sont visibles dans le tableau.

Utilisation de variables d’environnement

Les variables d’environnement peuvent rendre vos configurations pom.xml plus sécurisées et flexibles. Par exemple, les mots de passe n’ont pas besoin d’être codés en dur et votre configuration peut s’adapter en fonction des valeurs des variables d’environnement.

Vous pouvez accéder via XML aux variables et secrets d’environnement comme suit.

• ${env.VARIABLE_NAME}

Consultez le document Configuration d’un projet pour un exemple d’utilisation des deux types de variables dans un fichier pom.xml.

Voir documentation officielle de Maven pour plus d’informations.

Ressources Business.Adobe.com