Déplacer une API dans le cloud d’un environnement à l’autre

Utilisez des ensembles de mises à jour pour déplacer une API dans le cloud d’un environnement à un autre. Les ensembles de mises à jour vous permettent de regrouper une API dans le cloud et ses dépendances dans un ensemble nommé, puis de les déplacer en tant qu’unité vers d’autres systèmes à des fins de test ou de déploiement. Par exemple, vous pouvez déplacer une API dans le cloud d’un environnement de développement vers un environnement de production.

Avant de commencer

• Les utilisateurs disposant du rôle sn_cmp.cloud_service_designer peuvent uniquement exporter des ensembles de données.
• Les utilisateurs disposant du rôle admin peuvent exporter et importer des ensembles de mises à jour.

Rôle requis : sn_cmp.cloud_service_designer ou admin

Pourquoi et quand exécuter cette tâche

Empaquetez l’API dans le cloud en tant qu’ensemble de mises à jour. Exportez ensuite l’ensemble de mises à jour de son environnement actuel et importez-le dans l’autre environnement.

Remarque :

Si une API cloud que vous exportez à partir de l’environnement source existe dans l’environnement cible, lorsque vous importez cette API cloud, cela génère deux API cloud portant le même nom : une API cloud qui existait avant l’importation et une autre API cloud que vous venez d’importer. Par exemple, si vous exportez l’API de configuration Ansible à partir de l’environnement de développement et que vous disposez déjà d’une API cloud portant le même nom dans l’environnement de production, lorsque vous importez l’API de configuration Ansible dans l’environnement de production, deux API cloud portant le même nom, l’API de configuration Ansible, résident dans l’environnement de production.

Procédure

1. Dans le portail d’administration du cloud, accédez à Conception > Cloud API > API.
   Toutes les API dans le cloud s’affichent dans la fenêtre API dans le cloud.
2. Exporter l’API dans le cloud.
   1. Cliquez sur l’icône Exporter l’API dans le cloud (icône ) pour que l’API dans le cloud soit exportée.

      Figure 1. Fenêtre de l’exportateur d’API dans le cloud

      

   2. Dans la fenêtre Exportateur d’API dans le cloud, cliquez sur un objet dans la colonne Type.
      Dans la colonne de droite, sélectionnez les entrées correspondantes pour l’objet que vous souhaitez exporter avec l’API cloud. Par exemple, si vous sélectionnez Script MID, tous les scripts MID correspondants s’affichent dans la colonne de droite.
   3. Cliquez sur Suivant.
      Une fenêtre s’ouvre avec un résumé des dépendances indirectes de l’API dans le cloud que vous avez choisi d’inclure dans l’ensemble de mises à jour d’exportation.
   4. Cliquez sur Exporter l’ensemble de mises à jour.
      La fenêtre de l’exportateur d’API dans le cloud s’ouvre avec la case à cocher Réussite sélectionnée en vert, indiquant que l’API dans le cloud a été exportée avec succès avec toutes ses dépendances. Par défaut, tous les fichiers répertoriés sous Environnements de mise à jour exportés sont automatiquement téléchargés sur votre système.

      

      Remarque :

      Le nombre d’ensembles de mises à jour créés est basé sur le champ d’application des enregistrements en cours d’exportation. Par exemple, supposons que l’API dans le cloud que vous exportez compte 100 enregistrements en tout : 60 enregistrements sont dans le champ d’application un, 20 enregistrements sont dans le champ d’application deux et les 20 enregistrements restants sont dans le champ d’application trois. Dans un tel scénario, trois ensembles de mises à jour sont créés. Un ensemble de mises à jour pour chaque champ d’application.
3. Assurez-vous que les fichiers sont téléchargés.
   Si les fichiers ne sont pas téléchargés, procédez comme suit :
   1. Cliquez sur le fichier de métadonnées.
      Le fichier de métadonnées mentionne l’ordre dans lequel les fichiers exportés doivent être importés. Dans cet exemple, le fichier intitulé Ansible Tower Configuration API0 est le premier fichier à être exporté, suivi du fichier intitulé Ansible Tower Configuration API1.
   2. En fonction de l’ordre mentionné dans le fichier de métadonnées, cliquez sur le fichier approprié pour l’ouvrir.
      Une fenêtre s’ouvre avec une liste de tous les fichiers contenus dans l’ensemble de mises à jour.
   3. Pour télécharger le premier fichier XML (dans cet exemple, le fichier est API0 2018-05-03) sur votre système, cliquez sur Exporter vers XML.
   4. Ouvrez l’autre fichier XML (dans cet exemple, le fichier est API1 2018-05-03) et téléchargez-le sur votre système.
      Importez tous les fichiers exportés dans un autre environnement. Par exemple, vous avez peut-être créé l’ensemble de mises à jour d’exportation dans un système qui exécute l’environnement de développement et souhaitez l’importer dans un autre système qui exécute l’environnement de production.
4. Importez l’API dans le cloud.
   1. Dans l’environnement et la nouvelle instance dans laquelle vous souhaitez importer les fichiers, saisissez Ensembles de mises à jour récupérés dans le navigateur de filtre, puis appuyez sur la touche Entrée.
   2. Cliquez sur le lien connexe Importer l’ensemble de mises à jour à partir d’un XML .
   3. Dans la fenêtre Importer XML qui s’affiche, cliquez sur Choisir un fichier, sélectionnez le fichier d’exportation, puis cliquez sur Charger.
      L’API dans le cloud est importée dans votre nouvel environnement.
5. Pour vérifier que le plan est importé dans le nouvel environnement, accédez à votre instance dans le nouvel environnement et, dans le Portail d'administration du cloud, accédez à Conception > Cloud API > API.
   L’API dans le cloud que vous avez importée doit apparaître dans la liste des API dans le cloud.