환경의 유지보수 기간 지정

이 페이지에서는 사용자 환경의 유지보수 기간을 정의하는 방법을 설명합니다.

Cloud Composer 환경은 다른 Google Cloud 서비스를 기반으로 구축됩니다. 이러한 서비스 중 일부는 유지보수 작업이 필요합니다. 예를 들어 기존 리소스 구성을 패치하는 경우가 있습니다. GKE 및 Cloud SQL 리소스에는 유지보수 작업이 필요한 경우가 많습니다.

유지보수 기간 사용 방법

유지보수 작업은 DAG 및 Airflow 태스크 실행에 영향을 줄 수 있으므로 다음을 수행하는 것이 좋습니다.

  1. Cloud Composer 환경의 유지보수 기간을 정의합니다.

  2. DAG에서 start_dateschedule_interval 매개변수를 사용하여 DAG가 지정된 유지보수 기간 외에 실행되도록 예약합니다.

신규 및 기존 Cloud Composer 환경의 유지보수 기간을 정의할 수 있습니다. 명시적 유지보수 기간을 지정하지 않으면 DAG 실행 일정을 고려하지 않고 유지보수 작업 시간이 자동으로 선택됩니다.

새 환경의 유지보수 기간 지정

Console

환경을 만들 때 유지보수 기간을 정의하려면 다음 안내를 따르세요.

  1. Google Cloud Console에서 환경 만들기 페이지로 이동합니다.

    환경 만들기로 이동

  2. 네트워킹, Airflow 구성 재정의, 추가 기능 섹션을 펼칩니다.

  3. 유지보수 기간 섹션에서 유지보수 기간 커스텀 시간 설정 체크박스를 선택합니다.

  4. 시작 시간, 시간대, , 길이를 설정하여 지정한 일정의 총 기간이 7일 순환 기간 동안 최소 12시간이 되도록 합니다. 예를 들어 매주 월요일, 수요일, 금요일마다 4시간이면 필요한 시간을 제공합니다.

  5. 다른 모든 단계를 완료하여 환경을 만듭니다.

gcloud

환경을 만들 때 다음 인수가 유지보수 기간 매개변수를 정의합니다.

  • --maintenance-window-start는 유지보수 기간의 시작 시간을 설정합니다.
  • --maintenance-window-end는 유지보수 기간의 종료 시간을 설정합니다.
  • --maintenance-window-recurrence유지보수 기간 반복을 설정합니다.
gcloud beta composer environments create ENVIRONMENT_NAME \
    --location LOCATION \
    --maintenance-window-start 'DATETIME_START' \
    --maintenance-window-end 'DATETIME_END' \
    --maintenance-window-recurrence 'MAINTENANCE_RECURRENCE'

다음과 같이 바꿉니다.

  • ENVIRONMENT_NAME: 환경 이름입니다.
  • DATETIME_START날짜/시간 입력 형식의 시작 날짜 및 시간으로 바꿉니다. 지정된 시간만 사용되며 지정된 날짜는 무시됩니다.
  • DATETIME_END날짜/시간 입력 형식의 종료 날짜 및 시간으로 바꿉니다. 지정된 시간만 사용되며 지정된 날짜는 무시됩니다. 지정된 날짜 및 시간은 시작 날짜 이후여야 합니다.
  • MAINTENANCE_RECURRENCE를 유지보수 기간 반복을 위한 RFC 5545 RRULE로 바꿉니다. Cloud Composer는 두 가지 형식을 지원합니다.

    • FREQ=DAILY 형식은 일일 반복을 지정합니다.
    • FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SA 형식은 선택한 요일의 반복을 지정합니다.

다음 예시는 일요일, 수요일, 토요일 01:00에서 07:00 (UTC) 사이의 6시간 유지보수 기간을 지정합니다. 2021년 1월 1일 날짜는 무시됩니다.

gcloud beta composer environments create example-environment \
  --location us-central1 \
  --maintenance-window-start '2021-01-01T01:00:00Z' \
  --maintenance-window-end '2021-01-01T07:00:00Z' \
  --maintenance-window-recurrence 'FREQ=WEEKLY;BYDAY=SU,WE,SA'

기존 환경의 유지보수 기간 지정

Console

기존 환경의 유지보수 기간을 정의하거나 변경하려면 환경을 업데이트합니다.

  1. Google Cloud Console에서 환경 페이지로 이동합니다.

환경으로 이동

  1. 세부정보를 보려면 환경을 선택하세요.

  2. 환경 구성 탭으로 이동합니다.

  3. 유지보수 기간 항목 옆에 있는 수정을 클릭합니다.

  4. 유지보수 기간 대화상자에서 유지보수 기간 커스텀 시간 설정 체크박스를 선택합니다.

  5. 시작 시간, 시간대, , 길이를 설정하여 지정한 일정의 총 기간이 7일 순환 기간 동안 최소 12시간이 되도록 합니다. 예를 들어 매주 월요일, 수요일, 금요일마다 4시간이면 필요한 시간을 제공합니다.

  6. 저장을 클릭하고 환경이 업데이트될 때까지 기다립니다.

gcloud

환경을 업데이트할 때 다음 인수는 유지보수 기간 매개변수를 정의합니다.

  • --maintenance-window-start는 유지보수 기간의 시작 시간을 설정합니다.
  • --maintenance-window-end는 유지보수 기간의 종료 시간을 설정합니다.
  • --maintenance-window-recurrence유지보수 기간 반복을 설정합니다.
gcloud beta composer environments update ENVIRONMENT_NAME \
    --location LOCATION \
    --maintenance-window-start 'DATETIME_START' \
    --maintenance-window-end 'DATETIME_END' \
    --maintenance-window-recurrence 'MAINTENANCE_RECURRENCE'

다음과 같이 바꿉니다.

  • ENVIRONMENT_NAME: 환경 이름입니다.
  • DATETIME_START날짜/시간 입력 형식의 시작 날짜 및 시간으로 바꿉니다. 지정된 시간만 사용되며 지정된 날짜는 무시됩니다.
  • DATETIME_END날짜/시간 입력 형식의 종료 날짜 및 시간으로 바꿉니다. 지정된 시간만 사용되며 지정된 날짜는 무시됩니다. 지정된 날짜 및 시간은 시작 날짜 이후여야 합니다.
  • MAINTENANCE_RECURRENCE를 유지보수 기간 반복을 위한 RFC 5545 RRULE로 바꿉니다. Cloud Composer는 두 가지 형식을 지원합니다.

    • FREQ=DAILY 형식은 일일 반복을 지정합니다.
    • FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SA 형식은 선택한 요일의 반복을 지정합니다.

다음 예시는 일요일, 수요일, 토요일 01:00에서 07:00 (UTC) 사이의 6시간 유지보수 기간을 지정합니다. 2021년 1월 1일 날짜는 무시됩니다.

gcloud beta composer environments update example-environment \
  --location us-central1 \
  --maintenance-window-start '2021-01-01T01:00:00Z' \
  --maintenance-window-end '2021-01-01T07:00:00Z' \
  --maintenance-window-recurrence 'FREQ=WEEKLY;BYDAY=SU,WE,SA'

다음 단계