Documentation Oracle Cloud Infrastructure

Création d'un classeur

Créez un classeur personnalisé dans Fleet Application Management à l'aide du concepteur visuel.

Fleet Application Management fournit plusieurs classeurs d'exécution avec des étapes prédéfinies que vous pouvez utiliser pour effectuer des tâches courantes de gestion du cycle de vie telles que les vérifications de l'état avant exécution ou le repérage du serveur HTTP Oracle. Ces runbooks sont disponibles dans la bibliothèque de runbooks. Vous pouvez également créer vos runbooks personnalisés et les publier pour tous les utilisateurs.

  • Sur la page de liste Runbooks, sélectionnez Créer un runbook. Si vous avez besoin d'aide pour trouver la page de liste, reportez-vous à Liste des guides d'exécution.

    La création d'un guide d'exploitation se compose des pages suivantes :

    Exécutez chacun des workflows suivants dans l'ordre. Vous pouvez revenir à une page précédente, en sélectionnant Précédent.

    1. Informations de base

    La page Informations de base vous permet de fournir les informations de base du guide d'exploitation.

    Saisissez les informations suivantes :

    • Nom : entrez le nom convivial du guide d'exploitation. Le nom n'a pas besoin d'être unique, mais il ne peut pas être modifié dans la console. Vous pouvez toutefois le modifier à l'aide de l'API. Evitez de saisir des informations confidentielles.
    • Description : Entrez une description appropriée pour le guide d'exploitation.
    • Créer dans le compartiment : sélectionnez le compartiment vers lequel créer le guide d'exploitation.
    • Compartiment de l'opération de cycle de vie : sélectionnez un compartiment dans lequel existe l'opération de cycle de vie spécifique. Pour connaître les différentes opérations de cycle de vie, reportez-vous à Opération de cycle de vie dans Fleet Application Management.
    • Opération de cycle de vie : sélectionnez une opération de cycle de vie, par exemple un patch, un repérage, un provisionnement ou une opération personnalisée.
    • Pour les opérations de cycle de vie de patch ou de repérage, entrez les informations suivantes :
      • Compartiment de pile produit/produit : sélectionnez le compartiment dans lequel se trouve la pile produit ou produit.
      • Pile produit/produit : sélectionnez un produit ou une pile de produits auquel la tâche appartient dans le compartiment.
    • Type de système d'exploitation : sélectionnez une plate-forme prise en charge parmi les options sur lesquelles le guide d'exploitation s'exécute.
    • Temps estimé (heures) : sélectionnez le temps estimé en heures pour terminer l'exécution du guide d'exploitation.
    • Définir comme guide d'exploitation par défaut : activez l'option permettant à Fleet Application Management d'utiliser ce guide d'exploitation comme guide d'exploitation par défaut pour effectuer des opérations de cycle de vie.
      Remarque

      Vous ne pouvez définir qu'un seul classeur pour une opération de cycle de vie et une combinaison produit/pile de produits spécifiques en tant que classeur par défaut. Fleet Application Management utilise le classeur de repérage par défaut d'un produit ou d'une pile de produits pour repérer l'inventaire logiciel du produit et le classeur d'application de patches par défaut pour sélectionner automatiquement un classeur lors de la création de la programmation et des tâches de correction de conformité.
    • Ce guide d'exploitation nécessite un accès SUDO : activez l'option si le type de système d'exploitation est Oracle Linux pour repérer et appliquer les patches du logiciel exécuté sur les instances Compute.

      L'accès sudo est requis lorsque la prise en charge des produits est nécessaire pour Oracle WebLogic Server, Oracle HTTP Server (OHS) et Oracle Java, qui ne sont pas propres à OCI.

      Remarque

      Lorsque l'accès sudo est activé pour le guide d'exploitation, le module d'extension de gestion des applications de parc exécute les tâches avec le privilège sudo. Le module d'extension Fleet Application Management utilise un privilège sudo intégré, mais il est entièrement contrôlé via la propriété runbook isSudoAccessNeeded. Reportez-vous à Référence Runbook.

    Sélectionnez Suivant pour passer à l'étape suivante.

    2. Rationaliser (classeur de conception)

    La page Rationaliser (concevoir le guide d'exécution) permet de concevoir un workflow de guide d'exécution à l'aide du concepteur visuel ou du code de guide d'exécution.

    Avec le concepteur visuel, vous pouvez faire glisser une action du panneau Actions vers le canevas, en la plaçant à l'emplacement voulu dans le workflow de votre guide d'exploitation. Vous pouvez également réorganiser les actions de votre flux de travail en les faisant glisser vers un autre emplacement.

    1. Sélectionnez l'une des options suivantes :
      • Vue de conception : utilisez le concepteur visuel en faisant glisser les composants et en les configurant. Passez à l'étape 2.
      • Vue Code : chargez le code du guide d'exploitation dans un fichier YAML ou JSON. Passez à l'étape 3.
    2. Si vous avez sélectionné Vue de conception pour la création du guide d'exploitation, procédez comme suit :
      Important

      Pour ajouter une tâche, vous devez d'abord ajouter un groupe de ressources parallèle ou non simultané. Une tâche doit se trouver dans un groupe. Pour en savoir plus sur l'utilisation du concepteur visuel, reportez-vous à Conception d'un guide d'exploitation avec Visual Designer.
      1. Dans l'onglet Composants du panneau Actions, sélectionnez un groupe de ressources parallèle ou un groupe de ressources non simultané et faites-le glisser sur le canevas. Ajoutez autant de groupes que nécessaire.
        • Pour l'exécution parallèle de tâches de guide d'exploitation sur plusieurs ressources, sélectionnez un groupe parallèle. Un groupe de ressources parallèle est un espace réservé pour une ou plusieurs tâches qu'il contient, ou un autre groupe de tâches parallèle qui exécute plusieurs tâches sur une ressource cible en parallèle. Pour chaque tâche ajoutée à un groupe de ressources parallèle, la liste des tâches est exécutée les unes après les autres sur une ressource spécifique, mais simultanément sur une liste de ressources.
        • Pour l'exécution séquentielle des tâches du dossier d'exécution, sélectionnez un groupe de ressources non simultané. Un groupe de ressources non simultanées est un espace réservé pour une ou plusieurs tâches où la liste des tâches est exécutée les unes après les autres sur une ressource spécifique. Une fois les tâches exécutées avec succès dans la ressource, la tâche suivante est exécutée sur une autre ressource.
        Conseil

        Vous pouvez réorganiser les composants à l'aide de l'icône Glisser-déposer (poignée de glissière) dans l'angle droit d'un composant et le faire glisser vers un autre emplacement dans la zone de travail du guide d'exploitation. Une fois que vous avez placé un composant sur le canevas, son code est automatiquement généré et ajouté au code du guide d'exploitation.
      2. Sélectionnez une nouvelle tâche et faites-la glisser vers un groupe de ressources que vous avez ajouté. Entrez les détails sur la page Créer une tâche. Pour obtenir des instructions, reportez-vous aux étapes 4 à 17 de la section Création d'une tâche à l'aide de la console. Vous pouvez également ajouter une tâche prédéfinie en la faisant glisser vers un groupe de ressources.
        • Les tâches que vous créez dans le runbook sont locales pour le runbook et ne peuvent pas être réutilisées par d'autres runbooks.
        • La bibliothèque de tâches fournit une liste des tâches réutilisables qui existent ou que vous avez créées. Vous pouvez utiliser l'icône de manipulation glisser-déplacer (icône de poignée de traînée) dans le coin droit d'une tâche pour la faire glisser vers le groupe de ressources.
          Conseil

          Vous pouvez d'abord créer des tâches de bloc d'exécution selon vos besoins, puis les ajouter ultérieurement à des blocs d'exécution.
        • Pour créer une copie de la tâche dans la bibliothèque de tâches, sélectionnez Faire une copie de cette tâche dans la bibliothèque. Cette tâche fait alors partie du livre d'exécution et de la bibliothèque de tâches. Toutefois, vous pouvez réutiliser et mettre à jour la tâche de bibliothèque indépendamment de la tâche de classeur.
      3. Pour mettre à jour les propriétés d'une tâche, sélectionnez l'icône de modification en regard de la tâche, puis mettez à jour les valeurs de champ sur la page Modifier une tâche.
      4. Après avoir ajouté les composants requis au guide d'exploitation, sélectionnez l'icône de propriétés (icône de paramètres) du composant pour le configurer à l'aide de l'onglet Propriétés.
      5. Entrez un nom d'étape unique en fonction de son objectif. Evitez de saisir des informations confidentielles.
      6. Sélectionnez l'une des actions suivantes dans la liste En cas d'échec pour configurer la façon dont l'automatisation peut gérer les erreurs dans le workflow du classeur :
        Remarque

        Par défaut, lorsqu'un composant de guide d'exploitation signale une erreur, l'automatisation de la gestion des applications de parc arrête entièrement le workflow du guide d'exploitation. En effet, la valeur par défaut de la propriété En cas d'échec pour tous les composants est Abandonner.
        • Abandonner : arrêtez entièrement le workflow du bloc d'exécution lorsque l'exécution du composant échoue. Cette action est définie par défaut.
        • Continuer : passez à l'étape suivante du workflow de classeur d'exécution lorsque l'exécution du composant échoue.
        • Annuler : annulez la modification et revenez au niveau auquel le composant de bloc d'exécution était initialement.

          Pour effectuer une restauration, assurez-vous de sélectionner la propriété En cas d'échec comme Annulation. Vous pouvez indiquer la fonction d'annulation au niveau de la cible ou du groupe (groupe d'actions). Pour effectuer une restauration au niveau de la cible, sélectionnez En cas d'échec des tâches ou En cas d'échec des tâches d'annulation pour effectuer une restauration au niveau du groupe.

      7. Pour créer des instructions conditionnelles pour chaque composant de guide d'exploitation à l'aide de l'option Condition,
        Saisissez une variable dans la zone de condition, sélectionnez l'un des opérateurs arithmétiques, tels que AND, NOT ou autres, et entrez une valeur pour la condition. Voici un exemple d'instruction conditionnelle :
        Pour la condition suivante, si la variable backuptype d'une tâche est égale à la valeur hot, la tâche est exécutée ou le générateur de conditions ignore et passe à la tâche suivante. 
        backuptype=hot
      8. Configurez Exécuter le pour sélectionner l'une des options suivantes afin d'exécuter une tâche :
        • Instances spécifiées par la programmation : pour autoriser l'exécution conditionnelle d'une tâche uniquement sur certains composants applicables au produit (tels que définis dans les métadonnées du produit) sur la ressource, sélectionnez Filtrer les instances. Pour obtenir des instructions sur l'ajout de conditions de filtre, reportez-vous à la sous-étape i.
        • Instance auto-hébergée : pour vérifier l'activité de post-provisionnement, si nécessaire, sélectionnez une instance auto-hébergée appropriée que vous avez créée sous Gestion des métadonnées dans la section Administration.
          Remarque

          La sélection d'une instance garantit que la tâche est exécutée uniquement sur cet hôte (instance).

          Par exemple, il peut y avoir deux tâches dont le type d'action de la première tâche est Exécuter un Terraform qui provisionne les ressources. La deuxième tâche peut être avec le type d'action Exécuter un script, où le script inclut l'instance auto-hébergée (hôte central) qui vérifie si les ressources sont provisionnées et en cours d'exécution.

          Important

          Veillez à activer le module d'extension de gestion des applications de parc sur votre instance auto-hébergée et l'instance associée. Cette étape garantit que Fleet Application Management peut prendre en compte efficacement ces instances pour les opérations de cycle de vie.
        • Instance indiquée par la tâche précédente : permet de vérifier si des ressources provisionnées sont créées et en cours d'exécution lorsque vous ne configurez pas d'hôte central.
          Par exemple, il peut y avoir deux tâches qui effectuent les opérations suivantes :
          1. Créez une première tâche avec le type d'action Exécuter un Terraform qui provisionne les instances Compute et renvoie l'OCID des ressources provisionnées en tant que variable de sortie.
          2. Créez une deuxième tâche avec le type d'action Exécuter un script.
          3. Sélectionnez Variable de sortie de la tâche précédente pour fournir les variables de tâche.
          4. Entrez l'OCID de ressource renvoyé par la sous-étape i ou un type de ressource facultatif. Ajoutez des informations supplémentaires sur l'hôte telles que créées par la première tâche. Les OCID ou les types de ressource servent d'entrée à la deuxième tâche.
            Conseil

            Les informations sur l'hôte peuvent être fournies sous forme de fichier JSON avec des OCID de ressource décrits en tant que tableau.

          Fleet Application Management analyse désormais les variables de sortie et exécute le script sur les ressources.

      9. Si vous avez sélectionné Instances spécifiées par programmation à l'étape h, sélectionnez Instances pour ouvrir la boîte de dialogue Filtrer les instances.
        • Sélectionnez les propriétés du produit ou du composant dans le champ de gauche pour l'ajouter au champ de filtre de droite.
        • Sélectionnez l'un des opérateurs arithmétiques, tels que AND, NOT ou d'autres.
        • Saisissez une valeur pour la condition dans la zone de condition.
          Remarque

          Lorsque vous sélectionnez des propriétés de produit ou de composant, la zone de filtre est remplie avec une condition grammaticale pertinente.
          Voici un exemple de la condition de grammaire Exécuter le : 
          target.product.name = <product_name>
target.product.properties.<property_name> = <property_value>
target.product.components.has(<component_name>)
target.product.components.<component_name>.properties.<property_name> = <property_value>
          Remarque

          Les conditions basées sur les propriétés dépendent de votre compréhension du repérage des produits.
        Ajoutez d'autres instances de filtre selon vos besoins. Ces instances sont ajoutées à la ligne suivante dans la zone de filtre.
      10. Activez l'option Mettre en pause l'exécution pour arrêter ou retarder l'exécution des tâches pendant une période spécifique jusqu'à ce que certaines conditions soient remplies. Par exemple, vous pouvez choisir de suspendre l'exécution d'une tâche indéfiniment ou jusqu'à ce que vous repreniez la tâche, ou pour une heure spécifique que vous sélectionnez.
      11. Pour être averti lorsque le statut de la tâche change, activez le bouton à bascule Notification, puis cochez la case correspondant à l'activité de la tâche pour laquelle vous souhaitez être averti (par exemple, en cas d'échec de la tâche, de pause ou de réussite de la tâche).
      12. Configurez les propriétés des tâches que vous ajoutez. Pour une description des propriétés de tâche, reportez-vous aux étapes 4 à 17 de la section Création d'une tâche à l'aide de la console.
    3. Si vous avez sélectionné la vue Code pour la création du guide d'exploitation à l'étape 1, indiquez si vous utilisez JSON ou YAML, puis sélectionnez Télécharger le code du guide d'exploitation pour ajouter le fichier approprié.
    Sélectionnez Suivant pour passer à l'étape suivante.

    3. Consulter

    Vérifiez le contenu du guide d'exploitation sur la page Vérifier. Modifiez les paramètres ou revenez aux écrans précédents pour ajouter des informations.

    Sélectionnez Enregistrer en tant que brouillon pour enregistrer le guide d'exploitation au départ jusqu'à ce que vous soyez certain de tous les composants.
    Remarque

    Cette version provisoire du guide d'exploitation n'est pas active, ne peut pas être utilisée et est marquée comme brouillon.

    Pour rendre le guide d'exploitation utilisable une fois que vous êtes sûr de toutes ses tâches et que vous l'avez rationalisé (séquence d'exécution), sélectionnez Publier la dernière version sur la page de détails du guide d'exploitation.

    Le guide d'exécution publié peut être utilisé dans le provisionnement, le repérage, l'application de patches ou l'annulation (rollback), et son statut est Actif.
    Remarque

    Le guide d'exploitation est créé avec la version initiale 1 et son statut est Actif.

  • Utilisez la commande oci fleet-apps-management fleet-apps-management-runbooks runbook create et les paramètres requis pour créer un runbook personnalisé :

    oci fleet-apps-management fleet-apps-management-runbooks runbook create --compartment-id <compartment_OCID> --display-name <text> --operation <text> --runbook-version <json_file_or_string> [OPTIONS]

    Pour obtenir la liste complète des indicateurs et des options de variable des commandes de l'interface de ligne de commande de gestion des applications de parc, reportez-vous à la interface de ligne de commande de la gestion des applications de parc.

  • Exécutez l'opération CreateRunbook pour créer un classeur personnalisé.