Auf Airflow-Weboberfläche zugreifen

Cloud Composer 1 | Cloud Composer 2 | Cloud Composer 3

Hinweis: Diese Seite wurde für Cloud Composer 3 noch nicht überarbeitet und zeigt Inhalte für Cloud Composer 2.

Apache Airflow umfasst Benutzeroberfläche (UI) mit dem Sie Workflows (DAGs) und die Airflow-Umgebung verwalten können. und administrative Aufgaben ausführen. Beispielsweise haben Sie die Möglichkeit, mit der Weboberfläche den Fortschritt eines DAG zu prüfen, eine neue Datenverbindung einzurichten oder Logs aus der Ausführung vorheriger DAGs zu prüfen.

Airflow-Webserver

Jede Cloud Composer-Umgebung verfügt über einen Webserver, auf dem die Airflow-Weboberfläche ausgeführt wird. Der Webserver ist Teil der Cloud Composer-Umgebungsarchitektur.

Hinweise

• Sie benötigen eine Rolle, die Cloud Composer-Umgebungen aufrufen kann. Weitere Informationen finden Sie unter Zugriffssteuerung.

• Während der Erstellung der Umgebung konfiguriert Cloud Composer die URL für den Webserver, auf dem die Airflow-Weboberfläche ausgeführt wird. Die URL kann nicht angepasst werden.

• Cloud Composer 2 unterstützt die Funktion Airflow UI Access Control (Airflow Role-Based Access Control) für die Airflow-Weboberfläche.

• Wenn die API-Steuerung > Nicht konfigurierte Drittanbieter-Apps > Option Nutzer dürfen nicht auf Drittanbieter-Apps zugreifen in Google Workspace und Apache Airflow Cloud Composer-Anwendung nicht explizit zugelassen ist, dann Nutzer nicht auf die Airflow-UI zugreifen können, es sei denn, die . Führen Sie die Schritte unter Zugriff auf die Airflow-Benutzeroberfläche in Google Workspace zulassen aus, um den Zugriff zu erlauben.

Auf die Airflow-Weboberfläche zugreifen

Der Airflow-Webserver wird ausgeführt als Arbeitslast im Cluster Ihrer Umgebung. Der Webserver ist in der Domain composer.googleusercontent.com bereitgestellt und bietet Zugriff auf der Airflow-Weboberfläche angezeigt.

Cloud Composer 2 bietet Zugriff auf die Oberfläche basierend auf Nutzeridentitäten und IAM-Richtlinienbindungen für Nutzer definiert. Verglichen mit Cloud Composer 1 und Cloud Composer 2 verwenden einen anderen Mechanismus, der auf Identity-Aware Proxy.

Über die Google Cloud Console auf die Weboberfläche zugreifen

So greifen Sie über die Google Cloud Console auf die Airflow-Weboberfläche zu:

1. Rufen Sie in der Google Cloud Console die Seite Umgebungen auf.

   Zur Seite „Umgebungen“

2. Klicken Sie in der Spalte Airflow-Webserver auf den Link Airflow für Ihre Umgebung.

Zugriff auf den Airflow-Webserver beschränken

Mit Composer-Umgebungen können Sie den Zugriff auf den Airflow-Webserver beschränken:

• Sie können den gesamten Zugriff blockieren oder den Zugriff aus bestimmten externen IPv4- oder IPv6-IP-Bereichen zulassen.
• Die zulässigen IP-Bereiche können nicht mit privaten IP-Adressen konfiguriert werden Adressen.

URL der Weboberfläche mit dem gcloud-Befehlszeilentool abrufen

Sie können über einen beliebigen Webbrowser auf die Airflow-Weboberfläche zugreifen. Zum Abrufen der URL für die Weboberfläche geben Sie diesen gcloud-Befehl ein:

gcloud composer environments describe ENVIRONMENT_NAME \
  --location LOCATION

Ersetzen Sie Folgendes:

• ENVIRONMENT_NAME: der Name Ihrer Umgebung
• LOCATION: Region, in der sich die Umgebung befindet.

Der gcloud-Befehl zeigt die Attribute einer Cloud Composer-Umgebung an, einschließlich der URLs für die Weboberfläche. Die URLs lauten aufgelistet als airflowUri und airflowByoidUri:

• Die URL-Adresse „airflowUri“ wird von Google-Konten verwendet.
• Die URL-Adresse airflowByoidUri wird von externen Identitäten verwendet, wenn Sie in Ihrem Projekt die Workforce Identity-Föderation konfigurieren.

config:
  airflowUri: https://example-dot-us-central1.composer.googleusercontent.com
  airflowByoidUri: https://example-dot-us-central1.composer.byoid.googleusercontent.com

Webserver neu starten

Vorschau — Web server restarting

Diese Funktion unterliegt den „Nutzungsbedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Nutzungsbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Funktionen sind „wie besehen“ verfügbar und werden möglicherweise nur eingeschränkt unterstützt. Weitere Informationen finden Sie in den Beschreibungen der Startphase.

Bei dem Debugging oder der Fehlerbehebung in Cloud Composer-Umgebungen können einige Probleme möglicherweise durch einen Neustart des Airflow-Webservers behoben werden. Sie können den Webserver mit der restartWebWeb API oder dem gcloud-Befehl restart-web-server neu starten:

gcloud beta composer environments restart-web-server ENVIRONMENT_NAME \
  --location=LOCATION

Netzwerkzugriff für Webserver konfigurieren

Die Zugriffsparameter des Airflow-Webservers hängen nicht vom Typ Ihres zu verbessern. Stattdessen konfigurieren Sie den Webserverzugriff separat. Beispiel: In einer privaten IP-Umgebung kann die Airflow-UI weiterhin über das Internet zugänglich sein.

Die zulässigen IP-Bereiche können nicht mithilfe privater IP-Adressen konfiguriert werden.

Hinweis: Der Airflow-Webserver Ihrer Umgebung wird immer durch IAM geschützt werden, unabhängig von den IP-Bereichen, darauf zugreifen dürfen.

Achtung :In einigen Fällen können Änderungen an den Zugriffsparametern für den Webserver bis zu 10 Minuten dauern.

Console

1. Rufen Sie in der Google Cloud Console die Seite Umgebungen auf.

   Zur Seite Umgebungen

2. Klicken Sie in der Liste der Umgebungen auf den Namen Ihrer Umgebung. Die Seite Umgebungsdetails wird geöffnet.

3. Rufen Sie den Tab Umgebungskonfiguration auf.

4. Suchen Sie im Abschnitt Netzwerkkonfiguration nach der Webserver-Zugriffssteuerung und klicken Sie auf Bearbeiten.

5. Gehen Sie im Dialogfeld Webserver-Netzwerkzugriffssteuerung so vor:

   • Wenn Sie von allen IP-Adressen aus Zugriff auf den Airflow-Webserver gewähren möchten, Wählen Sie Zugriff von allen IP-Adressen zulassen aus.

   • Wenn Sie den Zugriff auf bestimmte IP-Bereiche beschränken möchten, wählen Sie Zugriff nur von bestimmten IP-Adressen zulassen Geben Sie im Feld IP-Bereich einen IP-Bereich in der CIDR-Notation an. In Beschreibung eine optionale Beschreibung Bereich. Wenn Sie mehrere Bereiche angeben möchten, klicken Sie auf IP-Bereich hinzufügen.

   • Um den Zugriff für alle IP-Adressen zu verbieten, wählen Sie Zugriff nur zulassen von bestimmte IP-Adressen und klicken Sie neben dem leeren Feld auf Element löschen. Bereichseintrag.

gcloud

Beim Aktualisieren einer Umgebung steuern die folgenden Argumente die Parameter für den Webserverzugriff:

• --web-server-allow-all bietet Zugriff auf Airflow von allen IP-Adressen aus. Dies ist die Standardoption.

• --web-server-allow-ip beschränkt den Zugriff auf bestimmte Quell-IP-Bereiche. Wenn Sie mehrere IP-Bereiche angeben möchten, verwenden Sie dieses Argument mehrmals.

• --web-server-deny-all unterbindet den Zugriff für alle IP-Adressen.

Hinweis: Der Airflow-Webserver Ihrer Umgebung ist immer durch IAM geschützt, unabhängig von den IP-Bereichen, die auf ihn zugreifen dürfen.

gcloud composer environments update ENVIRONMENT_NAME \
    --location LOCATION \
    --web-server-allow-ip ip_range=WS_IP_RANGE,description=WS_RANGE_DESCRIPTION

Ersetzen Sie Folgendes:

• ENVIRONMENT_NAME: der Name Ihrer Umgebung
• LOCATION: die Region, in der sich die Umgebung befindet.
• WS_IP_RANGE: der IP-Bereich in CIDR-Notation, der auf den Airflow-UI
• WS_RANGE_DESCRIPTION: die Beschreibung des IP-Bereichs

Beispiel:

gcloud composer environments update example-environment \
    --location us-central1 \
    --web-server-allow-ip ip_range=192.0.2.0/24,description="office net 1" \
    --web-server-allow-ip ip_range=192.0.4.0/24,description="office net 3"

API

1. Erstellen Sie eine API-Anfrage [environments.patch][api-patch].

2. In dieser Anfrage:

   1. Geben Sie im updateMask-Parameter die config.webServerNetworkAccessControl-Maske an.

   2. Geben Sie im Anfragetext an, wie Airflow-Aufgabenprotokolle gespeichert werden müssen:

      • Wenn Sie Zugriff auf Airflow über alle IP-Adressen gewähren möchten, geben Sie ein leeres config-Element an. Das webServerNetworkAccessControl-Element darf nicht vorhanden sein.

      • Wenn Sie den Zugriff auf bestimmte IP-Bereiche beschränken möchten, geben Sie einen oder mehrere an Bereiche in allowedIpRanges.

      • Wenn der Zugriff für alle IP-Adressen verboten werden soll, geben Sie ein leeres webServerNetworkAccessControl-Element an. Das webServerNetworkAccessControl-Element muss vorhanden sein, darf aber kein allowedIpRanges-Element enthalten.

Hinweis: Der Airflow-Webserver Ihrer Umgebung ist immer durch IAM geschützt, unabhängig von den IP-Bereichen, die auf ihn zugreifen dürfen.

{
  "config": {
    "webServerNetworkAccessControl": {
      "allowedIpRanges": [
        {
          "value": "WS_IP_RANGE",
          "description": "WS_RANGE_DESCRIPTION"
        }
      ]
    }
  }
}

Ersetzen Sie Folgendes:

• WS_IP_RANGE: der IP-Bereich (in CIDR-Notation), der auf die Airflow-UI zugreifen darf.
• WS_RANGE_DESCRIPTION: die Beschreibung des IP-Bereichs

Beispiel:

// PATCH https://composer.googleapis.com/v1/projects/example-project/
// locations/us-central1/environments/example-environment?updateMask=
// config.webServerNetworkAccessControl

{
  "config": {
    "webServerNetworkAccessControl": {
      "allowedIpRanges": [
        {
          "value": "192.0.2.0/24",
          "description": "office net 1"
        },
        {
          "value": "192.0.4.0/24",
          "description": "office net 3"
        }
      ]
    }
  }
}

Terraform

Geben Sie im Block allowed_ip_range im Block web_server_network_access_control die IP-Bereiche an, die auf den Webserver zugreifen können.

Hinweis: Der Airflow-Webserver Ihrer Umgebung ist unabhängig von den IP-Bereichen, die auf ihn zugreifen dürfen, immer durch IAM geschützt.

resource "google_composer_environment" "example" {
  provider = google-beta
  name = "ENVIRONMENT_NAME"
  region = "LOCATION"

  config {

    web_server_network_access_control {

      allowed_ip_range {
        value = "WS_IP_RANGE"
        description = "WS_RANGE_DESCRIPTION"
      }

    }

  }
}

Ersetzen Sie:

• WS_IP_RANGE durch den IP-Bereich (in CIDR-Notation), der auf die Airflow-UI zugreifen darf.
• WS_RANGE_DESCRIPTION durch die Beschreibung des IP-Bereichs.

Beispiel:

resource "google_composer_environment" "example" {
  provider = google-beta
  name = "example-environment"
  region = "us-central1"

  config {

    web_server_network_access_control {
      allowed_ip_range {
        value = "192.0.2.0/24"
        description = "office net 1"
      },
      allowed_ip_range {
        value = "192.0.4.0/24"
        description = "office net 3"
      }

    }
}

Nächste Schritte

• Airflow-UI-Zugriffssteuerung
• Fehlerbehebung bei Airflow-Webserver-Problemen