Taken

Een taak is een bewerking die tijd kost: een virtuele machine inschakelen, klonen of een host toevoegen. Wanneer u er in de console een start, antwoordt het verzoek meteen en gaat het werk op de achtergrond verder. Een taak heeft een van vijf statussen: In wachtrij, Wordt uitgevoerd, Voltooid, Mislukt of Geannuleerd. Deze pagina laat zien hoe u een taak volgt en hoe u hem annuleert.

In de console

1. Kijk naar het paneel onderaan elke pagina. Het tabblad Recente taken toont de laatste taken, en de teller geeft aan hoeveel er in de wachtrij staan of lopen. De tabbladen Gebeurtenissen en Alarmen staan ernaast. Selecteer Takenpaneel uitvouwen om het paneel te vergroten, Takenpaneel samenvouwen om het te verkleinen, of sleep de rand om de grootte aan te passen.
2. Een lopende taak toont een voortgangsbalk, en het paneel ververst elke twee seconden zolang een taak loopt. Een afgeronde taak toont Voltooid, Mislukt of Geannuleerd, en een mislukte taak noemt de fout in zijn bericht.

3. Om meer te zien dan het paneel bevat, opent u de pagina Taken: selecteer op de startpagina (Start) Taken onder Snelkoppelingen.

   (Groter weergeven)

   Grotere weergave sluiten

   De tabel heeft de kolommen Taak, Doel, Status, Initiator, In wachtrij en Voltooid. Het doel is een koppeling naar het object waaraan de taak werkt.

4. Om een taak in de wachtrij of een lopende taak te stoppen, selecteert u Annuleren in de rij. Het dialoogvenster Deze taak annuleren? meldt dat de taak stopt op het volgende veilige punt. Selecteer Taak annuleren, of Laten doorlopen om de taak met rust te laten.

U kunt uw eigen taken annuleren. Het annuleren van taken van andere gebruikers vraagt de bevoegdheid Global.CancelTask; zonder die bevoegdheid verschijnt de knop niet in hun rijen. Een geannuleerde bewerking kan werk half afgemaakt achterlaten. Werk dat al is gebeurd, wordt niet teruggedraaid, dus controleer daarna het object.

Resultaat

Een geannuleerde taak toont Geannuleerd. Gebeurtenissen legt vast wat de taak deed voordat hij stopte. Wanneer een taak Voltooid toont, is de bewerking klaar. Een taak die met Mislukt eindigde, noemt de oorzaak in een bericht-id; zie de foutcodes. Een taak waarvan de geheime parameters alleen in het geheugen van een herstarte controller stonden, eindigt met error.task.secrets_lost; start de bewerking opnieuw.

De console bewaart de taken van de laatste 30 dagen, en maximaal 100,000 taken. Lopende taken worden nooit verwijderd. Boven de limiet voor de grootte van de geschiedenis die de beheerder in de controllerconfiguratie instelt als history_max_bytes, worden de oudste taken en gebeurtenissen eerst verwijderd.

Automatisering

Met de 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 toont eerst de oudste taken; --desc toont eerst de nieuwste, en --after neemt de cursor next van de vorige pagina. tasks wait houdt het verzoek vast tot de taak is afgelopen of de time-out, in seconden, is verstreken; een taak die bij de time-out nog loopt, wordt ongewijzigd teruggegeven, dus voer de opdracht opnieuw uit om te blijven wachten. Een taak toont state, progress van 0 tot 100, queuedAt, startedAt, completedAt, de initiator, het doel en het result of de error. De chainId is gelijk voor alle taken en gebeurtenissen van één actie, dus --chain <id> bij tasks list en events list verzamelt ze.

Met de API

GET /v1/tasks toont taken met target, state, user, chainId, since, order, limit en after. GET /v1/tasks/{id} leest er een, GET /v1/tasks/{id}/wait?timeout=<seconds> wacht, en POST /v1/tasks/{id}/cancel annuleert. De API noemt de statussen queued, running, success, error en cancelled. Het opvragen van de lijst vraagt System.View op de root, en een taak over een object dat u niet mag zien, staat niet in de lijst. De API-conventies beschrijven de taakenvelop en de paginering.

Zie ook

• Gebeurtenissen legt vast wat de taken deden.
• Alarmen reageren op gebeurtenissen.