Airflow gerenciado (Geração 3) | Airflow gerenciado (Geração 2) | Airflow gerenciado (Geração 1 legada)
Esta página explica como ativar e desativar o serviço do Serviço Gerenciado para Apache Airflow no seu Google Cloud projeto.
Para informações sobre o gerenciamento de serviços no Google Cloud, consulte Como ativar e desativar serviços.
Para uma lista de serviços exigidos pelo Airflow gerenciado nas configurações do VPC Service Controls, consulte Configurar o VPC Service Controls.
Ativar o serviço do Airflow gerenciado
Esta seção descreve como ativar o serviço do Airflow gerenciado no seu Google Cloud projeto.
Antes de começar
Para ativar o serviço do 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 Composer
Console
Ative a API Cloud 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 API composer.googleapis.com:
Funções necessárias para ativar APIs
Para ativar as APIs, é necessário ter o papel do IAM de administrador de Service Usage
role (roles/serviceusage.serviceUsageAdmin), que contém a
serviceusage.services.enable permissão. 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 google_project_service
recurso para configurar a API composer.googleapis.com.
Desativar o serviço do Airflow gerenciado
Esta seção descreve como desativar o serviço do Airflow gerenciado no seu Google Cloud projeto.
Antes de começar
Para desativar o serviço do 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 todos os ambientes do Airflow gerenciado no 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 as etapas a seguir para cada ambiente antes de desativar a API do Airflow gerenciado:
- Pause os DAGs.
- Se necessário, exporte os dados do ambiente, como DAGs do bucket do ambiente.
- Exclua o ambiente, incluindo os recursos que não são excluídos automaticamente.
Desativar a API do Airflow gerenciado
Para desativar o serviço do Airflow gerenciado:
Console
No Google Cloud console, acesse a página API do Airflow gerenciado.
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, você
usa o google_project_service
recurso para configurar Google Cloud serviços.
Serviço Gerenciado para Apache Airflow: serviços exigidos
Esta seção descreve os serviços exigidos pelo 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 exigidos pelo Airflow gerenciado:
- artifactregistry.googleapis.com
- cloudbuild.googleapis.com
- composer.googleapis.com
- compute.googleapis.com
container.googleapis.com
deploymentmanager.googleapis.com
logging.googleapis.com
cloudkms.googleapis.com, se você estiver usando chaves do Cloud KMS ou CMEK
monitoring.googleapis.com
pubsub.googleapis.com
storage.googleapis.com
secretmanager.googleapis.com, se você estiver usando o Secret Manager como um back-end secreto
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 que seus DAGs estão usando, por exemplo:
- bigquery.googleapis.com
- dataflow.googleapis.com
- datacatalog.googleapis.com
É possível encontrar os nomes *.googleapis.com dos serviços nas páginas da API vinculadas à página do API Explorer.
Próxima descontinuação de serviços que não são exigidos pelo Airflow gerenciado (Geração 3)
Planejamos descontinuar as APIs que não são exigidas pelo Airflow gerenciado (Geração 3):
A partir de 27 de fevereiro de 2026, as APIs a seguir serão totalmente separáveis. A desativação dessas APIs não causará 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 Cloud Composer já está ativada não serão afetados. Você pode fazer o seguinte:
Após 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.
Após 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 delas pode levar ao mau funcionamento do ambiente.
Após 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.