Tester un exportateur et exporter un instantané

Définissez et validez les paramètres d’entrée pour tester un exportateur avant d’exporter les données de configuration dans un instantané.

Avant de commencer

Important :

DevOps Config est désormais obsolète et n’est plus pris en charge ni disponible pour une nouvelle activation.

Rôle requis : cdm_exporter_editor ou cdm_editor ou cdm_admin

• Le rôle cdm_secrets est requis pour exporter des instantanés qui incluent des données chiffrées.
• Le cdm_viewer peut exporter n’importe quel instantané qui n’inclut pas de données chiffrées.
• Le cdm_exporter_editor peut créer, modifier, publier et supprimer des exportateurs.

Pourquoi et quand exécuter cette tâche

Assurez-vous d’installer le pack de contenu de l’exportateur pour DevOps Config. Les exportateurs du pack de contenu sont de bons points de départ pour vos exportateurs personnalisés. Certains exportateurs de packs de contenu génèrent des sous-ensembles de données de configuration et d’autres génèrent des données pour des applications complètes. Par exemple, pour exporter des données de configuration mises à jour pour une base de données, vous pouvez sélectionner l’exportateur returnAllDataforNodeName . Dans les arguments d’entrée de l’exportateur, vous devez spécifier le déployable de base de données en tant que nœud, puis spécifier les paramètres mis à jour en tant qu’arguments d’entrée. Une fois que vous avez déterminé que les paramètres génèrent les données de configuration souhaitées, vous pouvez exporter ces données vers le pipeline.

• Les exportateurs du pack de contenu ont la valeur Source de ServiceNow. Vous pouvez dupliquer, mais vous ne pouvez pas supprimer ou modifier les exportateurs de packs de contenu.
• Vous ne pouvez exécuter que les exportateurs publiés.
• Pour l’exportation, les instantanés ne peuvent pas dépasser 10 000 éléments de données de configuration (CDI) par déployable ou 100 000 CDI par application.
• Pour plus d’informations sur la création d’un exportateur personnalisé, reportez-vous à la section Créer un exportateur personnalisé.
• Les enregistrements des exécutions des exportateurs sont supprimés après une période de trois ans. Pour obtenir des instructions sur la modification de la période par défaut, reportez-vous à la section Définir la période de purge pour les enregistrements d’exécutions d’exportateurs.

Procédure

1. Sélectionnez l’icône ) pour ouvrir la page Administration .
2. Dans l’onglet Exportateurs , sélectionnez le nom de l’exportateur.
   Conseil :

   Ajoutez les exportateurs couramment utilisés à la liste Mes exportateurs pour y accéder rapidement.
3. Sélectionnez la version de l’exportateur dans l’onglet Versions .
   L’exportateur s’ouvre dans l’onglet Générateur d’exportateur . Le texte du script de l’exportateur s’affiche dans un panneau en lecture seule. Utilisez le panneau Terrain de jeu de test pour spécifier l’instantané à exporter et tester les paramètres avant d’exporter les données de configuration.
4. Spécifiez les paramètres d’exécution de l’exportateur sur la page Sélectionner les entrées .

   Tableau 1. Tester les paramètres du terrain de jeu

   Champ	Description
   Instantané déployable et publié à exporter	Déployable pour l’exportation et l’instantané publié particulier que vous avez validé et que vous souhaitez utiliser. Les déployables apparaissent dans la liste en utilisant le format <AppName/DeployableName>. Lorsque vous sélectionnez un déployable, un autre champ répertorie tous les instantanés publiés pour le déployable. L’instantané le plus récemment publié apparaît en premier dans la liste. Sélectionnez l’instantané à exporter.
   Arguments d'entrée	Les arguments que le script de l’exportateur utilise pour générer des données de configuration en tant que sortie. La zone de texte affiche les valeurs par défaut de tous les arguments. Mettez à jour les valeurs si nécessaire.
   Format de sortie	Format dans lequel générer les données de configuration.
   Déployables supplémentaires	Déployables pour lequel générer des données de configuration en plus du déployable primaire que vous avez spécifié dans le champ Instantané déployable et publié à exporter . Seuls les derniers instantanés publiés apparaissent pour ce paramètre facultatif.

5. Sélectionnez Évaluer.
   • Le script de l’exportateur s’exécute à l’aide des paramètres que vous avez spécifiés.
   • Le panneau Terrain de jeu de test affiche la page de sortie Révision.
   • Les données de configuration générées par l’exportateur apparaissent dans la zone Sortie .
   • Le système répertorie les informations sur l’exécution dans l’onglet Exécutions .
6. Passez en revue les résultats.
   1. Pour apporter des modifications, sélectionnez Sélectionner les entrées, spécifiez de nouveaux paramètres, puis sélectionnez Évaluer.
   2. Répétez l’étape précédente aussi souvent que nécessaire.
   Remarque :

   Lorsque vous êtes satisfait que l’exportateur génère des données de configuration complètes et respecte les normes de format de sortie requises, vous pouvez le publier et l’activer.
7. Publiez l’exportateur en sélectionnant Publier dans l’onglet Générateur d’exportateur .
   Remarque :

   Vous devez définir un exportateur sur actif pour qu’il puisse être exécuté dans un pipeline.