서브네트워크 만들기 및 관리

이 페이지에서는 Distributed Cloud 영역에서 Google Distributed Cloud 서브넷 리소스를 만들고 관리하는 방법을 설명합니다.

Distributed Cloud 서브네트워크에 대한 자세한 내용은 Distributed Cloud 작동 방식을 참고하세요.

다음 사항에 유의하세요.

  • 각 네트워크 내에서 최대 20개의 서브네트워크를 만들 수 있습니다.
  • 서브네트워크는 상위 네트워크 내의 VLAN입니다. 따라서 각 서브넷에는 전역적으로 고유한 VLAN ID가 있어야 합니다. Distributed Cloud에서는 VLAN ID의 재사용이 허용되지 않습니다.
  • Distributed Cloud에서 사용되지 않은 VLAN ID를 무작위로 할당하도록 하려면 서브넷을 만들 때 0를 VLAN ID로 지정합니다.
  • 서브넷은 분산 클라우드 영역의 모든 노드에서 액세스할 수 있습니다.

하위 네트워크 생성

Distributed Cloud 서브넷을 만들려면 이 섹션의 단계를 완료하세요.

이 작업을 완료하려면 Google Cloud 프로젝트에 Edge 네트워크 관리자 역할(roles/edgenetwork.admin)이 있어야 합니다.

gcloud

gcloud edge-cloud networking subnets create 명령어를 사용합니다.

gcloud edge-cloud networking subnets create SUBNETWORK_NAME \
    --network=NETWORK_NAME \
    --ipv4-range=IPV4_RANGE \
    --vlan-id=VLAN_ID \
    --location=REGION \
    --zone=ZONE_NAME

다음을 바꿉니다.

  • SUBNETWORK_NAME: 이 서브네트워크를 고유하게 식별하는 설명 이름입니다.
  • NETWORK_NAME: 이 서브네트워크를 캡슐화하는 네트워크입니다.
  • IPV4_RANGE: 이 서브네트워크가 IP 주소/접두사 형식으로 포함하는 IPv4 주소 범위입니다.
  • VLAN_ID: 이 서브넷의 타겟 VLAN ID입니다.
  • REGION: 대상 Distributed Cloud 영역이 속한 Google Cloud 리전입니다.
  • ZONE_NAME: 대상 Distributed Cloud 영역의 이름입니다.

API

projects.locations.zones.subnets.create 메서드에 대해 POST 요청을 실행합니다.

 POST /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/subnets?subnetId=SUBNETWORK_ID
 {
  "labels": { LABELS,
   },
  "network": { NETWORK_NAME,
   },
  "ipv4Cidr": { IPV4_RANGE,
   },
  "vlanId": { VLAN_ID,
   },
 }

다음을 바꿉니다.

  • PROJECT_ID: 대상 Google Cloud 프로젝트의 ID입니다.
  • REGION: 대상 Distributed Cloud 영역이 속한 Google Cloud 리전입니다.
  • ZONE_NAME: 대상 Distributed Cloud 영역의 이름입니다.
  • SUBNETWORK_ID: 이 서브넷을 고유하게 식별하는 ID입니다.
  • LABELS: 이 서브네트워크 리소스에 적용할 라벨 목록입니다.
  • NETWORK_NAME: 이 서브네트워크를 캡슐화하는 네트워크입니다.
  • IPV4_RANGE: 이 서브네트워크가 IP 주소/접두사 형식으로 포함하는 IPv4 주소 범위입니다.
  • VLAN_ID: 이 서브넷의 타겟 VLAN ID입니다.

하위 네트워크 나열

Distributed Cloud 영역 내에 프로비저닝된 서브넷을 나열하려면 이 섹션의 단계를 완료하세요.

이 작업을 완료하려면 Google Cloud 프로젝트에Edge 네트워크 뷰어 역할(roles/edgenetwork.viewer)이 있어야 합니다.

gcloud

gcloud edge-cloud networking subnets list 명령어를 사용합니다.

gcloud edge-cloud networking subnets list \
    --location=REGION \
    --zone=ZONE_NAME

다음을 바꿉니다.

  • REGION: 대상 Distributed Cloud 영역이 속한 Google Cloud 리전입니다.
  • ZONE_NAME: 대상 Distributed Cloud 영역의 이름입니다.

API

projects.locations.zones.subnets.list 메서드에 대해 GET 요청을 실행합니다.

 GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/subnets?filter=FILTER&pageSize=PAGE_SIZE&orderBy=SORT_BY&pageToken=PAGE_TOKEN

다음을 바꿉니다.

  • PROJECT_ID: 대상 Google Cloud 프로젝트의 ID입니다.
  • REGION: 대상 Distributed Cloud 영역이 속한 Google Cloud 리전입니다.
  • ZONE_NAME: 대상 Distributed Cloud 영역의 이름입니다.
  • FILTER: 반환된 결과를 특정 값으로 제한하는 표현식입니다.
  • PAGE_SIZE: 페이지당 반환할 결과 수입니다.
  • SORT_BY: 반환된 결과를 정렬하는 쉼표로 구분된 필드 이름 목록입니다. 기본 정렬 순서는 오름차순입니다. 내림차순 정렬의 경우 원하는 필드 앞에 ~를 붙입니다.
  • PAGE_TOKEN: 응답의 nextPageToken 필드에 있는 마지막 목록 요청에 대한 응답에서 수신된 토큰입니다. 결과 페이지를 수신하려면 이 토큰을 전송하세요.

서브네트워크에 관한 정보 가져오기

Distributed Cloud 서브넷에 관한 정보를 가져오려면 이 섹션의 단계를 완료하세요.

이 작업을 완료하려면 Google Cloud 프로젝트에Edge 네트워크 뷰어 역할(roles/edgenetwork.viewer)이 있어야 합니다.

gcloud

gcloud edge-cloud networking subnets describe 명령어를 사용합니다.

gcloud edge-cloud networking subnets describe SUBNETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME

다음을 바꿉니다.

  • SUBNETWORK_NAME: 대상 서브네트워크의 이름입니다.
  • REGION: 대상 Distributed Cloud 영역이 속한 Google Cloud 리전입니다.
  • ZONE_NAME: 대상 Distributed Cloud 영역의 이름입니다.

API

projects.locations.zones.subnets.get 메서드에 대해 GET 요청을 실행합니다.

 GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/subnets/SUBNETWORK_ID

다음을 바꿉니다.

  • PROJECT_ID: 대상 Google Cloud 프로젝트의 ID입니다.
  • REGION: 대상 Distributed Cloud 영역이 속한 Google Cloud 리전입니다.
  • ZONE_NAME: 대상 Distributed Cloud 영역의 이름입니다.
  • SUBNETWORK_NAME: 대상 서브네트워크의 이름입니다.

이 작업은 프로비저닝 상태를 비롯한 리소스에 대한 세부정보를 반환합니다.

  • PENDING: 리소스의 프로비저닝이 아직 시작되지 않았으며 영역 전체에 아직 전파되지 않았습니다.
  • PROVISIONING: 리소스가 프로비저닝되고 있습니다. 영역 전체에 전파될 때까지 기다려야 합니다.
  • RUNNING: 리소스가 프로비저닝되고 영역 전체에 전파되었습니다. 사용할 수 있습니다.
  • FAILED: 리소스 프로비저닝이 실패했습니다. 리소스가 영역 전체에 전파되지 않았습니다.

하위 네트워크 삭제

Distributed Cloud 서브넷을 삭제하려면 이 섹션의 단계를 완료하세요.

이 작업을 완료하려면 Google Cloud 프로젝트에 Edge 네트워크 관리자 역할(roles/edgenetwork.admin)이 있어야 합니다.

gcloud

gcloud edge-cloud networking subnets delete 명령어를 사용합니다.

gcloud edge-cloud networking subnets delete SUBNETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME

다음을 바꿉니다.

  • SUBNETWORK_NAME: 대상 서브네트워크의 이름입니다.
  • REGION: 대상 Distributed Cloud 영역이 속한 Google Cloud 리전입니다.
  • ZONE_NAME: 대상 Distributed Cloud 영역의 이름입니다.

API

projects.locations.zones.subnets.delete 메서드에 대해 DELETE 요청을 실행합니다.

 DELETE /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/subnets/SUBNETWORK_ID

다음을 바꿉니다.

  • PROJECT_ID: 대상 Google Cloud 프로젝트의 ID입니다.
  • REGION: 대상 Distributed Cloud 영역이 속한 Google Cloud 리전입니다.
  • ZONE_NAME: 대상 Distributed Cloud 영역의 이름입니다.
  • SUBNETWORK_NAME: 대상 서브네트워크의 이름입니다.

다음 단계