이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Cloud RDMA를 사용하는 인스턴스 만들기

이 페이지에서는 RDMA 지원 네트워크 인터페이스를 사용하여 HPC 인스턴스를 만드는 방법을 설명합니다. RDMA를 사용하는 A4 또는 A3 Ultra 가속기 최적화 인스턴스를 만드는 방법은 A4 또는 A3 Ultra로 AI 최적화 인스턴스 만들기를 참고하세요.

원격 직접 메모리 액세스 (RDMA)를 사용하는 컴퓨팅 인스턴스를 만들려면 인스턴스를 만들 때 네트워크 인터페이스 (NIC)를 2개 이상 구성해야 합니다. 한 NIC는 RDMA 네트워크 프로필이 있는 VPC 네트워크에 연결되는 IRDMA NIC여야 하고 다른 NIC는 GVNIC를 사용해야 합니다.

머신 시리즈 비교 표를 사용하여 RDMA 네트워크 인터페이스를 지원하는 머신 시리즈를 확인합니다.

시작하기 전에

아직 설정하지 않았다면 인증을 설정합니다. 인증은 Google Cloud 서비스 및 API에 액세스하기 위해 ID를 확인합니다. 로컬 개발 환경에서 코드 또는 샘플을 실행하려면 다음 옵션 중 하나를 선택하여 Compute Engine에 인증하면 됩니다.
Select the tab for how you plan to use the samples on this page:
Console

When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
1. Google Cloud CLI를 설치합니다. 설치 후 다음 명령어를 실행하여 Google Cloud CLI를 초기화합니다.
  gcloud init
  외부 ID 공급업체(IdP)를 사용하는 경우 먼저 제휴 ID로 gcloud CLI에 로그인해야 합니다.
  
  참고: 이전에 gcloud CLI를 설치했으면 gcloud components update를 실행하여 최신 버전이 설치되어 있는지 확인하세요.
2. Set a default region and zone.
REST

로컬 개발 환경에서 이 페이지의 REST API 샘플을 사용하려면 gcloud CLI에 제공한 사용자 인증 정보를 사용합니다.
자세한 내용은 Google Cloud 인증 문서의 REST 사용을 위한 인증을 참조하세요.

필요한 역할

RDMA 통신을 지원하는 인스턴스를 만드는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 Compute 인스턴스 관리자 (v1) (roles/compute.instanceAdmin.v1) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이 사전 정의된 역할에는 RDMA 통신을 지원하는 인스턴스를 만드는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

필수 권한

RDMA 통신을 지원하는 인스턴스를 만들려면 다음 권한이 필요합니다.

프로젝트에 대한 compute.instances.create 권한
커스텀 이미지를 사용하여 VM 만들기: 이미지에 대한 compute.images.useReadOnly 권한
스냅샷을 사용하여 VM 만들기: 스냅샷에 대한 compute.snapshots.useReadOnly 권한
인스턴스 템플릿을 사용하여 VM 만들기: 인스턴스 템플릿에 대한 compute.instanceTemplates.useReadOnly 권한
VM의 서브넷 지정: 프로젝트 또는 선택한 서브넷에 대한 compute.subnetworks.use 권한
VM의 고정 IP 주소 지정: 프로젝트에 대한 compute.addresses.use 권한
VPC 네트워크를 사용할 때 VM에 외부 IP 주소 할당: 프로젝트 또는 선택한 서브넷에 대한 compute.subnetworks.useExternalIp 권한
VM에 VM 인스턴스 메타데이터 설정: 프로젝트에 대한 compute.instances.setMetadata 권한
VM에 태그 설정: VM에 대한 compute.instances.setTags 권한
VM에 라벨 설정: VM에 대한 compute.instances.setLabels 권한
VM에 사용할 서비스 계정 설정: VM에 대한 compute.instances.setServiceAccount 권한
VM의 새 디스크 만들기: 프로젝트에 대한 compute.disks.create 권한
기존 디스크를 읽기 전용 또는 읽기-쓰기 모드로 연결: 디스크에 대한 compute.disks.use 권한
기존 디스크를 읽기 전용 모드로 연결: 디스크에 대한 compute.disks.useReadOnly 권한

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

요구사항

인스턴스의 네트워크 인터페이스 구성에 관한 다음 규칙을 검토하세요.

각 네트워크 인터페이스는 서로 다른 Virtual Private Cloud 네트워크에 연결되어야 합니다.
IRDMA 네트워크 인터페이스를 구성하려면 먼저 인스턴스와 동일한 리전 및 영역에 Falcon RDMA 네트워크 프로필이 있는 VPC 네트워크를 만들어야 합니다.
네트워크나 서브넷을 지정하지 않으면 Compute Engine은 기본 VPC 네트워크 및 인스턴스와 동일한 리전에 있는 자동 서브넷을 사용합니다.
서브넷을 지정했지만 네트워크를 지정하지 않으면 Compute Engine은 지정된 서브넷에서 네트워크를 추론합니다.
네트워크를 지정하는 경우 서브넷을 지정해야 하며 서브넷은 동일한 네트워크에 속해야 합니다. 그렇지 않으면 인스턴스 생성에 실패합니다.

제한사항

내부 IP 통신용 Tier_1 네트워킹은 gVNIC 가상 네트워크 드라이버를 실행하는 VM과만 호환됩니다.
RDMA를 사용하는 VM에는 라이브 마이그레이션을 사용할 수 없습니다. 유지보수 이벤트 중에 종료되도록 인스턴스를 구성해야 합니다.
관리형 인스턴스 그룹 (MIG) (관리형 또는 비관리형)과 함께 RDMA를 사용할 수 없습니다.
RDMA 지원 인스턴스에는 IPv4_ONLY 네트워크 스택 유형만 사용할 수 있습니다.
H4D 머신 시리즈만 사용하여 Cloud RDMA를 사용하는 인스턴스를 만들 수 있습니다.

Cloud RDMA 지원 인스턴스 만들기

Cloud RDMA 지원 인스턴스에는 최소 2개의 네트워크 인터페이스 (NIC)가 필요합니다.

NIC 유형 GVNIC: 일반 VM-VM 및 VM-인터넷 통신을 위해 TCP/IP 및 인터넷 트래픽에 gve 드라이버를 사용합니다.
NIC 유형 IRDMA: 인스턴스 간 RDMA 기반 통신에 IDPF/iRDMA 드라이버를 사용합니다.

인스턴스에는 IRDMA 인터페이스가 하나만 있을 수 있습니다. 각 인스턴스는 1~10개의 네트워크 인터페이스를 가질 수 있습니다.

IRDMA를 사용하는 인스턴스를 만들려면 다음 섹션의 단계를 완료하세요.

적합한 배치 정책이 없으면 배치 정책을 만듭니다.
새 VPC 네트워크를 만들거나 기존 RDMA 지원 VPC 네트워크를 사용합니다.
IRDMA 네트워크 인터페이스와 하나 이상의 GVNIC 네트워크 인터페이스가 있고 압축 배치 정책을 사용하는 RDMA 지원 인스턴스를 만듭니다.

RDMA 인스턴스용 배치 정책 만들기

RDMA를 사용하여 통신하는 인스턴스는 단일 영역에 있어야 하며, 단일 클러스터 패브릭 내에 있어야 합니다. 압축 배치 정책을 만들고 최대 거리 값을 지정하여 영역 내 최소 압축을 설정할 수 있습니다. 최대 거리 값을 지정할 때 압축 배치 정책을 할당할 수 있는 인스턴스 수에는 제한이 있으며, 선택한 값에 따라 제한이 달라집니다.

RDMA 인스턴스와 함께 사용할 압축 배치 정책을 만들려면 압축 배치 정책 만들기의 단계를 따르고 최대 거리 값을 3 이하로 지정하세요.

가상 프라이빗 클라우드 네트워크 만들기

네트워크를 설정하려면 문서화된 안내를 따르거나 제공된 스크립트를 사용하면 됩니다.

안내 가이드

네트워크를 만들려면 다음 안내를 수행하면 됩니다.

GVNIC 네트워크 인터페이스의 호스트 네트워크를 만들려면 VPC 네트워크 만들기 및 관리를 참고하세요.

GVNIC 네트워크 인터페이스를 하나만 구성하는 경우 기본 VPC 네트워크와 인스턴스와 동일한 리전에 있는 자동 서브넷을 사용할 수 있습니다.
IRDMA 네트워크 인터페이스용 네트워크를 만들려면 RDMA 네트워크 프로필이 있는 VPC 네트워크 만들기를 참고하세요. RDMA 네트워크의 최대 전송 단위 (MTU)를 8896로 설정합니다.

스크립트

네트워크를 만들려면 다음 스크립트를 사용하면 됩니다.

선택사항: 스크립트를 실행하기 전에 RDMA 네트워크 프로필을 나열하여 사용할 수 있는지 확인합니다.
```
gcloud beta compute network-profiles list
```
다음 코드를 복사하여 Linux 셸 창에서 실행합니다.

#!/bin/bash

# Create standard VPC (network and subnet) for the GVNIC interface
  gcloud beta compute networks create GVNIC_NAME_PREFIX-net-0 \
    --subnet-mode=custom

  gcloud beta compute networks subnets create GVNIC_NAME_PREFIX-sub-0 \
    --network=GVNIC_NAME_PREFIX-net-0 \
    --region=REGION \
    --range=10.0.0.0/16

  gcloud beta compute firewall-rules create GVNIC_NAME_PREFIX-internal-0 \
    --network=GVNIC_NAME_PREFIX-net-0 \
    --action=ALLOW \
    --rules=tcp:0-65535,udp:0-65535,icmp \
    --source-ranges=10.0.0.0/8

# Create SSH firewall rules
gcloud beta compute firewall-rules create GVNIC_NAME_PREFIX-ssh \
  --network=GVNIC_NAME_PREFIX-net-0 \
  --action=ALLOW \
  --rules=tcp:22 \
  --source-ranges=IP_RANGE

# Optional: Create an external IP for only the GVNIC interface
gcloud beta compute firewall-rules create GVNIC_NAME_PREFIX-allow-ping-net-0 \
  --network=GVNIC_NAME_PREFIX-net-0 \
  --action=ALLOW \
  --rules=icmp \
  --source-ranges=IP_RANGE

# Create network for RDMA over Falcon transport
gcloud beta compute networks create RDMA_NAME_PREFIX-irdma \
  --network-profile=ZONE-vpc-falcon \
  --subnet-mode custom

# Create subnet for RDMA
gcloud beta compute networks subnets create RDMA_NAME_PREFIX-irdma-sub \
    --network=RDMA_NAME_PREFIX-irdma \
    --region=REGION \
    --range=10.1.0.0/16  # offset to avoid overlap with GVNIC network

다음을 바꿉니다.

GVNIC_NAME_PREFIX: GVNIC NIC 유형을 사용하는 표준 Virtual Private Cloud 네트워크 및 서브넷에 사용할 이름 프리픽스
RDMA_NAME_PREFIX: IRDMA NIC 유형을 사용하는 Virtual Private Cloud 네트워크 및 서브넷에 사용할 이름 프리픽스
ZONE: 네트워크와 컴퓨팅 인스턴스를 만들 영역입니다. us-central1-a 또는 europe-west4-b를 사용합니다.
REGION: 네트워크를 만들려는 리전입니다. 이 리전은 지정된 영역과 일치해야 합니다. 예를 들어 영역이 europe-west4-b이면 리전은 europe-west4입니다.
IP_RANGE: SSH 방화벽 규칙에 사용할 VPC 네트워크 외부의 IP 주소 범위입니다. 권장사항으로는 모든 IPv4 또는 IPv6 소스 대신 액세스를 허용해야 하는 특정 IP 주소 범위를 지정하는 것이 좋습니다. 0.0.0.0/0 또는 ::/0을 소스 범위로 사용하지 마세요.Google Cloud외부 소스를 포함한 모든 IPv4 또는 IPv6 소스의 트래픽이 허용되기 때문입니다.

RDMA 지원 인스턴스 만들기

다음 단계에서는 첫 번째 네트워크 인터페이스가 gVNIC 인터페이스로 구성되고 두 번째 네트워크 인터페이스가 IRDMA 네트워크 인터페이스로 구성된 인스턴스를 만드는 방법을 보여줍니다.

콘솔

Google Cloud 콘솔에서 인스턴스 만들기 페이지로 이동합니다.

인스턴스 만들기로 이동

메시지가 표시되면 프로젝트를 선택하고 계속을 클릭합니다.

인스턴스 만들기 페이지가 나타나고 머신 구성 창이 표시됩니다.
머신 구성 창에서 다음을 수행합니다.
1. 이름 필드에 인스턴스 이름을 지정합니다. 자세한 내용은 리소스 이름 지정 규칙을 참조하세요.
2. 선택사항: 영역 필드에서 이 인스턴스의 영역을 선택합니다.
  
  RDMA 네트워크 프로필을 설정하는 데 사용한 영역을 선택합니다.
3. 컴퓨팅 최적화 머신 계열을 선택합니다.
4. 시리즈 열에서 H4D 머신 시리즈를 선택합니다.
5. 머신 유형 섹션에서 인스턴스의 머신 유형을 선택합니다.
왼쪽 탐색 메뉴에서 OS 및 스토리지를 클릭합니다. 표시되는 운영체제 및 스토리지 창에서 다음을 수행합니다.
1. 운영체제 및 스토리지 섹션 하단에서 변경을 클릭합니다.
2. 운영체제 및 버전 목록에서 RDMA를 지원하는 OS 유형과 버전을 선택합니다.
3. 부팅 디스크 유형이 Hyperdisk Balanced로 설정되어 있는지 확인합니다.
4. 창 하단에 있는 선택을 클릭하여 변경사항을 저장합니다.
왼쪽 탐색 메뉴에서 네트워킹을 클릭합니다. 네트워킹 창이 표시되면 다음을 수행합니다.
1. 네트워크 인터페이스 섹션으로 이동합니다. default로 라벨이 지정된 네트워크 인터페이스가 이미 있어야 합니다.
2. 네트워크 인터페이스 추가를 클릭합니다. 표시되는 새 네트워크 인터페이스 섹션에서 다음을 수행합니다.
  1. 네트워크 인터페이스 카드 목록에서 IRDMA를 선택합니다.
  2. 네트워크 필드에서 RDMA 네트워크 프로필이 있는 VPC 네트워크를 선택합니다.
  3. (선택사항) 서브네트워크 목록에서 인스턴스가 사용할 서브넷을 선택합니다.
  4. IP 스택 유형 필드가 IPV4 전용으로 설정되어 있는지 확인합니다.
  5. 외부 IPv4 주소 목록에서 없음을 선택합니다.
  6. 네트워크 인터페이스 세부정보를 확인하려면 완료를 클릭합니다.
선택사항: 인스턴스의 다른 구성 옵션을 지정합니다. 자세한 내용은 인스턴스 생성 중 구성 옵션을 참고하세요.
만들기를 클릭하여 인스턴스를 만들고 시작합니다.

gcloud

In the Google Cloud console, activate Cloud Shell.

Activate Cloud Shell

At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
GVNIC 인터페이스용 --network-interface 플래그 하나와 IRDMA 인터페이스용 --network-interface 플래그 하나 등 최소 두 개의 --network-interface 플래그와 함께 gcloud compute instances create 명령어를 사용합니다. 필요에 따라 나머지 명령어 옵션을 맞춤설정할 수 있습니다.

참고: gVNIC 네트워크 인터페이스에는 내부 IPv6 주소와 외부 IPv6 주소 중 하나만 있을 수 있지만 둘 다 있을 수는 없습니다. RDMA 네트워크 인터페이스는 IPv4 주소만 사용할 수 있습니다.
```
gcloud compute instances create INSTANCE_NAME \
    --zone=ZONE \
    --machine-type=MACHINE_TYPE \
    --create-disk=boot=yes, \
        image=projects/IMAGE_PROJECT/global/images/IMAGE, \
        size=SIZE \
    --maintenance-policy=TERMINATE \
    --network-interface \
        nic-type=GVNIC, \
        network=NETWORK_NAME,subnet=SUBNET_NAME, \
        stack-type=STACK_TYPE, \
        private-network-ip=INTERNAL_IPV4_ADDRESS, \
        address=EXTERNAL_IPV4_ADDRESS \
    --network-interface \
        nic-type=IRDMA, \
        network=RDMA_NETWORK_NAME,subnet=RDMA_SUBNET_NAME, \
        stack-type=IPV4_ONLY, \
        no-address \
```
다음을 바꿉니다.
- INSTANCE_NAME: 컴퓨팅 인스턴스의 이름
- ZONE: 인스턴스가 생성되는 영역(예: europe-west1-b). 인스턴스의 리전은 영역에서 추론됩니다.
- MACHINE_TYPE: 선택사항: 인스턴스에 사용할 머신 유형
- IMAGE_PROJECT: 선택사항: 이미지가 포함된 이미지 프로젝트입니다. 미리보기 기간에는 커스텀 이미지 또는 HPC VM 이미지를 사용하세요.
- IMAGE: (선택사항) 다음 중 하나를 지정합니다.
  - OS 이미지의 특정 버전입니다(예: hpc-rocky-linux-8-v20250721).
  - 이미지 계열이며 형식은 family/IMAGE_FAMILY여야 합니다. 이렇게 하면 지원 중단되지 않은 최신 OS 이미지를 사용하여 인스턴스가 생성됩니다. 예를 들어 family/hpc-rocky-linux-8를 지정하면 Compute Engine이 HPC Rocky Linux 8 이미지 계열에서 최신 버전의 OS 이미지를 사용하여 인스턴스를 만듭니다. 이미지 계열 사용 방법에 대한 자세한 내용은 이미지 계열 권장사항을 참조하세요.
- SIZE: 선택사항: 새 디스크 크기입니다. 값은 정수여야 합니다. 기본 측정 단위는 GiB입니다.
- NETWORK_NAME: 선택사항: 네트워크 이름
- SUBNET_NAME: 네트워크 인터페이스에 사용할 서브넷의 이름입니다. 네트워크의 서브넷 목록을 보려면 gcloud compute networks subnets list 명령어를 사용합니다.
  
  GVNIC 네트워크 인터페이스의 경우 network 및 subnet 플래그를 생략하고 default 네트워크를 대신 사용할 수 있습니다.
- STACK_TYPE: 선택사항: GVNIC 네트워크 인터페이스의 스택 유형입니다. STACK_TYPE는 IPV4_ONLY, IPV4_IPV6, IPV6_ONLY 중 하나여야 합니다. 기본값은 IPV4_ONLY입니다.
- INTERNAL_IPV4_ADDRESS: 선택사항: 컴퓨팅 인스턴스가 대상 서브넷에서 사용할 내부 IPv4 주소입니다. 특정 IP 주소가 필요하지 않으면 이 플래그를 생략합니다.
  
  내부 IPv6 주소를 지정하려면 --internal-ipv6-address 플래그를 대신 사용하세요.
- EXTERNAL_IPV4_ADDRESS: 선택사항: 네트워크 인터페이스에 사용할 고정 외부 IPv4 주소입니다. 이전에 외부 IPv4 주소를 예약했어야 합니다. 다음 중 하나를 수행합니다.
  - 서브넷에서 유효한 IPv4 주소를 지정합니다.
  - 네트워크 인터페이스에 외부 IP 주소를 갖지 않도록 하려면 대신 no-address 플래그를 사용하세요.
  - 인터페이스에 임시 외부 IP 주소가 수신되도록 하려면 address=''를 지정합니다.
  외부 IPv6 주소를 지정하려면 --external-ipv6-address 플래그를 대신 사용하세요.
- RDMA_NETWORK_NAME: RDMA 네트워크 프로필로 만든 네트워크의 이름입니다.
- RDMA_SUBNET_NAME: RDMA 네트워크의 서브넷 이름입니다.

REST

RDMA를 사용하도록 구성된 인스턴스를 만들려면 instances.insert 메서드에 POST 요청을 보냅니다. gVNIC 인터페이스용과 IRDMA 인터페이스용 등 네트워크 구성이 두 개 이상인 networkInterfaces 객체를 포함합니다. 필요에 따라 나머지 인스턴스 속성을 맞춤설정할 수 있습니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

PROJECT_ID: 인스턴스를 만들 프로젝트의 ID
ZONE: 인스턴스를 만들 영역입니다.
MACHINE_TYPE: 사용할 머신 유형(예: h4d-highmem-192-lssd)
INSTANCE_NAME: 새 컴퓨팅 인스턴스 이름
IMAGE_PROJECT: 선택사항: 이미지가 포함된 이미지 프로젝트
IMAGE: (선택사항) 다음 중 하나를 지정합니다.
- OS 이미지의 특정 버전입니다(예: debian-12-bookworm-v20250415).
- 이미지 계열이며 형식은 family/IMAGE_FAMILY여야 합니다. 이렇게 하면 지원 중단되지 않은 최신 OS 이미지를 사용하여 인스턴스가 생성됩니다. 예를 들어 family/debian-12를 지정하면 Compute Engine은 Debian 12 이미지 계열에서 최신 버전의 OS 이미지를 사용하여 인스턴스를 만듭니다. 이미지 계열 사용에 대한 자세한 내용은 이미지 계열 권장사항을 참조하세요.
NETWORK_NAME: 선택사항: gVNIC 네트워크 인터페이스와 함께 사용할 네트워크의 이름
SUBNET_NAME: gVNIC 네트워크 인터페이스와 함께 사용할 서브넷의 이름

GVNIC 네트워크 인터페이스의 경우 network 및 subnet 속성을 생략하고 default 네트워크를 대신 사용할 수 있습니다.
INTERNAL_IPV4_ADDRESS: 선택사항: 컴퓨팅 인스턴스가 대상 서브넷에서 사용할 내부 IPv4 주소입니다. 특정 IP 주소가 필요하지 않으면 이 플래그를 생략합니다.
EXTERNAL_IPV4_ADDRESS: 선택사항: 네트워크 인터페이스에 사용할 고정 외부 IPv4 주소입니다. 이전에 외부 IPv4 주소를 예약했어야 합니다.
RDMA_NETWORK_NAME: RDMA 네트워크 프로필로 만든 네트워크의 이름
RDMA_SUBNET_NAME: RDMA 네트워크의 서브넷 이름

HTTP 메서드 및 URL:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances

JSON 요청 본문:

{
    "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE",
    "name": "INSTANCE_NAME",
    "disks": [
      {
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        },
        "boot": true
      }
    ],
    "networkInterfaces": [
      {
        "network": "NETWORK_NAME",
        "subnetwork": "SUBNET_NAME",
        "networkIP": "INTERNAL_IPV4_ADDRESS",
        "accessConfigs": [
          {
            "type": "ONE_TO_ONE_NAT",
            "name": "External IP",
            "natIP": "EXTERNAL_IPV4_ADDRESS"
          }
        ],
        "stackType": "IPV4_ONLY",
        "nicType": "GVNIC",
      },
      {
        "network": "RDMA_NETWORK_NAME",
        "subnetwork": "RDMA_SUBNET_NAME",
        "stackType": "IPV4_ONLY",
        "nicType": "IRDMA",
      }
    ]
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances"

PowerShell(Windows)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "kind": "compute#operation",
  "id": "9216044482154695709",
  "name": "operation-1739207409646-62dccc7d7bc58-d1350b42-64fdb7f7",
  "zone": "https://www.googleapis.com/compute/v1/projects/`PROJECT_ID`/zones/`ZONE`",
  "operationType": "insert",
  "targetLink": "https://www.googleapis.com/compute/v1/projects/`PROJECT_ID`/zones/`ZONE`/instances/`INSTANCE_NAME`",
  "targetId": "2679381553616227357",
  "status": "RUNNING",
  "user": "USER_ID",
  "progress": 0,
  "insertTime": "2025-02-10T09:10:10.551-08:00",
  "startTime": "2025-02-10T09:10:10.551-08:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/`PROJECT_ID`/zones/`ZONE`/operations/operation-1565289606387-58f9f62f5989c-e582f586-6d22f38"
 "kind": "compute#operation"
}

다음 단계

인스턴스 상태를 확인하여 사용 준비가 되었는지 확인하는 방법 알아보기
인스턴스 연결 방법 알아보기
인스턴스를 만들 때 할당되는 IP 주소에 대해 알아봅니다.
이중 스택 또는 IPv6 전용 인스턴스를 만드는 방법을 알아봅니다.

Cloud RDMA를 사용하는 인스턴스 만들기 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

시작하기 전에

Console

gcloud

REST

필요한 역할

필수 권한

요구사항

제한사항

Cloud RDMA 지원 인스턴스 만들기

RDMA 인스턴스용 배치 정책 만들기

가상 프라이빗 클라우드 네트워크 만들기

안내 가이드

스크립트

RDMA 지원 인스턴스 만들기

콘솔

gcloud

REST

cURL(Linux, macOS, Cloud Shell)

PowerShell(Windows)

다음 단계

Cloud RDMA를 사용하는 인스턴스 만들기