Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

유지보수 이벤트 및 정책

Google Cloud는 Google Cloud Managed Lustre 인스턴스를 최신 상태로 유지하기 위해 Google Cloud 정기적으로 유지보수를 실행합니다. 유지보수 이벤트에는 기본 소프트웨어 또는 인프라 업데이트가 포함될 수 있습니다. 이러한 이벤트로 인해 일시적인 다운타임이 발생할 수 있으며, 이 기간 동안 인스턴스에 대한 I/O 작업이 응답을 중지할 수 있습니다. 영향을 받는 I/O 작업은 유지보수가 완료되면 다시 시작됩니다. 다운타임은 일반적으로 2~25분입니다.

유지보수가 진행되는 동안 인스턴스의 상태는 UPGRADING입니다. 유지보수가 완료되면 인스턴스가 ACTIVE 상태로 돌아갑니다.

유지보수 정책을 사용하면 이러한 유지보수 이벤트가 발생하는 시점을 제어할 수 있습니다. 각 인스턴스의 유지보수 정책을 구성하여 유지보수 기간과 유지보수를 제외해야 하는 기간을 지정할 수 있습니다. 인스턴스에 유지보수 정책이 구성되지 않은 경우 언제든지 유지보수가 진행될 수 있습니다.

유지보수 이벤트 일정을 변경하여 즉시, 다음 사용 가능한 기간 또는 최대 28일 후 특정 시간에 시작되도록 할 수도 있습니다.

익스트림 스케일 인스턴스

최고의 성능과 확장성을 제공하는 특정 Managed Lustre 구성에는 주기적인 호스트 유지보수를 위해 최대 4시간의 계획된 다운타임이 필요할 수 있습니다. Google에서는 이러한 유지보수 이벤트를 사전에 조정합니다.

유지보수 정책 정보

각 Managed Lustre 인스턴스에서 유지보수 정책을 구성할 수 있습니다. 유지보수 정책에는 다음이 포함됩니다.

주간 유지보수 기간: Managed Lustre가 유지보수 이벤트를 시작해도 되는 주중의 반복되는 1시간 기간입니다.
유지보수 제외 기간: Managed Lustre가 유지보수 이벤트를 시작할 수 없는 기간입니다. 인스턴스당 하나의 제외 기간을 정의할 수 있으며 최대 기간은 2주입니다. 시작일과 종료일에 연도가 지정되지 않으면 제외 기간이 매년 반복됩니다.

제외 기간이 일반 유지보수 기간보다 우선합니다. 예약된 이벤트가 이 기간에 속하는 경우 Managed Lustre는 이벤트를 다음 사용 가능한 기간으로 연기하거나 완전히 건너뜁니다. 업데이트는 다음 유지보수 주기 중에 적용됩니다.

유지보수 알림

예정된 유지보수 이벤트에 대한 이메일 알림을 구독하여 잠재적인 중단을 계획할 수 있습니다. 유지보수 알림 구독은 Google Cloud 콘솔 커뮤니케이션 페이지를 통해 관리됩니다.

커뮤니케이션 페이지로 이동

구독하면 다음과 같은 알림이 전송됩니다.

사전 알림: 예약된 유지보수 이벤트 7~14일 전에 전송되거나 고객이 유지보수 이벤트 일정을 변경한 후에 전송됩니다.
취소됨: 예약된 유지보수 이벤트가 Google에 의해 취소되거나 고객에 의해 일정이 변경된 경우 전송됩니다.
진행 중: 유지보수 이벤트가 시작될 때 전송됩니다.
완료됨: 유지보수 이벤트가 완료되면 전송됩니다.

Google Cloud 콘솔의 인스턴스 세부정보 페이지에서 예정된 유지보수 일정을 확인할 수도 있고 Cloud Logging을 사용하여 유지보수 로그를 볼 수도 있습니다.

유지보수 기간 구성

유지보수 기간에는 요일과 1시간 기간의 UTC 시작 시간이 필요합니다.

Google Cloud 콘솔

인스턴스를 만들 때 유지보수 기간을 구성하려면 인스턴스 만들기를 참고하세요.

gcloud

--maintenance-policy-weekly-windows 플래그를 지정하여 유지보수 기간이 있는 인스턴스를 만듭니다.

gcloud lustre instances create INSTANCE_ID \
  --per-unit-storage-throughput=PER_UNIT_STORAGE_THROUGHPUT \
  --capacity-gib=CAPACITY_GIB \
  --filesystem=FS_NAME \
  --location=LOCATION \
  --network=NETWORK_PATH \
  --maintenance-policy-weekly-windows='dayOfWeek=DAY,startTime={START_TIME}'

다음을 바꿉니다.

INSTANCE_ID: Managed Lustre 인스턴스의 ID입니다.
PER_UNIT_STORAGE_THROUGHPUT는 TiB당 MBps의 성능 등급입니다. 유효한 값은 0, 125, 250, 500, 1000입니다. [동적 등급][dynamic-tier]을 지정하려면 이 값을 0로 설정하고 --dynamic-tier-options-mode=DEFAULT_CACHE 플래그를 포함합니다.
CAPACITY: 인스턴스의 용량(GiB)입니다.
FS_NAME: 파일 시스템의 이름입니다.
LOCATION: Managed Lustre 인스턴스의 위치입니다.
NETWORK_PATH: 인스턴스가 속한 VPC 네트워크의 전체 경로입니다(projects/PROJECT_ID/global/networks/NETWORK 형식). VPC 네트워크 구성을 참고하세요.
DAY: 유지보수 기간의 요일입니다 (예: TUESDAY).
START_TIME: 유지보수 기간의 UTC 시작 시간(사전 형식)(예: {hours=1,minutes=0})

인스턴스 만들기에 관한 자세한 내용은 Managed Lustre 인스턴스 만들기를 참고하세요.

REST API

인스턴스의 유지보수 기간을 지정하려면 인스턴스를 만들 때 maintenancePolicy 객체를 포함합니다.

다음은 maintenancePolicy 객체의 예시입니다.

"maintenancePolicy": {
  "weeklyMaintenanceWindows": [
    {
      "dayOfWeek": "DAY",
      "startTime": {
        "hours": HOURS,
        "minutes": MINUTES
      }
    }
  ]
}

다음을 바꿉니다.

DAY: 유지보수 기간의 요일입니다 (예: TUESDAY).
HOURS: 유지보수 기간 시작 시간의 시간입니다 (예: 1).
MINUTES: 유지보수 기간 시작 시간의 분입니다 (예: 0).

제외 기간 구성

휴일이나 비즈니스 이벤트와 같은 특정 기간에 유지보수가 발생하지 않도록 하려면 유지보수 정책에서 유지보수 제외 기간을 하나 정의하면 됩니다. 제외 기간은 최대 2주입니다. 매년 반복되는 제외 기간을 만들려면 시작일과 종료일에 연도를 지정하지 마세요.

주간 유지보수 기간과 제외 기간을 동일한 정책에 결합할 수 있습니다.

Google Cloud 콘솔

인스턴스를 만들 때 제외 기간을 구성하려면 인스턴스 만들기를 참고하세요.

gcloud

--maintenance-policy-exclusion-window 플래그를 지정하여 제외 기간이 있는 인스턴스를 만듭니다.

gcloud lustre instances create INSTANCE_ID \
  --per-unit-storage-throughput=PER_UNIT_STORAGE_THROUGHPUT \
  --capacity-gib=CAPACITY_GIB \
  --filesystem=FILESYSTEM \
  --location=LOCATION \
  --network=NETWORK_PATH \
  --maintenance-policy-exclusion-window='startDate={START_DATE},endDate={END_DATE},time={TIME}'

다음을 바꿉니다.

INSTANCE_ID: Managed Lustre 인스턴스의 ID입니다.
PER_UNIT_STORAGE_THROUGHPUT는 TiB당 MBps의 성능 등급입니다. 유효한 값은 0, 125, 250, 500, 1000입니다. [동적 등급][dynamic-tier]을 지정하려면 이 값을 0로 설정하고 --dynamic-tier-options-mode=DEFAULT_CACHE 플래그를 포함합니다.
CAPACITY: 인스턴스의 용량(GiB)입니다.
FS_NAME: 파일 시스템의 이름입니다.
LOCATION: Managed Lustre 인스턴스의 위치입니다.
NETWORK_PATH: 인스턴스가 속한 VPC 네트워크의 전체 경로입니다(projects/PROJECT_ID/global/networks/NETWORK 형식). VPC 네트워크 구성을 참고하세요.
START_DATE: 유지보수 제외 기간의 시작일입니다 (예: {day=08,month=06,year=2026}). 매년 반복하려면 year 키를 생략하세요.
END_DATE: 유지보수 제외 기간의 종료일입니다 (예: {day=08,month=06,year=2026}). 매년 반복하려면 year 키를 생략하세요.
TIME: 제외 기간의 UTC 시작 및 종료 시간 (사전 형식, 예: {hours=1,minutes=0})

REST API

다음은 제외 창이 있는 maintenancePolicy 객체의 예입니다.

"maintenancePolicy": {
  "maintenanceExclusionWindow": [
    {
      "startDate": {
        "day": START_DAY,
        "month": START_MONTH,
        "year": START_YEAR
      },
      "endDate": {
        "day": END_DAY,
        "month": END_MONTH,
        "year": END_YEAR
      },
      "time": {
        "hours": HOURS,
        "minutes": MINUTES
      }
    }
  ]
}

다음을 바꿉니다.

START_YEAR: 제외 기간 시작 날짜의 연도입니다 (예: 2026). 매년 반복되는 기간을 만들려면 이 필드와 END_YEAR를 생략하세요.
START_MONTH: 제외 기간 시작 날짜의 월입니다 (예: 12).
START_DAY: 제외 기간 시작 날짜의 일입니다 (예: 24).
END_YEAR: 제외 기간 종료일의 연도입니다 (예: 2027). 매년 반복되는 기간을 만들려면 이 필드와 START_YEAR를 생략하세요.
END_MONTH: 제외 기간 종료 날짜의 월입니다(예: 1).
END_DAY: 제외 기간 종료일의 일입니다 (예: 7).
HOURS: 제외 기간의 시간입니다(예: 0).
MINUTES: 제외 기간 시간의 분입니다(예: 0).

유지보수 정책 업데이트

기존 인스턴스의 유지보수 정책을 추가하거나 수정하려면 다음 단계를 따르세요.

Google Cloud 콘솔

인스턴스의 유지보수 정책을 업데이트하려면 인스턴스 관리를 참고하세요.

gcloud

다음 gcloud 예시에서는 인스턴스의 유지보수 정책을 업데이트합니다.

gcloud lustre instances update INSTANCE_ID \
--location=LOCATION \
--maintenance-policy-weekly-windows='dayOfWeek=DAY,startTime={START_TIME}'

다음을 바꿉니다.

INSTANCE_ID: Managed Lustre 인스턴스의 ID입니다.
LOCATION: Managed Lustre 인스턴스의 위치입니다.
DAY: 유지보수 기간의 요일입니다 (예: TUESDAY).
START_TIME: 유지보수 기간의 UTC 시작 시간(사전 형식)(예: {hours=1,minutes=0})

REST API

인스턴스의 유지보수 기간을 지정하려면 인스턴스를 업데이트할 때 maintenancePolicy 객체를 포함합니다. updateMask 쿼리 매개변수에서 maintenancePolicy도 지정해야 합니다.

다음 curl 예시에서는 인스턴스의 유지보수 정책을 업데이트합니다.

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" -d '{
  "maintenancePolicy": {
    "weeklyMaintenanceWindows": [
      {
        "dayOfWeek": "DAY",
        "startTime": {
          "hours": HOURS,
          "minutes": MINUTES
        }
      }
    ]
  }
}' "https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID?updateMask=maintenancePolicy"

다음을 바꿉니다.

PROJECT_ID: Google Cloud 프로젝트의 ID입니다.
LOCATION Managed Lustre 인스턴스의 위치입니다.
INSTANCE_ID Managed Lustre 인스턴스의 ID입니다.
DAY: 유지보수 기간의 요일입니다 (예: TUESDAY).
HOURS 유지보수 기간 시작 시간의 시간입니다 (예: 3).
MINUTES 유지보수 기간 시작 시간의 분입니다 (예: 45).

유지보수 정책 삭제

인스턴스에서 유지보수 정책을 삭제하려면 정책에서 모든 주간 유지보수 기간과 제외 기간을 삭제합니다.

Google Cloud 콘솔

인스턴스에서 유지보수 정책을 삭제하려면 인스턴스를 수정하고 유지보수 정책 필드를 선택 해제합니다. 인스턴스 관리를 참고하세요.

gcloud

gcloud lustre instances update 명령어를 --clear-maintenance-policy-weekly-windows 및 --clear-maintenance-policy-exclusion-window 플래그와 함께 사용합니다.

gcloud lustre instances update INSTANCE_ID \
--location=LOCATION \
--clear-maintenance-policy-weekly-windows \
--clear-maintenance-policy-exclusion-window

다음을 바꿉니다.

INSTANCE_ID: Managed Lustre 인스턴스의 ID입니다.
LOCATION: Managed Lustre 인스턴스의 위치입니다.

REST API

REST API를 사용하여 유지보수 정책을 삭제하려면 빈 maintenancePolicy 객체와 updateMask 쿼리 매개변수가 maintenancePolicy로 설정된 instances.patch 메서드를 사용합니다.

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" -d '{
  "maintenancePolicy": {}
}' "https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID?updateMask=maintenancePolicy"

다음을 바꿉니다.

PROJECT_ID: Google Cloud 프로젝트의 ID입니다.
LOCATION: Managed Lustre 인스턴스의 위치입니다.
INSTANCE_ID: Managed Lustre 인스턴스의 ID입니다.

유지보수 로그 보기

Managed Lustre는 Cloud Logging을 사용하여 다음 활동 유형을 비롯한 유지관리 이벤트를 로깅합니다.

LustreAdvancedNotification: 인스턴스에 유지보수가 예약되어 있습니다.
LustreOngoingNotification: 인스턴스에서 유지보수가 시작되었습니다. 완료되면 이번에는 is_completed=true와 함께 다른 LustreOngoingNotification 이벤트가 기록됩니다.
LustreCancelledNotification: 유지보수가 취소되었습니다.

로그 탐색기를 사용하거나 Google Cloud CLI를 사용하여 유지보수 로그를 볼 수 있습니다.

로그 탐색기

로그 탐색기를 사용하여 Managed Lustre 유지관리 로그를 보려면 다음 단계를 따르세요.

Google Cloud 콘솔에서 Cloud Logging > 로그 탐색기 페이지로 이동합니다.

로그 탐색기로 이동

쿼리 편집기에 다음 필터를 입력하고 쿼리 실행을 클릭합니다.

resource.type="lustre.googleapis.com/Instance"
resource.labels.instance_id="INSTANCE_ID"
resource.labels.location="LOCATION"
logName="projects/PROJECT_ID/logs/lustre.googleapis.com%2Fmaintenance"

gcloud CLI

Google Cloud CLI로 유지보수 로그를 보려면 gcloud logging read 명령어를 실행합니다.

gcloud logging read 'resource.type="lustre.googleapis.com/Instance" resource.labels.instance_id="INSTANCE_ID" resource.labels.location="LOCATION" logName="projects/PROJECT_ID/logs/lustre.googleapis.com%2Fmaintenance"' --project=PROJECT_ID

다음을 바꿉니다.

INSTANCE_ID: Managed Lustre 인스턴스의 ID입니다.
LOCATION: 인스턴스가 있는 영역입니다.
PROJECT_ID: 인스턴스가 있는 프로젝트의 프로젝트 ID입니다.

유지보수 일정 변경

예약된 유지보수 이벤트가 필요와 충돌하는 경우 일정을 변경할 수 있습니다. 일정을 변경할 때 다음 옵션을 사용할 수 있습니다.

즉시: 가능한 한 빨리 시작되도록 유지보수 이벤트의 일정을 변경합니다. 이 옵션은 인스턴스에 구성된 유지보수 기간 및 제외 기간을 무시합니다.
사용 가능한 다음 기간: 유지보수 이벤트를 사용 가능한 다음 유지보수 기간으로 재예약합니다. 일반적으로 업데이트가 1주일 연기됩니다.
날짜별: 유지보수 이벤트를 특정 날짜와 시간으로 다시 예약합니다. 원래 예약된 시간으로부터 최대 28일까지 유지보수를 연기할 수 있습니다. 이 옵션은 인스턴스에 구성된 유지보수 기간 및 제외 기간을 무시합니다.

유지보수 일정을 변경하려면 다음 단계를 따르세요.

gcloud

유지보수 이벤트를 최대한 빨리 시작하려면 다음 단계를 따르세요.

gcloud lustre instances reschedule-maintenance INSTANCE_ID \
--location=LOCATION \
--reschedule-type=immediately

유지보수를 사용 가능한 다음 기간으로 변경하려면 다음 단계를 따르세요.

gcloud lustre instances reschedule-maintenance INSTANCE_ID \
--location=LOCATION \
--reschedule-type=next-available-window

특정 시간으로 유지보수 일정을 변경하려면 다음 단계를 따르세요.

gcloud lustre instances reschedule-maintenance INSTANCE_ID \
--location=LOCATION \
--reschedule-type=by-time \
--reschedule-schedule-time=TIMESTAMP

다음을 바꿉니다.

INSTANCE_ID: Managed Lustre 인스턴스의 ID입니다.
LOCATION: Managed Lustre 인스턴스의 위치입니다.
TIMESTAMP: RFC 3339 형식의 시작 시간입니다 (예: 2026-04-30T10:00:00Z). 원래 예정된 시간으로부터 28일 이내여야 합니다.

REST API

instances.rescheduleMaintenance 메서드를 사용합니다.

다음 curl 예에서는 가능한 한 빨리 유지보수 이벤트를 시작합니다.

curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" -d '{
  "reschedule": {
    "rescheduleType": "IMMEDIATELY"
  }
}' "https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID:rescheduleMaintenance"

다음 curl 예에서는 유지보수 일정을 사용 가능한 다음 기간으로 변경합니다.

curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" -d '{
  "reschedule": {
    "rescheduleType": "NEXT_AVAILABLE_WINDOW"
  }
}' "https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID:rescheduleMaintenance"

다음 curl 예시에서는 특정 시간으로 유지보수 일정을 변경합니다.

curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" -d '{
  "reschedule": {
    "rescheduleType": "BY_TIME",
    "scheduleTime": "TIMESTAMP"
  }
}' "https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID:rescheduleMaintenance"

다음을 바꿉니다.

PROJECT_ID: Google Cloud 프로젝트의 ID입니다.
INSTANCE_ID: Managed Lustre 인스턴스의 ID입니다.
LOCATION: Managed Lustre 인스턴스의 위치입니다.
TIMESTAMP: RFC 3339 형식의 시작 시간입니다 (예: 2026-04-30T10:00:00Z). 원래 예정된 시간으로부터 28일 이내여야 합니다.

유지보수 이벤트 및 정책 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

익스트림 스케일 인스턴스

유지보수 정책 정보

유지보수 알림

유지보수 기간 구성

Google Cloud 콘솔

gcloud

REST API

제외 기간 구성

Google Cloud 콘솔

gcloud

REST API

유지보수 정책 업데이트

Google Cloud 콘솔

gcloud

REST API

유지보수 정책 삭제

Google Cloud 콘솔

gcloud

REST API

유지보수 로그 보기

로그 탐색기

gcloud CLI

유지보수 일정 변경

gcloud

REST API

유지보수 이벤트 및 정책