Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

유지보수 이벤트 및 정책

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

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

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를 사용하여 유지보수 정책을 삭제하려면 instances.patch 메서드와 빈 maintenancePolicy 객체 및 updateMask 쿼리 매개변수가 maintenancePolicy로 설정된 메서드를 사용합니다.

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"
```
다음을 바꿉니다.
- INSTANCE_ID: Managed Lustre 인스턴스의 ID입니다.
- LOCATION: Managed Lustre 인스턴스의 위치입니다.
- PROJECT_ID: 프로젝트 Google Cloud 의 ID입니다.

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

유지보수 이벤트 및 정책