Secrets Monaco Managed : variables, environnements et delete

Secrets Monaco Managed : jetons en variables d’environnement, plusieurs environnements, monaco delete et un dépôt Git sûr, avec exercice et quiz.
Secrets Monaco Managed : variables, environnements et delete

Module 5 du parcours Monaco Managed : les secrets Monaco Managed, c’est-à-dire la façon de garder jetons et URL hors du dépôt Git, de viser plusieurs environnements avec un même code et de supprimer proprement une configuration.

Parcours : Monaco Managed · Module 5/5 · Durée : ~45 min · Niveau : Intermédiaire

Objectifs :

  • Fournir jetons et URL par variables d’environnement, jamais en clair dans Git
  • Déclarer plusieurs environnements Managed et adapter une configuration à chacun
  • Écrire un fichier delete.yaml et lancer monaco delete sans surprise
  • Organiser un dépôt Git sûr pour le code de configuration

Prérequis : le module 4 (projets, config.yaml, deploy --dry-run), Monaco installé, un environnement Managed de recette et un jeton d’API par environnement.

Un manifeste qui fonctionne sur votre poste ne suffit pas : il finit dans Git, lu par toute l’équipe et par le pipeline. Ce module traite donc les secrets Monaco Managed avant le reste. Il vaut pour Dynatrace Managed uniquement : jetons d’API classiques, URL de la forme https://<domaine>/e/<id-environnement>, aucune notion d’OAuth ni de jeton de plateforme.

Côté fiabilité, l’enjeu est double. Un jeton publié dans un dépôt oblige à le révoquer en urgence (toil et risque). Un delete lancé sur le mauvais environnement détruit de la configuration de production, ce qui allonge le MTTR d’un incident que vous avez vous-même causé.

Secrets Monaco Managed : tout passe par des variables d’environnement

La documentation de Monaco est explicite : l’outil refuse que des informations sensibles soient saisies directement dans le manifeste. Le champ name d’un jeton ne contient pas le jeton, mais le nom de la variable d’environnement qui le porte. Le code du dépôt officiel confirme que, pour ces secrets, la lecture se fait uniquement depuis l’environnement du processus.

L’URL de l’environnement peut suivre la même logique : type: environment indique que value est un nom de variable et non une adresse.

manifest.yaml avec deux groupes d'environnements, recette et production : URL et jeton lus dans des variables d'environnement

Lignes critiques :

  • url.type: environment : MANAGED_URL_RECETTE est lue dans l’environnement ; l’URL attendue est celle de l’environnement Managed, avec son identifiant ;
  • auth.token.name : nom de la variable qui contient le jeton d’API ;
  • environmentGroups : regroupe les environnements, ici « recette » et « production ». Les commandes deploy et delete acceptent --group (-g) ou --environment (-e), deux options incompatibles entre elles.

Sous Linux ou macOS, saisissez le jeton sans l’écrire dans l’historique du shell :

read -rs TOKEN_MANAGED_RECETTE
export TOKEN_MANAGED_RECETTE
export MANAGED_URL_RECETTE="https://<domaine>/e/<id-environnement>"

La page « Migrate configuration » de la documentation Managed donne le même conseil : ranger le jeton dans un endroit sûr, comme un gestionnaire de mots de passe, puis le fournir par une variable d’environnement du système. Un jeton par environnement : un jeton de recette ne doit pas ouvrir la production.

Portées du jeton

Cette même page liste, pour l’environnement cible d’une migration, des portées en écriture : Write Configuration, Write settings, Write SLO, en plus des portées de lecture. Pour un déploiement, donnez au jeton les seules portées d’écriture utiles aux types de configuration que vous déployez. La page ne précise pas de portée propre à la suppression : ce point est non vérifié, testez en recette.

Environnements multiples : un code, plusieurs cibles

Un projet décrit une configuration ; le manifeste décrit où la déployer. La doc précise que les paramètres peuvent être redéfinis selon le groupe ou l’environnement ciblé. Dans config.yaml, trois mécanismes couvrent l’essentiel :

  • un paramètre type: environment avec name et, en option, default : sans default, une variable absente produit une erreur ;
  • skip, qui peut lui-même venir d’une variable d’environnement ;
  • environmentOverrides (ou groupOverrides), qui remplacent des valeurs pour un environnement nommé.
config.yaml : un objet Settings désactivé par défaut et réactivé en recette par environmentOverrides, un paramètre lu depuis la variable TAG_PROPRIETAIRE avec une valeur par défaut

Ici, tag-equipe n’est déployé qu’en recette. Le schéma builtin:tags.auto-tagging provient des données de test du dépôt Monaco ; vérifiez qu’il existe dans votre version de Managed avant de le reprendre.

Règle simple : une valeur qui change d’un environnement à l’autre et n’est pas secrète va dans environmentOverrides, versionnée. Une valeur secrète ne figure jamais dans un fichier du dépôt : elle passe par type: environment sans default.

Supprimer avec monaco delete

Monaco ne supprime que ce que vous listez. Le fichier delete.yaml (nom par défaut) contient une liste delete. Le format dépend du type de configuration, d’après la documentation et le code du dépôt :

  • API de configuration classique : type et name ;
  • objets Settings 2.0 : project, type (l’identifiant du schéma) et id, l’identifiant Monaco de la configuration ;
  • suppression directe : type et objectId.
delete.yaml avec une zone de gestion supprimée par son nom et un objet Settings supprimé par projet, schéma et identifiant

La commande indiquée dans l’aide du CLI :

monaco delete --manifest manifest.yaml --file delete.yaml --environment recette-managed

Point de vigilance, tiré de l’aide de la commande : sans --environment ni --group, tous les environnements du manifeste sont ciblés. Nommez donc toujours la cible. La commande monaco generate deletefile produit un fichier à partir des projets d’un manifeste, avec les options --types, --exclude-types, --project et --output-folder : relisez-le avant tout usage. La commande purge, elle, n’apparaît que si la variable MONACO_ENABLE_DANGEROUS_COMMANDS est définie : évitez-la.

Bonnes pratiques de dépôt Git

  • Versionnez le manifeste, les projets, les gabarits JSON et le delete.yaml : ils ne contiennent que des noms de variables.
  • Ne versionnez jamais un fichier de variables avec des valeurs réelles : ajoutez-le au .gitignore et fournissez un exemple vide.
  • Faites relire chaque modification par une revue : le diff d’un delete.yaml se lit en deux minutes.
  • Injectez les jetons depuis le coffre de secrets de votre outil d’intégration continue, un par environnement.
  • Activez un contrôle de secrets avant poussée (outil d’analyse de votre choix) : une fuite se détecte avant la publication, pas après.
  • Prévoyez la rotation : un jeton à date d’expiration se remplace sans toucher au dépôt, puisque seule la variable change.

Pour le cadrage général, voyez Dynatrace Monaco : la configuration en code ; pour comparer avec Terraform, voir le parcours Terraform séparé.

Exercice pratique

À réaliser sur un environnement Managed de recette, avec un projet du module 4. Aucune des commandes ci-dessous n’a été exécutée pour rédiger ce module : comparez vos résultats aux attendus décrits, pas à une sortie recopiée.

Étape 1 — Sortir les secrets du manifeste

Remplacez URL et jeton par des références type: environment et token.name, comme dans le premier extrait. Résultat attendu : git grep sur le dépôt ne trouve aucun jeton.

Étape 2 — Valider

Exportez les variables, puis lancez monaco deploy manifest.yaml --dry-run --environment recette-managed. Résultat attendu : la validation réussit. Retirez ensuite une variable utilisée sans default : une erreur doit signaler la variable manquante.

Étape 3 — Différencier recette et production

Ajoutez un environmentOverrides et vérifiez qu’un --dry-run ciblant la production n’inclut pas la configuration réservée à la recette.

Étape 4 — Supprimer en recette

Déployez une configuration de test en recette, écrivez son delete.yaml, puis lancez monaco delete avec --environment recette-managed. Résultat attendu : la configuration disparaît de la recette et reste intacte ailleurs.

Quiz

  1. Que contient auth.token.name dans le manifeste ? a) Le jeton b) Le nom de la variable d’environnement qui contient le jeton c) Le nom du fichier du jeton d) L’identifiant de l’environnement
  2. Que se passe-t-il si monaco delete est lancé sans --environment ni --group ? a) Rien b) Une erreur c) Tous les environnements du manifeste sont ciblés d) Seule la recette est ciblée
  3. Quelle clé de config.yaml remplace une valeur pour un seul environnement ? a) environmentOverrides b) template c) scope d) originObjectId
  4. Quel fichier ne doit jamais contenir de valeur réelle dans Git ? a) manifest.yaml b) delete.yaml c) Un fichier de variables d’environnement d) Un gabarit JSON sans secret

Corrigé

  1. b) Monaco refuse les secrets en clair et lit la variable nommée.
  2. c) Sans cible précisée, tous les environnements du manifeste servent à la suppression.
  3. a) environmentOverrides redéfinit paramètres ou skip pour un environnement nommé.
  4. c) Il porte les valeurs réelles ; seuls les noms de variables sont versionnés.

Pour aller plus loin

← Module 4 : Déploiement Monaco Managed · Sommaire du parcours · Formation Terraform Managed (parcours séparé)

Questions fréquentes

Peut-on mettre le jeton dans le manifeste si le dépôt est privé ?

Non. La documentation de Monaco n’accepte pas les secrets saisis directement, et un dépôt privé reste lisible par toute l’équipe et par ses sauvegardes. Utilisez une variable d’environnement.

Comment éviter un delete sur la production ?

Nommez toujours --environment ou --group, et faites relire le delete.yaml. Sans cible, tous les environnements du manifeste sont visés.

Le même manifeste sert-il pour Managed et SaaS ?

Le format est le même, mais pas l’authentification : ce module n’utilise que des jetons d’API Managed. Le parcours SaaS traite OAuth et jetons de plateforme à part.

Vous savez maintenant garder les secrets hors de Git, cibler un environnement précis et supprimer une configuration de façon contrôlée. Le parcours Monaco s’arrête ici ; Terraform fait l’objet d’une formation séparée.

span.observer est un blog indépendant de la communauté, non affilié à Dynatrace LLC. Ce parcours ne remplace pas les formations et certifications officielles de Dynatrace University. Vérifiez les fonctionnalités dans la documentation officielle de votre version.

Total
0
Shares
Laisser un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *

Previous Post
Déploiement Monaco SaaS : projets, gabarits et dry-run

Déploiement Monaco SaaS : projets, gabarits et dry-run

Next Post
Module 5 — OAuth Monaco SaaS : jetons, secrets, environnements et delete

Module 5 — OAuth Monaco SaaS : jetons, secrets, environnements et delete

Related Posts