Documentation sur Oracle Cloud Infrastructure

Création d'un dossier de traitement

Créez un dossier d'exécution 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 d'état avant l'exécution et la détection de serveur HTTP Oracle. Ces dossiers d'exploitation sont disponibles dans la bibliothèque de dossiers d'exploitation. Vous pouvez également créer vos dossiers d'exploitation personnalisés et les publier pour tous les utilisateurs.

  • Dans la page de liste Livres d'exécution, sélectionnez Créer un dossier d'exécution. Si vous avez besoin d'aide pour trouver la page de liste, voir Liste des classeurs d'exécution.

    La création d'un dossier d'exploitation comprend les pages suivantes :

    Exécutez chacun des flux de travail suivants dans l'ordre. Pour retourner à une page précédente, sélectionnez Précédent.

    1. Informations de base

    La page Informations de base vous permet de fournir les informations de base pour le dossier d'exploitation.

    Entrez les informations suivantes :

    • Nom : Entrez un nom convivial pour le dossier d'exploitation. Le nom ne doit pas nécessairement être unique, mais ne peut pas être modifié dans la console. Vous pouvez toutefois le remplacer à l'aide de l'API. Évitez d'entrer des informations confidentielles.
    • Description : Entrez une description appropriée pour le dossier d'exploitation.
    • Créer dans le compartiment : Sélectionnez le compartiment dans lequel créer le dossier 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 en savoir plus sur diverses opérations de cycle de vie, voir 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, correctif, détection, provisionnement ou personnalisée).
    • Pour les opérations de cycle de vie de correctif ou de détection, entrez les informations suivantes :
      • Compartiment de la pile de produits/produits : Sélectionnez le compartiment dans lequel se trouve le produit ou la pile de produits.
      • Pile de produits/produits : Sélectionnez une pile de produits ou de produits à laquelle la tâche appartient dans le compartiment.
    • Type de système d'exploitation : Sélectionnez une plate-forme prise en charge dans les options d'exécution du dossier d'exploitation.
    • Heure estimative (heures) : Sélectionnez le temps estimatif en heures pour terminer l'exécution du dossier d'exploitation.
    • Définir comme dossier d'exploitation par défaut : Activez l'option pour laisser la gestion des applications de parc utiliser ce dossier d'exploitation comme dossier d'exploitation par défaut pour effectuer des opérations de cycle de vie.
      Note

      Vous ne pouvez définir qu'un seul dossier d'exécution pour une opération de cycle de vie particulière et une combinaison de produit ou de pile de produits en tant que dossier d'exécution par défaut. La gestion des applications de flotte utilise le dossier d'exploration par défaut d'un produit ou d'une pile de produits pour découvrir l'inventaire logiciel du produit et le dossier d'application de correctifs par défaut pour sélectionner automatiquement un dossier d'exécution lors de la création du programme et des tâches de correction de conformité.
    • Ce dossier d'exploitation nécessite un accès SUDO : Activez l'option d'activation/de désactivation si le type de système d'exploitation est Oracle Linux pour détecter et appliquer des correctifs au logiciel s'exécutant sur des instances de calcul.

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

      Note

      Lorsque l'accès sudo est activé pour le dossier d'exploitation, le plugiciel de gestion de l'application de parc exécute les tâches avec le privilège sudo. Le plugiciel de gestion des applications de parc utilise un privilège sudo intégré, mais il est entièrement contrôlé au moyen de la propriété de dossier d'exploitation isSudoAccessNeeded. Voir Informations de référence sur le type Runbook.

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

    2. Rationaliser (coureur de conception)

    La page Streamline (Carnet de conception) vous permet de concevoir un flux de travail de dossier d'exploitation à l'aide du concepteur visuel ou du code de dossier d'exploitation.

    Avec le concepteur visuel, vous pouvez faire glisser une action à partir du volet actions dans le canevas, en la plaçant là où vous le souhaitez dans le flux de travail de votre dossier d'exploitation. Vous pouvez également réordonner les actions de votre flux de travail en les faisant glisser vers un autre emplacement.

    1. Sélectionnez 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 de code : Chargez le code de dossier 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 dossier d'exploitation, procédez comme suit :
      Important

      Pour ajouter une tâche, vous devez d'abord ajouter un groupe de ressources parallèle ou continu. Une tâche doit se trouver dans un groupe. Pour en savoir plus sur l'utilisation du concepteur visuel, voir Conception d'un dossier d'exploitation avec Visual Designer.
      1. Dans l'onglet Composants du volet des actions, sélectionnez un groupe de ressources en parallèle ou un groupe de ressources glissant et faites-le glisser sur le canevas. Ajoutez autant de groupes que nécessaire.
        • Pour exécuter en parallèle des tâches du dossier d'exploitation sur toutes les ressources, sélectionnez un groupe parallèle. Un groupe de ressources parallèle est un paramètre fictif pour une ou plusieurs tâches au sein de celui-ci, 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 l'une après l'autre sur une ressource spécifique, mais simultanément sur une liste de ressources.
        • Pour l'exécution séquentielle des tâches de carnet d'exécution, sélectionnez un groupe de ressources continu. Un groupe de ressources glissantes est un paramètre fictif pour une ou plusieurs tâches pour lesquelles 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 de poignée de glisser-déposer (poignée) dans le coin droit d'un composant et le faire glisser vers un autre emplacement dans la zone de travail du dossier d'exploitation. Après avoir placé un composant sur le canevas, son code est automatiquement généré et ajouté au code du dossier 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 dans la page Créer une tâche. Pour obtenir des instructions, voir les étapes 4 à 17 sous 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 dossier d'exécution sont locales au dossier d'exécution et ne peuvent pas être réutilisées par d'autres dossiers d'exécution.
        • 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 poignée de glisser-déposer ( icône de poignée de glisser-déposer) dans le coin droit d'une tâche pour la faire glisser dans le groupe de ressources.
          Conseil

          Vous pouvez d'abord créer des tâches de carnet d'exécution, au besoin, puis les ajouter à un ou plusieurs carnets d'exécution plus tard.
        • 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 ensuite partie du dossier 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 dossier d'exécution.
      3. Pour mettre à jour les propriétés d'une tâche, sélectionnez l'icône de modification à côté de la tâche, puis mettez à jour les valeurs de champ dans la page Modifier la tâche.
      4. Après avoir ajouté les composants requis au dossier d'exploitation, sélectionnez l'icône des 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, de préférence en fonction de son objectif. Évitez d'entrer 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 traiter les erreurs dans le flux de travail du dossier d'exécution :
        Note

        Par défaut, lorsqu'un composant de dossier d'exploitation signale une erreur, l'automatisation de la gestion des applications de parc arrête entièrement le flux de travail du dossier 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 flux de travail du livre d'exécution en cas d'échec de l'exécution du composant. Cette action est définie par défaut.
        • Continuer : Passez à l'étape suivante du flux de travail du dossier d'exécution en cas d'échec de l'exécution du composant.
        • Repositionner : Annulez la modification et revenez au niveau initial du composant de carnet d'exécution.

          Pour effectuer le repositionnement, assurez-vous de sélectionner la propriété En cas d'échec Repositionner. Vous pouvez spécifier la fonction d'annulation au niveau de la cible ou du groupe (groupe d'actions). Pour effectuer un repositionnement au niveau cible, sélectionnez En cas d'échec des tâches ou En cas d'échec des tâches de repositionnement pour effectuer un repositionnement au niveau du groupe.

      7. Pour créer des énoncés conditionnels pour chaque composant de dossier d'exploitation à l'aide de l'option Condition,
        Entrez une variable dans la zone de condition, sélectionnez l'un des opérateurs arithmétiques, par exemple AND, NOT ou d'autres, et entrez une valeur pour la condition. Voici un exemple d'instruction conditionnelle :
        Pour la condition suivante, si la variable backuptype pour 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 pour exécuter une tâche :
        • Instances spécifiées par programme : Pour autoriser une tâche à s'exécuter sous condition uniquement sur certains composants applicables au produit (tels que définis dans les métadonnées du produit) sur la ressource, sélectionnez Instances de filtre. Pour des instructions sur la façon d'ajouter des conditions de filtre, voir la sous-étape i.
        • Instance auto-hébergée : Pour vérifier l'activité 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.
          Note

          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 pour lesquelles le type d'action de la première tâche est Exécuter une Terraform qui provisionne les ressources. La deuxième tâche peut être de type 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

          Assurez-vous d'activer le plugiciel de gestion des applications de parc sur votre instance auto-hébergée et son 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 spécifiée par la tâche précédente : Pour vérifier si les 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 une Terraform qui provisionne les instances de calcul et retourne 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 la ressource que retourne la sous-étape i ou un type de ressource facultatif. Ajoutez d'autres informations sur l'hôte telles qu'elles ont été 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 en tant que fichier JSON avec les 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 dans la sous-é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 la zone située à gauche pour l'ajouter à la zone de filtre située à droite.
        • Sélectionnez l'un des opérateurs arithmétiques, par exemple AND, NOT ou d'autres.
        • Entrez une valeur pour la condition dans la zone de condition.
          Note

          Lorsque vous sélectionnez des propriétés de produit ou de composant, la zone de filtre est alimentée avec une condition de grammaire pertinente.
          Voici un exemple pour 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>
          Note

          Les conditions basées sur les propriétés dépendent de votre compréhension de la détection de produit.
        Ajoutez d'autres instances de filtre si nécessaire. Ces instances sont ajoutées à la ligne suivante de la zone de filtre.
      10. Passez l'activation/désactivation de l'exécution en pause 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 d'interrompre l'exécution d'une tâche indéfiniment ou jusqu'à ce que vous repreniez la tâche, ou pour une période spécifique que vous sélectionnez.
      11. Pour être avisé lorsque le statut de la tâche change, activez l'option Avis, puis cochez la case correspondant à l'activité de la tâche pour laquelle vous souhaitez être avisé (par exemple, en cas d'échec de la tâche, en cas de pause ou lorsque la tâche réussit).
      12. Configurez les propriétés des tâches que vous ajoutez. Pour obtenir la description des champs des propriétés de tâche, voir les étapes 4 à 17 sous Création d'une tâche à l'aide de la console.
    3. Si vous avez sélectionné Vue de code pour la création du dossier d'exploitation à l'étape 1, indiquez si vous utilisez JSON ou YAML, puis sélectionnez Charger le code du dossier d'exploitation pour ajouter le fichier approprié.
    Sélectionnez Suivant pour passer à l'étape suivante.

    3. Vérifier

    Vérifiez le contenu du dossier d'exploitation dans la page Vérifier. Modifier les paramètres ou retourner aux écrans précédents pour ajouter des informations.

    Sélectionnez Enregistrer comme brouillon pour enregistrer le dossier d'exploitation initialement jusqu'à ce que vous soyez sûr de tous les composants.
    Note

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

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

    Le dossier d'exploitation publié peut être utilisé pour le provisionnement, la détection, l'application de correctifs ou le repositionnement, et il a un statut actif.
    Note

    Le dossier d'exploitation est créé avec la version 1 comme version initiale et il a un statut actif.

  • Utilisez la commande oci fleet-apps-management fleet-apps-management-runbooks runbook create et les paramètres requis pour créer un classeur d'exécution 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 pour les commandes de l'interface de ligne de commande de gestion des applications de flotte, voir Interface de ligne de commande pour la gestion des applications de parc.

  • Exécutez l'opération CreateRunbook pour créer un dossier d'exécution personnalisé.