Tâches

Une tâche est une opération qui prend du temps : mettre sous tension une machine virtuelle, la cloner, ajouter un hôte. Quand vous en démarrez une dans la console, la requête répond aussitôt et le travail se poursuit en arrière-plan. Une tâche est dans l'un de cinq états : En file d’attente, En cours, Terminée, Échec ou Annulée. Cette page montre comment suivre une tâche et comment l'annuler.

Dans la console

1. Regardez le volet en bas de chaque page. L'onglet Tâches récentes liste les dernières tâches, et son compteur indique combien sont en file ou en cours. Les onglets Événements et Alarmes sont à côté. Sélectionnez Développer le volet des tâches pour agrandir le volet, Réduire le volet des tâches pour le réduire, ou faites glisser son bord pour le redimensionner.
2. Une tâche en cours affiche une barre de progression, et le volet s'actualise toutes les deux secondes tant qu'une tâche s'exécute. Une tâche terminée affiche Terminée, Échec ou Annulée, et une tâche échouée nomme l'erreur dans son message.
3. Pour voir plus que ce que le volet contient, ouvrez la page Tâches : sur la page d'accueil (Accueil), sélectionnez Tâches sous Raccourcis.

:::screen tasks

Le tableau a les colonnes Tâche, Cible, Statut, Initiateur, Mise en file et Fin. La cible est un lien vers l'objet sur lequel la tâche travaille.

4. Pour arrêter une tâche en file ou en cours, sélectionnez Annuler dans sa ligne. La boîte de dialogue Annuler cette tâche ? indique que la tâche s'arrête au prochain point sûr. Sélectionnez Annuler la tâche, ou Laisser continuer pour laisser la tâche en l'état.

Vous pouvez annuler vos propres tâches. Annuler les tâches d'autres utilisateurs demande le privilège Global.CancelTask ; sans lui, le bouton n'apparaît pas dans leurs lignes. Une opération annulée peut laisser un travail à moitié fait. Ce qui a déjà eu lieu n'est pas défait, donc vérifiez ensuite l'objet.

Résultat

Une tâche annulée affiche Annulée. Les événements enregistrent ce que la tâche a fait avant de s'arrêter. Quand une tâche affiche Terminée, l'opération est terminée. Une tâche qui s'est terminée par Échec nomme la cause dans un identifiant de message ; consultez les codes d'erreur. Une tâche dont les paramètres secrets n'existaient que dans la mémoire d'un contrôleur redémarré se termine par error.task.secrets_lost ; relancez l'opération.

La console conserve les tâches des 30 derniers jours, et au plus 100,000 d'entre elles. Les tâches en cours ne sont jamais supprimées. Au-delà de la limite de taille de l'historique que l'administrateur fixe dans la configuration du contrôleur avec history_max_bytes, les tâches et les événements les plus anciens sont supprimés en premier.

Automatisation

Avec la CLI

kyvernon tasks list --target vm-42 --desc --limit 20
kyvernon tasks list --state running,queued
kyvernon tasks wait task-42 --timeout 300
kyvernon tasks cancel task-42

tasks list affiche d'abord les tâches les plus anciennes ; --desc affiche d'abord les plus récentes, et --after prend le curseur next de la page précédente. tasks wait retient la requête jusqu'à la fin de la tâche ou jusqu'à l'expiration du délai, en secondes ; une tâche encore en cours à l'expiration est renvoyée telle quelle, donc relancez la commande pour continuer à attendre. Une tâche indique state, progress de 0 à 100, queuedAt, startedAt, completedAt, l'initiator, la cible et le result ou l'error. Le chainId est le même pour toutes les tâches et tous les événements d'une même action, donc --chain <id> sur tasks list et events list les regroupe.

Avec l'API

GET /v1/tasks liste les tâches avec target, state, user, chainId, since, order, limit et after. GET /v1/tasks/{id} en lit une, GET /v1/tasks/{id}/wait?timeout=<seconds> attend, et POST /v1/tasks/{id}/cancel annule. L'API nomme les états queued, running, success, error et cancelled. La liste demande System.View sur la racine, et une tâche portant sur un objet que vous n'avez pas le droit de voir n'est pas listée. Les conventions de l'API décrivent l'enveloppe d'une tâche et la pagination.

Voir aussi

• Les événements enregistrent ce que les tâches ont fait.
• Les alarmes réagissent aux événements.