Managed Lustre 인스턴스의 용량 늘리기

Managed Lustre 인스턴스의 스토리지 용량을 늘릴 수 있습니다. 용량을 줄일 수 없습니다.

인스턴스 용량을 늘리면 업데이트 작업이 진행되는 동안 인스턴스를 계속 사용할 수 있습니다.

용량 증가 제한사항

두 가지 보폭이 있는 성능 등급의 경우 인스턴스의 현재 용량에 따라 가능한 최대 크기가 결정됩니다.

인스턴스 용량이 단계 크기 기준점 이하인 경우 크기를 기준점 값 자체까지 늘릴 수 있습니다. 이 한도를 초과하여 확장할 수 없습니다.

예를 들어 TiB당 250MBps 등급에서 보폭이 변경되는 기준점은 10,224,000GiB입니다. 이 기준점 이하의 용량으로 생성된 인스턴스는 10,224,000GiB 한도까지만 확장할 수 있습니다.

새 용량 계산

성능 등급 및 보폭에 허용되는 최댓값까지 인스턴스 용량을 업데이트할 수 있습니다. 이러한 값은 다음과 같습니다.

성능 등급 최소 용량 최대 용량 보폭
TiB당 1,000MBps 9,000GiB 10,008,000 GiB (9.5 PiB) 최대 2,556,000GiB의 스토리지 용량: 9,000GiB
더 큰 스토리지 용량: 72,000GiB
TiB당 500MBps 18,000GiB 20,016,000 GiB (19.1 PiB) 최대 5,112,000GiB의 스토리지 용량: 18,000GiB
더 큰 스토리지 용량: 144,000GiB
TiB당 250MBps 36,000GiB 40,032,000 GiB (38.2 PiB) 최대 10,224,000GiB의 스토리지 용량: 36,000GiB
더 큰 스토리지 용량: 288,000GiB
TiB당 125MBps 72,000GiB 20,448,000 GiB (19.5 PiB) 72,000GiB
동적 (TiB당 25MBps) 472,000 GiB 84,016,000 GiB (80.1 PiB) 472,000 GiB

업데이트된 용량은 보폭의 배수여야 하며 해당 보폭의 최댓값을 초과할 수 없습니다.

Google Cloud 프로젝트에는 영역당 가상 프라이빗 클라우드 (VPC) 네트워크당 사용 가능한 용량에 영향을 미치는 처리량 및 용량 할당량이 있습니다. 인스턴스 용량을 늘리기 전에 추가 처리량 또는 용량 할당량을 요청해야 할 수 있습니다. 자세한 내용은 할당량 및 한도를 참조하세요.

용량 계산기

다음 계산기를 사용하여 선택한 성능 등급에 유효한 용량을 찾습니다.

인스턴스 용량 업데이트

Google Cloud 콘솔 또는 Google Cloud CLI를 사용하여 인스턴스 용량을 업데이트할 수 있습니다.

Google Cloud 콘솔

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

    Managed Lustre로 이동

  2. 업데이트할 인스턴스의 인스턴스 이름을 클릭합니다. 인스턴스 개요 페이지가 표시됩니다.

  3. 수정을 클릭합니다.

  4. 새 스토리지 용량 값을 입력합니다. 값은 허용되는 최대 용량 이하여야 하며 보폭의 배수여야 합니다. 이러한 값은 새 용량 계산을 참고하세요.

  5. 제출을 클릭합니다.

gcloud

gcloud lustre instances update 명령어를 사용하여 인스턴스의 스토리지 용량을 늘립니다.

gcloud lustre instances update INSTANCE_NAME \
  --location=LOCATION \
  --capacity-gib=NEW_CAPACITY

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

  • INSTANCE_NAME은 업데이트할 인스턴스입니다.
  • LOCATION은 인스턴스가 있는 영역입니다.
  • NEW_CAPACITY은 이 인스턴스의 새 스토리지 용량이며 단위는 기비바이트 (GiB)입니다. 이 값은 허용되는 최대 용량을 초과할 수 없으며 보폭의 배수여야 합니다. 이러한 값은 새 용량 계산을 참조하세요.

REST

REST API를 사용하여 인스턴스를 업데이트하려면 특정 엔드포인트에 PATCH 요청을 보냅니다.

PATCH https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME?updateMask=capacityGib
Authorization: Bearer [YOUR_ACCESS_TOKEN]

{
  "capacityGib": NEW_CAPACITY
}

다음 값을 지정해야 합니다.

  • PROJECT_ID는 Google Cloud 프로젝트 ID입니다.
  • ZONE은 인스턴스의 Google Cloud 영역입니다.
  • INSTANCE_NAME은 업데이트할 Managed Lustre 인스턴스의 이름입니다.
  • updateMask=capacityGib는 업데이트할 필드를 지정합니다. 마스크에 있는 경우에만 필드를 덮어씁니다.
  • NEW_CAPACITY은 이 인스턴스의 새 스토리지 용량이며 단위는 기비바이트 (GiB)입니다. 값은 허용되는 최대 용량을 초과할 수 없으며 보폭의 배수여야 합니다. 이러한 값은 새 용량 계산을 참조하세요.

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

업데이트 요청이 제출되면 Managed Lustre에서 사용 가능한 할당량을 확인합니다. 할당량이 충분하면 크기 변경에 따라 일정 기간 동안 인스턴스 용량이 증가합니다. 증가하는 데 20분에서 1시간 이상 걸릴 수 있습니다.

업데이트 작업 중에도 인스턴스를 계속 사용할 수 있습니다.

업데이트 상태 보기

다음 인터페이스에서 업데이트 요청 상태를 확인할 수 있습니다.

Google Cloud 콘솔

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

    Managed Lustre로 이동

  2. 목록에서 인스턴스 이름을 클릭합니다. 인스턴스 업데이트 요청의 현재 상태가 포함된 인스턴스 세부정보 페이지가 표시됩니다.

gcloud

기본적으로 gcloud lustre instances update 명령어는 완료될 때까지 기다린 후 셸 프롬프트를 반환합니다.

Request issued for: [my-instance]
Waiting for operation [projects/my-project/locations/us-central1-a/operations/operation-1234567890-123] to complete...

완료되면 명령줄에 업데이트된 용량을 포함한 인스턴스 세부정보와 함께 Updated instance [my-instance]가 표시됩니다.

--async 플래그를 사용하여 업데이트 명령어를 실행했거나 명령줄에서 업데이트 상태를 쿼리해야 하는 경우 작업 세부정보를 검색하여 인스턴스 업데이트가 완료되었는지 확인할 수 있습니다.

gcloud lustre operations describe OPERATION_ID \
  --location=ZONE

인스턴스가 업데이트되는 동안 응답에 done: false 값이 표시됩니다. 완료되면 done가 true로 설정됩니다.

예를 들면 다음과 같습니다.

$ gcloud lustre operations describe operation-1234567890-123abc456-789def012-a1b2c3d4 \
    --location=us-central1-a

done: false
metadata:
  '@type': type.googleapis.com/google.cloud.lustre.v1.OperationMetadata
  apiVersion: v1
  createTime: '2025-08-27T18:13:49.771203623Z'
  requestedCancellation: false
  target: projects/my-project/locations/us-central1-a/instances/my-instance
  verb: update
name: projects/my-project/locations/us-central1-a/operations/operation-1234567890-123abc456-789def012-a1b2c3d4

REST

업데이트 작업의 상태를 쿼리하려면 응답의 작업 ID를 사용합니다. 작업 ID의 형식은 다음과 같습니다.

  • operation-1234567890123-6127783ad26ea-88913969-02748053

다음 엔드포인트에 요청을 보냅니다.

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

요청이 성공하면 응답 본문에 Operation의 인스턴스가 포함됩니다.

용량 증가 후 성능

Managed Lustre 인스턴스의 최대 처리량은 스토리지 용량과 성능 등급에 따라 결정됩니다. 기존 인스턴스의 스토리지 용량을 늘리면 최대 처리량도 증가합니다.

새 데이터가 작성될 때까지 성능 향상이 표시되지 않을 수 있습니다. 새 데이터가 작성되고 추가 스토리지에 재배포됨에 따라 처리량 성능이 점진적으로 향상됩니다.

'기기에 남은 공간 없음' 오류

파일 시스템이 전체 용량에 가까워지면 (일반적으로 90% 이상 사용) 모니터링 도구에서 집계된 여유 공간이 아직 사용 가능하다고 표시되더라도 조기 No space left on device 또는 FILESYSTEM_NO_SPACE_ON_DEVICE (ENOSPC) 오류가 발생할 수 있습니다.

이 동작은 분산 파일 시스템의 여러 기본 메커니즘으로 인해 발생할 수 있습니다.

  • OST 불균형: Lustre는 여러 객체 스토리지 타겟 (OST)에 파일 데이터를 스트라이프합니다. 그러나 특정 워크로드 패턴은 스트라이핑 구성에 관계없이 단일 OST를 채울 수 있습니다. 일반적인 원인으로는 추가 모드 (O_APPEND)로 파일을 작성하거나 연결되지 않은 대용량 파일을 유지하는 것이 있습니다.

  • 확장 후 오류: 클러스터에 용량을 추가한 후에도 ENOSPC 오류가 계속 발생할 수 있습니다. 용량을 확장하면 새 OST가 추가되지만 기존 파일이 새로 추가된 대상으로 자동으로 재분산되지는 않습니다.

  • 클라이언트 공간 부여: Compute Engine 클라이언트는 성능 향상을 위해 디스크 공간의 일부를 동적으로 예약합니다. 이 예약된 부여 공간은 사용 가능한 물리적 풀을 줄입니다. 즉, 용량 측정항목이 분산 클라이언트가 이미 요청한 공간을 반영하지 않을 수 있습니다.

  • 아이노드 소진: 수백만 개의 파일을 생성하는 워크로드는 물리적 스토리지 한도에 도달하기 전에 파일 시스템의 사용 가능한 아이노드를 소진하여 새 파일 생성 시 ENOSPC 오류를 일으킬 수 있습니다.

권장 완화 전략:

  • 용량 모니터링 및 알림 설정: 집계된 클러스터 용량 외에도 OST별 용량 사용률과 개별 inode 측정항목을 모니터링합니다. 마운트된 클라이언트에서 lfs df 명령어를 실행하여 대상별 용량 사용량을 확인하고, 대상별 inode 사용량에 lfs df -i를 사용하거나, 모니터링 측정항목에 대한 자세한 내용은 인스턴스 및 작업 모니터링을 참조하세요.

    집계 용량 또는 개별 OST 사용률이 80%를 초과할 때 트리거되는 자동 알림을 설정합니다(스토리지 용량 알림 만들기 참조).

  • 용량 늘리기: 집계 용량이 80~90%에 도달하면 Managed Lustre 인스턴스의 용량을 늘리는 것이 좋습니다. 확장하기 전에 추가 할당량을 요청해야 할 수 있습니다.

  • 스토리지 재분산: lfs migrate 명령어를 사용하여(비차단 모드(-n) 권장) 과도하게 사용된 OST에서 비어 있거나 새로 추가된 OST로 파일을 수동으로 전환합니다.

  • 클라이언트에서 연결 해제된 파일 확인: 연결 해제된 열린 파일은 파일 시스템 네임스페이스에서 연결 해제된 후에도 프로세스에 의해 열린 상태로 유지되는 대용량 파일입니다. 이러한 분리된 파일은 디스크에 남아 공간을 차지하지만 표준 디렉터리 목록에는 표시되지 않습니다. 이 경우 Cloud Monitoring 용량 측정항목과 lfs df 명령어는 du 또는 lfs find보다 높은 공간 사용량을 보고합니다. 클라이언트에서 lsof 명령어를 사용하여 (deleted)로 표시된 항목을 찾아 이러한 파일을 식별합니다. 식별되면 파일 핸들을 보유한 프로세스를 종료하거나 애플리케이션을 다시 시작하여 파일 시스템 공간을 확보합니다.