Ajouter les nœuds qui contiendront des données de configuration à une nouvelle CDM application

Rversion finale: Yokohama

Mis à jour 30 janv. 2025

4 minutes de lecture

Ajoutez la structure des données à une nouvelle application qui acceptera les données de configuration chargées dans les nœuds appropriés.

Avant de commencer

Important :

À partir de la version Washington DC, DevOps Config ne sera plus disponible. L'application sera masquée et ne sera plus installée sur les nouvelles instances, mais continuera d'être prise en charge. Pour en savoir plus, consultez l'article Processus de retrait [KB0867184] dans la base de connaissances Now Support.

Rôle requis : Administrateur CDM [sn_cdm.cdm_admin]

Pourquoi et quand exécuter cette tâche

Lorsque le système crée une nouvelle application, elle ne possède que le niveau de structure le plus élevé : composants, collections et dossiers déployables . Dans cette procédure, vous ajoutez le composant, la collection et déployable les nœuds qui accepteront les données de configuration chargées. Lorsque vous chargez des données de configuration existantes dans l’application, le système mappe les données sous forme de paires [nom :valeur] (éléments de données de configuration - CDI) dans le nœud approprié de la structure de données de l’application CDM . Pour plus d'informations, consultez Modèle de données CDM.

Remarque :

Gestion des données de configuration À partir de la version 4.2, vous pouvez définir un nœud à l’aide de n’importe quel caractère UTF-8, y compris la barre oblique (/).

Procédure

Créez les composants qui seront inclus dans les collections.
Pour plus d'informations, consultez Définir ou mettre à jour un composant et Définir ou mettre à jour une collection dans une application.
Ajouter une collection à un ou plusieurs déployables:
1. Pour le nœud de collection de l’arborescence, sélectionnez l’icône de menu (icône ) et sélectionnez Inclure dans les éléments déployables.
2. Sélectionnez tout déployables dans lequel inclure la collection, puis sélectionnez Inclure.
  
  Remarque :
  Seuls déployables ceux qui n’incluent pas déjà la collection ou l’un de ses descendants apparaissent dans la liste. Si la collection porte le même nom qu’un nœud existant, la collection est transformée en remplacement ou en superposition.
  
  La collection est incluse dans chaque fichier déployable.
Lorsque vous ajoutez une collection à un déployable, le panneau Éditeur affiche les noms des collections incluses mais pas leur contenu (des remplacements ou des superpositions apparaissent). Cette stratégie réduit l’encombrement et clarifie la structure. Pour afficher le contenu entièrement résolu des données, affichez le panneau Aperçu .
Créez les composants qui seront inclus dans les collections.
Facultatif : Ajoutez des CDI à la déployable qui remplaceront ou superposeront les paramètres dans les composants ou les collections.
Remarque :
Les éléments de données téléchargés sont triés par ordre alphabétique dans les dossiers structurels pour vous permettre de localiser rapidement des éléments particuliers.
Le système impose les limites suivantes au nombre d’éléments de données de configuration (CDI) :

Une application peut contenir un total maximal de 100 000 CDI.

Tout single déployable peut contenir un maximum de 10 000 CDI.

Pour plus d’informations sur la configuration des paramètres des propriétés, reportez-vous à la sn_cdm.max_allowed_cdi_per_application section Propriétés système CDM .sn_cdm.max_allowed_cdi_per_deployable
Pour en savoir plus, reportez-vous à Définir ou mettre à jour un composant, Définir ou mettre à jour une collection dans une applicationou Créer ou mettre à jour un CDI variable.
Sélectionnez Enregistrer pour enregistrer les changements dans l’ensemble de changements et préparer les changements dans l’ensemble de changements à valider.
Le panneau Éditeur, la vue Liste et le panneau Aperçu s’actualisent pour refléter l’état résolu de l’ensemble de changements. Le système met à jour l’ensemble de changements, mais ne met pas à jour l’application. Les changements apparaissent dans l’onglet Activité . Vous devez valider un ensemble de changements pour mettre à jour les données de configuration de l’application. Après l’enregistrement, vous pouvez passer à d’autres activités et revenir plus tard pour modifier l’ensemble de changements.
Facultatif : Sélectionnez Valider.
La boîte de dialogue Valider l’ensemble de changements s’ouvre et répertorie tous les déployable éléments affectés par les changements.
Remarque :
Après avoir validé un ensemble de changements, celui-ci ne peut plus être modifié.
Le système génère un instantané de chaque déployable élément affecté par les changements. La boîte de dialogue propose les actions supplémentaires suivantes :
- Si aucun n’est déployables affecté par les changements, sélectionnez Aucune action supplémentaire. Le système mettra à jour l’application pour conserver les modifications.
- - Sélectionnez Valider les instantanés pour effectuer les opérations suivantes sur tous les instantanés générés :
    - Le système exécute toutes les politiques qui sont mappées statiquement ou dynamiquement au déployable.
    - Si l’instantané réussit toutes les politiques, la valeur de l’état de validation est définie sur Réussi et aucune entrée n’est répertoriée dans l’onglet Résultats de validation . Si la validation a été invoquée avec l’option Publier une publication valide , les instantanés valides sont publiés automatiquement.
    - Si une politique rencontre des problèmes, la valeur de l’état de validation est définie sur Échec. L’onglet Résultats de validation affiche toutes les défaillances ou tous les avertissements renvoyés par les politiques.
    - Si une politique n’a pas été exécutée jusqu’à son terme, la valeur de l’état de validation est définie sur Erreur d’exécution et l’onglet Résultats de validation indique que la validation a échoué en raison d’une erreur.
  - Sélectionnez Valider et publier les instantanés pour effectuer la validation comme décrit dans l’action Valider les instantanés . Seuls les instantanés ayant passé la validation sont publiés. Seuls les instantanés publiés peuvent être exportés.
  Sélectionnez Valider.
  - Le système met à jour l’application pour conserver les modifications apportées aux données de configuration.
  - L’état de l’ensemble de changements devient Validé.
  - L’ensemble de changements ne peut pas être modifié.
  - Si des instantanés ont été créés, le message de confirmation inclut un lien vers les instantanés.
  - Si une erreur se produit pendant le processus de validation, l’état de l’ensemble de changements est défini sur Échec de la validation.

Que faire ensuite

L’application ne contient pas encore de données de configuration, l’étape suivante consiste donc à importer vos données de configuration existantes dans les nœuds appropriés de l’application. Consultez Chargement de vos données de configuration.