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

IPv6 주소를 사용하는 인스턴스 만들기

기본적으로 Compute Engine 인스턴스는 IPv4 주소로 생성됩니다. 원하는 경우 IPv6 주소를 사용하는 컴퓨팅 인스턴스를 만들 수 있습니다. IPv4 및 IPv6 구성을 모두 포함하는 컴퓨팅 인스턴스를 이중 스택 인스턴스라고 합니다. IPv6 주소는 네트워크 인터페이스에 구성된 IPv4 주소에 추가로 제공됩니다.

인스턴스가 연결된 서브넷에 IPv6 범위가 구성된 경우 Compute Engine 인스턴스에서 IPv6 주소를 구성할 수 있습니다.

컴퓨팅 인스턴스의 모든 네트워크 인터페이스에 IPv6 주소를 구성할 수 있습니다. 다중 네트워크 인터페이스 구성에 관한 자세한 내용은 다중 네트워크 인터페이스를 참고하세요.

인스턴스의 네트워크 인터페이스의 스택 유형에 따라 연결할 수 있는 서브넷의 유형이 결정됩니다.

IPv4 전용 네트워크 인터페이스는 이중 스택 및 IPv4 전용 서브넷에 연결할 수 있습니다.
이중 스택 네트워크 인터페이스는 이중 스택 서브넷에 연결할 수 있습니다.
IPv6 전용 네트워크 인터페이스는 이중 스택 및 IPv6 전용 서브넷에 연결할 수 있습니다(미리보기).

또한 서브넷의 IPv6 액세스 유형 구성에 따라 서브넷에 내부 또는 외부 IPv6 범위가 포함되는지 결정됩니다. 연결된 인스턴스는 서브넷에서 IPv6 액세스 유형을 상속합니다.

IPv6 주소에 대한 자세한 내용은 IPv6 개요를 참고하세요.

제한사항

IPv6 전용 인스턴스 (미리보기)는 Ubuntu 및 Debian OS에서만 지원됩니다.

시작하기 전에

컴퓨팅 인스턴스를 만들기 전에 네트워크와 서브넷을 만들어야 합니다.
아직 인증을 설정하지 않았다면 설정합니다. 인증은 Google Cloud 서비스 및 API에 액세스하기 위해 ID를 확인하는 프로세스입니다. 로컬 개발 환경에서 코드 또는 샘플을 실행하려면 다음 옵션 중 하나를 선택하여 Compute Engine에 인증하면 됩니다.

Select the tab for how you plan to use the samples on this page:
Consolegcloud

When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
1. Install the Google Cloud CLI, then initialize it by running the following command:
  gcloud init
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. Set a default region and zone.

필요한 역할

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

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

이 태스크에 필요한 권한

이 태스크를 수행하려면 다음과 같은 권한이 있어야 합니다.

프로젝트에 대한 compute.instances.create 권한
커스텀 이미지를 사용하여 VM 만들기: 이미지에 대한 compute.images.useReadOnly 권한
스냅샷을 사용하여 VM 만들기: 스냅샷에 대한 compute.snapshots.useReadOnly 권한
인스턴스 템플릿을 사용하여 VM 만들기: 인스턴스 템플릿에 대한 compute.instanceTemplates.useReadOnly 권한
VM에 기존 네트워크 할당: 프로젝트에 대한 compute.networks.use 권한
VM의 고정 IP 주소 지정: 프로젝트에 대한 compute.addresses.use 권한
기존 네트워크 사용 시 VM에 외부 IP 주소 할당: 프로젝트에 대한 compute.networks.useExternalIp 권한
VM의 서브넷 지정: 프로젝트 또는 선택한 서브넷에 대한 compute.subnetworks.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 권한

이중 스택 인스턴스 만들기

내부 IPv4 주소와 외부 IPv6 주소로 인스턴스를 만들려면 컴퓨팅 인스턴스를 이중 스택 서브넷에 연결합니다.

공유 VPC를 사용하는 경우 공유 서브넷에 연결된 이중 스택 인스턴스를 만들려면 공유 VPC 문서의 인스턴스 만들기를 참고하세요.

콘솔 gcloud REST

인스턴스 만들기 페이지로 이동

인스턴스 만들기로 이동
메시지가 표시되면 프로젝트를 선택하고 계속을 클릭합니다. 인스턴스 만들기 페이지가 표시되고 머신 구성 창이 표시됩니다.
머신 구성 창에서 다음을 수행합니다.
1. 이름 필드에 인스턴스의 이름을 지정합니다. 자세한 내용은 리소스 이름 지정을 참고하세요.
2. 선택사항: 영역 필드에서 이 인스턴스의 영역을 선택합니다. IPv6 범위가 구성된 서브넷이 포함된 리전의 영역을 선택합니다.
3. 인스턴스의 머신 계열을 선택합니다. 그러면 Google Cloud 콘솔에 선택한 머신 계열에 사용할 수 있는 머신 시리즈가 표시됩니다. 다음과 같은 머신 계열 옵션을 사용할 수 있습니다.
  - 범용
  - 컴퓨팅 최적화
  - 메모리 최적화
  - 스토리지 최적화
  - GPU
4. 시리즈 열에서 인스턴스의 머신 시리즈를 선택합니다.
5. 머신 유형 섹션에서 인스턴스의 머신 유형을 선택합니다.
탐색 메뉴에서 네트워킹을 클릭합니다. 표시되는 네트워킹 창에서 다음을 수행합니다.
1. 네트워크 인터페이스 섹션에서 네트워크 인터페이스를 클릭하여 펼치고 수정합니다.
2. 네트워크 및 서브네트워크에서 IPv6 범위가 구성된 네트워크와 서브네트워크를 선택합니다.
3. IP 스택 유형에 IPv4 및 IPv6(이중 스택)을 선택합니다.
4. 기본 내부 IPv4 주소에서 다음 중 하나를 선택합니다.
  - 새 임시 IPv4 내부 주소를 할당하려면 임시를 선택합니다.
  - 기존 고정 외부 IP 주소를 할당하려면 목록에서 예약된 IPv4 주소의 이름을 선택합니다.
  - 새 고정 내부 IPv4 주소를 만들고 할당하려면 고정 내부 IPv4 주소 예약을 선택합니다.
5. 선택사항: 외부 IPv4 주소에 대해 다음 중 하나를 선택합니다.
  - 임시 외부 IPv4 주소를 할당하려면 임시를 선택합니다.
  - 외부 IPv4 주소 없이 인스턴스를 만들려면 없음을 선택합니다.
  - 기존 고정 외부 IP 주소를 할당하려면 목록에서 예약된 IPv4 주소의 이름을 선택합니다.
  - 새 고정 외부 IPv4 주소를 만들고 할당하려면 고정 외부 IPv4 주소 예약을 선택합니다.
6. 선택사항: 외부 IPv6 주소를 구성하려면 외부 IPv6 주소에서 다음 중 하나를 선택합니다.
  - 새 임시 외부 IPv6 주소를 할당하려면 자동 할당을 선택합니다.
  - 기존 고정 외부 IP 주소를 할당하려면 목록에서 예약된 IPv6 주소의 이름을 선택합니다.
  - 새 고정 외부 IPv6 주소를 만들고 할당하려면 고정 외부 IPv6 주소 예약을 선택합니다.
7. 네트워크 인터페이스 수정을 완료하려면 완료를 클릭합니다.
8. 선택사항: 네트워크 인터페이스를 추가로 구성하려면 네트워크 인터페이스 추가를 클릭하고 네트워킹 창에 대해 이전 단계를 반복합니다.
선택사항: 다른 구성 옵션을 지정합니다. 자세한 내용은 인스턴스 생성 중 구성 옵션을 참고하세요.
만들기를 클릭하여 인스턴스를 만들고 시작합니다.

gcloud compute instances create 명령어를 사용하여 인스턴스를 만듭니다.

gcloud compute instances create INSTANCE_NAME \
    --subnet=SUBNET_NAME \
    --zone=ZONE \
    --stack-type=IPV4_IPV6

다음을 바꿉니다.

INSTANCE_NAME: 인스턴스의 이름입니다.
SUBNET_NAME: 인스턴스를 연결할 서브넷입니다. 서브넷에 IPv6 서브넷 범위가 있어야 합니다.
ZONE: 인스턴스를 배포할 영역입니다.

이미지를 선택합니다. 이미지 이름 또는 이미지 계열과 이미지가 포함된 프로젝트의 이름을 기록해 둡니다.
instances.insert 메서드를 사용하여 이미지 계열 또는 특정 버전의 OS 이미지로 인스턴스를 만듭니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_ID: 인스턴스를 만들 프로젝트의 ID입니다.
- ZONE: 인스턴스를 만들 영역입니다.
- MACHINE_TYPE_ZONE: 커스텀 머신 유형을 사용하는 경우 새 인스턴스에 사용할 커스텀 머신 유형이 포함된 영역을 지정합니다. 그렇지 않으면 인스턴스를 만들 영역을 지정합니다.
- MACHINE_TYPE: 새 인스턴스의 머신 유형(사전 정의 또는 커스텀)(예: n4-standard-2)
- INSTANCE_NAME: 새 인스턴스의 이름
- REGION: 서브넷이 포함된 리전
- SUBNET: 이중 스택 서브넷
- IMAGE_PROJECT: 선택사항: 이미지가 포함된 이미지 프로젝트
- IMAGE: 선택사항: 다음 중 하나를 지정합니다.
  - OS 이미지의 특정 버전입니다(예: debian-12-bookworm-v20241009).
  - 이미지 계열이며 형식은 family/IMAGE_FAMILY여야 합니다. 이렇게 하면 지원 중단되지 않은 최신 OS 이미지를 사용하여 인스턴스가 생성됩니다. 예를 들어 family/debian-12를 지정하면 Compute Engine이 Debian 12 이미지 계열에서 최신 버전의 OS 이미지를 사용하여 인스턴스를 만듭니다. 이미지 계열 사용에 관한 자세한 내용은 이미지 계열 권장사항을 참고하세요.
HTTP 메서드 및 URL:
```
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances
```
JSON 요청 본문:
```
{
    "machineType": "zones/MACHINE_TYPE_ZONE/machineTypes/MACHINE_TYPE",
    "name": "INSTANCE_NAME",
    "networkInterfaces": [
      {
        "subnetwork": "regions/REGION/subnetworks/SUBNET",
        "stackType": "IPV4_IPV6"
      }
    ],
    "disks": [
      {
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        },
        "boot": true
      }
    ],
}
```
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
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/{api_version}/projects/`PROJECT_ID`/zones/`ZONE`",
  "operationType": "insert",
  "targetLink": "https://www.googleapis.com/compute/{api_version}/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/{api_version}/projects/`PROJECT_ID`/zones/`ZONE`/operations/operation-1565289606387-58f9f62f5989c-e582f586-6d22f38"
 "kind": "compute#operation"
}
```

IPv6 전용 인스턴스 만들기

IPv6 전용 인스턴스를 만들려면 이 섹션의 단계를 따르세요.

단일 네트워크 인터페이스가 있는 Compute Engine 인스턴스의 경우 인터페이스가 연결된 네트워크의 액세스 유형에 따라 인스턴스에 내부 또는 외부 IPv6 주소가 있을 수 있습니다. IPv6 주소 범위가 있는 서브넷으로 커스텀 모드 Virtual Private Cloud (VPC) 네트워크를 만들어야 합니다.

내부 및 외부 IPv6 주소를 모두 사용하는 다중 NIC VM 인스턴스를 만들려면 먼저 다음을 만들어야 합니다.

내부 네트워크 및 서브넷: IPv6 ULA가 사용 설정된 커스텀 모드 VPC 네트워크, IPv6 주소 범위가 있는 서브넷, 액세스 유형이 internal로 설정된 서브넷
외부 네트워크 및 서브넷: 두 번째 맞춤 모드 VPC 네트워크, IPv6 주소 범위가 있는 두 번째 서브넷, 액세스 유형이 external로 설정됨

인스턴스를 만들 때 내부 IPv6 주소 범위로 서브넷에 연결하는 네트워크 인터페이스와 외부 주소 범위로 서브넷에 연결하는 네트워크 인터페이스를 각각 하나씩 구성합니다.

공유 VPC를 사용하는 경우 공유 서브넷에 연결된 IPv6 전용 인스턴스를 만들려면 공유 VPC 문서의 인스턴스 만들기를 참고하세요.