관리형 Airflow 서비스 사용 설정 및 사용 중지

Managed Airflow (3세대) | Managed Airflow (2세대) | Managed Airflow (기존 1세대)

이 페이지에서는프로젝트에서 Managed Service for Apache Airflow 서비스를 사용 설정하고 중지하는 방법을 설명합니다. Google Cloud

의 서비스 관리에 대한 자세한 내용은 Google Cloud 서비스 사용 설정 및 중지를 참조하세요.

VPC 서비스 제어 구성에서 Managed Airflow에 필요한 서비스 목록은 VPC 서비스 제어 구성을 참조하세요.

Managed Airflow 서비스 사용 설정

이 섹션에서는 프로젝트에서 Managed Airflow 서비스를 사용 설정하는 방법을 설명합니다. Google Cloud

시작하기 전에

Cloud Composer API 사용 설정

콘솔

Cloud Composer API를 사용 설정합니다.

API 사용 설정에 필요한 역할

API를 사용 설정하려면 serviceusage.services.enable 권한이 포함된 서비스 사용량 관리자 IAM 역할(roles/serviceusage.serviceUsageAdmin)이 필요합니다. 역할 부여 방법 알아보기

API 사용 설정하기

gcloud

composer.googleapis.com API를 사용 설정합니다.

API 사용 설정에 필요한 역할

API를 사용 설정하려면 역할 (roles/serviceusage.serviceUsageAdmin)이 포함된 서비스 사용량 관리자 IAM 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 (2세대) 종속 항목 사용 설정

Managed Airflow (2세대)에 필요한 모든 종속 항목을 사용 설정하려면 다음 Google Cloud CLI 명령어를 사용하여 services/composer.googleapis.com/groups/dependencies@composer2 서비스 그룹을 사용 설정하면 됩니다.

gcloud

gcloud beta services enable 명령어를 실행합니다.

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

또는 콘솔 또는 Terraform을 통해 Managed Airflow (2세대)에 필요한 추가 종속 항목을 수동으로 사용 설정할 수 있습니다. Google Cloud

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

Managed Airflow 서비스 사용 중지

이 섹션에서는 프로젝트에서 Managed Airflow 서비스를 사용 중지하는 방법을 설명합니다. Google Cloud

시작하기 전에

  • Managed Airflow 서비스를 사용 중지하려면 올바른 Identity and Access Management 권한이 있어야 합니다. 서비스 사용량에 대한 IAM 요구사항에 대해 알아보려면 액세스 제어의 서비스 사용량 페이지를 참조하세요.

  • 프로젝트의 모든 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

  • 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를 보안 비밀 백엔드로 사용하는 경우

  • cloudresourcemanager.googleapis.com

  • servicedirectory.googleapis.com

Cloud DNS 또는 IAM과 같은 Google 서비스는 기본적으로 대부분의 프로젝트에서 이미 허용됩니다.

또한 DAG에서 사용 중인 모든 서비스 사용을 허용합니다. 예를 들면 다음과 같습니다.

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

서비스의 *.googleapis.com 이름은 API 페이지 에서 확인할 수 있습니다. 이 페이지는 API 탐색기 페이지에서 연결됩니다.

Managed Airflow (3세대)에 필요하지 않은 서비스의 지원 중단 예정사항

Managed Airflow (3세대)에 필요하지 않은 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가 사용 설정되어 있는지 확인합니다. 수동으로 사용 설정하거나 Google Cloud CLI 명령어를 사용하여 Managed Airflow (2세대) 종속 항목이 있는 서비스 그룹을 사용 설정하여 사용 설정할 수 있습니다.

다음 단계