Abilitare e disabilitare il servizio Managed Airflow

Managed Airflow (Gen 3) | Managed Airflow (Gen 2) | Managed Airflow (Legacy Gen 1)

Questa pagina spiega come attivare e disattivare il servizio Managed Service for Apache Airflow nel tuo progetto Google Cloud .

Per informazioni sulla gestione dei servizi su Google Cloud, vedi Abilitazione e disabilitazione dei servizi.

Per un elenco dei servizi richiesti da Managed Airflow nelle configurazioni dei Controlli di servizio VPC, consulta Configura i Controlli di servizio VPC.

Abilita il servizio Managed Airflow

Questa sezione descrive come attivare il servizio Managed Airflow nel tuo progetto Google Cloud .

Prima di iniziare

Abilita l'API Cloud Composer

Console

Abilita l'API Cloud Composer:

Ruoli richiesti per abilitare le API

Per abilitare le API, devi disporre del ruolo IAM Amministratore utilizzo dei servizi (roles/serviceusage.serviceUsageAdmin), che include l'autorizzazione serviceusage.services.enable. Scopri come concedere i ruoli.

Abilitare l'API

gcloud

Abilita l'API composer.googleapis.com:

Ruoli richiesti per abilitare le API

Per abilitare le API, devi disporre del ruolo IAM Amministratore utilizzo dei servizi (roles/serviceusage.serviceUsageAdmin), che include l'autorizzazione serviceusage.services.enable. Scopri come concedere i ruoli.

gcloud services enable composer.googleapis.com

API

Utilizza il metodo services.enable per abilitare l'API composer.googleapis.com.

Terraform

Utilizza la risorsa google_project_service per configurare l'API composer.googleapis.com.

Abilita le dipendenze di Managed Airflow (Gen 2)

Per abilitare tutte le dipendenze richieste da Managed Airflow (Gen 2), puoi abilitare il gruppo di servizi services/composer.googleapis.com/groups/dependencies@composer2 con il seguente comando Google Cloud CLI:

gcloud

Esegui il comando gcloud beta services enable:

gcloud beta services enable composer.googleapis.com \
    --group dependencies@composer2

In alternativa, puoi attivare manualmente le dipendenze aggiuntive richieste da Managed Airflow (Gen 2), ad esempio tramite la console Google Cloud o Terraform:

  • artifactregistry.googleapis.com
  • cloudbuild.googleapis.com
  • container.googleapis.com
  • pubsub.googleapis.com
  • sqladmin.googleapis.com

Disabilita il servizio Managed Airflow

Questa sezione descrive come disattivare il servizio Managed Airflow nel tuo progetto Google Cloud .

Prima di iniziare

  • Per disattivare il servizio Managed Airflow, devi disporre delle autorizzazioni Identity and Access Management corrette. Per scoprire di più sui requisiti IAM per Service Usage, consulta la pagina Service Usage per il controllo dell'accesso.

  • Assicurati che tutti gli ambienti Managed Airflow nel tuo progetto siano eliminati. Se disabiliti l'API, le parti del progetto tenant degli ambienti Managed Airflow vengono eliminate in modo irreversibile e questi ambienti diventano inutilizzabili.

  • Per evitare addebiti aggiuntivi, completa i seguenti passaggi per ogni ambiente prima di disattivare l'API Cloud Composer:

    1. Metti in pausa i DAG.
    2. Se necessario, esporta i dati dell'ambiente, ad esempio i DAG dal bucket dell'ambiente.
    3. Elimina l'ambiente, incluse le risorse che non vengono eliminate automaticamente.

Disabilita l'API Cloud Composer

Per disattivare il servizio Managed Airflow:

Console

  1. Nella console Google Cloud , vai alla pagina API Cloud Composer.

    Vai all'API Cloud Composer

  2. Fai clic su Gestisci.

  3. Fai clic su Disabilita API.

gcloud

Esegui il comando gcloud services disable:

gcloud services disable composer.googleapis.com

API

Utilizza il metodo services.disable per disattivare l'API composer.googleapis.com.

Terraform

Rimuovi la configurazione per l'API composer.googleapis.com. In genere, per configurare i servizi Google Cloud , utilizzi la risorsa google_project_service.

Servizi richiesti da Managed Service for Apache Airflow

Questa sezione descrive i servizi richiesti da Managed Airflow. In alcuni casi, gli amministratori dell'organizzazione o del progetto possono limitare i servizi Google utilizzabili nei loro progetti.

I seguenti servizi sono richiesti da Managed Airflow:

  • artifactregistry.googleapis.com
  • cloudbuild.googleapis.com
  • composer.googleapis.com
  • compute.googleapis.com
  • container.googleapis.com

  • logging.googleapis.com

  • cloudkms.googleapis.com, se utilizzi chiavi Cloud KMS o CMEK

  • monitoring.googleapis.com

  • pubsub.googleapis.com

  • storage.googleapis.com

  • secretmanager.googleapis.com, se utilizzi Secret Manager come backend dei secret

  • cloudresourcemanager.googleapis.com

  • servicedirectory.googleapis.com

I servizi Google come Cloud DNS o IAM sono già consentiti per impostazione predefinita nella maggior parte dei progetti.

Inoltre, consenti l'utilizzo di tutti i servizi utilizzati dai tuoi DAG, ad esempio:

  • bigquery.googleapis.com
  • dataflow.googleapis.com
  • datacatalog.googleapis.com

Puoi trovare i nomi *.googleapis.com dei servizi nelle pagine API collegate dalla pagina Explorer API.

Ritiro imminente dei servizi non richiesti da Managed Airflow (Gen 3)

Stiamo pianificando il ritiro delle API non richieste da Managed Airflow (Gen 3):

  • A partire dal 27 febbraio 2026, le seguenti API diventeranno completamente rimovibili. La disattivazione di queste API non comporta la disattivazione dell'API Cloud Composer.

    • artifactregistry.googleapis.com
    • cloudbuild.googleapis.com
    • container.googleapis.com
    • pubsub.googleapis.com
    • sqladmin.googleapis.com
  • A partire dal 27 maggio 2026, queste API non verranno più abilitate automaticamente quando abiliti l'API Cloud Composer. Per creare ambienti Managed Airflow (Gen 2) in nuovi progetti, il gruppo di API separate deve essere abilitato oltre all'API Cloud Composer.

Gli ambienti Managed Airflow (Gen 3) e Managed Airflow (Gen 2) esistenti nei progetti in cui l'API Cloud Composer è già abilitata non saranno interessati. Puoi fare quanto segue:

  • Dopo il 27 febbraio 2026, se il tuo progetto ha solo ambienti Managed Airflow (Gen 3), puoi disattivare manualmente le API separate.

  • Dopo il 27 febbraio 2026, se il tuo progetto ha ambienti Managed Airflow (Gen 2), ti consigliamo di mantenere attive queste API perché la loro disattivazione potrebbe causare il malfunzionamento dell'ambiente.

  • Dopo il 27 maggio 2026, se utilizzi script di automazione per il provisioning di ambienti Managed Airflow (Gen 2), assicurati che le API elencate siano abilitate oltre all'API Cloud Composer. Puoi abilitarli manualmente o abilitando il gruppo di servizi con le dipendenze di Managed Airflow (Gen 2) utilizzando un comando Google Cloud CLI.

Passaggi successivi