이 페이지에서는 Cloud Data Fusion 인스턴스의 유지보수 기간을 정의하는 방법을 설명합니다.
유지보수 기간은 Cloud Data Fusion 인스턴스 버전 6.8.0 이상에서 지원됩니다.
유지보수 기간 정보
Cloud Data Fusion의 유지보수 기간은 유지보수 작업을 수행할 수 있도록 허용하는 기간으로, 사용량이 높은 시간에 서비스 중단 위험을 줄일 수 있습니다. 사용량이 많지 않은 시간 또는 활동이 적은 시간에 유지보수 기간을 예약하면 Cloud Data Fusion 인스턴스 및 파이프라인 실행에 미치는 영향을 최소화할 수 있습니다.
유지보수 기간을 구성하면 인스턴스의 유지보수 작업 시기를 제어할 수 있습니다.
- 유지보수 기간이 정의된 경우 Cloud Data Fusion은 정의된 기간 내에 유지보수 작업을 수행합니다.
- 유지보수 기간이 정의되지 않은 경우 언제든지 유지보수를 수행할 수 있습니다.
유지보수 작업 정보
시스템 보안 및 규정 준수를 보장하기 위해 Cloud Data Fusion은 정기적인 유지보수 작업을 수행합니다. 이러한 작업에는 취약점을 완화하고 사용자 데이터를 보호하기 위한 중요 업데이트 및 보안 패치를 적용하는 것이 포함됩니다. 예약된 유지보수 기간을 통해 업데이트를 효율적으로 적용하여 시스템 무결성을 유지하고 인스턴스 및 파이프라인 실행 중단을 최소화할 수 있습니다.
- 유지보수 기간을 구성할 때 유지보수 작업을 위해 주당 12시간 이상을 할당해야 합니다. 각 기간은 4~12시간 사이여야 합니다.
유지보수 기간 중에는 특정 작업이 영향을 받을 수 있습니다. 사용량이 많지 않은 시간에 유지보수 기간을 설정하는 것이 좋습니다. 유지보수 작업은 다음과 같은 방식으로 Cloud Data Fusion에 영향을 줄 수 있습니다.
- Cloud Data Fusion Studio 인터페이스를 일시적으로 사용하지 못할 수 있습니다.
- 파이프라인 실행에 영향을 주어 장애가 발생할 수 있습니다.
- Cloud Data Fusion 서비스가 일시적으로 중지되어 API 호출이 실패할 수 있습니다.
- 유지보수 기간 동안 최대 1시간 동안 인스턴스가 제대로 작동하지 않을 수 있습니다. 파이프라인이 실행되지 않거나 실행이 예약되지 않았을 때 유지보수 기간을 설정하는 것이 좋습니다.
인스턴스 생성 중에 유지보수 기간 지정
콘솔
인스턴스를 만들 때 유지보수 기간을 설정하려면 다음 단계를 따르세요.
- Cloud Data Fusion 인스턴스 페이지로 이동하고 인스턴스 만들기를 클릭합니다.
- 인스턴스 이름과 버전을 입력합니다. 각 필드에 대한 자세한 내용은 인스턴스 만들기를 참조하세요.
- 고급 옵션 섹션을 펼칩니다.
- 유지보수 섹션을 펼치고 다음 단계를 따르세요.
- 유지보수 기간 사용 설정 체크박스를 선택합니다.
- 시작 시간 필드에 지원되는 형식으로 시간을 입력합니다.
- TimeZone 목록에서 시간대를 선택합니다.
- 요일 및 기간 목록에서 요일과 기간을 선택합니다. 이러한 설정에 대한 자세한 내용은 유지보수 작업 정보를 참조하세요.
- 만들기를 클릭합니다.
자세한 내용은 유지보수 기간 시간 및 반복(RRULE) 구성을 참조하세요.
REST API
instance.createAPI를 사용하여Instance구성을 설정합니다.
{
"name": string,
"description": string,
…
…
"maintenancePolicy": {
"maintenanceWindow": {
"recurringTimeWindow": {
"window": {
"startTime": "START_TIME",
"endTime": "END_TIME"
},
"recurrence": "MAINTENANCE_RECURRENCE"
}
},
}
}
다음을 바꿉니다.
START_TIME: RFC 3339 형식의 기간 시작 시간입니다.END_TIME: RFC 3339 형식의 기간 종료 시간입니다.MAINTENANCE_RECURRENCE: 유지보수 기간 반복의 RRULE입니다. Cloud Data Fusion은 다음 형식만 지원합니다.FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SA또는BYDAY=SU,MO,TU,WE,TH,FR,SA,MO;FREQ=WEEKLY. 이는startTime부터 시작하여 지정된 기간 동안 선택한 날짜에 대해 기간이 매주 반복되도록 지정합니다.
자세한 내용은 유지보수 기간 시간 및 반복(RRULE) 구성을 참조하세요.
다음 예시에서는 매주 토요일과 일요일 오전 10시~오후 4시(UTC)에 6시간의 유지보수 기간이 있는 인스턴스를 만듭니다. 자세한 내용은 인스턴스 API 문서를 참조하세요.
// POST https://datafusion.googleapis.com/v1/projects/example-project/locations/us-central1/instances?instanceID=example-instance
{
"maintenancePolicy": {
"maintenanceWindow": {
"recurringTimeWindow": {
"window": {
"startTime": "2024-01-01T10:00:00Z",
"endTime": "2024-01-01T16:00:00Z",
},
"recurrence": "FREQ=WEEKLY;BYDAY=SA,SU"
}
},
}
}
gcloud
인스턴스를 만드는 동안 gcloud beta data-fusion instances create 명령어를 사용하여 유지보수 기간을 지정할 수 있습니다.
유지보수 기간에 다음 파라미터를 정의해야 합니다.
--maintenance-window-start는 기간의 시작 시간을 설정합니다.--maintenance-window-end는 기간의 종료 시간을 설정합니다.--maintenance-window-recurrence는 유지보수 기간 반복의 RRULE입니다.
gcloud beta data-fusion instances create INSTANCE_NAME \
--project=PROJECT_NAME \
--location=LOCATION \
--maintenance-window-start=START_TIME \
--maintenance-window-end=END_TIME \
--maintenance-window-recurrence=MAINTENANCE_RECURRENCE
다음을 바꿉니다.
INSTANCE_NAME: 인스턴스 이름PROJECT_NAME: 프로젝트의 이름입니다.LOCATION: 인스턴스의 리전 이름START_TIME: 날짜/시간 입력 형식의 기간의 시작 시간입니다. 지정한 시간만 사용되며 날짜는 무시됩니다.END_TIME: 날짜/시간 입력 형식의 기간의 종료 시간입니다. 지정한 시간만 사용되며 날짜는 무시됩니다. 지정한 날짜와 시간은 시작 시간 이후여야 합니다.MAINTENANCE_RECURRENCE: 유지보수 기간 반복의 RRULE입니다. Cloud Data Fusion은 다음 형식만 지원합니다.FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SA또는BYDAY=SU,MO,TU,WE,TH,FR,SA,MO;FREQ=WEEKLY. 이는--maintenance-window-start시간부터 시작하여 지정된 기간 동안 선택한 날짜에 대해 기간이 매주 반복되도록 지정합니다.
자세한 내용은 유지보수 기간 시간 및 반복(RRULE) 구성을 참조하세요.
다음 명령어에서는 매주 토요일과 일요일 오후 12시~오후 6시(UTC)에 6시간의 유지보수 기간이 있는 인스턴스를 만듭니다.
gcloud beta data-fusion instances create example-instance \
--project='example-project' \
--location='us-east1' \
--maintenance-window-start='2024-01-01T12:00:00Z' \
--maintenance-window-end='2024-01-01T18:00:00Z' \
--maintenance-window-recurrence='FREQ=WEEKLY;BYDAY=SA,SU'
인스턴스의 유지보수 기간 업데이트
콘솔
Google Cloud 콘솔에서 기존 인스턴스의 유지보수 기간을 업데이트하려면 다음 단계를 따르세요.
Cloud Data Fusion 인스턴스 페이지로 이동합니다.
인스턴스 이름을 클릭하여 인스턴스 세부정보를 확인합니다.
인스턴스 세부정보 페이지에서 유지보수 기간 필드로 이동하고 수정을 클릭합니다.
유지보수 기간 필드는 수정 모드로 열립니다. 필요에 따라 값을 업데이트합니다.
- 유지보수 기간 사용 설정 체크박스를 선택합니다.
- 시작 시간 필드에 지원되는 형식으로 시간을 입력합니다.
- TimeZone 목록에서 시간대를 선택합니다.
- 요일 및 기간 목록에서 요일과 기간을 선택합니다. 이러한 설정에 대한 자세한 내용은 유지보수 작업 정보를 참조하세요.
저장을 클릭합니다.
자세한 내용은 유지보수 기간 시간 및 반복(RRULE) 구성을 참조하세요.
REST API
기존 인스턴스의 경우 instances.patch API 요청을 사용하여 유지보수 기간을 업데이트합니다. 이렇게 하면 기존 유지보수 기간 구성이 재정의됩니다(있는 경우). 그렇지 않으면 요청 본문에 언급된 대로 새 구성이 설정됩니다.
다음과 같이 API 요청을 생성합니다.
updateMask매개변수에서maintenance_policy마스크를 지정합니다.- 요청 본문에서 유지보수 정책 구성에서 유지보수 기간을 지정합니다.
{
"maintenancePolicy": {
"maintenanceWindow": {
"recurringTimeWindow": {
"window": {
"startTime": "START_TIME",
"endTime": "END_TIME"
},
"recurrence": "MAINTENANCE_RECURRENCE"
}
},
}
}
자세한 내용은 유지보수 기간 시간 및 반복(RRULE) 구성을 참조하세요.
다음 예시에서는 매주 금요일, 토요일, 일요일 오전 11시~오후 3시(UTC)에 4시간의 유지보수 기간이 있는 인스턴스의 유지보수 정책 구성을 업데이트합니다.
// PATCH https://datafusion.googleapis.com/v1/projects/example-project/locations/us-central1/instances/example-instance?updateMask=maintenance_policy
{
"maintenancePolicy": {
"maintenanceWindow": {
"recurringTimeWindow": {
"window": {
"startTime": "2024-01-01T11:00:00Z",
"endTime": "2024-01-01T15:00:00Z",
},
"recurrence": "FREQ=WEEKLY;BYDAY=FR,SA,SU"
}
},
}
}
gcloud
gcloud beta data-fusion instances update 명령어를 사용하여 인스턴스의 유지보수 기간을 업데이트할 수 있습니다.
유지보수 기간에 다음 파라미터를 정의해야 합니다.
--maintenance-window-start는 기간의 시작 시간을 설정합니다.--maintenance-window-end는 기간의 종료 시간을 설정합니다.--maintenance-window-recurrence는 유지보수 기간 반복의 RRULE입니다.
gcloud beta data-fusion instances update INSTANCE_NAME \
--project=PROJECT_NAME \
--location=LOCATION \
--maintenance-window-start=START_TIME \
--maintenance-window-end=END_TIME \
--maintenance-window-recurrence=MAINTENANCE_RECURRENCE
다음을 바꿉니다.
INSTANCE_NAME: 인스턴스 이름PROJECT_NAME: 프로젝트의 이름입니다.LOCATION: 인스턴스의 리전 이름START_TIME: 날짜/시간 입력 형식의 기간의 시작 시간입니다. 지정한 시간만 사용되며 날짜는 무시됩니다.END_TIME: 날짜/시간 입력 형식의 기간의 종료 시간입니다. 지정한 시간만 사용되며 날짜는 무시됩니다. 지정한 날짜와 시간은 시작 시간 이후여야 합니다.MAINTENANCE_RECURRENCE: 유지보수 기간 반복의 RRULE입니다. Cloud Data Fusion은 다음 형식만 지원합니다.FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SA또는BYDAY=SU,MO,TU,WE,TH,FR,SA,MO;FREQ=WEEKLY. 이는--maintenance-window-start시간부터 시작하여 지정된 기간 동안 선택한 날짜에 대해 기간이 매주 반복되도록 지정합니다.
다음 명령어에서는 매주 토요일과 일요일 오후 12시~오후 6시(UTC)에 6시간의 유지보수 기간이 있는 example-instance 인스턴스를 업데이트합니다.
gcloud beta data-fusion instances update example-instance \
--project='example-project' \
--location='us-east1' \
--maintenance-window-start='2024-01-01T12:00:00Z' \
--maintenance-window-end='2024-01-01T18:00:00Z' \
--maintenance-window-recurrence='FREQ=WEEKLY;BYDAY=SA,SU'
유지보수 기간 시간 및 반복(RRULE) 구성
유지보수 기간의 시작 및 종료 시간을 구성하면 제공된 타임스탬프의 날짜 구성요소는 무시됩니다. 시간과 시작 시간과 종료 시간 사이의 기간만 고려됩니다. 시간은 UTC로 저장되지만 REST API 또는 gcloud CLI를 사용하여 유지보수 기간을 예약할 때 UTC 또는 시간대 오프셋을 사용할 수 있습니다.
반복을 구성할 때 RRULE은 UTC 날짜를 따르므로 시간대가 다른 경우 이에 맞게 조정합니다. 예를 들어 시간대가 PDT(UTC-7)이고 유지보수 기간이 해당 시간대를 기준으로 수요일 오후 9시(UTC 기준 목요일 오후 4시에 해당)에 시작되도록 하려면 RRULE의 BYDAY 옵션에서 WE 대신 TH를 지정합니다.
인스턴스의 유지보수 기간 삭제
콘솔
Google Cloud 콘솔의 기존 인스턴스에서 유지보수 기간을 삭제하려면 다음 단계를 따르세요.
Cloud Data Fusion 인스턴스 페이지로 이동합니다.
인스턴스 이름을 클릭하여 인스턴스 세부정보를 확인합니다.
인스턴스 세부정보 페이지에서 유지보수 기간 필드로 이동하고 수정을 클릭합니다.
인스턴스에서 유지보수 기간을 삭제하려면 유지보수 기간 사용 설정 체크박스를 선택 해제합니다.
저장을 클릭합니다.
REST API
인스턴스에서 유지보수 기간을 삭제하려면 요청 본문의 빈 유지보수 정책 객체를 전달합니다.
// PATCH https://datafusion.googleapis.com/v1/projects/example-project/locations/us-central1/instances/example-instance?updateMask=maintenance_policy
{
"maintenancePolicy": {}
}
gcloud
인스턴스에서 유지보수 기간을 삭제하려면 gcloud beta data-fusion instances update 명령어를 --clear-maintenance-window 플래그와 함께 사용합니다.
gcloud beta data-fusion instances update INSTANCE_NAME \
--project=PROJECT_NAME \
--location=LOCATION \
--clear-maintenance-window
다음을 바꿉니다.
INSTANCE_NAME: 인스턴스 이름PROJECT_NAME: 프로젝트의 이름입니다.LOCATION: 인스턴스의 리전 이름
다음 단계
- 인스턴스 API 문서 참조