Risoluzione dei problemi del server web di Airflow

Cloud Composer 1 | Cloud Composer 2

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

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

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

Sintomo: una volta configurati i controlli di accesso al server web, non è possibile accedere alla UI di Airflow. Di solito, il codice di errore visualizzato in questa situazione è 403.

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

I problemi di accesso all'interfaccia utente di Airflow di solito restituiscono l'errore 403. Per verificare se l'errore è correlato ai controlli di accesso di rete del server web, segui questi passaggi:

  1. Nell'elenco degli ambienti, fai clic sul nome dell'ambiente. Viene visualizzata la pagina Dettagli ambiente.
  2. Vai alla scheda Configurazione dell'ambiente.
  3. Controlla se l'elemento Controllo accesso server web è impostato su Tutti gli indirizzi IP hanno accesso (impostazione predefinita).
  4. Se viene configurato un valore diverso da Tutti gli indirizzi IP hanno accesso (predefinito), il controllo dell'accesso alla rete viene 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 di 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 effettivamente risolto per la connessione alla UI di Airflow. Per risolvere il problema:

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

  2. Vai alla scheda Configurazione dell'ambiente.

  3. Trova la voce Controllo accesso server web e fai clic su Modifica.

  4. Nella finestra di dialogo Controllo dell'accesso di rete al 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 si verificano problemi, vai al passaggio successivo.

    • Se si verifica un problema a questo punto, significa che potrebbe riguardare la configurazione delle autorizzazioni IAM. Per ulteriori informazioni sulle autorizzazioni IAM per Cloud Composer, consulta Controllo dell'accesso.

  6. Nella finestra di dialogo Controllo dell'accesso di rete al 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 connetti è un indirizzo IPv4.

    • Se a questo punto si verifica un problema, 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 connetti è un indirizzo IPv6.

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

  9. Ora hai stabilito 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 quelli 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 presupponi essere 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 relativa pagina. Puoi cercare questi servizi con la query di ricerca "Qual è il mio indirizzo IP".

Passaggi successivi