Übersicht zum Debugging

Die folgenden Informationen können Ihnen bei der Fehlerbehebung in Workflows helfen und Sie bei der Bereitstellung eines zuverlässigen, vorhersehbaren und optimierten Workflows unterstützen.

Projekte und Umgebungen
  • Idealerweise sollten Sie zum Schutz Ihrer Produktionsressourcen separate Projekte für jede Ihrer Umgebungen verwenden: ein Projekt für Entwicklungsaufgaben, ein Projekt für Anwendungstests, ein Staging-Projekt, in dem die Entwicklung in das erstellte System zusammengeführt werden kann, und ein Projekt für Ihre Produktionsumgebung, in dem fertige Builds verfügbar sind.
  • Alternativ können Sie separate Workflows verwenden.
Workflow erstellen
  • Sie können Ihren Workflow im Editor der Google Cloud Console oder mit einer bevorzugten IDE oder einem bevorzugten Quellcode-Editor schreiben.
  • Das Bearbeiten von YAML-Dateien kann fehleranfällig sein. Richten Sie die automatische Vervollständigung in Ihrer IDE oder Ihrem Editor ein, um Tippfehler und andere häufige Fehler bei der Entwicklung Ihres Workflows zu vermeiden. Der Editor für Workflows in der Google Cloud Console bietet zwar eine gewisse YAML- und Syntaxprüfung sowie eine automatische Vervollständigung, es können jedoch Syntaxfehler auftreten, die behoben werden müssen und erst bei der Bereitstellung erkannt werden. Weitere Informationen finden Sie unter Einzug in YAML-Dateien.
Workflowbereitstellung
Workflowausführung
  • Wenn Sie einen Workflow testen möchten, können Sie ihn mit der gcloud CLI oder in der Google Cloud Console ausführen:
    • Verwenden Sie gcloud workflows run, um den Workflow über die Befehlszeile auszuführen und die Ergebnisse zu sehen.
    • Führen Sie den Workflow in der Google Cloud Console aus und sehen Sie sich die Ergebnisse im Bereich Output an.
  • Sie können auf die Ergebnisse der Workflowausführung in der Google Cloud Console oder mithilfe der gcloud CLI zugreifen. Wenn Sie über die Befehlszeile testen, sollten Sie sich die Protokolle in der Google Cloud Console auf der Seite Workflow-Details ansehen.
  • Sie können den Verlauf einer bestimmten Workflowausführung als Liste von Schritten abrufen. Jeder Eintrag enthält Informationen, die Ihnen bei der Ermittlung der Fehlerquelle oder der Optimierung der Leistung eines Workflows helfen können.
  • Mithilfe von vordefinierten Umgebungsvariablen können Sie auf Umgebungsinformationen eines Workflows zugreifen, z. B. auf seinen Speicherort oder seine Projekt-ID. Integrierte Umgebungsvariablen müssen nicht deklariert werden und sind bei jeder Workflowausführung verfügbar.
  • Fehler, die während der Workflowausführung ausgelöst werden, enthalten Tags, anhand derer Sie die Fehlerursache ermitteln können.
  • Sie können den Status einer lang andauernden Ausführung prüfen.
  • Jede Workflowausführung löst automatisch mindestens zwei Ausführungslogs aus: eines zu Beginn einer Ausführung und eines am Ende. Sie können Logs in Workflows oder in Cloud Logging aufrufen. Wenn Sie die Logs für einen einzelnen Workflow aufrufen möchten, verwenden Sie den Tab Logs in Workflows. Eine zusammengefasste Ansicht der Logs für alle Ihre Workflows erhalten Sie auf der Seite Log-Explorer in Cloud Logging.
  • Sie können Logs auf folgende Weise an Cloud Logging senden:
    • Wenn Sie das Aufruf-Logging aktivieren, können Sie ein Flag festlegen, damit jeder Aufrufschritt oder jede Ausnahme während der Ausführung Ihres Workflows protokolliert wird.
    • Durch Erstellen von benutzerdefinierten Logs, die die Funktion sys.log in Ihrer Quelle verwenden

Nächste Schritte