Managed Lustre 인스턴스 만들기

Google Cloud Managed Lustre 인스턴스는 클라우드의 완전한 Lustre 파일 시스템입니다. Compute Engine VM 또는 Kubernetes Engine 클러스터에 마운트할 수 있습니다. 표준 POSIX 용어를 사용하여 인스턴스의 데이터에 액세스합니다.

Managed Lustre 인스턴스를 만들 때는 다음 속성을 정의해야 합니다.

• Google Cloud에서 사용하는 인스턴스의 이름입니다.
• 클라이언트 측 도구(예: lfs)에서 사용하는 파일 시스템 이름입니다.
• 스토리지 용량(기비바이트, GiB)입니다. 용량은 9,000GiB에서 12,240,000GiB (11.67PiB)까지 가능합니다. 인스턴스의 최대 크기는 성능 등급에 따라 달라집니다.
• 성능 등급입니다. Managed Lustre는 TiB당 125MBps에서 1,000MBps까지의 성능 등급을 제공합니다.
• 위치입니다. 최상의 성능을 위해 클라이언트 VM 또는 GKE 클러스터와 동일한 영역에 인스턴스를 배치하세요.
• 이 인스턴스의 VPC 네트워크입니다. VM 또는 클러스터에 사용된 네트워크와 동일해야 합니다.
• Kubernetes Engine (GKE) 클러스터에서 이 인스턴스에 액세스할지 여부입니다. Lustre와 GKE는 기본적으로 포트 988을 사용하므로 이 설정은 충돌을 방지하기 위해 Lustre 포트를 변경합니다.

성능 등급 및 최대 스토리지 용량

Managed Lustre는 4가지 성능 등급을 제공하며, 각 등급은 TiB당 최대 처리 속도가 다릅니다. 성능 등급은 최소 및 최대 인스턴스 크기와 허용되는 용량 증가 단위에도 영향을 줍니다.

등급	최소 용량	최대 용량	보폭
TiB당 125MBps	72,000GiB	12,240,000 GiB (11.67 PiB)	72,000GiB
TiB당 250MBps	36,000GiB	6,120,000 GiB (5.84 PiB)	36,000GiB
TiB당 500MBps	18,000GiB	3,060,000 GiB (2.92 PiB)	18,000GiB
TiB당 1,000MBps	9,000GiB	1,530,000 GiB (1.46 PiB)	9,000GiB

인스턴스를 만든 후에는 인스턴스의 성능 등급을 변경할 수 없습니다.

중요: 사용 가능한 스토리지 용량 할당량은 인스턴스 위치, 요청된 성능 등급 등 여러 요인에 따라 달라집니다. 프로젝트와 위치에 사용 가능한 할당량이 있는 경우 기본적으로 TiB당 500MBps 성능 등급에 적용됩니다. 프로젝트에 사용 가능한 할당량이 없거나 할당량이 부족하거나 TiB당 125MBps, TiB당 250MBps 또는 TiB당 1,000MBps 등급을 사용하려면 추가 할당량을 요청해야 합니다.

필수 권한

새 Managed Lustre 인스턴스를 만들려면 프로젝트에 대한 Managed Lustre 관리자 (roles/lustre.admin) IAM 권한이 있어야 합니다.

자세한 내용은 IAM으로 액세스 제어를 참고하세요.

Managed Lustre API를 사용 설정해야 합니다.

인스턴스 만들기

다음 인터페이스에서 새 Managed Lustre 인스턴스를 만들 수 있습니다.

gcloud

새 Managed Lustre 인스턴스를 만들려면 gcloud lustre instances create 명령어를 사용합니다.

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

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

• INSTANCE_ID은 이 Managed Lustre 인스턴스의 이름입니다. 다음과 같아야 합니다.

  • 소문자, 숫자, 하이픈만 포함해야 합니다.
  • 문자로 시작해야 합니다.
  • 1~63자(영문 기준)
  • 숫자 또는 문자로 끝나야 합니다.
  • 프로젝트 및 위치 내에서 고유해야 합니다.

• --per-unit-storage-throughput은 TiB당 MBps 단위의 인스턴스 최대 처리량입니다. 유효한 값은 125, 250, 500, 1000입니다. 처리량 선택은 인스턴스의 최소 및 최대 스토리지 용량에 영향을 미칩니다.

• --capacity-gib는 기비바이트(GiB)로 표현된 인스턴스의 스토리지 용량입니다. 허용되는 값은 지정한 스토리지 처리량 등급에 따라 다릅니다. 자세한 내용은 성능 등급 및 최대 스토리지 용량 섹션을 참고하세요.

• --filesystem은 이 Lustre 파일 시스템에 할당할 이름입니다. 이 이름은 mount 및 lfs을 비롯한 클라이언트 측 명령어에서 사용됩니다. 길이가 8자 이하여야 하며, 문자 또는 숫자만 포함할 수 있고, 대소문자를 구분합니다.

  VPC의 모든 관리형 Lustre 인스턴스에서 고유한 이름을 선택하는 것이 좋습니다. 이렇게 하면 단일 GKE 노드에서 여러 인스턴스를 사용할 수 있습니다.

• --location은 Managed Lustre에서 지원하는 유효한 Google Cloud 영역이어야 합니다. 전체 목록은 지원되는 위치를 참고하세요.

• --network은 인스턴스가 속한 VPC 네트워크의 전체 경로이며 projects/PROJECT_ID/global/networks/NETWORK 형식입니다. VPC 네트워크 구성을 참고하세요.

• --project는 Google Cloud 프로젝트 ID입니다.

선택적 플래그는 다음과 같습니다.

• --kms-key-name는 이 인스턴스를 암호화할 고객 관리 암호화 키를 지정합니다. 자세한 내용은 관리형 Lustre의 고객 관리 암호화 키를 참고하세요.

• --gke-support-enabled는 Google Kubernetes Engine 클러스터에서 사용할 수 있는 인스턴스를 만듭니다. Lustre LNet accept_port을 6988로 설정합니다.

  --gke-support-enabled가 지정된 경우 Compute Engine VM에서 연결하려면 VM의 LNet 구성 파일을 업데이트해야 합니다. gke-support-enabled 인스턴스용 LNet 구성을 참고하세요.

• --async (선택사항) 명령어를 비동기식으로 실행합니다. 인스턴스 생성이 완료될 때까지 기다리는 대신 Google Cloud CLI는 명령어의 상태를 쿼리하는 데 사용할 수 있는 작업 ID를 반환합니다.

요청이 성공하면 작업 ID가 반환됩니다.

Create request issued for: [$INSTANCE_ID]
Waiting for operation [projects/$PROJECT_ID/locations/us-central1-a/operations/
operation-1234567890-609d21deae6f0-befaf0bc-867b1aa1] to complete...

인스턴스 생성에는 9,000GiB 용량의 인스턴스의 경우 약 15분, 12,240,000GiB (11.67PiB) 용량의 인스턴스의 경우 최대 1시간이 걸립니다. 요청 상태를 확인하는 방법은 인스턴스 생성 상태 쿼리를 참고하세요.

REST

REST API를 사용하여 인스턴스를 만들려면 다음 엔드포인트로 요청을 보냅니다.

POST https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances?instanceId=INSTANCE_ID
Authorization: Bearer AUTH_TOKEN
{
  "filesystem": string,
  "perUnitStorageThroughput": int64,
  "capacityGib": int64,
  "network": string,
  "gkeSupportEnabled": boolean
}

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

• PROJECT_ID는 Google Cloud 프로젝트 ID입니다.

• ZONE은 Managed Lustre에서 지원하는 유효한 Google Cloud 영역이어야 합니다. 전체 목록은 지원되는 위치를 참고하세요.

• INSTANCE_ID은 이 관리형 Lustre 인스턴스의 이름입니다. 다음과 같아야 합니다.

  • 소문자, 숫자, 하이픈만 포함해야 합니다.
  • 문자로 시작해야 합니다.
  • 1~63자(영문 기준)
  • 숫자 또는 문자로 끝나야 합니다.
  • 프로젝트 및 위치 내에서 고유해야 합니다.

• filesystem은 이 Lustre 파일 시스템에 할당할 이름입니다. 이 이름은 mount 및 lfs을 비롯한 클라이언트 측 명령어에서 사용됩니다. 길이가 8자 이하여야 하며, 문자 또는 숫자만 포함할 수 있고, 대소문자를 구분합니다.

  VPC의 모든 Managed Lustre 인스턴스에서 고유한 파일 시스템 이름을 선택하는 것이 좋습니다. 이렇게 하면 단일 GKE 노드에서 여러 인스턴스를 사용할 수 있습니다.

• perUnitStorageThroughput은 TiB당 MBps 단위의 인스턴스 최대 처리량입니다. 유효한 값은 125, 250, 500, 1000입니다. 처리량 선택은 인스턴스의 최소 및 최대 스토리지 용량에 영향을 미칩니다.

• capacityGib는 기비바이트(GiB)로 표현된 인스턴스의 스토리지 용량입니다. 허용되는 값은 지정한 스토리지 처리량 등급에 따라 다릅니다. 자세한 내용은 성능 등급 및 최대 스토리지 용량 섹션을 참고하세요.

• network는 인스턴스가 속한 VPC 네트워크의 전체 경로이며 projects/PROJECT_ID/global/networks/NETWORK 형식입니다. VPC 네트워크 구성을 참고하세요.

다음 필드는 선택사항입니다.

• kmsKey는 이 인스턴스를 암호화할 고객 관리 암호화 키를 지정합니다. 자세한 내용은 관리형 Lustre의 고객 관리 암호화 키를 참고하세요.

• gkeSupportEnabled는 이 인스턴스를 Google Kubernetes Engine 클러스터에서 사용할 수 있음을 지정합니다. Lustre LNet accept_port을 6988로 설정합니다.

  gkeSupportEnabled가 지정된 경우 Compute Engine VM에서 연결하려면 VM의 LNet 구성 파일을 업데이트해야 합니다. gke-support-enabled 인스턴스용 LNet 구성을 참고하세요.

API는 인스턴스에 대한 추가 선택적 필드를 지원합니다. 전체 목록과 설명은 Instance 리소스 참조 문서를 참고하세요.

Google Cloud 콘솔

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

   Managed Lustre로 이동

2. 만들기를 클릭합니다. 인스턴스 만들기 페이지가 표시됩니다.

3. 고유한 인스턴스 이름과 설명(선택사항)을 입력합니다. 인스턴스 이름은 Google Cloud 에서 이 인스턴스를 식별하는 데 사용됩니다.

4. 파일 시스템 이름을 입력합니다. 이 이름은 lfs와 같은 클라이언트 측 도구에서 사용됩니다. 길이가 8자 이하여야 하며, 문자 또는 숫자만 포함할 수 있고, 대소문자를 구분합니다.

5. 이 인스턴스를 만들 리전과 영역을 선택합니다. 인스턴스는 연결될 Compute Engine VM 또는 Google Kubernetes Engine 클러스터와 동일한 리전 및 영역에 배치해야 합니다.

6. 이 인스턴스의 성능 등급을 선택합니다.

7. 인스턴스의 스토리지 용량 (기비바이트, GiB)을 지정합니다. 유효한 값은 선택한 스토리지 처리량 등급에 따라 달라집니다. 자세한 내용은 성능 등급 및 최대 스토리지 용량 섹션을 참고하세요.

8. 암호화 섹션에서 Google 관리 암호화 키 또는 Cloud Key Management Service 키를 선택합니다. Cloud Key Management Service 키 옵션에 대한 자세한 내용은 관리 Lustre용 고객 관리 암호화 키를 참고하세요.

9. GKE 클러스터에서 이 인스턴스에 연결하는 경우 GKE 지원 사용 설정을 선택합니다. 이 옵션은 Lustre LNet accept_port를 6988로 설정합니다.

   GKE 지원 사용 설정이 지정된 경우 Compute Engine VM에서 연결하려면 VM의 LNet 구성 파일을 업데이트해야 합니다. gke-support-enabled 인스턴스용 LNet 구성을 참고하세요.

10. VPC 네트워크 만들기에서 만든 네트워크를 선택합니다.

페이지의 요약 섹션이 업데이트되어 선택한 항목을 기준으로 비용 추정치가 표시됩니다.

계속하려면 제출을 클릭하세요. 인스턴스 생성 프로세스는 인스턴스 용량에 따라 15분에서 1시간이 걸립니다.

인스턴스 생성 상태 쿼리

다음 인터페이스에서 생성 요청의 상태를 쿼리할 수 있습니다.

gcloud

생성 작업의 상태를 쿼리하려면 작업 또는 인스턴스를 가져오면 됩니다.

인스턴스를 가져오려면 다음 단계를 따르세요.

gcloud lustre instances describe INSTANCE_NAME \
  --location=ZONE

생성 상태는 state의 값입니다.

작업을 가져오려면 인스턴스 생성 응답의 작업 ID를 사용하세요. 작업 ID의 형식은 다음과 같습니다.

• operation-1234567890123-6127783ad26ea-88913969-02748053

gcloud lustre operations describe OPERATION_ID \
  --location=LOCATION

생성 상태는 done의 값입니다.

인스턴스가 생성되면 인스턴스에 대한 가져오기 요청의 결과는 다음 응답과 비슷합니다.

mountPoint 필드의 IP 주소와 파일 시스템 이름을 기록해 둡니다. 인스턴스를 마운트할 때 이 값이 필요합니다.

capacityGib: '27000'
createTime: '2025-03-14T00:07:34.308574307Z'
filesystem: lustre-fs
mountPoint: 10.115.0.3@tcp:/testfs
name: projects/$PROJECT/locations/us-central1-a/instances/$INSTANCE_NAME
network: projects/$PROJECT/global/networks/default
state: ACTIVE
updateTime: '2025-03-14T00:15:37.101024263Z'

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의 인스턴스가 포함됩니다.

Google Cloud 콘솔

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

   Managed Lustre로 이동

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

다음 단계

• Compute Engine 클라이언트에서 연결
• Google Kubernetes Engine에서 연결