Bekannte Probleme

Cloud Composer 1 | Cloud Composer 2 | Cloud Composer 3

Auf dieser Seite werden bekannte Probleme mit Cloud Composer aufgelistet. Einige Fehlerkorrekturen für diese Probleme sind in Arbeit und werden in zukünftigen Versionen verfügbar sein.

Einige Probleme betreffen ältere Versionen und können durch ein Upgrade Ihrer Umgebung behoben werden.

Adressen außerhalb des RFC 1918-Bereichs werden für Pods und Dienste teilweise unterstützt

Cloud Composer benötigt GKE, um Adressen außerhalb von RFC 1918 für Pods und Dienste zu unterstützen. Derzeit wird in Cloud Composer nur die folgende Liste von Bereichen außerhalb von RFC 1918 unterstützt:

  • 100.64.0.0/10
  • 192.0.0.0/24
  • 192.0.2.0/24
  • 192.88.99.0/24
  • 198.18.0.0/15
  • 198.51.100.0/24
  • 203.0.113.0/24
  • 240.0.0.0/4

In der Airflow-Benutzeroberfläche werden keine Aufgabenlogs angezeigt, wenn sich die DAG-Serialisierung in Composer 1.10.2 und Composer 1.10.3 befindet

Durch Aktivieren der DAG-Serialisierung in Umgebungen mit Composer-Versionen 1.10.2 und 1.10.3 werden die Logs nicht im Airflow-Webserver angezeigt. Führen Sie zur Problembehebung ein Upgrade auf Version 1.10.4 oder höher durch.

Zeitweiliger Aufgabenfehler während der Planung in Cloud Composer

Das Problem wird während der Ausführung der Aufgabe in einem Airflow-Planer für die Aufgabeninstanz angezeigt. Die Logs erklären jedoch nicht die Ursache des Aufgabenfehlers und Airflow Worker und Airflow Scheduler sahen relativ fehlerfrei aus.

Die Fehlermeldung im Airflow-Planer kann wie folgt aussehen:

Executor reports task instance <TaskInstance: xx.xxxx scheduled__2022-04-21T06:00:00+00:00 [queued]> finished (failed) although the task says its queued. (Info: None) Was the task killed externally?

Es kann auch ein Fehler wie der folgende in Airflow Worker auftreten:

Log file is not found: gs://$BUCKET_NAME/logs/$DAG_NAME/$TASK_NAME/2023-01-25T05:01:17.044759+00:00/1.log.
The task might not have been executed or worker executing it might have finished abnormally (e.g. was evicted).

Es wird dringend empfohlen, proaktiv geeignete Wiederholungsstrategien sowohl auf Aufgaben- als auch auf DAG-Ebene zu implementieren, um die Widerstandsfähigkeit gegen solche Fehler zu gewährleisten, die auf ein langjähriges Problem in Airflow zurückzuführen sind. Durch die Integration dieser Maßnahmen kann das System die Auswirkungen dieser Fehler effektiv mindern und so die Zuverlässigkeit und Robustheit des Workflows insgesamt verbessern.

GKE Workload Identity wird nicht unterstützt

Dieses Problem betrifft nur Cloud Composer 1-Umgebungen. Cloud Composer 2-Umgebungen verwenden Workload Identity.

Sie können Workload Identity für Cloud Composer-Umgebungscluster nicht aktivieren. Daher wird in Security Command Center möglicherweise das Ergebnis WORKLOAD_IDENTITY_DISABLED angezeigt.

Umgebungslabels, die während einer Aktualisierung hinzugefügt werden, werden nicht vollständig weitergegeben

Aktualisierte Umgebungslabels werden nicht auf Compute Engine-VMs angewendet. Als Behelfslösung können diese Labels manuell angewendet werden.

GKE-Upgrades im Zusammenhang mit Problem CVE-2020-14386

Wir arbeiten daran, die Sicherheitslücke CVE-2020-14386 in allen Cloud Composer-Umgebungen zu beheben. Im Rahmen der Problembehebung werden alle vorhandenen GKE-Cluster von Cloud Composer auf eine neuere Version aktualisiert.

Kunden, die sich entscheiden, die Sicherheitslücke sofort zu beheben, können ein Upgrade des Composer-GKE-Clusters durchführen. Folgen Sie dazu dieser Anleitung und beachten Sie dabei Folgendes:

Schritt 1: Wenn Sie eine Cloud Composer-Version vor Version 1.7.2 ausführen, führen Sie ein Upgrade auf eine neuere Version von Cloud Composer durch. Wenn Sie bereits Version 1.7.2 oder höher haben, fahren Sie mit dem nächsten Punkt fort.

Schritt 2: Aktualisieren Sie die GKE-Cluster (Master und Knoten) auf die neueste 1.15-Patch-Version, die den Fehlerbehebung für diese Sicherheitslücke enthält.

Airflow-Aufgabenlogs sind im Airflow-Webserver nach einem Upgrade von Airflow 1.9.0 auf Airflow 1.10.x nicht verfügbar.

Mit Airflow 1.10.x wurden nicht abwärtskompatible Änderungen an der Namenskonvention für Logdateien vorgenommen. Zoneninformationen werden jetzt den Lognamen für Airflow-Aufgaben hinzugefügt.

Airflow 1.9.0 speichert und erwartet, dass die Log-Namen das folgende Format haben:BUCKET/logs/DAG/2020-03-30T10:29:06/1.log Airflow 1.10.x speichert und erwartet, dass die Log-Namen das folgende Format haben:BUCKET/logs/DAG/2020-03-30T10:29:06+00:00/1.log

Wenn Sie ein Upgrade von Airflow 1.9.0 auf Airflow 1.10.x durchführen und das Log für eine mit Airflow 1.9.0 ausgeführte Aufgabe lesen möchten, zeigt der Airflow-Webserver die folgende Fehlermeldung an: Unable to read remote log from BUCKET/logs/DAG/2020-03-30T10:29:06+00:00/1.log

Problemumgehung: Benennen Sie die von Airflow 1.9.0 im Cloud Storage-Bucket generierten Logs in folgendem Format um: BUCKET/logs/DAG/2020-03-30T10:29:06+00:00/1.log

Es können keine Cloud Composer-Umgebungen mit der erzwungenen Organisationsrichtlinieneinschränkung /compute.disableSerialPortLogging erstellt werden

Wird constraints/compute.disableSerialPortLogging für das Zielprojekt erzwungen, so schlägt die Erstellung der Cloud Composer-Umgebung fehl.

Diagnose

So ermitteln Sie, ob Sie von diesem Problem betroffen sind:

Rufen Sie in der Google Cloud Console das GKE-Menü auf. Zum GKE-Menü

Wählen Sie anschließend den neu erstellten Cluster aus. Suchen Sie nach folgendem Fehler:

Not all instances running in IGM after 123.45s.
Expect <number of desired instances in IGM>. Current errors:

Constraint constraints/compute.disableSerialPortLogging violated for
project <target project number>.

Problemumgehungen:

  1. Deaktivieren Sie die Organisationsrichtlinie für das Projekt, in dem die Cloud Composer-Umgebung erstellt werden soll.

    Eine Organisationsrichtlinie kann jederzeit auf Projektebene deaktiviert werden, auch wenn sie von den übergeordneten Ressourcen (Organisation oder Ordner) aktiviert ist. Weitere Informationen finden Sie auf der Seite Richtlinien für boolesche Einschränkungen anpassen.

  2. Ausschlussfilter verwenden

    Durch Verwendung eines Ausschlussfilters für serielle Portlogs wird das gleiche Ziel wie das Deaktivieren der Organisationsrichtlinie verwendet, da es in Logging serielle Konsolenlogs gibt. Weitere Informationen finden Sie auf der Seite Ausschlussfilter.

Deployment Manager zum Verwalten von Google Cloud-Ressourcen verwenden, die durch VPC Service Controls geschützt sind

Composer verwendet Deployment Manager, um Komponenten von Cloud Composer-Umgebungen zu erstellen.

Im Dezember 2020 haben Sie möglicherweise Informationen erhalten, die Sie unter Umständen zur Konfiguration weiterer VPC Service Controls-Ressourcen benötigen, um Deployment Manager zum Verwalten von Ressourcen zu verwenden, die durch VPC Service Controls geschützt sind.

Wir möchten klarstellen, dass Ihrerseits keine Maßnahme erforderlich ist, wenn Sie Composer verwenden und Deployment Manager nicht direkt zum Verwalten von Google Cloud-Ressourcen verwenden, die in der Ankündigung von Deployment Manager erwähnt werden.

Eine Umgebung kann nicht gelöscht werden, nachdem der GKE-Cluster gelöscht wurde.

Wenn Sie den Cluster der Umgebung vor der Umgebung selbst löschen, führt der Versuch, die Umgebung zu löschen, zu folgendem Fehler:

 Got error "" during CP_DEPLOYMENT_DELETING [Rerunning Task. ]

So löschen Sie eine Umgebung, wenn der GKE-Cluster bereits gelöscht ist:

  1. Öffnen Sie in der Google Cloud Console die Seite Deployment Manager.

    Seite „Deployment Manager“ aufrufen

  2. Alle mit Labels gekennzeichneten Bereitstellungen suchen:

    • goog-composer-environment:<environment-name>
    • goog-composer-location:<environment-location>.

    Sie sollten zwei Bereitstellungen sehen, die mit den beschriebenen Labels gekennzeichnet sind:

    • Eine Bereitstellung mit dem Namen <environment-location>-<environment-name-prefix>-<hash>-sd
    • Eine Bereitstellung mit dem Namen addons-<uuid>
  3. Löschen Sie Ressourcen, die noch in diesen beiden Bereitstellungen aufgeführt und im Projekt vorhanden sind (z. B. Pub/Sub-Themen und -Abos). Anleitung:

    1. Wählen Sie die Bereitstellungen aus.

    2. Klicken Sie auf Löschen.

    3. Wählen Sie die Option Zwei Bereitstellungen und alle von ihnen erstellten Ressourcen löschen, z. B. VMs, Load-Balancer und Laufwerke, und klicken Sie auf Alle löschen.

    Der Löschvorgang schlägt fehl, die verbleibenden Ressourcen werden jedoch gelöscht.

  4. Löschen Sie die Bereitstellungen mit einer der folgenden Optionen:

    • Wählen Sie in der Google Cloud Console noch einmal beide Bereitstellungen aus. Klicken Sie auf Löschen und wählen Sie die Option Zwei Bereitstellungen löschen, aber die von ihnen erstellten Ressourcen beibehalten aus.

    • Führen Sie einen gcloud-Befehl aus, um die Bereitstellungen mit der Richtlinie ABANDON zu löschen:

      gcloud deployment-manager deployments delete addons-<uuid> \
          --delete-policy=ABANDON
      
      gcloud deployment-manager deployments delete <location>-<env-name-prefix>-<hash>-sd \
          --delete-policy=ABANDON
      
  5. Ihre Cloud Composer-Umgebung löschen.

Deployment Manager zeigt Informationen zu einer nicht unterstützten Funktion an.

Im Tab „Deployment Manager“ kann die folgende Warnung angezeigt werden:

The deployment uses actions, which are an unsupported feature. We recommend
that you avoid using actions.

Bei Bereitstellungen von Deployment Manager, die Cloud Composer gehören, können Sie diese Warnung ignorieren.

Warnungen zu doppelten Einträgen der Aufgabe „echo“, die zum DAG „echo-airflow_monitoring“ gehört.

In den Airflow-Logs wird möglicherweise der folgende Eintrag angezeigt:

in _query db.query(q) File "/opt/python3.6/lib/python3.6/site-packages/MySQLdb/
connections.py", line 280, in query _mysql.connection.query(self, query)
_mysql_exceptions.IntegrityError: (1062, "Duplicate entry
'echo-airflow_monitoring-2020-10-20 15:59:40.000000' for key 'PRIMARY'")

Sie können diese Logeinträge ignorieren, da dieser Fehler keine Auswirkungen auf den Airflow-DAG und die Aufgabenverarbeitung hat.

Wir arbeiten an der Verbesserung des Cloud Composer-Dienstes, um diese Warnungen aus Airflow-Logs zu entfernen.

Die Umgebung kann in Projekten mit Identity-Aware Proxy APIs nicht erstellt werden, die dem VPC Service Controls-Perimeter hinzugefügt wurden

In Projekten mit aktiviertem VPC Service Controls benötigt das Konto cloud-airflow-prod@system.gserviceaccount.com ausdrücklichen Zugriff in Ihrem Sicherheitsperimeter, um Umgebungen zu erstellen.

Zum Erstellen von Umgebungen können Sie eine der folgenden Lösungen verwenden:

  • Fügen Sie dem Sicherheitsbereich nicht die Cloud Identity-Aware Proxy API und die Identity-Aware Proxy TCP API hinzu.

  • Fügen Sie das Dienstkonto cloud-airflow-prod@system.gserviceaccount.com als Mitglied Ihres Sicherheitsperimeters hinzu. Verwenden Sie dazu die folgende Konfiguration in der YAML-Bedingungsdatei:

     - members:
        - serviceAccount:cloud-airflow-prod@system.gserviceaccount.com
    

Das Erstellen der Cloud Composer 1-Umgebung schlägt fehl, wenn die Richtlinie compute.requireOsLogin aktiviert ist

Wenn die Richtlinie compute.requireOsLogin in Ihrem Projekt auf true gesetzt ist, schlägt das Erstellen der Umgebung von Cloud Composer 1 v1 fehl.

Deaktivieren Sie diese Richtlinie in Ihrem Projekt, um Cloud Composer 1-Umgebungen zu erstellen.

Weitere Informationen zu dieser Organisationsrichtlinie finden Sie unter Einschränkungen für Organisationsrichtlinien.

Das Erstellen oder Upgrade der Cloud Composer-Umgebung schlägt fehl, wenn compute.vmExternalIpAccess deaktiviert ist

Cloud Composer-eigene GKE-Cluster, die im Modus für öffentliche IP-Adressen konfiguriert sind, erfordern eine externe Verbindung für ihre VMs. Aus diesem Grund kann die Erstellung von VMs mit externen IP-Adressen in der Richtlinie compute.vmExternalIpAccess nicht verboten werden. Weitere Informationen zu dieser Organisationsrichtlinie finden Sie unter Einschränkungen für Organisationsrichtlinien.

Wenn die Richtlinie compute.vmCanIpForward deaktiviert ist, schlägt das Erstellen der Cloud Composer-Umgebung fehl.

In Cloud Composer 1-Umgebungen, die im Modus nicht VPC-nativ (mit Alias-IP) erstellt werden, ist diese Richtlinie erforderlich, um das Erstellen von VMs mit der aktivierten Funktion "IP-Weiterleitung" zu ermöglichen. Weitere Informationen zu dieser Organisationsrichtlinie finden Sie unter Einschränkungen für Organisationsrichtlinien.

Der erste DAG wird für eine hochgeladene DAG-Datei mit mehreren fehlgeschlagenen Aufgaben ausgeführt.

Wenn Sie eine DAG-Datei hochladen, schlagen manchmal die ersten Aufgaben des ersten DAG mit dem Fehler Unable to read remote log... fehl. Dieses Problem tritt auf, weil die DAG-Datei zwischen dem Bucket Ihrer Umgebung, den Airflow-Workern und den Airflow-Planern Ihrer Umgebung synchronisiert wird. Diese Synchronisierungen werden unabhängig voneinander durchgeführt. Wenn der Planer die DAG-Datei abruft und plant, sie von einem Worker ausgeführt zu werden, und wenn der Worker noch nicht die DAG-Datei hat, schlägt die Aufgabenausführung fehl.

Als Behelfslösung können Airflow-2-Umgebungen in Cloud Composer 1.17.0-preview.9 und höhere versions standardmäßig so konfiguriert werden, dass zwei Wiederholungen für eine fehlgeschlagene Aufgabe ausgeführt werden. Wenn eine Aufgabe fehlschlägt, wird sie zweimal mit Intervallen von 5 Minuten wiederholt.

So verwenden Sie die Problemumgehung in Problem 1: Überschreiben Sie die core-default_task_retries Airflow-Konfigurationsoption und legen Sie sie auf eine Zahl größer oder gleich 2 fest.

Aufgabe schlägt mit „OSError: [Errno 5] Input/output error“ in Airflow 1.10.15 oder früheren Versionen fehl

Ein Programmfehler in Airflow-1-Versionen führt dazu, dass in einigen seltenen Fällen Aufgaben zweimal in die Redis-Warteschlange gestellt werden.

Manchmal kann dies zu einer Race-Bedingung in der Logdatei und einem nachfolgenden Aufgabenfehler führen. Aufgaben schlagen mit OSError: [Errno 5] Input/output error in Cloud Logging und Task is in the 'running' state which is not a valid state for execution. im Aufgabenversuchslog fehl.

Dieser Fehler wurde in Airflow 2 behoben. Wenn dieses Problem in Airflow 1 bei einer lang andauernden Aufgabe auftritt, erhöhen Sie den Wert der Airflow-Konfigurationsoption [celery_broker_transport_options]visibility_timeout (Standardwert ist 604800 für Composer 1.17.0, 21600 für ältere Umgebungen). Erwägen Sie bei kurz laufenden Aufgaben, zusätzliche Wiederholungen zu den betroffenen Aufgaben hinzuzufügen oder Ihre Umgebung zu Airflow 2 zu migrieren.

Dataproc/Dataflow-Operatoren schlagen mit Negsignal.SIGSEGV fehl.

Dies ist ein vorübergehendes Problem der grcpio-Bibliothek, wenn sie von einem Celery-Worker verwendet wird. Dieses Problem betrifft Airflow-Versionen ab 1.10.14.

Das Problem lässt sich dadurch umgehen, dass Sie die Abfragestrategie grpcio ändern. Dazu fügen Sie der Umgebung die folgende Umgebungsvariable hinzu: GRPC_POLL_STRATEGY=epoll1. Diese Problemumgehung wurde bereits in Cloud Composer 1.17.1 und höheren Versionen angewendet.

Hinweise zur Einstellung der Unterstützung für verworfene Beta APIs aus GKE-Versionen

Cloud Composer verwaltet zugrunde liegende Cloud Composer-Cluster. Sofern Sie diese APIs nicht explizit in Ihren DAGs und Ihrem Code verwenden, können Sie Ankündigungen zu verworfenen GKE APIs ignorieren. Cloud Composer übernimmt bei Bedarf alle Migrationen.

GKE-Upgrades im Zusammenhang mit Sicherheitsproblemen mit CVE-2021-25741

Alle GKE-Cluster von Cloud Composer werden automatisch auf neuere GKE-Versionen aktualisiert, wobei die in CVE-2021-25741 beschriebenen Probleme behoben werden.

Wenn Sie diese Sicherheitslücke sofort beheben möchten, führen Sie ein Upgrade des GKE-Clusters Ihrer Umgebung durch. Folgen Sie dazu der Anleitung zum Upgrade eines Clusters.

  • Wenn Sie eine Cloud Composer 1-Umgebung und GKE-Version 1.18.x oder früher haben, aktualisieren Sie auf 1.18.20-gke.4501.

  • Wenn Sie eine Cloud Composer 1-Umgebung und GKE-Version 1.19.x haben, führen Sie ein Upgrade auf 1.19.14-gke.301 durch.

  • Wenn Sie eine Cloud Composer 2-Umgebung und GKE-Version 1.21.x haben, führen Sie ein Upgrade auf 1.21.4-gke.301 durch.

Cloud Composer sollte nicht von der Apache Log4j 2-Sicherheitslücke (CVE-2021-44228) betroffen sein

Als Reaktion auf die Apache Log4j 2-Sicherheitslücke (CVE-2021-44228) hat Cloud Composer eine detaillierte Untersuchung durchgeführt und wir sind der Auffassung, dass Cloud Composer nicht anfällig für diesen Exploit ist.

Cloud Composer 2: Bei Airflow-Workern oder -Planern können Probleme beim Zugriff auf Cloud Storage-Buckets auftreten

In einigen sporadischen Situationen können in Cloud Composer 2-Umgebungen nach dem Neustart des Airflow-Workers oder des Airflow-Planers Fehlfunktionen auftreten und es können Probleme beim Zugriff auf den Inhalt des Cloud Storage-Bucket auftreten.

In einer solchen Situation werden in Airflow-Logs möglicherweise Fehler angezeigt, die mit Transport endpoint is not connected beginnen.

Das Fehlerlog für Airflow-Worker könnte beispielsweise so aussehen:

[Errno 107] Transport endpoint is not connected: '/home/airflow/gcs/logs/airflow_monitoring/echo/2022-01-11T22:50:48+00:00'

Lösung:

  • Upgrade auf Cloud Composer 2.0.26 oder eine neuere Version

In der Airflow-UI wird ein Plug-in nach dem Ändern möglicherweise nicht neu geladen

Wenn ein Plug-in aus vielen Dateien besteht, die andere Module importieren, kann die Airflow-UI möglicherweise nicht erkennen, dass ein Plug-in neu geladen werden sollte. In einem solchen Fall muss der Airflow-Webserver neu gestartet werden. Dazu können Sie eine Umgebungsvariable hinzufügen oder PYPI-Abhängigkeiten installieren oder deinstallieren. Sie können auch den Airflow-Webserver neu starten.

Zeitweilige Probleme bei der Kommunikation mit der Airflow-Metadatendatenbank

Dieses bekannte Problem tritt nur bei Cloud Composer 1 auf.

In einigen älteren Cloud Composer 1-Umgebungen (1.16.3 oder älter), die vor dem 12. August 2021 erstellt wurden, können vorübergehende Probleme im Zusammenhang mit der Kommunikation mit Airflow-Metadatendatenbanken auftreten.

Wenn dieses Problem auftritt, wird in den Airflow-Aufgabenlogs die folgende Fehlermeldung angezeigt:

"Can't connect to MySQL server on 'airflow-sqlproxy-service.default.svc.cluster.local' (104)"

Das Cloud Composer-Team arbeitet an der Lösung dieses Problems. Wenn Sie der Meinung sind, dass Sie stark von diesem Problem betroffen sind, können Sie es in der Zwischenzeit so beseitigen:

  1. Rufen Sie in der Google Cloud Console die Seite Umgebungskonfiguration der betroffenen Cloud Composer-Umgebungen auf.
  2. Klicken Sie auf den Link Clusterdetails ansehen, um den zugrunde liegenden GKE-Cluster der Umgebung aufzurufen.
  3. Wechseln Sie zum Tab Knoten und klicken Sie im Abschnitt Knotenpools auf den Standardpool. Standardpool auswählen
  4. Klicken Sie oben auf der Seite auf Bearbeiten.
  5. Ändern Sie den Image-Typ in Container-Optimized OS mit containerd und speichern Sie die Konfiguration wie unten gezeigt. Image-Typ des Knotenpools von Docker in containerd ändern
  6. Nachdem die Änderung gesendet wurde, wird der Knotenpool default-pool so konfiguriert, dass containerd als Containerlaufzeit verwendet wird. Einige Ihrer Airflow-Aufgaben schlagen möglicherweise fehl, während der Knotenpool neu konfiguriert wird. Wenn für diese Aufgaben Wiederholungen konfiguriert sind, werden sie von Airflow noch einmal ausgeführt, sobald der Vorgang im Knotenpool abgeschlossen ist.

Der Cluster der Umgebung hat Arbeitslasten im Status „Nicht planbar“

Dieses bekannte Problem tritt nur bei Cloud Composer 2 auf.

In Cloud Composer 2 verbleiben nach dem Erstellen einer Umgebung mehrere Arbeitslasten im Cluster der Umgebung im Status „Nicht planbar“.

Wenn eine Umgebung hochskaliert wird, werden neue Worker-Pods erstellt und Kubernetes versucht, sie auszuführen. Wenn keine freien Ressourcen zum Ausführen verfügbar sind, werden die Worker-Pods als nicht planbar gekennzeichnet.

In diesem Fall fügt der Cluster Autoscaler weitere Knoten hinzu, was einige Minuten dauert. Bis dahin bleiben die Pods im Status „Nicht planbar“ und führen keine Aufgaben aus.

Nicht planbare DaemonSet-Arbeitslasten mit den Namen composer-gcsfuse und composer-fluentd, die nicht auf Knoten gestartet werden können, auf denen keine Airflow-Komponenten vorhanden sind, haben keine Auswirkungen auf Ihre Umgebung.

Wenn dieses Problem über eine Stunde lang anhält, können Sie die Cluster Autoscaler-Logs prüfen. Sie finden sie in der Loganzeige mit dem folgenden Filter:

resource.type="k8s_cluster"
logName="projects/<project-name>/logs/container.googleapis.com%2Fcluster-autoscaler-visibility"
resource.labels.cluster_name="<cluster-name>"

Sie enthält Informationen zu Entscheidungen, die vom Cluster Autoscaler getroffen wurden: Maximieren Sie "noDecisionStatus", um den Grund zu sehen, warum der Cluster nicht hoch- oder herunterskaliert werden kann.

Fehler 504 beim Zugriff auf die Airflow-UI

Der Fehler 504 Gateway Timeout kann beim Zugriff auf die Airflow-UI ausgegeben werden. Dieser Fehler kann mehrere Ursachen haben:

  • Vorübergehendes Kommunikationsproblem. Versuchen Sie in diesem Fall später, auf die Airflow-UI zuzugreifen. Sie können auch den Airflow-Webserver neu starten.
  • (Nur Cloud Composer 2) Verbindungsproblem. Wenn die Airflow-UI dauerhaft nicht verfügbar ist und Zeitüberschreitungs- oder 504-Fehler auftreten, muss Ihre Umgebung auf *.composer.cloud.google.com zugreifen können. Wenn Sie den privater Google-Zugriff verwenden, Traffic über virtuelle private.googleapis.com-IP-Adressen oder VPC Service Controls und Traffic über virtuelle restricted.googleapis.com-IP-Adressen senden, muss Ihr Cloud DNS auch für *.composer.cloud.google.com-Domainnamen konfiguriert sein.
  • Nicht reagierender Airflow-Webserver. Wenn der Fehler 504 weiterhin besteht, Sie aber zu bestimmten Zeiten immer noch auf die Airflow-UI zugreifen können, reagiert der Airflow-Webserver möglicherweise nicht, weil er überlastet ist. Versuchen Sie, die Skalierungs- und Leistungsparameter des Webservers zu erhöhen.

Fehler 502 beim Zugriff auf die Airflow-UI

Der Fehler 502 Internal server exception gibt an, dass die Airflow-UI eingehende Anfragen nicht verarbeiten kann. Dieser Fehler kann mehrere Ursachen haben:

  • Vorübergehendes Kommunikationsproblem. Versuchen Sie später noch einmal, auf die Airflow-UI zuzugreifen.

  • Webserver konnte nicht gestartet werden. Damit der Webserver gestartet werden kann, müssen zuerst Konfigurationsdateien synchronisiert werden. Suchen Sie in den Webserverlogs nach Logeinträgen, die in etwa so aussehen: GCS sync exited with 1: gsutil -m cp gs://<bucket-name>/airflow.cfg /home/airflow/gcs/airflow.cfg.tmp oder GCS sync exited with 1: gsutil -m cp gs://<bucket-name>/env_var.json.cfg /home/airflow/gcs/env_var.json.tmp. Wenn Sie diese Fehler sehen, prüfen Sie, ob die in den Fehlermeldungen genannten Dateien noch im Bucket der Umgebung vorhanden sind.

    Im Falle einer versehentlichen Entfernung, z. B. weil eine Aufbewahrungsrichtlinie konfiguriert wurde, können Sie sie wiederherstellen:

    1. Legen Sie eine neue Umgebungsvariable in Ihrer Umgebung fest. Sie können einen beliebigen Variablennamen und -wert verwenden.

    2. Airflow-Konfigurationsoption überschreiben. Sie können eine nicht vorhandene Airflow-Konfigurationsoption verwenden.

Wenn der Mauszeiger in der Baumansicht auf die Aufgabeninstanz bewegt wird, wird ein nicht abgefangener TypeError ausgegeben.

In Airflow 2 funktioniert die Baumansicht in der Airflow-UI möglicherweise nicht richtig, wenn eine nicht standardmäßige Zeitzone verwendet wird. Sie können dieses Problem umgehen, indem Sie in der Airflow-UI die Zeitzone explizit konfigurieren.

Die Airflow-UI in Airflow 2.2.3 oder früheren Versionen ist anfällig für CVE-2021-45229

Wie in CVE-2021-45229 erwähnt, war der Bildschirm "Trigger DAG with config" (DAG mit Konfiguration auslösen) anfällig für XSS-Angriffe über das Abfrageargument origin.

Empfehlung: Führen Sie ein Upgrade auf die neueste Cloud Composer-Version durch, die Airflow 2.2.5 unterstützt.

Worker benötigen mehr Arbeitsspeicher als in früheren Airflow-Versionen

Symptome:

  • In Ihrer Cloud Composer 2-Umgebung haben alle Clusterarbeitslasten von Airflow-Workern den Status CrashLoopBackOff und führen keine Aufgaben aus. Sie können auch OOMKilling-Warnungen sehen, die generiert werden, wenn Sie von diesem Problem betroffen sind.

  • Dadurch können Umgebungsupgrades verhindert werden.

Ursache:

  • Wenn Sie einen benutzerdefinierten Wert für die Airflow-Konfigurationsoption [celery]worker_concurrency und benutzerdefinierte Arbeitsspeichereinstellungen für Airflow-Worker verwenden, kann dieses Problem auftreten, wenn sich der Ressourcenverbrauch dem Limit nähert.
  • In Airflow 2.6.3 mit Python 3.11 ist der Arbeitsspeicherbedarf von Airflow-Workern 10 % höher als bei Workern in früheren Versionen.
  • Die Arbeitsspeicheranforderungen der Airflow-Worker sind in Airflow 2.3 und höher 30 % höher als in Airflow 2.2 oder Airflow 2.1.

Lösungen:

  • Entfernen Sie die Überschreibung für worker_concurrency, damit Cloud Composer diesen Wert automatisch berechnet.
  • Wenn Sie für worker_concurrency einen benutzerdefinierten Wert verwenden, legen Sie einen niedrigeren Wert fest. Sie können den automatisch berechneten Wert als Ausgangspunkt verwenden.
  • Alternativ können Sie den für Airflow-Worker verfügbaren Arbeitsspeicher erhöhen.
  • Wenn Sie aufgrund dieses Problems ein Upgrade Ihrer Umgebung auf eine höhere Version durchführen können, wenden Sie vor dem Upgrade eine der vorgeschlagenen Lösungen an.

DAG-Trigger über private Netzwerke mit Cloud Functions

Das Auslösen von DAGs mit Cloud Functions über private Netzwerke mithilfe eines VPC-Connectors wird von Cloud Composer nicht unterstützt.

Empfehlung: Verwenden Sie Cloud Functions, um Nachrichten in Pub/Sub zu veröffentlichen. Durch solche Ereignisse können Pub/Sub-Sensoren Airflow-DAGs auslösen oder einen Ansatz implementieren, der auf zurückstellbaren Operatoren basiert.

Problem mit gcloud composer-Befehlen in Version 410.0.0

In der gcloud-Version 410.0.0 führen Sie die folgenden Cloud Composer-Befehle aus:

  • gcloud composer environments run
  • gcloud composer environments list-packages

einen Fehlercode ungleich null zurückgeben und folgende Fehlermeldung anzeigen:

  (ERROR: gcloud crashed (TypeError): 'NoneType' object is not callable)

Dieses Verhalten tritt zusätzlich zur regulären Ausgabe der gcloud-Befehle auf und wirkt sich nicht auf deren Funktionalität aus.

Wenn dieses Problem keine Auswirkungen auf Ihre Vorgänge hat, können Sie weiterhin die Version 410.0.0 verwenden und die inkorrekte Fehlermeldung ignorieren. Wenn Sie Version 410.0.0 verwenden müssen und den gcloud-Befehl programmatisch nutzen, implementieren Sie eine zusätzliche Logik, um Fehlercode ungleich null und Informationen zum Fehler-Stacktrace in der Ausgabe zu ignorieren. Im Abschnitt „Lösung“ finden Sie weitere Behelfslösungen.

Lösung

  • Sie sollten kein Upgrade auf die Version 410.0.0 ausführen. Sie verwenden Version 409.0.0 oder eine frühere Version.
  • Falls Sie bereits ein Upgrade durchgeführt haben, führen Sie ein Downgrade auf eine frühere Version aus (z. B. 409.0.0). Weitere Informationen finden Sie unter Versionierte Archive verwenden.

Leere Ordner in Planer und Workern

Cloud Composer entfernt leere Ordner nicht aktiv aus Airflow-Workern und -Planern. Solche Entitäten können bei der Synchronisierung des Umgebungs-Buckets erstellt werden, wenn diese Ordner im Bucket vorhanden waren und schließlich entfernt wurden.

Empfehlung: Passen Sie Ihre DAGs so an, dass sie solche leeren Ordner überspringen können.

Solche Entitäten werden letztendlich aus den lokalen Speichern von Airflow-Planern und -Workern entfernt, wenn diese Komponenten neu gestartet werden (z.B. aufgrund von Herunterskalieren oder Wartungsvorgängen im Cloud Composer-Cluster).

Unterstützung für Kerberos

Cloud Composer unterstützt noch keine Airflow-Kerberos-Konfiguration.

Unterstützung für Computing-Klassen in Cloud Composer 2

Cloud Composer 2 unterstützt nur die Computing-Klasse für allgemeine Zwecke. Das Ausführen von Pods, die andere Compute-Klassen wie Balanced oder Scale-Out anfordern, ist nicht möglich.

Mit der Klasse allgemeine Zwecke können Pods ausgeführt werden, die bis zu 110 GB Arbeitsspeicher und bis zu 30 CPUs anfordern (wie unter Compute Class Max-Anfragen beschrieben).

Wenn Sie eine ARM-basierte Architektur verwenden möchten oder mehr CPU und Arbeitsspeicher benötigen, müssen Sie eine andere Compute-Klasse verwenden, die in Cloud Composer 2-Clustern nicht unterstützt wird.

Empfehlung: Verwenden Sie GKEStartPodOperator, um Kubernetes-Pods in einem anderen Cluster auszuführen, der die ausgewählte Compute-Klasse unterstützt. Wenn Sie benutzerdefinierte Pods ausführen, die eine andere Compute-Klasse erfordern, müssen diese auch in einem Cluster ausgeführt werden, der nicht zu Cloud Composer 2 gehört.

Unterstützung für Google Campaign Manager 360-Operatoren

Google Campaign Manager-Operatoren in Cloud Composer-Versionen vor 2.1.13 basieren auf der Campaign Manager 360 v3.5 API, die eingestellt wurde. Das Ablaufdatum ist der 1. Mai 2023.

Wenn Sie Google Campaign Manager-Operatoren verwenden, führen Sie ein Upgrade Ihrer Umgebung auf Cloud Composer Version 2.1.13 oder höher durch.

Unterstützung für Google Display & Video 360-Operatoren

Google Display & Video 360-Operatoren in Cloud Composer-Versionen vor 2.1.13 basieren auf der Display & Video 360 v1.1 API, die eingestellt wurde. Ihr Ablaufdatum ist der 27. April 2023.

Wenn Sie Google Display & Video 360-Operatoren verwenden, führen Sie ein Upgrade Ihrer Umgebung auf Cloud Composer Version 2.1.13 oder höher durch. Möglicherweise müssen Sie Ihre DAGs ändern, da einige der Google Display & Video 360-Operatoren verworfen und durch neue ersetzt wurden.

  • GoogleDisplayVideo360CreateReportOperator wurde verworfen. Verwenden Sie stattdessen GoogleDisplayVideo360CreateQueryOperator. Dieser Operator gibt query_id anstelle von report_id zurück.
  • GoogleDisplayVideo360RunReportOperator wurde verworfen. Verwenden Sie stattdessen GoogleDisplayVideo360RunQueryOperator. Dieser Operator gibt query_id und report_id statt nur report_id zurück und erfordert query_id anstelle von report_id als Parameter.
  • Mit dem neuen GoogleDisplayVideo360RunQuerySensor-Sensor, der die Parameter query_id und report_id verwendet, können Sie prüfen, ob ein Bericht verfügbar ist. Für den verworfenen Sensor GoogleDisplayVideo360ReportSensor war nur report_id erforderlich.
  • Für GoogleDisplayVideo360DownloadReportV2Operator sind jetzt die Parameter query_id und report_id erforderlich.
  • Unter GoogleDisplayVideo360DeleteReportOperator gibt es keine Änderungen, die sich auf Ihre DAGs auswirken können.

Einschränkungen für Namen des sekundären Bereichs

CVE-2023-29247 (Detailseite der Aufgabeninstanz in der Benutzeroberfläche ist anfällig für gespeicherte XSS.)

Die Airflow-UI in Airflow-Versionen von 2.0.x bis 2.5.x ist anfällig für CVE-2023-29247.

Wenn Sie eine frühere Version von Cloud Composer als Version 2.4.2 verwenden und befürchten, dass Ihre Umgebung anfällig für das Exploit ist, lesen Sie die folgende Beschreibung und mögliche Lösungen.

In Cloud Composer ist der Zugriff auf die Airflow-UI mit IAM und der Airflow-UI-Zugriffssteuerung geschützt.

Dies bedeutet, dass Angreifer sich zuerst Zugriff auf Ihr Projekt sowie die erforderlichen IAM-Berechtigungen und -Rollen verschaffen müssen, um die Airflow-UI-Sicherheitslücke auszunutzen.

Lösung:

  • Prüfen Sie die IAM-Berechtigungen und -Rollen in Ihrem Projekt, einschließlich einzelnen Nutzern zugewiesene Cloud Composer-Rollen. Achten Sie darauf, dass nur genehmigte Nutzer auf die Airflow-UI zugreifen können.

  • Überprüfen Sie die Rollen, die Nutzern über den Zugriffssteuerungsmechanismus der Airflow-UI zugewiesen wurden. Dies ist ein separater Mechanismus, der einen genaueren Zugriff auf die Airflow-UI bietet. Achten Sie darauf, dass nur genehmigte Nutzer auf die Airflow-UI zugreifen können und alle neuen Nutzer mit der richtigen Rolle registriert sind.

  • Erwägen Sie eine zusätzliche Härtung mit VPC Service Controls.

Der Airflow-Monitoring-DAG der Cloud Composer 2 Composer-Umgebung wird nach dem Löschen nicht neu erstellt

Der Airflow-Monitoring-DAG wird nicht automatisch neu erstellt, wenn er vom Nutzer gelöscht oder in Composer-Umgebungen mit composer-2.1.4-airflow-2.4.3 aus dem Bucket verschoben wird.

Lösung:

  • Dieses Problem wurde in neueren Versionen wie composer-2.4.2-airflow-2.5.3 behoben. Der empfohlene Ansatz besteht darin, Ihre Umgebung auf eine neuere Version zu aktualisieren.
  • Eine alternative oder vorübergehende Problemumgehung für ein Umgebungsupgrade wäre, den DAG „airflow_monitoring“ aus einer anderen Umgebung mit derselben Version zu kopieren.

Upgradevorgänge können fehlschlagen, wenn Sentry aktiviert ist

Der Upgradevorgang für eine Cloud Composer-Umgebung kann fehlschlagen, wenn Sie Sentry in Ihrer Umgebung konfiguriert und die Einstellung [sentry]sentry_on auf true festgelegt haben.

Lösung:

  • Deaktivieren Sie Sentry in Ihrer Umgebung, führen Sie das Upgrade durch und konfigurieren Sie Sentry noch einmal.

Es ist nicht möglich, den Cloud SQL-Speicher zu reduzieren

Cloud Composer verwendet Cloud SQL, um die Airflow-Datenbank auszuführen. Im Laufe der Zeit kann der Laufwerksspeicher für die Cloud SQL-Instanz zunehmen, da das Laufwerk vertikal für die von Cloud SQL-Vorgängen gespeicherten Daten skaliert wird, wenn die Airflow-Datenbank wächst.

Es ist nicht möglich, die Cloud SQL-Laufwerksgröße herunterzuskalieren.

Wenn Sie die kleinste Cloud SQL-Laufwerksgröße verwenden möchten, können Sie als Behelfslösung Cloud Composer-Umgebungen mit Snapshots neu erstellen.

Messwert zur Laufwerksnutzung der Datenbank wird nach dem Entfernen von Einträgen aus Cloud SQL nicht verkleinert

Relationale Datenbanken wie Postgres oder MySQL entfernen Zeilen nicht physisch nicht, wenn sie gelöscht oder aktualisiert werden. Stattdessen werden sie als „tote Tupel“ gekennzeichnet, um die Datenkonsistenz zu wahren und die Blockierung gleichzeitiger Transaktionen zu vermeiden.

Sowohl MySQL als auch Postgres implementieren Mechanismen zur Rückgewinnung von Speicherplatz nach gelöschten Einträgen.

Es ist zwar möglich, die Datenbank dazu zu zwingen, ungenutzten Speicherplatz zurückzugewinnen. Dies ist jedoch ein ressourcenhungriger Vorgang, bei dem die Datenbank zusätzlich gesperrt wird, sodass Cloud Composer nicht mehr verfügbar ist. Daher wird empfohlen, sich auf die Build-Verfahren zu verlassen, um nicht genutzten Speicherplatz zurückzugewinnen.

Zugriff blockiert: Autorisierungsfehler

Wenn dieses Problem einen Nutzer betrifft, enthält das Dialogfeld Access blocked: Authorization Error (Zugriff blockiert: Autorisierungsfehler) die Meldung Error 400: admin_policy_enforced.

Wenn die Option API-Steuerung > Nicht konfigurierte Drittanbieter-Apps > Nutzern nicht den Zugriff auf Drittanbieter-Apps erlauben in Google Workspace aktiviert ist und Apache Airflow in der Cloud Composer-Anwendung nicht explizit zugelassen ist, können Nutzer nur dann auf die Airflow-UI zugreifen, wenn sie dies explizit zulassen.

Führen Sie die Schritte unter Zugriff auf die Airflow-UI in Google Workspace erlauben aus, um den Zugriff zu gewähren.

Aufgabeninstanzen, die in der Vergangenheit erfolgreich waren und als FEHLGESCHLAGEN markiert wurden

Unter bestimmten Umständen und in seltenen Fällen können Airflow-Aufgabeninstanzen, die in der Vergangenheit erfolgreich ausgeführt wurden, als FAILED gekennzeichnet werden.

Wenn dies geschieht, wurde es in der Regel entweder durch einen Aktualisierungs- oder Upgradevorgang der Umgebung oder durch eine GKE-Wartung ausgelöst.

Hinweis:Das Problem selbst weist nicht auf ein Problem in der Umgebung hin und verursacht keine tatsächlichen Fehler bei der Aufgabenausführung.

Das Problem wurde in Cloud Composer Version 2.6.5 oder höher behoben.

Airflow-Komponenten haben Probleme bei der Kommunikation mit anderen Teilen der Cloud Composer-Konfiguration

In sehr seltenen Fällen kann die langsame Kommunikation mit dem Compute Engine-Metadatenserver dazu führen, dass die Airflow-Komponenten nicht optimal funktionieren. Beispielsweise kann es sein, dass der Airflow-Planer neu gestartet wird, Airflow-Aufgaben wiederholt werden müssen oder die Startzeit von Aufgaben länger dauert.

Symptome:

Die folgenden Fehler werden in den Logs von Airflow-Komponenten (z. B. Airflow-Planer, Worker oder der Webserver) angezeigt:

Authentication failed using Compute Engine authentication due to unavailable metadata server

Compute Engine Metadata server unavailable on attempt 1 of 3. Reason: timed out
...
Compute Engine Metadata server unavailable on attempt 2 of 3. Reason: timed out
...
Compute Engine Metadata server unavailable on attempt 3 of 3. Reason: timed out

Lösung

Legen Sie die folgende Umgebungsvariable fest: GCE_METADATA_TIMEOUT=30.

Der Ordner „/data“ ist auf dem Airflow-Webserver nicht verfügbar

In Cloud Composer 2 ist der Airflow-Webserver hauptsächlich eine schreibgeschützte Komponente und Cloud Composer synchronisiert den Ordner data/ nicht mit dieser Komponente.

Manchmal möchten Sie gemeinsame Dateien für alle Airflow-Komponenten, einschließlich des Airflow-Webservers, freigeben.

Lösung

  • Verpacken Sie die Dateien, die für den Webserver freigegeben werden sollen, in ein PYPI-Modul und installieren Sie es als reguläres PYPI-Paket. Nachdem das PYPI-Modul in der Umgebung installiert wurde, werden die Dateien den Images der Airflow-Komponenten hinzugefügt und stehen ihnen zur Verfügung.

  • Fügen Sie dem Ordner „plugins/“ Dateien hinzu. Dieser Ordner wird mit dem Airflow-Webserver synchronisiert.

Nächste Schritte