Cloud Composer 1 Cloud Composer 2
Auf dieser Seite finden Sie Informationen zur Fehlerbehebung bei Problemen, die beim Aktualisieren oder Upgraden von Cloud Composer-Umgebungen auftreten können.
Informationen zur Fehlerbehebung beim Erstellen von Umgebungen finden Sie unter Fehlerbehebung bei der Erstellung von Umgebungen.
Wenn Cloud Composer-Umgebungen aktualisiert werden, treten die meisten Probleme aus den folgenden Gründen auf:
- Probleme mit Dienstkontoberechtigungen
- Probleme mit der PyPI-Abhängigkeit
- Größe der Airflow-Datenbank
Unzureichende Berechtigungen zum Aktualisieren oder Upgraden einer Umgebung
Wenn Cloud Composer eine Umgebung aufgrund unzureichender Berechtigungen nicht aktualisieren oder aktualisieren kann, wird die folgende Fehlermeldung ausgegeben:
ERROR: (gcloud.composer.environments.update) PERMISSION_DENIED: The caller does not have permission
Lösung: Weisen Sie Ihrem Konto und dem Dienstkonto Ihrer Umgebung Rollen zu, wie unter Zugriffssteuerung beschrieben.
Das Dienstkonto der Umgebung hat nicht die erforderlichen Berechtigungen
Beim Erstellen einer Cloud Composer-Umgebung geben Sie ein Dienstkonto an, das die GKE-Clusterknoten der Umgebung ausführt. Wenn dieses Dienstkonto nicht genügend Berechtigungen für den angeforderten Vorgang hat, gibt Cloud Composer einen Fehler aus:
UPDATE operation on this environment failed 3 minutes ago with the
following error message:
Composer Backend timed out. Currently running tasks are [stage:
CP_COMPOSER_AGENT_RUNNING
description: "No agent response published."
response_timestamp {
seconds: 1618203503
nanos: 291000000
}
].
Lösung: Weisen Sie Ihrem Konto und dem Dienstkonto Ihrer Umgebung Rollen zu, wie unter Zugriffssteuerung beschrieben.
Die Airflow-Datenbank ist zu groß für den Vorgang durchzuführen
Ein Cloud Composer-Upgradevorgang ist möglicherweise nicht erfolgreich, da die Größe der Airflow-Datenbank zu groß ist.
Wenn die Größe der Airflow-Datenbank mehr als 16 GB beträgt, gibt Cloud Composer den folgenden Fehler aus:
Airflow database uses more than 16 GB. Please clean the database before upgrading.
Lösung: Führen Sie eine Airflow-Datenbankbereinigung durch, wie unter Airflow-Datenbankwartung beschrieben.
Ein Upgrade auf eine neue Cloud Composer-Version schlägt aufgrund von PyPI-Paketkonflikten fehl
Wenn Sie ein Upgrade für eine Umgebung mit installierten benutzerdefinierten PyPI-Paketen durchführen, können Fehler im Zusammenhang mit PyPI-Paketkonflikten auftreten. Dies kann daran liegen, dass das neue Cloud Composer-Image neuere Versionen vorinstallierter Pakete enthält, die Abhängigkeitskonflikte mit PyPI-Paketen verursachen, die Sie in Ihrer Umgebung installiert haben.
Lösung:
- Führen Sie eine Upgradeprüfung aus, um detaillierte Informationen zu Paketkonflikten zu erhalten.
- Lockern Sie Versionseinschränkungen für installierte benutzerdefinierte PyPI-Pakete. Anstatt eine Version beispielsweise als
==1.0.1
anzugeben, geben Sie sie als>=1.0.1
an. - Weitere Informationen zum Ändern von Versionsanforderungen, um in Konflikt stehende Abhängigkeiten zu lösen, finden Sie in der Dokumentation zu pip.
Mangelnde Verbindung zum DNS kann zu Problemen bei Upgrades oder Updates führen.
Solche Verbindungsprobleme können zu Logeinträgen wie diesen führen:
WARNING - Compute Engine Metadata server unavailable attempt 1 of 5. Reason: [Errno -3] Temporary failure in name resolution Error
Das bedeutet in der Regel, dass es keine Route zu DNS gibt. Achten Sie deshalb darauf, dass der DNS-Name „metadata.google.internal“ aus Cluster-, Pods- und Dienstnetzwerken in IP-Adressen aufgelöst werden kann. Prüfen Sie, ob der privater Google-Zugriff in der VPC (im Host- oder Dienstprojekt), in der Ihre Umgebung erstellt wird, aktiviert ist.
Weitere Informationen:
Trigger-CPU überschreitet das Limit von 1 vCPU
In Cloud Composer 2 und höher wird in den Versionen 2.4.4 und höher eine andere Trigger-Ressourcenzuweisungsstrategie eingeführt, um die Leistungsskalierung zu verbessern. Wenn bei einem Umgebungsupdate ein Fehler in Verbindung mit der Triggerer-CPU auftritt, bedeutet dies, dass Ihre aktuellen Trigger so konfiguriert sind, dass sie mehr als 1 vCPU pro Trigger verwenden.
Lösung:
- Passen Sie die Triggerer-Ressourcenzuweisung so an, dass das Limit von 1 vCPU nicht überschritten wird.
- Wenn Sie Probleme mit DAGs erwarten, bei denen verzögerte Operatoren verwendet werden, sollten Sie auch die Anzahl der Trigger erhöhen.
Warnungen zu fehlgeschlagener Migration prüfen
Beim Upgrade von Airflow auf eine neuere Version werden manchmal neue Einschränkungen auf die Airflow-Datenbank angewendet. Wenn diese Einschränkungen nicht angewendet werden können, erstellt Airflow neue Tabellen zum Speichern der Zeilen, für die die Einschränkungen nicht angewendet werden konnten. In der Airflow-UI wird eine Warnmeldung angezeigt, bis die verschobenen Datentabellen umbenannt oder gelöscht werden.
Lösung:
Mit den folgenden beiden DAGs können Sie die verschobenen Daten überprüfen und die Tabellen umbenennen.
Der DAG list_moved_tables_after_upgrade_dag
listet Zeilen auf, die aus allen Tabellen verschoben wurden, in denen keine Einschränkungen angewendet werden konnten. Überprüfen Sie die Daten und entscheiden
Sie, ob Sie sie behalten möchten. Sie müssen die Daten in der Airflow-Datenbank manuell korrigieren, um sie beizubehalten. Sie können beispielsweise die Zeilen mit den richtigen Daten wieder hinzufügen.
Wenn Sie die Daten nicht benötigen oder wenn Sie die Probleme bereits behoben haben, können Sie den DAG rename_moved_tables_after_upgrade_dag
ausführen. Dieser DAG benennt die verschobenen Tabellen um.
Die Tabellen und die zugehörigen Daten werden nicht gelöscht, sodass Sie die Daten später überprüfen können.