Création d'une tâche

Créez une tâche de guide d'exploitation pour effectuer des opérations de cycle de vie sur un parc dans Fleet Application Management.

Remarque

Les tâches que vous créez à l'aide de cette procédure sont des tâches partagées et peuvent être utilisées par n'importe quel livre d'exécution.
    1. Sur la page de liste Tâches, sélectionnez Créer une tâche. Si vous avez besoin d'aide pour trouver la page de liste, reportez-vous à Liste des tâches de guide d'exécution.
    2. Sur la page Créer une tâche, saisissez les informations suivantes :
      • Nom : entrez un nom unique pour la tâche. 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 la tâche.
      • Créer dans le compartiment : sélectionnez dans quel compartiment créer la tâche de 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 tout autre élément personnalisé.
      • 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 d'action : sélectionnez l'une des options suivantes :
        • Exécuter un script : associez un script à partir d'Object Storage ou ajoutez le script en ligne sous Commande. Pour ajouter un script en ligne, reportez-vous à la sous-étape n.
        • Exécuter un terraform : utilisez un package Terraform pour provisionner des ressources. Passez à l'étape 4.
    3. Si vous avez sélectionné Exécuter un script, entrez les informations suivantes sous Détails du script, le cas échéant.
      1. Pour Type de système d'exploitation, sélectionnez une plate-forme prise en charge sur laquelle la tâche s'exécute.
      2. Si la tâche est destinée au repérage des cibles :
        1. Activez l'option Marquer comme tâche de sortie de découverte. Cette action permet à Fleet Application Management de collecter les informations d'inventaire des logiciels à partir de la tâche une fois celle-ci terminée.
        2. Sous Ajouter un script, sélectionnez Télécharger le modèle de sortie de repérage pour vous assurer que la sortie de tâche correspond au format du modèle de repérage. Utilisez le modèle de repérage téléchargé comme guide pour coder le script de repérage. Pour connaître les attributs du modèle, reportez-vous à Utilisation de la console.
          Remarque

          Le succès de l'exécution des scripts de repérage ou d'application de patches dépend des commandes utilisées par le rédacteur de scripts et de la prise en charge de ces commandes sur votre instance. Si certaines commandes échouent, assurez-vous de configurer l'hôte avec les installations nécessaires avant d'utiliser les commandes. Par exemple, l'utilisation de commandes telles que mlocate ou locate pour rechercher des fichiers.
      3. Si la tâche consiste à appliquer des patches, activez la bascule Cette tâche nécessite l'exécution de patches. Lorsque cette option est activée, Fleet Application Management renseigne les détails des patches recommandés pour la tâche. Les détails sont disponibles dans le fichier patches.json. Le script peut lire le fichier patches.json pour obtenir tous les patches et utiliser la variable d'environnement, DATA_DIR, pour connaître l'emplacement du patch téléchargé par Fleet Application Management sur l'instance Compute.
      4. Pour ajouter votre script pour l'exécution de tâche, sélectionnez l'une des options suivantes :
        • Téléchargement vers le serveur ou sélection dans un stockage d'objet : option permettant de télécharger le script à partir du système de fichiers ou du bucket Object Storage. Passer à l'étape e.
        • Sélectionner dans le catalogue : option permettant de choisir le script à partir de l'élément de catalogue privé. Passer à la sous-étape i.
      5. Si l'ajout de script s'effectue via Object Storage, sélectionnez Parcourir en regard de Sélectionner un script dans Object Storage.
        Sur la page Sélectionner un fichier, sélectionnez l'une des options suivantes :
        • Sélectionner dans un bucket de stockage d'objet : sélectionnez un script dans Object Storage, s'il a déjà été téléchargé, et passez à la sous-étape f.
        • Télécharger un fichier : sélectionnez un script en le téléchargeant vers Object Storage, puis passez à la sous-étape g.
      6. Si vous avez sélectionné Sélectionner dans un bucket de stockage d'objet :
        1. Sélectionnez le compartiment qui contient le bucket Object Storage avec le script, puis sélectionnez le bucket.
        2. Sélectionnez un fichier de script dans le bucket, puis sélectionnez Sélectionner. Passer au sous-étape h.
      7. Si vous avez sélectionné Télécharger un fichier :
        1. Faites glisser un fichier du système de fichiers vers la zone Glisser-déplacer ou recherchez le fichier.
        2. Sélectionnez le compartiment contenant le bucket Object Storage vers lequel télécharger le fichier, puis sélectionnez le bucket.
        3. Sélectionnez le fichier script, le cas échéant.
        4. Pour le préfixe de nom d'objet, indiquez un préfixe pour le fichier que vous téléchargez afin de l'identifier facilement lors de la sélection dans Object Storage.
        5. Sélectionnez Télécharger et sélectionner pour stocker le script dans le bucket et sélectionnez le script pour la tâche.
      8. Activez la bascule Enregistrer en tant qu'article de catalogue si le script doit être stocké en tant qu'article de catalogue. Indiquez ensuite le nom de l'article de catalogue stocké.
      9. Si l'ajout de script se fait via le catalogue privé à l'étape d, sélectionnez le compartiment contenant l'article de catalogue, puis sélectionnez l'article de catalogue ou utilisez la commande en ligne. Pour connaître l'utilisation de la commande, reportez-vous à la sous-étape n.
      10. Activez l'option Rendre le script exécutable pour activer l'exécution automatique du fichier de script.
      11. Activez l'option Verrouiller le script pour empêcher l'exécution du script lorsqu'il est mis à jour dans le bucket Object Storage.
      12. Activez l'option Ajouter des variables d'entrée si la tâche nécessite des variables d'entrée, puis entrez les détails suivants :
        1. Entrez un nom unique et un descriptif pour la variable. Evitez de saisir des informations confidentielles.
        2. Pour Type, sélectionnez une variable de chaîne ou de sortie. Par exemple, sélectionnez le type comme variable de sortie si vous voulez que la valeur de variable soit utilisée comme variable d'entrée pour une autre tâche.

        Ajoutez d'autres variables d'entrée si nécessaire.

      13. Activez la bascule Ajouter des variables de sortie si la tâche génère des variables de sortie. Entrez ensuite un nom unique pour la variable Ajoutez d'autres variables de sortie si nécessaire.
      14. (Facultatif) Si l'exécution de la tâche est basée sur plusieurs fichiers, dans la zone Commande, indiquez la commande permettant de démarrer l'exécution. Fournissez la commande permettant à Fleet Application Management de savoir comment exécuter le script. Le script peut être un fichier ZIP, un fichier JAR, un fichier EXE ou tout autre programme pouvant être exécuté sur l'instance. Les variables définies pour la tâche peuvent être transmises au script sous forme d'arguments de place ou d'arguments clé-valeur. Lorsque vous transmettez une variable en tant qu'argument, ajoutez le préfixe "$". Par exemple, pour utiliser les fichiers ZIP et JAR :
        • Entrez la commande unzip zippedfile.zip pour décompresser le fichier contenant tous les fichiers, puis entrez la commande ./main.sh pour lancer l'exécution.
        • Pour transmettre des variables à la commande, fournissez-les en tant qu'arguments de ligne de commande. Reportez-vous aux types d'arguments de ligne de commande suivants. Reportez-vous aux types d'argument de ligne de commande suivants :
          • Pour les arguments statiques, fournissez-les directement en tant qu'arguments (par exemple, si le script de tâche attend une valeur de délai d'expiration), l'argument peut être le suivant : ./main.sh 10s
          • Pour les arguments dynamiques basés sur ceux configurés dans la tâche (par exemple, s'il attend un délai d'expiration et un type de sauvegarde), l'argument peut être le suivant : ./main.sh $timeout $backuptype
          • Pour une combinaison d'arguments statiques et dynamiques, l'argument peut être le suivant : ./main.sh 10s $backuptype
        • Entrez la commande JAR suivante pour les arguments dynamiques (type de sauvegarde et délai d'expiration) :
          java -jar ApplicationBackup.jar $backuptype $timeout
      15. (Facultatif) Sélectionnez un compartiment d'informations d'identification et des noms d'informations d'identification que vous avez créés dans Bault s'ils ne sont pas définis pour le produit ou la pile de produits.
        Important

        Si la tâche requiert des informations d'identification, vous devez la créer dans le cadre de la gestion des métadonnées et fournir ses détails pour les informations d'identification de parc, de ressource ou de cible. Fleet Application Management transmet ensuite ces détails pour l'exécution de la tâche de dossier d'exécution.
    4. Si vous avez sélectionné Exécuter un terraform à l'étape 2, entrez les informations suivantes sous Détails Terraform, si nécessaire.
      1. Sélectionnez un élément de catalogue Terraform privé ou Marketplace existant dans le compartiment spécifique.
      2. Si vous avez sélectionné un package Marketplace (zone de renvoi de base OCI) existant à partir d'un compartiment spécifique à l'étape a, créez un élément de catalogue privé pour le type "package Terraform" afin de créer un package Terraform personnalisé.
        1. Créez un élément de catalogue privé de type de package CONFIG_FILE qui contient un exemple config.json.
        2. Téléchargez config.json vers un bucket Object Storage et créez un lien d'URL de demande pré-authentifiée pour ce bucket.
        3. Pour Sélectionner un fichier de configuration dans le catalogue, sélectionnez l'élément de catalogue de package Terraform correspondant qui contient le lien URL de demande pré-authentifiée vers le fichier config.json, comme indiqué à l'étape précédente.

          Voici un exemple de fichier config.json :

          {
              "service_label": "cisbasic",
              "network_admin_email_endpoints": ["email.address@example.com"],
              "security_admin_email_endpoints": ["email.address@example.com"],
              "enable_cloud_guard": true
          }

          Pour plus d'informations sur toutes les variables de configuration de l'élément de catalogue de zone de renvoi principale OCI, reportez-vous à Variables de zone de renvoi principale OCI.

      3. Si vous avez sélectionné un élément de catalogue privé de configuration existant à partir d'un compartiment spécifique à l'étape a, créez un élément de catalogue privé pour le type "package Terraform" afin de créer un package de configuration personnalisé.
      4. Sélectionnez un compartiment cible dans lequel les instances Compute, les ressources de base de données, les volumes de blocs ou les ressources réseau créés après l'exécution du package Terraform peuvent résider.
        Remarque

        L'allocation de différents compartiments pour différentes ressources rend les ressources plus sécurisées, gérables et évolutives.
      5. Activez la bascule Lecture de la variable de sortie pour autoriser la lecture et l'utilisation des variables de sortie générées par l'exécution de Terraform en tant qu'entrée pour la tâche suivante.
    5. Sous Propriétés de tâche, entrez les détails suivants :
      • Nombre maximal de tentatives en cas d'échec : indiquez une valeur pour le nombre de tentatives d'une tâche en cas d'échec.
      • Délai d'expiration : indiquez une valeur de délai d'expiration pour une tâche en secondes lorsqu'elle échoue.

      Reportez-vous à la section Task Properties.

    6. Pour créer une copie de la tâche dans la bibliothèque de tâches, activez l'option Faire une copie de cette tâche dans la bibliothèque. Cette tâche fait alors partie de la bibliothèque de tâches et vous pouvez la réutiliser et la mettre à jour.
    7. Sélectionnez Create (Créer).
  • Utilisez la commande oci fleet-apps-management fleet-apps-management-runbooks task-record create et les paramètres requis pour créer une tâche de runbook :

    oci fleet-apps-management fleet-apps-management-runbooks task-record create --compartment-id <compartment_OCID> --details <json_file_or_string> -display-name <text> [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 CreateTaskRecord pour créer une tâche de dossier d'exploitation.