Airflow gerenciado (Geração 3) | Airflow gerenciado (Geração 2) | Airflow gerenciado (Geração 1 legada)
Nesta página, explicamos como ativar e desativar o Serviço gerenciado para Apache Airflow no seu projeto Google Cloud .
Para informações sobre o gerenciamento de serviços no Google Cloud, consulte Como ativar e desativar serviços.
Para conferir uma lista dos serviços exigidos pelo Airflow Gerenciado em configurações do VPC Service Controls, consulte Configurar o VPC Service Controls.
Ativar o serviço do Airflow Gerenciado
Nesta seção, descrevemos como ativar o serviço Airflow Gerenciado no seu projeto Google Cloud .
Antes de começar
Para ativar o serviço Airflow Gerenciado, você precisa ter as permissões de Identity and Access Management corretas. Para saber mais sobre os requisitos do IAM para o Service Usage, consulte a página "Service Usage" para Controle de acesso.
Verifique se o faturamento está ativado no projeto.
Ativar a API Cloud Composer
Console
Ative a API Composer:
Funções necessárias para ativar APIs
Para ativar as APIs, é necessário ter o papel do IAM de administrador de uso do serviço (roles/serviceusage.serviceUsageAdmin), que contém a permissão serviceusage.services.enable. Saiba como conceder
papéis.
gcloud
Ative a composer.googleapis.com API:
Funções necessárias para ativar APIs
Para ativar as APIs, é necessário ter o papel do IAM de administrador de uso do serviço (roles/serviceusage.serviceUsageAdmin), que contém a permissão serviceusage.services.enable. Saiba como conceder
papéis.
gcloud services enable composer.googleapis.com
API
Use o método services.enable para ativar a API composer.googleapis.com.
Terraform
Use o recurso google_project_service
para configurar a API composer.googleapis.com.
Desativar o serviço do Airflow gerenciado
Nesta seção, descrevemos como desativar o serviço Airflow Gerenciado no seu projeto Google Cloud .
Antes de começar
Para desativar o serviço Airflow Gerenciado, você precisa ter as permissões de Identity and Access Management corretas. Para saber mais sobre os requisitos do IAM para o Service Usage, consulte a página do Service Usage para Controle de acesso.
Verifique se todos os ambientes do Airflow gerenciado no seu projeto foram excluídos. Desativar a API exclui de forma irreversível as partes do projeto de locatário de ambientes do Airflow gerenciado, e esses ambientes se tornam inutilizáveis.
Para evitar cobranças extras, conclua os passos a seguir para cada ambiente antes de desativar a API Cloud Composer:
- Pause os DAGs.
- Se necessário, exporte os dados do ambiente, como DAGs do bucket dele.
- Exclua seu ambiente, incluindo os recursos que não são excluídos automaticamente.
Desativar a API Cloud Composer
Para desativar o serviço Airflow Gerenciado:
Console
No console do Google Cloud , acesse a página da API Composer.
Clique em Gerenciar.
Clique em Desativar API.
gcloud
Execute o comando gcloud services disable:
gcloud services disable composer.googleapis.com
API
Use o método services.disable para desativar
a API composer.googleapis.com.
Terraform
Remova a configuração da API composer.googleapis.com. Normalmente,
o recurso google_project_service
é usado para configurar serviços Google Cloud .
Serviços exigidos pelo Serviço gerenciado para Apache Airflow
Esta seção descreve os serviços necessários para o Airflow Gerenciado. Em alguns casos, os administradores da organização ou do projeto podem restringir quais serviços do Google podem ser usados nos projetos.
Os seguintes serviços são necessários para o Airflow Gerenciado:
- artifactregistry.googleapis.com
- cloudbuild.googleapis.com
- composer.googleapis.com
- compute.googleapis.com
container.googleapis.com
(Somente nas versões 2.0.* do Airflow Gerenciado) deploymentmanager.googleapis.com
logging.googleapis.com
cloudkms.googleapis.com, se você estiver usando chaves do Cloud KMS ou da CMEK
monitoring.googleapis.com
pubsub.googleapis.com
storage.googleapis.com
secretmanager.googleapis.com, se você estiver usando o Secret Manager como um back-end de secrets
cloudresourcemanager.googleapis.com
servicedirectory.googleapis.com
Os serviços do Google, como o Cloud DNS ou o IAM, já são permitidos por padrão na maioria dos projetos.
Além disso, permita o uso de todos os serviços usados pelos seus DAGs, por exemplo:
- bigquery.googleapis.com
- dataflow.googleapis.com
- datacatalog.googleapis.com
Você pode encontrar os nomes *.googleapis.com dos serviços nas páginas de API vinculadas à página do API Explorer.
Suspensão de uso de serviços que não são necessários para o Airflow gerenciado (Geração 3)
Estamos planejando desativar gradualmente as APIs que não são necessárias para o Airflow gerenciado (Geração 3):
A partir de 27 de fevereiro de 2026, as seguintes APIs vão se tornar totalmente separáveis. A desativação dessas APIs não causa a desativação da API Composer.
- artifactregistry.googleapis.com
- cloudbuild.googleapis.com
- container.googleapis.com
- pubsub.googleapis.com
- sqladmin.googleapis.com
A partir de 27 de maio de 2026, essas APIs não serão mais ativadas automaticamente quando você ativar a API Cloud Composer. Para criar ambientes do Airflow gerenciado (Geração 2) em novos projetos, o grupo de APIs separadas precisa ser ativado manualmente.
Os ambientes do Airflow Gerenciado (Geração 3) e do Airflow Gerenciado (Geração 2) em projetos em que a API Composer já está ativada não serão afetados. Você pode fazer o seguinte:
Depois de 27 de fevereiro de 2026, se o projeto tiver apenas ambientes do Airflow Gerenciado (Geração 3), será possível desativar manualmente as APIs separadas.
Depois de 27 de fevereiro de 2026, se o projeto tiver ambientes do Airflow Gerenciado (Geração 2), recomendamos manter essas APIs ativadas, porque a desativação pode causar mau funcionamento do ambiente.
Depois de 27 de maio de 2026, se você usar scripts de automação para provisionar ambientes do Airflow Gerenciado (Geração 2), verifique se as APIs listadas estão ativadas, além da API Cloud Composer.