Vous pouvez créer des ressources personnalisées utilisables pour créer des modèles de cloud à l'aide de workflows vRealize Orchestrator. Dans ce cas d'utilisation, vous ajoutez une ressource personnalisée qui ajoute un hôte SSH. Vous pouvez ensuite inclure la ressource dans des modèles de cloud. Cette procédure ajoute également un workflow de mise à jour afin que les utilisateurs puissent modifier la configuration SSH après le déploiement plutôt que d'effectuer des actions du jour 2 individuelles.

Les ressources personnalisées sont des objets vRealize Orchestrator ou d'action d'extensibilité que vous gérez au moyen de vRealize Automation Cloud avec les actions de cycle de vie définies dans la ressource personnalisée. Le service de modèle de cloud appelle automatiquement les workflows ou les actions d'extensibilité vRealize Orchestrator appropriés lorsque l'opération associée à une action de cycle de vie spécifique est déclenchée. Vous pouvez étendre la fonctionnalité du type de ressource en sélectionnant également des workflows ou des actions d'extensibilité vRealize Orchestrator qui peuvent être utilisés comme opérations de jour 2.

Ce cas d'utilisation utilise des workflows intégrés fournis dans la bibliothèque vRealize Orchestrator. Il comporte des valeurs ou des chaînes normatives pour expliquer le déroulement du processus. Vous pouvez les modifier afin de les adapter à votre environnement.

Ce cas d'utilisation utilise un projet nommé DevOpsTesting à des fins de référence. Vous pouvez remplacer ce projet par celui dont vous disposez déjà.

Conditions préalables

  • Vérifiez que vous avez configuré l'intégration de vRealize Orchestrator. Reportez-vous à la section Configurer une intégration de vRealize Orchestrator dans Cloud Assembly.
  • Vérifiez que les workflows que vous utilisez pour les actions de création, de mise à jour, de destruction et de jour 2 existent dans vRealize Orchestrator et s'exécutent correctement depuis cet emplacement.
  • Dans vRealize Orchestrator, localisez le type de ressource utilisé par les workflows. Les workflows inclus dans cette ressource personnalisée doivent tous utiliser le même type de ressource. Dans ce cas d'utilisation, le type de ressource est SSH:Host. Pour plus d'informations sur la validation du type de ressource, reportez-vous à la section Types de ressources personnalisées pour les modèles de cloud Cloud Assembly.
  • Vérifiez que vous savez comment configurer et déployer un modèle de cloud de machine.

Procédure

  1. Créez une ressource personnalisée d'hôte SSH pour ajouter SSH à un modèle de cloud.
    Cette étape permet d'ajouter la ressource personnalisée au canevas de conception du modèle de cloud en tant que type de ressource.
    1. Dans Cloud Assembly, sélectionnez Conception > Ressources personnalisées, puis cliquez sur Nouvelle ressource personnalisée.
    2. Fournissez les valeurs suivantes.

      Rappelez-vous que ces valeurs sont données à titre d'exemple, à l'exception des noms de workflows.

      Tableau 1.
      Paramètre Exemple de valeur
      Nom SSH Host - DevOpsTesting Project

      Il s'agit du nom qui apparaît dans la palette des types de ressource du modèle de cloud.

      Type de ressource Custom.SSHHost

      Le type de ressource doit commencer par Custom. et chaque type de ressource doit être unique.

      Bien que l'ajout de Custom. ne soit pas validé dans le champ, la chaîne est automatiquement ajoutée si vous la supprimez.

      Ce type de ressource est ajouté au canevas de conception pour que vous puissiez l'utiliser dans le modèle de cloud.

    3. Pour activer ce type de ressource dans la liste Type de ressource du modèle de cloud, vérifiez que l'option Activer est sélectionnée.
    4. Sélectionnez le paramètre Étendue afin de rendre le type de ressource disponible pour n'importe quel projet DevOpsTesting.
    5. Dans la section Basé sur, vérifiez que Inventaire vRO est sélectionné en tant que fournisseur d'actions de cycle de vie.
    6. Sélectionnez les workflows qui définissent la ressource.
      Paramètre Paramètre
      Actions du cycle de vie : créer Sélectionnez le workflow Ajouter un hôte SSH.

      Si vous disposez de plusieurs intégrations de vRealize Orchestrator, sélectionnez le workflow sur l'instance de l'intégration que vous utilisez pour exécuter ces ressources personnalisées.

      Après avoir sélectionné le workflow, le menu déroulant de type externe devient disponible et est automatiquement défini sur SSH:Host. Un type de source externe ne peut être utilisé qu'une seule fois en cas de partage et une fois par projet. Dans ce cas d'utilisation, vous fournissez la ressource personnalisée uniquement pour le projet DevOpsTesting. Si vous avez d'autres workflows qui nécessitent le type SSH:Host, vous devez créer des ressources personnalisées individuelles pour chaque projet.

      Actions du cycle de vie : Mettre à jour Sélectionnez le workflow Mettre à jour un hôte SSH.
      Actions du cycle de vie : détruire Sélectionnez le workflow Supprimer un hôte SSH.
    7. Vérifiez les valeurs de clé et de type de schéma dans l'onglet Propriétés afin de comprendre les entrées de workflow que vous pouvez configurer dans le modèle de cloud.
      Le schéma répertorie les valeurs d'entrée obligatoires et facultatives définies dans le workflow. Les valeurs d'entrée requises sont incluses dans le code YAML du modèle de cloud.

      Dans le workflow Ajouter un hôte SSH, hostname, port et username sont des valeurs d'entrée requises. Les autres propriétés de schéma ne sont pas requises. Vous pouvez également utiliser le schéma pour déterminer l'emplacement dans lequel vous souhaitez créer des liaisons vers d'autres valeurs de champ, workflows ou actions. Les liaisons ne sont pas incluses dans ce cas d'utilisation.

    8. Pour terminer la création de votre ressource personnalisée, cliquez sur Créer.
  2. Créez un modèle de cloud qui ajoute l'hôte SSH lorsque vous le déployez.
    1. Sélectionnez Conception > Modèles de cloud, puis cliquez sur Nouveau à partir de > Canevas vide.
    2. Nommez le modèle de cloud Machine avec un hôte SSH.
    3. Sélectionnez le projet DevOpsTesting, puis cliquez sur Créer.
    4. Ajoutez et configurez une machine vSphere.
    5. Dans la liste des ressources personnalisées à gauche de la page de conception du modèle de cloud, faites glisser le type de ressource Hôte SSH - Projet DevOpsTesting sur le canevas.
      Note : Vous pouvez sélectionner la ressource personnalisée en faisant défiler l'écran vers le bas et en la sélectionnant dans le volet de gauche, ou en la recherchant dans la zone de texte Rechercher des types de ressources. Si la ressource personnalisée ne s'affiche pas, cliquez sur le bouton Actualiser en regard de la zone de texte Rechercher des types de ressources.
      Un rappel indiquant que le type de ressource est disponible, car il a été configuré pour le projet. Si vous créez un modèle de cloud pour un autre projet, vous ne pouvez pas voir le type de ressource.
    6. À droite, modifiez le code YAML pour y ajouter les valeurs d'entrée obligatoires.
      Ajoutez une section inputs dans le code pour que les utilisateurs puissent fournir le nom d'utilisateur et le nom d'hôte au moment du déploiement. Dans cet exemple, le port par défaut est 22. Dans l'exemple suivant, certaines de ces valeurs sont des exemples de données. Vos valeurs peuvent être différentes.
      inputs: 
        hostname:
          type: string
          title: The hostname of the SSH Host
        username:
          type: string
          title: Username
      
    7. Dans la section resources, ajoutez le code ${input.input-name} pour inviter l'utilisateur à effectuer une sélection :
      resources:
        Custom_SSHHost_1:
          type: Custom.SSHHost
          properties:
            port: 22
            hostname: '${input.hostname}'
            username: '${input.username}'
      
  3. Déployez le modèle de cloud.
    1. Sur la page du concepteur de modèle de cloud, cliquez sur Déployer.
    2. Entrez le Nom du déploiement Test de l'hôte SSH.
    3. Sélectionnez la Version du modèle de cloud et cliquez sur Suivant.
    4. Complétez les entrées de déploiement.
    5. Cliquez sur Déployer.
  4. Surveillez la demande de provisionnement sur la page Déploiements pour vous assurer que l'hôte SSH est inclus dans le déploiement et que celui-ci a réussi.

Que faire ensuite

Lorsque votre modèle de cloud testé fonctionne, vous pouvez commencer à utiliser la ressource personnalisée SSH Host avec d'autres modèles de cloud.