Aktive Jobs stoppen oder beenden
Nach dem Aufrufen eines Arbeitsbereichsjobs wie plan
, apply
oder destroy
können Sie den aktiven Job oder die Bereitstellung von Ressourcen stoppen. Beim Stoppen oder Abbrechen eines Jobs mit langer Laufzeit
ist es ratsam, zuerst die Jobprotokolle zu überprüfen, um festzustellen, ob der Job tatsächlich blockiert ist und gestoppt werden muss, oder ob er Operationen mit langer Laufzeit ausführt, deren Ausführung einige Zeit in Anspruch nimmt.
Schematics bietet eine Reihe von Optionen, mit denen Benutzer den aktiven Job (gracefully) stop
, force-stop
oder terminate
in der Reihenfolge der Unmittelbarkeit und Auswirkung der Stoppoperation ausführen
können.
Jobtypen stoppen
Die Tabelle enthält die Liste der Stoppjobtypen:
Typen | Beschreibung |
---|---|
stop |
Sendet ein Unterbrechungssignal an den laufenden Terraform-Befehl. Dadurch wird dieselbe Funktion wie bei der eigenständigen Ausführung von Terraform ausgeführt, wobei ein interrupt mit cntl-C oder ähnlich wie
Terraform gesendet wird. Interruptsignale können mehrmals gesendet werden, um Terraform zum Stoppen zu benachrichtigen. Terraform versucht, den aktiven Befehl (planen, anwenden, löschen) zu stoppen, nachdem alle ausgeführten Ressourcenoperationen
abgeschlossen und bereinigt wurden. Schematics wartet auf den Abschluss des Befehls. Nachdem der Befehl gestoppt oder beendet wurde, werden Status- und Protokolldateien erfasst und gespeichert. |
force-stop |
Sendet ein Abbruchsignal vom Typ 'Kill' an den Terraform-Befehl, der ausgeführt wird. Verwenden Sie dies, wenn Sie den Terraform-Befehl beenden möchten, nachdem Sie festgestellt haben, dass der Stoppbefehl (Interrupts) den Befehl nicht
stoppt. Eine E-Mail an force-stop kann beliebig oft gesendet werden, bis der Befehl abgeschlossen ist und der Auftrag beendet wird. Wenn Terraform auf das Abbruchsignal reagieren kann, stoppt Terraform die aktiven Befehls-und
Ressourcenoperationen sofort und führt eine Bereinigung durch. Nachdem der Befehl gestoppt oder beendet wurde, werden Statusdatei und Protokolldateien erfasst und gespeichert. |
terminate |
Wenn die vorherigen Operationen fehlschlagen, wird der Job Schematics sofort beendet. Der Job wird als STOPPED markiert und der Arbeitsbereich freigegeben. Alle zuvor gespeicherten Kopien der Protokolle und statefile werden beibehalten. Wenn ein Job beendet wird, wird der Job beendet, ohne dass am Ende Dateien separat gesammelt werden. Diese Option kann zu Datenverlust in der Protokolldatei und den neuesten Aktualisierungen von statefile führen und sollte sorgfältig verwendet werden. |
Bis der Job gestoppt wird, können Sie eine beliebige Anzahl dieser Stoppsignale senden. Im Normalfall sollten Sie nicht mehr als drei Signale senden. Wenn der Terraform nicht auf Anfragen von stop
reagiert (Unterbrechungssignale),
können Sie jederzeit force-stop
verwenden. Wenn force-stop
aufgrund eines Problems im Job nicht reagiert, können Sie den Job immer noch mit terminate
sperren.
Job abbrechen
Wenn sich der Auftrag in einem pending
-Status befindet, führt jede Art von Stoppanforderung zur Stornierung des Auftrags. Die Schaltfläche " Cancel
" wird angezeigt, wenn sich der Auftrag im Status "
pending
" befindet und einfach storniert werden kann. Das Abbrechen bewirkt, dass der Job aus der Warteschlange für anstehende Jobs entfernt wird. Wenn die Ausführung von plan
, apply
oder destroy
in der Zwischenzeit gestartet wird, wird dies zu einem Stoppsignal (Interrupt) an Terraform.
Aktiven Job über die Benutzerschnittstelle stoppen
Sie können diese Schritte ausführen, um einen laufenden Arbeitsbereichsauftrag mithilfe der Konsole zu stoppen.
-
Wählen Sie im Arbeitsbereichsdashboardden Arbeitsbereich für den aktiven Job aus.
Sie können den aktiven Job während der Ausführung eines Planungs-, eines Anwendungs- oder Zerstörungsvorgangs stoppen oder abbrechen (stornieren).
-
Klicken Sie auf die Registerkarte "Job ", um die Schaltflächen "Stopp ", "Force stop ", "Terminieren " und "Abbrechen " anzuzeigen.
Jobstoppoptionen Schaltfläche Beschreibung Stoppen Entfernt den Job aus der Warteschlange für anstehende Jobs, falls er den Status 'Anstehend' hat. Andernfalls wird ein Unterbrechungssignal vom Typ 'Interrupt' an den Terraform-Befehl gesendet. Stopp erzwingen Sendet ein Abbruchsignal vom Typ 'Kill' an den Terraform-Befehl, der ausgeführt wird. Beenden Beendet Schematics und markiert den Auftrag als BEENDET und gibt den Arbeitsbereich frei. Dieser Befehl sollte sorgfältig verwendet werden, da er zu Datenverlust führen kann. Abbrechen Die Schaltfläche " Cancel
" wird angezeigt, wenn sich der Auftrag im Status "pending
" befindet und einfach storniert werden kann. Das Abbrechen bewirkt, dass der Job aus der Warteschlange für anstehende Jobs entfernt wird. Wenn in der Zwischenzeit die Ausführung vonplan
,apply
oderdestroy
gestartet wird, wird aus 'Abbrechen' ein Unterbrechungssignal für die Terraform-Ausführung. -
Geben Sie den Namen Ihrer
<option>
in das Textfeld Option zur Bestätigung eingeben ein. -
Klicken Sie auf die Schaltfläche Option bestätigen.
Aktiven Job über die Befehlszeilenschnittstelle stoppen
Stoppt einen aktiven IBM Cloud Schematics-Arbeitsbereichsjob.
Syntax
ibmcloud schematics workspace job stop --id WORKSPACE_ID --job-id JOB_ID [--stop] [--force-stop] [--terminate] [--no-prompt]
Befehlsoptionen
Flag | Erforderlich / Optional | Beschreibung |
---|---|---|
--id oder -i |
Erforderlich | Die ID des Arbeitsbereichs, der aktualisiert werden soll. |
--job-id oder --jid |
Erforderlich | Die Job-ID des Jobs. |
--stop |
Optionale | Entfernt den Job aus der Warteschlange für anstehende Jobs, falls er den Status 'Anstehend' hat. Andernfalls wird ein Unterbrechungssignal vom Typ 'Interrupt' an den Terraform-Befehl gesendet. |
--force-stop oder --fs |
Optionale | Sendet ein Abbruchsignal vom Typ 'Kill' an die Terraform-Ausführung in der Engine, um die Ausführung sofort zu stoppen. |
--terminate oder -t |
Optionale | Die Beendigung der Engine wird erzwungen, der Job wird als gestoppt gekennzeichnet und Ihr Arbeitsbereich wird entsperrt. Daten werden mit diesem Flag nicht gespeichert. |
--no-prompt |
Optionale | Legen Sie dieses Flag fest, um den Befehl ohne einen interaktiven Modus auszuführen. |
Beispiel
ibmcloud schematics workspace job stop --id <WORKSPACE_ID> --stop --job-id <JOB_ID>
ibmcloud schematics workspace job stop --id <WORKSPACE_ID> --force-stop --job-id <JOB_ID>
ibmcloud schematics workspace job stop --id <WORKSPACE_ID> --terminate --job-id <JOB_ID>
Aktiven Job über die Anwendungsprogrammierschnittstelle (API) stoppen
Mit den folgenden CURL-Befehlen können Sie einen aktiven Job für den IBM Cloud Schematics-Arbeitsbereich stoppen.
Syntax zum Stoppen aktiver Jobs
-
Richten Sie Ihren REST-Client so ein, dass er die Schematics-Anwendungsprogrammierschnittstelle (API) ausführt.
-
Verwenden Sie die Syntax und das Beispiel, um den laufenden Auftrag zu stoppen.
Syntax
curl -X DELETE https://schematics.cloud.ibm.com/v1/workspaces/<wks_id>/actions/{job_id}?signal=interrupt -H "Authorization: <iam_token>"
Beispiel
curl -X DELETE https://schematics.cloud.ibm.com/v2/jobs/{job_id}?signal=interrupt -H "Authorization: <iam_token>"
-
Orientieren Sie sich am Beispiel, wenn Sie den aktiven Job
force-stop
wollen.Beispiel
curl -X DELETE https://schematics.cloud.ibm.com/v1/workspaces/<wks_id>/actions/{job_id}?signal=force-stop -H "Authorization: <iam_token>"
-
Orientieren Sie sich am Beispiel, wenn Sie den aktiven Job
terminate
wollen.Beispiel
curl -X DELETE https://schematics.cloud.ibm.com/v1/workspaces/<wks_id>/actions/{job_id}?signal=terminate -H "Authorization: <iam_token>"
Weitere Informationen zum Beenden des laufenden Auftrags finden Sie unter "Stop and delete the running Job API ".
Schematics Jobdetails überprüfen
Verwenden Sie die Schematics Jobseite in der Konsole, um die Historie aller Schematics Aktivitäten zu ermitteln, z. B. das Herunterladen Ihrer template
, plan
, apply
und das Anzeigen der Protokolle der Jobs.
Die Jobs werden erstellt, wenn Sie Ihre Vorlagen ausführen. Sie können auch die Anzahl der Ressourcen, die sich in plan
befinden, oder apply
von Jobs anzeigen, die sich in der hinzugefügten, geändertenoder
zerstörten Status befinden. Weitere Informationen zum Jobwarteschlangenprozess finden Sie unter "Ausführungsprozess Schematics ".
Im Jobprotokoll kann eine Nachricht wie folgt angezeigt werden:
-
Aktivität ausgelöst. Warten auf die Protokolle. Dies bedeutet, dass der Job sich im Status "Anstehend" befindet und noch verarbeitet werden muss.
-
Ihr Job wurde übergeben und befindet sich in der Warteschlange an Position x von y. Hierbei steht
x
für die Position Ihres Jobs in der Warteschlange für anstehende Jobs undy
für die Gesamtzahl der anstehenden Jobs. Die verfügbaren Ressourcen im Schematics-Back-End werden gleichmäßig auf die anstehenden Jobs verteilt. Wenn Sie eine große Anzahl von Jobs ausführen, können Sie sehen, wie sich die Position zusammen mit der Gesamtzahl erhöht.