Risoluzione dei problemi relativi agli upgrade e agli aggiornamenti degli ambienti

Cloud Composer 1 | Cloud Composer 2 | Cloud Composer 3

Questa pagina fornisce informazioni per la risoluzione dei problemi che potresti riscontrare durante l'aggiornamento o l'upgrade degli ambienti Cloud Composer.

Per informazioni sulla risoluzione dei problemi relativi alla creazione di ambienti, consulta Risolvere i problemi di creazione dell'ambiente.

Quando gli ambienti Cloud Composer vengono aggiornati, la maggior parte dei problemi perché si verificano per i seguenti motivi:

  • Problemi relativi alle autorizzazioni dell'account di servizio
  • Problemi di dipendenza PyPI
  • Dimensione del database Airflow

Autorizzazioni insufficienti per l'aggiornamento o l'upgrade di un ambiente

Se Cloud Composer non riesce ad aggiornare o eseguire l'upgrade di un ambiente a causa di autorizzazioni insufficienti, viene visualizzato il seguente messaggio di errore:

ERROR: (gcloud.composer.environments.update) PERMISSION_DENIED: The caller does not have permission

Soluzione: assegna i ruoli sia al tuo account sia all'account di servizio del tuo ambiente come descritto in Controllo dell'accesso.

L'account di servizio dell'ambiente non dispone di autorizzazioni sufficienti

Quando crei un ambiente Cloud Composer, specifichi un servizio che esegue i nodi del cluster GKE dell'ambiente. Se questo l'account di servizio non dispone di autorizzazioni sufficienti per l'operazione richiesta Cloud Composer restituisce un errore:

    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
    }
    ].

Soluzione: assegna i ruoli sia al tuo account sia all'account di servizio del tuo ambiente come descritto in Controllo dell'accesso.

La dimensione del database Airflow è troppo grande per eseguire l'operazione

Un'operazione di upgrade di Cloud Composer potrebbe non riuscire perché le dimensioni del database Airflow sono troppo grandi per consentire il completamento delle operazioni di upgrade.

Se la dimensione del database Airflow è superiore a 16 GB, Cloud Composer restituisce il seguente errore:

Airflow database uses more than 16 GB. Please clean the database before upgrading.

Soluzione: esegui la pulizia del database Airflow, come descritto in Manutenzione del database Airflow.

L'upgrade a una nuova versione di Cloud Composer non va a buon fine a causa di conflitti tra i pacchetti PyPI

Quando esegui l'upgrade di un ambiente con pacchetti PyPI personalizzati installati, potresti riscontrare errori relativi a conflitti dei pacchetti PyPI. Questo potrebbe accadere perché la nuova immagine Cloud Composer contiene versioni più recenti dei pacchetti preinstallati che causano conflitti di dipendenza con i pacchetti PyPI installati nel tuo ambiente.

Soluzione:

  • Per ottenere informazioni dettagliate sui conflitti di pacchetto, esegui un controllo degli upgrade.
  • Allenta i vincoli di versione per i pacchetti PyPI personalizzati installati. Ad esempio, invece di specificare una versione come ==1.0.1, specificala come >=1.0.1.
  • Per ulteriori informazioni sulla modifica dei requisiti delle versioni per risolvere le dipendenze in conflitto, consulta la documentazione di pip.

Non è possibile eseguire l'upgrade di un ambiente a una versione ancora supportata

È possibile eseguire l'upgrade degli ambienti Cloud Composer solo a diverse versioni recenti e precedenti.

Le limitazioni della versione per la creazione di nuovi ambienti e l'upgrade di quelli esistenti ambienti sono diversi. La versione di Cloud Composer che scegli quando crei un nuovo ambiente potrebbe non essere disponibile durante l'upgrade degli ambienti esistenti.

Puoi eseguire l'operazione di upgrade utilizzando Google Cloud CLI, l'API o Terraform. Nella console Google Cloud, come opzioni di upgrade sono disponibili solo le versioni più recenti.

La mancanza di connettività al DNS può causare problemi durante l'esecuzione di upgrade o aggiornamenti

Questi problemi di connettività potrebbero comportare voci di log come questa:

WARNING - Compute Engine Metadata server unavailable attempt 1 of 5. Reason: [Errno -3] Temporary failure in name resolution Error

Di solito significa che non esiste una route per il DNS, quindi assicurati che il nome DNS metadata.google.internal possa essere risolto in indirizzo IP dalle reti di cluster, pod e servizi. Verifica di aver attivato l'accesso privato Google all'interno del VPC (nel progetto host o di servizio) in cui è stato creato il tuo ambiente.

Ulteriori informazioni:

Passaggi successivi