셀프서비스 유지보수 수행

셀프서비스 유지보수를 사용하면 필요에 따라 Managed Lustre 인스턴스에 유지보수 업그레이드를 적용할 수 있습니다.

Managed Lustre에서 새 소프트웨어 버전을 출시하면 셀프서비스 유지보수에 즉시 사용할 수 있습니다. 이는 일반적으로 자동 유지보수가 인스턴스에 도달하기 몇 주 전입니다.

버전을 사용할 수 있게 되면 언제든지 셀프서비스 유지보수를 수행할 수 있습니다. 인스턴스에 유지보수 정책이 있는 경우 예약된 유지보수 기간 1시간 전까지 셀프 서비스 유지보수를 수행할 수 있습니다.

유지보수 영향 및 정책에 대한 개요는 유지보수 개요를 참조하세요.

사용 가능한 유지보수 버전 확인

Managed Lustre 인스턴스는 다음 버전 필드를 사용하여 유지보수 출시 버전을 추적합니다.

  • effectiveVersion: 출력 전용. 인스턴스에서 실행 중인 소프트웨어 출시 버전입니다. 예를 들면 Lustre_20260516.00_p00입니다.
  • availableVersion: 출력 전용. 인스턴스를 업그레이드할 수 있는 검증된 최신 소프트웨어 출시 버전입니다. 이 필드가 비어 있으면 인스턴스에서 이미 사용 가능한 최신 출시 버전을 실행 중인 것입니다.
  • targetVersion: 입력 전용입니다. 후보 버전 또는 latest로 업그레이드를 시작하기 위해 업데이트 요청에 지정된 매개변수입니다.

인스턴스의 현재 버전을 확인하고 업그레이드가 가능한지 확인하려면 다음 안내를 따르세요.

Google Cloud 콘솔

  1. Google Cloud 콘솔에서 관리형 Lustre 페이지로 이동합니다.

    Managed Lustre로 이동

  2. 인스턴스 목록에서 인스턴스를 찾습니다. 최신 유지보수 버전을 사용할 수 있는 경우 ACTIVE 상태 옆에 사용 가능한 업데이트 배지가 표시됩니다.

  3. 인스턴스 이름을 클릭하여 인스턴스 세부정보 페이지를 열고 사용 가능한 버전 문자열을 확인합니다.

gcloud CLI

형식 필터와 함께 gcloud lustre instances describe 명령어를 실행합니다.

gcloud lustre instances describe INSTANCE_ID \
  --location=LOCATION \
  --format="yaml(effectiveVersion, availableVersion, state)"

다음을 바꿉니다.

  • INSTANCE_ID: Managed Lustre 인스턴스의 ID입니다.
  • LOCATION: 인스턴스가 있는 영역입니다.

사용할 수 있는 최신 버전이 있으면 다음과 유사한 결과가 출력됩니다.

availableVersion: Lustre_20260716.01_p00
effectiveVersion: Lustre_20260516.00_p00
state: ACTIVE

availableVersion가 비어 있으면 인스턴스에서 이미 사용 가능한 최신 출시 버전을 실행 중인 것입니다.

REST

인스턴스의 버전 세부정보를 확인하려면 인스턴스 엔드포인트에 GET 요청을 보냅니다.

GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID
Authorization: Bearer ACCESS_TOKEN

각 항목의 의미는 다음과 같습니다.

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

최신 버전을 사용할 수 있는 경우 응답에 effectiveVersion 및 availableVersion가 포함됩니다.

{
  "name": "projects/my-project/locations/us-central1-a/instances/my-instance",
  "state": "ACTIVE",
  "effectiveVersion": "Lustre_20260516.00_p00",
  "availableVersion": "Lustre_20260716.01_p00"
}

availableVersion가 생략되거나 비어 있으면 인스턴스가 이미 사용 가능한 최신 출시 버전을 실행 중인 것입니다.

자세한 내용은 instances.get API 참조를 확인하세요.

셀프서비스 업그레이드 수행

인스턴스를 사용 가능한 소프트웨어 버전으로 업그레이드하려면 다음 안내를 따르세요.

gcloud CLI

--target-version 플래그와 함께 gcloud lustre instances update 명령어를 실행합니다.

gcloud lustre instances update INSTANCE_ID \
  --location=LOCATION \
  --target-version=latest

다음을 바꿉니다.

  • INSTANCE_ID: Managed Lustre 인스턴스의 ID입니다.
  • LOCATION: 인스턴스가 있는 영역입니다.

latest 대신 특정 검증된 출시 버전으로 업그레이드하려면 버전 문자열을 전달합니다.

gcloud lustre instances update INSTANCE_ID \
  --location=LOCATION \
  --target-version=TARGET_VERSION

TARGET_VERSION을 availableVersion의 버전 문자열로 바꿉니다. 예를 들면 Lustre_20260716.01_p00입니다.

REST

REST API를 사용하여 인스턴스를 업그레이드하려면 updateMask 쿼리 매개변수에 targetVersion를 지정하여 인스턴스 엔드포인트에 PATCH 요청을 보냅니다.

PATCH https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID?updateMask=targetVersion
Authorization: Bearer ACCESS_TOKEN

{
  "targetVersion": "latest"
}

각 항목의 의미는 다음과 같습니다.

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

latest 대신 특정 검증된 출시 버전으로 업그레이드하려면 요청 본문에 버전 문자열(예: "targetVersion": "Lustre_20260716.01_p00")을 지정합니다.

자세한 내용은 instances.patch API 참조를 확인하세요.

유지보수 진행 상황 추적

업그레이드는 비동기 장기 실행 작업으로 실행됩니다. 셀프 서비스 유지보수는 자동 알림 이메일을 트리거하지 않습니다.

실시간으로 진행 상황을 추적하려면 다음 단계를 따르세요.

gcloud CLI

gcloud lustre operations describe 명령어를 사용하여 작업 상태를 폴링합니다.

gcloud lustre operations describe OPERATION_ID \
  --location=LOCATION

다음을 바꿉니다.

  • OPERATION_ID: 업데이트 명령어에서 반환된 작업 ID입니다.
  • LOCATION: 인스턴스가 있는 영역입니다.

업그레이드가 진행되는 동안 인스턴스 상태는 UPGRADING로 표시되고 완료되면 ACTIVE로 돌아갑니다.

REST

operations.get 엔드포인트에 GET 요청을 보냅니다.

GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID
Authorization: Bearer ACCESS_TOKEN

각 항목의 의미는 다음과 같습니다.

  • PROJECT_ID는 Google Cloud 프로젝트 ID입니다.
  • LOCATION은 인스턴스가 있는 영역입니다.
  • OPERATION_ID는 업데이트 요청에서 반환된 작업 ID입니다.

자세한 내용은 operations.get API 참조를 확인하세요.

업그레이드가 완료된 경우:

  1. 인스턴스가 ACTIVE 상태로 돌아갑니다.
  2. effectiveVersion은 새로 적용된 버전 문자열을 반영합니다.
  3. availableVersion가 삭제되고 API 응답에서 생략됩니다.

예약된 유지보수와의 상호작용

인스턴스에 예정된 유지보수가 있는 경우 셀프 서비스 업그레이드를 완료하면 예정된 유지보수가 자동으로 취소됩니다. 유지보수 알림을 구독하는 경우 자동 유지보수 취소됨 이메일 알림을 받습니다.

셀프 서비스 업그레이드가 실패하면 대기 중인 예약된 유지보수 기간이 취소되지 않습니다. 인스턴스가 현재 버전의 ACTIVE 상태로 돌아가고 예약된 유지보수 기간이 유지됩니다.

예정된 유지보수 기간이 시작되기 1시간 전에는 셀프 서비스 업그레이드를 트리거할 수 없습니다. 이 기간 동안 업그레이드를 시작하려고 하면 예정된 유지보수와 겹치지 않도록 409 CONFLICT 오류가 반환됩니다.

오류 메시지

가능한 셀프 서비스 유지보수 오류는 다음과 같습니다.

  • Instance is already running version "<CURRENT>": 인스턴스에서 이미 실행 중인 소프트웨어 버전으로 업그레이드하려고 하면 발생합니다.
  • Downgrading to a lower version is not supported.: 이전 소프트웨어 버전으로 다운그레이드하려고 하면 발생합니다.
  • Version "<TARGET>" is not a valid update version.: 지정된 버전이 인스턴스의 availableVersion 문자열 또는 latest과 일치하지 않는 경우에 발생합니다.
  • Instance must be in ACTIVE state to update version: 인스턴스가 ACTIVE 상태가 아닌 동안 업그레이드가 시작되면 발생합니다.
  • Cannot trigger self-service update within 1 hour of a scheduled maintenance window: 예정된 유지보수 기간이 시작되기 1시간 이내에 셀프 서비스 업그레이드가 시작되면 발생합니다.