启用和停用 Managed Airflow 服务

Managed Airflow（第 3 代） | Managed Airflow（第 2 代） | Managed Airflow（旧版第 1 代）

本页面介绍了如何在 Google Cloud 项目中启用和停用 Managed Service for Apache Airflow 服务。

如需了解 Google Cloud上的服务管理，请参阅启用和停用服务。

如需查看 VPC Service Controls 配置中 Managed Airflow 所需的服务列表，请参阅配置 VPC Service Controls。

启用 Managed Airflow 服务

本部分介绍如何在 Google Cloud 项目中启用 Managed Airflow 服务。

准备工作

启用 Cloud Composer API

控制台

启用 Cloud Composer API：

启用 API 所需的角色

如需启用 API，您需要拥有 Service Usage Admin IAM 角色 (roles/serviceusage.serviceUsageAdmin)，该角色包含 serviceusage.services.enable 权限。了解如何授予角色。

启用 API

gcloud

启用 composer.googleapis.com API：

启用 API 所需的角色

如需启用 API，您需要拥有 Service Usage Admin IAM 角色 (roles/serviceusage.serviceUsageAdmin)，该角色包含 serviceusage.services.enable 权限。了解如何授予角色。

gcloud services enable composer.googleapis.com

API

使用 services.enable 方法启用 composer.googleapis.com API。

Terraform

使用 google_project_service 资源配置 composer.googleapis.com API。

停用 Managed Airflow 服务

本部分介绍如何在 Google Cloud 项目中停用 Managed Airflow 服务。

准备工作

  • 如需停用 Managed Airflow 服务，您必须具有正确的 Identity and Access Management 权限。如需了解 Service Usage 的 IAM 要求，请参阅访问权限控制的 Service Usage 页面。

  • 确保项目中的所有 Managed Airflow 环境都已删除。停用 API 会永久删除 Managed Airflow 环境的租户项目部分，并且这些环境将变得不可用。

  • 为避免产生额外费用，请先针对每个环境完成以下步骤，然后再停用 Cloud Composer API：

    1. 暂停 DAG。
    2. 如果需要，从环境的存储桶导出环境的数据，例如 DAG。
    3. 删除您的环境，包括未自动删除的资源。

停用 Cloud Composer API

如需停用 Managed Airflow 服务，请执行以下操作：

控制台

  1. 在 Google Cloud 控制台中，前往 Cloud Composer API 页面。

    转到 Cloud Composer API

  2. 点击管理。

  3. 点击停用 API。

gcloud

运行 gcloud services disable 命令：

gcloud services disable composer.googleapis.com

API

使用 services.disable 方法停用 composer.googleapis.com API。

Terraform

移除 composer.googleapis.com API 的配置。您通常使用 google_project_service 资源配置 Google Cloud 服务。

Managed Service for Apache Airflow 所需的服务

本部分介绍了 Managed Airflow 所需的服务。在某些情况下，组织或项目管理员可以限制其项目中使用哪些 Google 服务。

Managed Airflow 需要以下服务：

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

  • container.googleapis.com

  • logging.googleapis.com

  • cloudkms.googleapis.com（如果您使用的是 Cloud KMS 或 CMEK 密钥）

  • monitoring.googleapis.com

  • pubsub.googleapis.com

  • storage.googleapis.com

  • secretmanager.googleapis.com（如果您使用 Secret Manager 作为 Secret 后端）

  • cloudresourcemanager.googleapis.com

  • servicedirectory.googleapis.com

默认情况下，大多数项目都已允许使用 Cloud DNS 或 IAM 等 Google 服务。

此外，还允许使用 DAG 所用的所有服务，例如：

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

您可以在 API 浏览器页面中链接的 API 页面中找到服务的 *.googleapis.com 名称。

即将弃用 Managed Airflow（第 3 代）不需要的服务

我们计划逐步淘汰 Managed Airflow（第 3 代）不需要的 API：

  • 自 2026 年 2 月 27 日起，以下 API 将完全可分离。停用这些 API 不会导致 Cloud Composer API 停用。

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

  • 自 2026 年 5 月 27 日起，当您启用 Cloud Composer API 时，这些 API 将不再自动启用。如需在新项目中创建 Managed Airflow (Gen 2) 环境，必须手动启用一组分离的 API。

如果项目已启用 Cloud Composer API，则该项目中的现有 Managed Airflow（第 3 代）和 Managed Airflow（第 2 代）环境不会受到影响。您可以执行以下操作：

  • 2026 年 2 月 27 日之后，如果您的项目仅包含 Managed Airflow（第 3 代）环境，则可以手动停用分离的 API。

  • 2026 年 2 月 27 日之后，如果您的项目有 Managed Airflow（第 2 代）环境，建议您保持这些 API 处于启用状态，因为停用它们可能会导致环境故障。

  • 2026 年 5 月 27 日之后，如果您使用自动化脚本来预配 Managed Airflow（第 2 代）环境，请确保除了 Cloud Composer API 之外，还启用了所列的 API。

后续步骤