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

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 4 minutes de lecture

    • Ajoutez la structure de 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 application, celle-ci n’a que le niveau de structure le plus élevé : dossiers de composants, de collections et d’éléments 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.

    Procédure

    1. 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.
    2. Ajouter une collection à un ou plusieurs déployables:
      1. Pour le nœud de collecte dans l’arborescence, sélectionnez l’icône de menu ( icône Menu)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, elle 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 Editeur affiche les noms de collections incluses, mais pas leur contenu (des remplacements ou des superpositions apparaissent). Cette stratégie permet de réduire l’encombrement et de clarifier la structure. Pour afficher le contenu entièrement résolu des données, affichez le panneau Aperçu .

    3. Créez les composants qui seront inclus dans les collections.
    4. Facultatif : Ajoutez des CDI qui déployable 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 maximum de 100 000 CDI.
      • Un seul déployable peut contenir un maximum de 10 000 CDI.
      Pour Propriétés système de CDM plus d’informations sur la configuration des paramètres de propriété, reportez-vous à la sn_cdm.max_allowed_cdi_per_application section .sn_cdm.max_allowed_cdi_per_deployable
      Pour plus d’informations, reportez-vous à la section Définir ou mettre à jour un composant, Définir ou mettre à jour une collectionou Créer ou mettre à jour un CDI de variable.
    5. Sélectionnez Enregistrer pour enregistrer les changements dans l’ensemble de changements et préparer les changements dans l’ensemble de changements à valider.
      Les panneaux Éditeur, Liste et Aperçu sont actualisés 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.
    6. Facultatif : Sélectionnez Valider.
      La boîte de dialogue Valider l’ensemble de changements s’ouvre et répertorie tous ceux déployable qui sont affectés par les changements.
      Remarque :
      Une fois que vous avez validé un ensemble de changements, celui-ci ne peut pas être modifié.
      Le système génère un instantané de chacune déployable des propriétés affectées par les changements. La boîte de dialogue propose les actions supplémentaires suivantes :
      • Si aucune action supplémentaire n’est déployables affectée 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 stratégies mappées à la stratégie associée déployable.
          • Si l’instantané réussit toutes les politiques, la valeur É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 État de validation est définie sur Échec. L’onglet Résultats de validation affiche tous les échecs ou avertissements renvoyés par les politiques.
          • Si une politique n’a pas pu être exécutée jusqu’à son terme, la valeur É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 qui passent 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 changements apportés 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 contenant 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.