启用和停用 Managed Airflow 服务

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

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

如需了解上 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

  • （仅在 Managed Airflow 2.0.* 版本中）deploymentmanager.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 页面中找到服务的 *.googleapis.com 名称 ，这些页面链接自 API 探索器页面。

即将废弃 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（第 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 ，因为停用这些 API 可能会导致环境出现故障。

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

后续步骤