Risoluzione dei problemi del server web Airflow

Managed Airflow (terza generazione) | Managed Airflow (seconda generazione) | Managed Airflow (prima generazione legacy)

Questa pagina fornisce passaggi e informazioni per la risoluzione dei problemi comuni del server web di Airflow.

Il server web di Airflow è un componente di Airflow che fornisce un'interfaccia utente per la gestione di DAG e attività di Airflow. Questa pagina descrive i passaggi per la risoluzione dei problemi relativi all'accesso al server web di Airflow del tuo ambiente o per gli avvisi relativi al server web visibili nei log di Airflow.

Impossibile accedere alla UI di Airflow quando i controlli dell'accesso alla rete sono abilitati

Sintomo: dopo aver configurato i controlli dell'accesso al server web, non è possibile accedere alla UI di Airflow. In genere, il codice di errore visualizzato in questa situazione è 403.

Informazioni sul problema: Managed Airflow supporta i controlli dell'accesso alla rete del server web, che consentono di specificare gli intervalli IP autorizzati a connettersi al server web.

I problemi di accesso alla UI di Airflow in genere generano l'errore 403. Per verificare se l'errore è correlato ai controlli dell'accesso alla rete del server web:

  1. Nell'elenco degli ambienti, fai clic sul nome del tuo ambiente. Viene visualizzata la pagina Dettagli ambiente.
  2. Vai alla scheda Configurazione ambiente.
  3. Verifica se l'elemento Controllo dell'accesso al server web è impostato su Tutti gli indirizzi IP hanno accesso (impostazione predefinita).
  4. Se è configurato un valore diverso da Tutti gli indirizzi IP hanno accesso (impostazione predefinita), il controllo dell'accesso alla rete è abilitato e la visibilità della UI di Airflow è limitata agli intervalli di indirizzi IPv4 e IPv6 forniti. In questo caso, il problema potrebbe essere correlato ai controlli dell'accesso alla rete del server web.

Nella maggior parte dei casi, la causa del problema è la mancata corrispondenza tra l'IP previsto che hai specificato e l'IP a cui viene effettivamente risolto per connettersi alla UI di Airflow. Per risolvere il problema:

  1. Nell'elenco degli ambienti, fai clic sul nome del tuo ambiente. Viene visualizzata la pagina Dettagli ambiente.

  2. Vai alla scheda Configurazione ambiente.

  3. Trova l'elemento Controllo dell'accesso al server web e fai clic su Modifica.

  4. Nella finestra di dialogo Controllo dell'accesso alla rete del server web, seleziona Consenti l'accesso da tutti gli indirizzi IP.

  5. Accedi più volte alla UI di Airflow e verifica che funzioni senza problemi:

    • Se non riscontri problemi, continua con il passaggio successivo.

    • Se riscontri un problema a questo punto, significa che potrebbe essere correlato alla configurazione delle autorizzazioni IAM. Per saperne di più sulle autorizzazioni IAM per Managed Airflow, consulta Controllo dell'accesso.

  6. Nella finestra di dialogo Controllo dell'accesso alla rete del server web, seleziona Consenti l'accesso solo da indirizzi IP specifici.

  7. Aggiungi l'intervallo IP 0.0.0.0/0, quindi accedi più volte alla UI di Airflow e verifica che funzioni senza problemi:

    • Se non riscontri problemi, l'IP con cui ti stai connettendo è un indirizzo IPv4.

    • Se riscontri un problema a questo punto, significa che l'IP con cui ti stai connettendo è un indirizzo IPv6.

  8. Elimina l'intervallo IP 0.0.0.0/0 e aggiungi l'intervallo IP ::/0.

    • Se non riscontri problemi, l'IP con cui ti stai connettendo è un indirizzo IPv6.

    • Se riscontri un problema a questo punto, significa che l'IP con cui ti stai connettendo è un indirizzo IPv4.

  9. Ora hai determinato se l'indirizzo risolto è IPv4 o IPv6.

  10. A seconda del tipo di indirizzo, restringi gli intervalli ::/0 o 0.0.0.0/0 a intervalli più specifici, per verificare l'intervallo più ampio quando l'accesso smette di funzionare:

    • Puoi iniziare con la subnet mask ampia (ad esempio 192.0.2.0/8) che include l'indirizzo che ritieni sia il tuo indirizzo IP.

    • Per determinare il tuo indirizzo IP, puoi utilizzare un servizio di terze parti che fornisce il tuo indirizzo IP esterno quando visiti la sua pagina. Puoi cercare questi servizi utilizzando la query di ricerca "qual è il mio indirizzo IP".

I valori di configurazione non vengono visualizzati nella pagina di configurazione

Alcuni parametri di configurazione di Airflow sono nascosti nella pagina di configurazione per impedire l'accesso a informazioni potenzialmente sensibili. Ad esempio, le credenziali per accedere al database di Airflow non vengono visualizzate.

Per visualizzare i campi nascosti, esegui l'override della seguente opzione di configurazione di Airflow. Ti consigliamo di ripristinare le modifiche dopo aver ottenuto i valori richiesti.

Sezione Chiave Valore Note
webserver expose_config True Il valore predefinito è non-sensitive-only. Imposta su False per nascondere tutti i parametri di configurazione.

Il DAG arresta il server web di Airflow o fa sì che restituisca un errore "502 gateway timeout"

Gli errori del server web possono verificarsi per diversi motivi. Controlla i log airflow-webserver in Cloud Logging per determinare la causa dell' 502 gateway timeout errore.

Passaggi successivi