Fonctionnement : effectuer le chargement initial de vos données de configuration existantes dans des tables de données CDM

1. Ouvrez l'interface utilisateur CDM et créez une application. Par exemple, créons l'application Librairie pour prendre en charge une librairie en ligne. Une application dans CDM est la collection complète de données de configuration d'un service d'application, d'un modèle d'application ou d'une groupe de CI dynamique [infrastructure] dans le CMDB.

   

2. Ouvrez maintenant l'application Librairie et générez un nouvel ensemble de changements afin de pouvoir commencer à mettre en place la structure des données. (Une vue d'ensemble plus détaillée de ce processus est disponible dans Préparation d'une application pour le chargement des données de configuration.)

   

   Dans l'ensemble de changements, définissez la structure des données qui inclut un nœud pour chaque ensemble de données de configuration que vous allez charger. Ce processus est appelé modélisation des données. Vous ajoutez des composants, des collections, des éléments déployables et des CDI selon les besoins. Pour plus d'informations sur chacun de ces éléments, consultez Modèle de données CDM. Pour plus d'informations sur l'ajout de nœuds à une application, consultez Préparation d'une application pour le chargement des données de configuration.

   Dans cet exemple, deux composants et deux collections ont été ajoutés. Désormais, le composant PaymentSvc-1.0 est inclus dans la collection Release-1.0. Comme pour toutes les collections, cela signifie que toutes les données du composant PaymentSvc-1.0 sont désormais incluses dans la collection Release-1.0.

   

   Lorsque vous êtes satisfait de la structure (vous pouvez effectuer la mise à jour à tout moment), ouvrez l'Explorateur REST pour commencer le processus de chargement des données de configuration source dans les tables de données CDM. Ne validez pas l'ensemble de changements : il reste ouvert afin que vous puissiez charger des données.

3. À l'aide des API REST ou de l'éditeur de données de configuration, définissez des valeurs de paramètre qui spécifient le nom de l'application vers laquelle effectuer le chargement, le chemin d'accès dans la structure des données de l'application CDM dans laquelle placer les données, le format des données sources (JSON dans l'exemple), etc.
   Remarque :

   Lorsque vous chargez votre configuration existante à partir d'un fichier XML et que ignoreAttributes est défini sur false, l'analyseur XML CDM conserve les attributs en JSON à l'aide d'identificateurs. Pour plus d'informations, consultez Analyse des fichiers XML dans CDM.

   Cet exemple montre l'utilitaire de plateforme Explorateur d'API REST pour plus de clarté. Il s'agit d'un exemple de la façon dont vous pouvez construire une demande REST POST Charger vers les composants qui crée un nœud dbProperties.json dans le composant PaymentSvc-1.0, puis ajoute les données sources au nouveau nœud. (Vous spécifiez les données sources à charger dans un autre champ.) Les API sont décrites dans CdmApplicationsApi, CdmChangesetsApi et CdmSnapshotApi.

   

4. Lorsque vous sélectionnez Envoyer, l'API lit les données de configuration d'origine, les charge et les aligne dans la structure des données CDM.
   Remarque :

   Les éléments de données 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 nombre total maximum de 100 000 CDI.
   • Un seul déployable peut contenir un maximum de 10 000 CDI.

   Pour en savoir plus sur la configuration des paramètres de propriété sn_cdm.max_allowed_cdi_per_application et sn_cdm.max_allowed_cdi_per_deployable, consultez Propriétés système de CDM.
   Important :

   Chaque fois que vous soumettez une demande POST, l'API effectue le POST et génère également un script de chargement. Vous pouvez spécifier l'une des langues de script. L'objectif est de vous permettre d'utiliser le code dans votre système de pipeline pour automatiser le processus de chargement de cette application lors des futurs chargements.
5. Retour à CDM : examinez et mettez à jour les données de configuration comme décrit à la section Préparation d'une application pour le chargement des données de configuration.
6. Lorsque vous êtes convaincu que l'application est une représentation complète et correcte des données de configuration, vous pouvez valider l'ensemble de changements. L'action de validation génère un instantané de chaque élément déployable et l'API stocke les données dans les tables CDM.

   Maintenant que l'application est entièrement en place, vous pouvez gérer les données selon vos besoins : mettre à jour les paramètres de configuration, appliquer des politiques pour valider les données, exporter des instantanés valides des données de configuration, etc.

   Lorsque vous exportez un instantané, le système peut générer un code API que vous pouvez utiliser pour automatiser le processus d'exportation. Consultez Générer un code d'invocation d'API pour un exportateur pour en savoir plus.