Risoluzione dei problemi del server web di Airflow

Cloud Composer 1 | Cloud Composer 2 | Cloud Composer 3

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 dei DAG e delle attività di Airflow. Questa pagina descrive i passaggi per la risoluzione dei problemi relativi a vari problemi di accesso al server web 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 di accesso alla rete sono abilitati

Sintomo: dopo aver configurato 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 ai server web, che consentono di specificare gli intervalli IP autorizzati a connettersi al server web.

I problemi di accesso alla UI di Airflow di solito generano l'errore 403. Per verificare se l'errore riguarda i controlli di accesso alla rete del server web, procedi nel seguente modo:

  1. Nell'elenco degli ambienti, fai clic sul nome dell'ambiente. Si apre la pagina Dettagli ambiente.
  2. Vai alla scheda Configurazione dell'ambiente.
  3. Controlla se la voce Controllo accesso server web è impostata su Tutti gli indirizzi IP hanno accesso (impostazione predefinita).
  4. Se viene configurato un valore diverso da Tutti gli indirizzi IP hanno accesso (impostazione predefinita), 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 riguardare i controlli dell'accesso alla rete del server web.

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

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

  2. Vai alla scheda Configurazione dell'ambiente.

  3. Individua la voce Controllo accesso 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 all'interfaccia utente di Airflow e verifica che funzioni senza problemi:

    • Se non riscontri problemi, vai al passaggio successivo.

    • Se a questo punto riscontri un problema, 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 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 quelli più specifici per verificare l'intervallo più ampio quando l'accesso smetterà di funzionare:

    • Puoi iniziare con la subnet mask larga (come 192.0.2.0/8), che include l'indirizzo che consideri il tuo indirizzo IP.

    • Per determinare il tuo indirizzo IP, puoi utilizzare un servizio di terze parti che fornisca il tuo indirizzo IP esterno quando visiti la relativa pagina. Puoi cercarli utilizzando la query di ricerca "qual è il mio indirizzo IP").

Passaggi successivi