Chargement de vos données de configuration
Vous créez d’abord une nouvelle CDM structure d’application, puis chargez les données de configuration existantes dans la structure.
Comment ça marche : exécution du chargement initial de vos données de configuration existantes dans CDM des tables de données
- Ouvrez l’interface CDM utilisateur 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 pour un service d’application, un modèle d’application ou groupe de CI dynamique une [infrastructure] dans le CMDB.
- Ouvrez maintenant l’application Librairie et générez un nouvel ensemble de modifications afin de commencer à mettre en place la structure des données. (Un aperçu plus détaillé 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 de données qui inclut un nœud pour chaque ensemble de données de configuration que vous allez charger. Ce processus s’appelle la modélisation des données. Vous ajoutez des composants, des collections, des déployables et des CDI selon vos besoins. Pour plus d’informations sur chacun de ces éléments, reportez-vous à la section Modèle de données CDM. Pour plus d’informations sur l’ajout de nœuds à une application, reportez-vous à la section 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 la mettre à jour à tout moment), vous ouvrez l’explorateur REST pour commencer le processus de chargement des données de configuration source dans les CDM tables de données. Ne validez pas l’ensemble de changements : il reste ouvert afin que vous puissiez charger des données.
- À 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 charger, le chemin dans la structure de données de l’application CDM où 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 au format 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 de téléchargement vers des 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, CdmChangesetsApiet CdmSnapshotApi.
- Lorsque vous sélectionnez Envoyer, l’API lit les données de configuration d’origine, les télécharge et les aligne dans la structure des CDM données.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.
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 suivantes. L’objectif est que vous utilisiez le code dans votre système de pipeline pour automatiser le processus de chargement de cette application lors de chargements futurs. - Revenir à CDM: examinez et mettez à jour les données de configuration comme décrit dans Préparation d’une application pour le chargement des données de configuration.
- Lorsque vous êtes satisfait 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 déployable et oblige l’API à stocker les données dans CDM des tables.
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.
Pendant que vous exportez un instantané, le système peut générer du 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.