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

허브 및 스포크 작업

이 페이지에서는 Network Connectivity Center 허브와 스포크를 나열, 생성, 설명, 삭제, 업데이트하는 방법을 설명합니다.

Network Connectivity Center에 대한 소개는 Network Connectivity Center 개요를 참조하세요.

시작하기 전에

시작하기 전에 다음 섹션을 검토합니다.

프로젝트 생성 또는 선택

Network Connectivity Center를 더 쉽게 구성하려면 먼저 유효한 프로젝트를 식별합니다.

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

Install the Google Cloud CLI.

To initialize the gcloud CLI, run the following command:

gcloud init

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

Install the Google Cloud CLI.

To initialize the gcloud CLI, run the following command:

gcloud init

Google Cloud CLI를 사용하는 경우 gcloud config set 명령어를 사용하여 프로젝트 ID를 설정합니다.
```
gcloud config set project PROJECT_ID
```
PROJECT_ID를 고유한 프로젝트 ID로 바꿉니다.

이 페이지의 gcloud CLI 안내에서는 프로젝트 ID를 설정했다고 가정합니다.
프로젝트 ID를 올바르게 설정했는지 확인하려면 gcloud config list 명령어를 사용합니다.
```
gcloud config list --format='text(core.project)'
```

Network Connectivity API 사용 설정

Network Connectivity Center를 사용하는 아무 태스크든 수행하려면 먼저 Network Connectivity API를 사용 설정해야 합니다.

콘솔

Network Connectivity API를 사용 설정하려면 다음 단계를 따르세요.

Google Cloud 콘솔에서 Network Connectivity Center 페이지로 이동합니다.

Network Connectivity Center로 이동
사용 설정을 클릭합니다.

또는 API 사용 설정의 설명대로 Google Cloud 콘솔 API 라이브러리를 사용하여 API를 사용 설정할 수 있습니다.

액세스하기

Network Connectivity Center를 사용하려면 역할 및 권한에 설명된 권한이 필요합니다.

리소스 식별

gcloud CLI 또는 API를 사용하여 리소스를 참조하는 경우 다음 표에 설명된 규칙을 따릅니다.

컨벤션	지원	참고	예
전체 URI	모든 리소스	이 방법 중 하나를 사용하여 라우터 어플라이언스 인스턴스를 참조합니다.	"https://www.googleapis.com/compute/projects/`PROJECT_ID`/zones/`ZONE`/instances/`INSTANCE_NAME`"
상대적 리소스 이름	모든 리소스	이 방법 중 하나를 사용하여 라우터 어플라이언스 인스턴스를 참조합니다.	"projects/`PROJECT_ID`/zones/`ZONE`/instances/`INSTANCE_NAME`"
이름	리전 및 전역 리소스	허브, 스포크, VPN 터널, VLAN 연결에 이 방법을 사용합니다.	"`HUB_NAME`"

허브 작업

이 섹션에서는 Network Connectivity Center 허브를 나열, 생성, 설명, 삭제하는 방법을 설명합니다. 허브의 라벨 또는 설명을 업데이트할 수도 있습니다.

허브 만들기

Network Connectivity Center를 사용하려면 허브와 스포크를 각각 최소 하나 이상 만들어야 합니다. 허브를 만드는 동시에 스포크를 만들거나 나중에 스포크를 추가할 수 있습니다.

허브를 만들 때 선택적으로 허브에 라벨을 적용할 수 있습니다. 라벨에 대한 자세한 내용은 라벨 요구사항을 참조하세요.

프로젝트당 허용되는 최대 스포크 수에 대한 자세한 내용은 할당량 및 한도를 참조하세요.

이 태스크에 필요한 권한

이 태스크를 수행하려면 다음과 같은 권한 또는 다음과 같은 IAM 역할을 부여받아야 합니다.

권한

networkconnectivity.hubs.create
또한 Google Cloud 콘솔에서 작업하는 경우:
- networkconnectivity.hubs.get
- networkconnectivity.hubs.list
- networkconnectivity.spokes.list
- compute.projects.get

역할

허브 및 스포크 관리자(roles/networkconnectivity.hubAdmin)
Google Cloud 콘솔에서 작업하는 경우 Compute 네트워크 뷰어(roles/compute.networkViewer)

콘솔

Google Cloud 콘솔에서 Network Connectivity Center 페이지로 이동합니다.

Network Connectivity Center로 이동
프로젝트 메뉴에서 프로젝트를 선택합니다.
허브 만들기를 클릭합니다.
양식의 기본 구성 섹션을 완료합니다.
1. 허브 이름을 입력합니다.
2. 선택사항: 설명을 입력합니다.
3. 선택사항: 라벨을 추가하려면 항목 추가를 클릭한 후 키 및 값을 입력합니다.
4. 양식에 올바른 프로젝트 ID가 표시되는지 확인합니다. 프로젝트 ID가 잘못되었으면 페이지 위에 있는 메뉴를 사용하여 다른 프로젝트를 선택합니다.
Private Service Connect 연결 전파를 사용 설정하려면 Private Service Connect 연결 전파 필드에서 사용을 클릭합니다. 이 기능(미리보기)은 VPC 스포크에만 적용됩니다.
다음 중 하나를 수행합니다.
- 스포크를 만들려면 다음 단계를 클릭하고 양식의 스포크 만들기 섹션을 완료합니다. 자세한 내용은 다음 섹션 중 하나를 참조하세요.
- 지금 스포크를 만들지 않으려면 만들기를 클릭하여 새 허브 만들기를 마칩니다.

gcloud

허브를 만들려면 gcloud network-connectivity hubs create 명령어를 사용합니다.

  gcloud network-connectivity hubs create HUB_NAME \
      --description="DESCRIPTION" \
      --labels="KEY"="VALUE"

Network Connectivity Center 허브에 대해 Private Service Connect 전파 연결(미리보기)을 전역으로 사용 설정하려면 --export-psc 플래그를 사용합니다. 이 기능은 VPC 스포크에만 적용됩니다.

  gcloud network-connectivity hubs create HUB_NAME \
      --description="DESCRIPTION" \
      --labels="KEY"="VALUE" \
      [ --export-psc]

다음 값을 바꿉니다.

HUB_NAME: 새 허브의 이름
DESCRIPTION: 허브를 설명하는 텍스트(선택사항)
KEY: 선택적 라벨 텍스트의 키-값 쌍에 있는 키
VALUE: 선택적 라벨 텍스트의 키-값 쌍에 있는 값

API

허브를 만들려면 networkconnectivity.hubs.create 메서드를 사용합니다.

  POST https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs
  {
    "name":"HUB_NAME",
    "description":"DESCRIPTION",
    "labels": {
      "KEY": "VALUE"
    }
  }

Network Connectivity Center 허브에 대해 Private Service Connect 전파 연결(미리보기)을 전역으로 사용 설정하려면 export-psc 값을 'true'로 설정합니다. 이 기능은 VPC 스포크에만 적용됩니다. Private Service Connect 연결 전파는 Cloud Interconnect VLAN 연결, HA VPN 터널, 라우터 어플라이언스와 같은 하이브리드 스포크를 통해 온프레미스 네트워크로 전파되지 않습니다.

  POST https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs
  {
    "export_psc": true
  }

다음 값을 바꿉니다.

PROJECT_ID: 새 허브가 포함된 프로젝트의 프로젝트 ID
HUB_NAME: 새 허브의 이름
DESCRIPTION: 허브를 설명하는 텍스트(선택사항)
KEY: 선택적 라벨 텍스트의 키-값 쌍에 있는 키
VALUE: 선택적 라벨 텍스트의 키-값 쌍에 있는 값

허브 나열

프로젝트와 연결된 허브를 나열하려면 다음 안내를 따르세요.

이 태스크에 필요한 권한

이 태스크를 수행하려면 다음과 같은 권한 또는 다음과 같은 IAM 역할을 부여받아야 합니다.

권한

networkconnectivity.hubs.list
또한 Google Cloud 콘솔에서 작업하는 경우:
- networkconnectivity.hubs.get
- networkconnectivity.spokes.list
- compute.projects.get

역할

다음 중 하나입니다.
- 허브 및 스포크 뷰어(roles/networkconnectivity.hubViewer)
- 스포크 관리자(roles/networkconnectivity.spokeAdmin)
- 허브 및 스포크 관리자(roles/networkconnectivity.hubAdmin)
Google Cloud 콘솔에서 작업하는 경우 Compute 네트워크 뷰어(roles/compute.networkViewer)

콘솔

Google Cloud 콘솔에서 Network Connectivity Center 페이지로 이동합니다.

Network Connectivity Center로 이동
프로젝트 메뉴에서 프로젝트를 선택합니다.

이 페이지에는 프로젝트와 연결된 모든 허브와 각 허브에 대한 다음 정보가 나와 있습니다.
- 허브 이름
- 허브 설명
- 허브에 적용된 모든 라벨
- 허브와 연결된 스포크의 수
- 허브와 연결된 스포크의 유형

gcloud

프로젝트와 연결된 허브를 나열하려면 gcloud network-connectivity hubs list 명령어를 사용합니다.

  gcloud network-connectivity hubs list

명령어 결과에는 각 허브의 이름과 설명이 포함됩니다.

API

프로젝트와 연결된 허브를 나열하려면 networkconnectivity.hubs.list 메서드를 사용합니다.

  GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs

PROJECT_ID를 나열할 허브가 포함된 프로젝트의 프로젝트 ID로 바꿉니다.

이 메서드는 허브마다 다음과 같은 세부정보를 반환합니다.

허브 이름
허브가 생성된 시간을 표시하는 타임스탬프
마지막 업데이트의 타임스탬프
허브에 적용된 모든 라벨
허브 설명(있는 경우)
허브의 고유 ID
허브 상태
허브 스포크와 연결된 VPC 네트워크인 routingVpcs의 목록

허브 설명

프로젝트 허브에 대한 세부정보를 검색하려면 다음 안내를 따르세요.

이 태스크에 필요한 권한

이 태스크를 수행하려면 다음과 같은 권한 또는 다음과 같은 IAM 역할을 부여받아야 합니다.

권한

networkconnectivity.hubs.get
또한 Google Cloud 콘솔에서 작업하는 경우:
- networkconnectivity.hubs.list
- networkconnectivity.spokes.list
- compute.projects.get

역할

다음 중 하나입니다.
- 허브 및 스포크 뷰어(roles/networkconnectivity.hubViewer)
- 스포크 관리자(roles/networkconnectivity.spokeAdmin)
- 허브 및 스포크 관리자(roles/networkconnectivity.hubAdmin)
Google Cloud 콘솔에서 작업하는 경우 Compute 네트워크 뷰어(roles/compute.networkViewer)

콘솔

Google Cloud 콘솔에서 Network Connectivity Center 페이지로 이동합니다.

Network Connectivity Center로 이동
프로젝트 메뉴에서 프로젝트를 선택하여 프로젝트 허브에 대한 정보를 확인합니다.
허브 스포크의 세부정보를 보려면 스포크 탭을 클릭합니다.

gcloud

기존 허브에 대한 자세한 정보를 보려면 gcloud network-connectivity hubs describe 명령어를 사용합니다.

gcloud network-connectivity hubs describe HUB_NAME

HUB_NAME을 허브 이름으로 바꿉니다.

이 명령어의 출력에는 다음 정보가 포함됩니다.

허브가 생성된 시간
허브 설명
허브에 적용된 모든 라벨
이 허브의 스포크 리소스와 연결된 VPC 네트워크(routingVpcs)
허브의 고유 식별자
허브가 마지막으로 업데이트된 시간

허브에 연결된 스포크에 대한 정보는 스포크 나열 및 스포크 설명을 참조하세요.

API

기존 허브에 대한 자세한 정보를 보려면 networkconnectivity.hubs.get 메서드를 사용합니다.

  GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs/HUB_NAME

다음 값을 바꿉니다.

PROJECT_ID: 설명할 허브가 포함된 프로젝트의 프로젝트 ID
HUB_NAME: 설명할 허브의 이름

이 명령어의 출력에는 다음 정보가 포함됩니다.

허브가 생성된 시간
허브 설명
허브에 적용된 모든 라벨
이 허브의 스포크 리소스와 연결된 VPC 네트워크(routingVpcs)
허브의 고유 식별자
허브가 마지막으로 업데이트된 시간

다음 스니펫은 이 API 호출의 일반적인 응답을 보여줍니다.

 {
   "name": "projects/myproject/locations/global/hubs/myhub",
   "createTime": "2021-08-29T23:40:25.844970812Z",
   "updateTime": "2021-08-30T04:20:36.738801209Z",
   "labels": {
     "environment": "test"
   },
   "description": "in review",
   "uniqueId": "d6d3e375-4224-4352-a3b6-776042419430",
   "state": "ACTIVE",
   "routingVpcs": [ {
     "uri": "https://www.googleapis.com/compute/v1/projects/myproject/global/networks/myvpcnetwork"
   } ]
 }

허브에 연결된 스포크에 대한 정보는 스포크 나열 및 스포크 설명을 참조하세요.

허브 업데이트

허브를 만든 후 다음 중 하나를 추가하거나 변경할 수 있습니다.

허브에 적용되는 라벨. 라벨에 대한 자세한 내용은 라벨 요구사항을 참조하세요.
허브 설명
기존 허브에서 Private Service Connect 연결 전파 사용 설정. 이 기능(미리보기)은 VPC 스포크에만 적용됩니다.

이 태스크에 필요한 권한

이 태스크를 수행하려면 다음과 같은 권한 또는 다음과 같은 IAM 역할을 부여받아야 합니다.

권한

networkconnectivity.hubs.update

역할

허브 및 스포크 관리자(roles/networkconnectivity.hubAdmin)

콘솔

Google Cloud 콘솔에서 Network Connectivity Center 페이지로 이동합니다.

Network Connectivity Center로 이동
프로젝트 메뉴에서 프로젝트를 선택합니다.
수정할 허브 이름을 클릭합니다.
허브 세부정보 페이지에서 허브 수정을 클릭합니다.
허브 설명과 라벨을 업데이트합니다.
Private Service Connect 연결 전파를 사용 설정하려면 사용을 클릭합니다. Private Service Connect 연결 전파를 사용 중지하려면 사용 중지를 클릭합니다. 이 기능(미리보기)은 VPC 스포크에만 적용됩니다.
저장을 클릭합니다.

gcloud

허브 설명을 업데이트하거나 허브에 라벨을 추가하려면 gcloud network-connectivity hubs update 명령어를 사용합니다.

  gcloud network-connectivity hubs update HUB_NAME \
      --description="DESCRIPTION" \
      --update-labels="KEY"="VALUE"

  gcloud network-connectivity hubs update HUB_NAME \
      --description="DESCRIPTION" \
      --labels="KEY"="VALUE" \
      --export-psc

다음 값을 바꿉니다.

HUB_NAME: 허브의 이름
DESCRIPTION: (선택사항) 허브에 대한 새로운 설명
KEY: 선택적 라벨 텍스트의 키-값 쌍에 있는 키
VALUE: 선택적 라벨 텍스트의 키-값 쌍에 있는 값

--no-export-psc 플래그를 사용하여 기존 허브에서 Private Service Connect 연결 전파 기능을 사용 중지할 수 있습니다. 기존 전파 연결은 비동기식으로 삭제됩니다.

하나 이상의 라벨을 삭제하려면 --remove-labels 플래그를 사용합니다. 모든 라벨을 삭제하려면 --clear-labels 플래그를 사용합니다. 자세한 내용은 gcloud network connectivity hubs update 명령어를 참조하세요.

API

허브 설명을 업데이트하거나 허브에 라벨을 추가하려면 networkconnectivity.hubs.patch 메서드를 사용합니다.

  PATCH https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs/HUB_NAME
  {
    "description": "DESCRIPTION",
    "labels": {
      "KEY": "VALUE"
    }
  }

Network Connectivity Center 허브에 대해 Private Service Connect 전파 연결(미리보기)을 전역으로 사용 설정하려면 export-psc 값을 'true'로 설정합니다. 이 기능은 VPC 스포크에만 적용됩니다.

PATCH https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs/HUB_NAME
{
 "export_psc": true
}

다음 값을 바꿉니다.

PROJECT_ID: 허브가 포함된 프로젝트의 ID
HUB_NAME: 허브의 이름
DESCRIPTION: 허브 설명(선택사항)
KEY: 선택적 라벨 텍스트의 키-값 쌍에 있는 키
VALUE: 선택적 라벨 텍스트의 키-값 쌍에 있는 값

export_psc 값을 "false"로 설정하여 기존 허브에서 Private Service Connect 연결 전파 기능을 사용 중지할 수 있습니다. 기존 전파 연결은 비동기식으로 삭제됩니다.

허브 삭제

허브를 삭제하려면 먼저 스포크 삭제에 설명된 대로 스포크를 삭제해야 합니다.

이 태스크에 필요한 권한

이 태스크를 수행하려면 다음과 같은 권한 또는 다음과 같은 IAM 역할을 부여받아야 합니다.

권한

networkconnectivity.hubs.delete
또한 Google Cloud 콘솔에서 작업하는 경우:
- networkconnectivity.hubs.get
- networkconnectivity.hubs.list
- networkconnectivity.spokes.list
- compute.projects.get

역할

허브 및 스포크 관리자(roles/networkconnectivity.hubAdmin)
Google Cloud 콘솔에서 작업하는 경우 Compute 네트워크 뷰어(roles/compute.networkViewer)

콘솔

Google Cloud 콘솔에서 Network Connectivity Center 페이지로 이동합니다.

Network Connectivity Center로 이동
프로젝트 메뉴에서 프로젝트를 선택합니다.
허브 삭제를 클릭합니다.
확인 대화상자에서 다음 중 하나를 수행합니다.
- 허브를 삭제하지 않으려면 취소를 클릭합니다.
- 삭제를 클릭하여 허브를 삭제합니다.

gcloud

허브를 삭제하려면 gcloud network-connectivity hubs delete 명령어를 사용합니다.

  gcloud network-connectivity hubs delete HUB_NAME

HUB_NAME을 허브 이름으로 바꿉니다.

API

허브를 삭제하려면 networkconnectivity.hubs.delete 메서드를 사용합니다.

  DELETE https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs/HUB_NAME

다음 값을 바꿉니다.

PROJECT_ID: 삭제할 허브가 포함된 프로젝트의 프로젝트 ID
HUB_NAME: 삭제할 허브의 이름

스포크 작업

이 섹션에서는 Network Connectivity Center 스포크를 나열, 생성, 설명, 삭제, 업데이트하는 방법을 설명합니다.

스포크 가이드라인

스포크를 만들 때 스포크와 연결하려는 Google Cloud 네트워크 리소스 유형을 지정합니다.

지원되는 리소스 유형 목록은 Network Connectivity Center 개요의 스포크 섹션을 참조하세요.
스포크와 연결할 수 있는 리소스 수에 대해서는 할당량 및 한도 페이지를 참조하세요.

하이브리드 스포크의 경우 스포크가 연결되는 사이트에 가장 가까운 리전에서 스포크를 만드는 것이 좋습니다. 사이트는 온프레미스 데이터 센터, 지사, 다른 클라우드 제공업체일 수 있습니다. VPC 스포크는 전역입니다.

요구사항

각 스포크를 스포크와 연결할 네트워크 연결 리소스와 동일한 Google Cloud 리전에 만들어야 합니다. 예를 들어 us-central1에 HA VPN 게이트웨이를 사용하는 VPN 터널이 있다고 가정해 보겠습니다. 이 터널을 사용하는 스포크를 만들려면 us-central1에 스포크를 만들어야 합니다.

제한사항

스포크를 만든 후에는 여러 속성을 변경할 수 없습니다. 변경할 수 없는 속성을 수정하려면 스포크를 삭제하고 다시 만들어야 합니다.

예를 들어 다음 속성을 변경할 수 없습니다.

사이트 간 데이터 전송 필드 값
스포크와 연결된 HA VPN 터널 또는 VLAN 연결
스포크의 지원 리소스와 연결된 VPC 네트워크. 이 제한은 라우터 어플라이언스 스포크에만 관련 있습니다. 이 스포크에 수정 가능한 리소스가 있기 때문입니다.
생산자 VPC 스포크의 소비자 VPC 스포크 및 피어링 연결 이름 (미리보기)

스포크를 만든 후 변경할 수 있는 스포크 속성 목록은 스포크 업데이트를 참조하세요.

스포크에 리소스 첨부 권장사항

스포크를 만들 때 리소스를 2개 이상 추가할 수 있지만 모든 리소스가 동일한 유형이어야 합니다. 예를 들어 여러 HA VPN 터널을 추가할 수 있지만 HA VPN 터널과 VLAN 연결을 추가할 수는 없습니다.

또한 VLAN 연결 및 VPN 터널의 경우에는 스포크를 여러 리소스에 연결할 수 있더라도 각 리소스가 스포크 하나에만 연결될 수 있다는 제한이 있습니다. 반면에 여러 VPC 네트워크에 인터페이스가 있고 사이트 간 데이터 전송 필드가 false로 설정된 경우 라우터 어플라이언스 인스턴스가 여러 스포크에 연결될 수 있습니다. 하지만 각 인터페이스는 스포크 하나에만 연결될 수 있습니다.

또한 라우터 어플라이언스 스포크 만들기, VLAN 연결 스포크 만들기, VPN 스포크 만들기, VPC 스포크 만들기 섹션에 설명된 리소스별 권장사항을 참조하세요.

ASN 스포크 할당(하이브리드 스포크만 해당)

하이브리드 스포크의 경우 ASN 요구사항에 설명된 대로 ASN을 할당해야 합니다.

스포크 리소스 확인

스포크를 만들기 전 해당 리소스를 올바르게 구성해야 합니다. 자세한 내용은 VPC 스포크 만들기, 프로듀서 VPC 스포크 만들기 (미리보기), 라우터 어플라이언스 스포크 만들기, VLAN 연결 스포크 만들기, VPN 스포크 만들기 섹션에 설명된 리소스별 권장사항을 참고하세요.

VPC 스포크 만들기

VPC 연결 스포크를 만들려면 먼저 다음 안내를 고려하세요.

VPC 네트워크가 전역이므로 VPC 스포크는 전역입니다.
VPC 스포크 간에 서브넷 중복이 없어야 합니다. exclude export ranges 플래그를 사용하여 이를 방지할 수 있습니다.
Network Connectivity Center VPC 연결과 VPC 피어링 간에는 서브넷이 겹치면 안 됩니다.
허브와 VPC 스포크가 서로 다른 프로젝트에 있는 VPC 스포크의 워크플로는 다릅니다. 자세한 내용은 허브와 다른 프로젝트에 있는 VPC 스포크를 참조하세요.
스타 토폴로지를 지원하는 허브에 연결된 VPC 스포크는 스포크 그룹에 명시적으로 할당되어야 합니다.
VPC 스포크(미리보기)에서 Private Service Connect 연결을 만들려면 허브에 Private Service Connect 연결 전파가 사용 설정되어 있어야 합니다. Private Service Connect 엔드포인트를 만드는 방법에 대한 지침은 엔드포인트 만들기를 참조하세요.

이 태스크에 필요한 권한

이 태스크를 수행하려면 다음과 같은 권한 또는 다음과 같은 IAM 역할을 부여받아야 합니다.

권한

스포크에 추가되는 VPC 네트워크에 대한 compute.networks.use
스포크가 연결되는 허브의 networkconnectivity.groups.use
VPC 네트워크가 있는 프로젝트의 networkconnectivity.spokes.create
그룹을 만들기 위한 허브에 대한 networkconnectivity.groups.create
허브가 아닌 다른 프로젝트의 그룹과 연결된 스포크를 만들기 위한 허브에 대한 networkconnectivity.groups.use

역할

스포크에 추가되는 VPC 네트워크에 대한 roles/compute.networkAdmin
스포크가 연결되는 허브의 roles/networkconnectivity.groupUser
VPC 네트워크가 있는 프로젝트의 roles/networkconnectivity.spokeAdmin

특정 프로젝트 내에서 여러 VPC 네트워크를 연결하려면 VPC 네트워크를 스포크에 연결하고 이를 허브에 연결합니다.

스타 토폴로지용으로 구성된 허브에 연결할 VPC를 만드는 경우 허브 관리자로부터 프로젝트 ID, 허브 이름 또는 URI, 그룹 이름을 가져와야 합니다.

내보내기 범위 제외 또는 내보내기 범위 포함을 할당하려면 스포크를 만들 때 적절한 옵션을 사용합니다.

VPC 스포크를 만들려면 다음 단계를 따르세요.

콘솔

Google Cloud 콘솔에서 Network Connectivity Center 페이지로 이동합니다.

Network Connectivity Center로 이동
프로젝트 메뉴에서 스포크를 만들 프로젝트를 선택합니다.
스포크 탭을 클릭합니다.
스포크 추가를 클릭합니다.
허브 선택 섹션에서 다음과 같이 허브 위치를 선택합니다.
- 동일한 프로젝트의 허브에 새 스포크를 연결하려면 PROJECT_NAME 프로젝트 내를 선택하고 목록에서 허브 이름을 선택합니다.
- 새 스포크를 다른 프로젝트의 허브에 연결하려면 다른 프로젝트 내를 선택합니다. 새 스포크를 연결할 프로젝트 ID 및 허브 이름을 입력합니다.
다른 프로젝트의 허브를 선택하면 허브 관리자가 제안한 스포크를 검토하고 수락할 때만 스포크가 활성화됩니다. 다른 프로젝트의 허브에 연결된 스포크를 만드는 방법에 관한 자세한 내용은 VPC 스포크 개요를 참고하세요. 허브와 동일한 프로젝트에 VPC 스포크를 만드는 경우 자동으로 허용되고 활성화됩니다.
스포크 이름과 선택사항인 설명을 입력합니다.
연결하려는 허브가 스타 토폴로지로 구성된 경우 해당 스포크의 스포크 그룹을 선택합니다. 스포크 그룹에 대한 자세한 내용은 스포크 그룹을 참고하세요.
스포크 유형으로 VPC 네트워크를 선택합니다.
VPC 네트워크를 스포크에 추가하려면 연결된 VPC 네트워크 목록에서 하나를 선택합니다.
원하는 경우 VPC 스포크 필터를 추가하여, 스포크에서 허브로 내보내기를 제외하거나 포함할 IP 주소 범위를 입력함으로써 경로를 공지하는 방법을 맞춤 설정할 수 있습니다. 스포크가 생성된 후에는 이 필터를 변경할 수 없습니다.
완료를 클릭합니다.
스포크를 더 추가하려면 스포크 추가를 클릭하고 스포크 이름을 입력하여 프로세스를 다시 시작합니다.
스포크 추가를 완료하면 만들기를 클릭합니다. Network Connectivity Center 페이지가 업데이트되어 생성한 스포크에 대한 세부정보가 표시됩니다.

gcloud

VPC 스포크를 만들려면 gcloud network-connectivity spokes linked-vpc-network create 명령어를 사용합니다.

gcloud network-connectivity spokes linked-vpc-network create SPOKE_NAME \
    --hub=HUB \
    --description=DESCRIPTION \
    --vpc-network=VPC_URI \
    --exclude-export-ranges=[EXCLUDE_CIDR_RANGE] \
    --include-export-ranges=[INCLUDE_CIDR_RANGE] \
    --global \
    --group=GROUP_NAME

다음을 바꿉니다.

SPOKE_NAME: 만들려는 스포크의 이름(예: vpc-spoke1)
HUB: 스포크의 허브
DESCRIPTION: (선택사항) 스포크를 설명하는 텍스트
VPC_URI: 이 스포크가 가리키는 VPC 네트워크
[EXCLUDE_CIDR_RANGE]: 허브로 내보내기에서 제외할 쉼표로 구분된 IP 주소 범위 목록(최대 16개의 CIDR 범위)(예: 10.1.0.0/16, 192.168.0.0/24, 172.16.1.1/32). 지정된 범위는 VPC 내에서 개별적으로 구성된 서브넷과 같거나 커야 합니다.
[INCLUDE_CIDR_RANGE]: 허브로 내보내기에 포함할 쉼표로 구분된 IP 주소 범위 목록(최대 16개의 CIDR 범위)(예: 10.1.0.0/16, 192.168.0.0/24, 172.16.1.1/32).
GROUP_NAME: 이 스포크가 속한 그룹(예: center 또는 edge). 이 필드는 스타 토폴로지를 사용하는 스포크 그룹에 필요합니다. 스포크 그룹에 대한 자세한 내용은 스포크 그룹을 참조하세요.

API

VPC 스포크를 만들려면 networkconnectivity.spokes.create 메서드를 사용합니다.

  POST https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/spokes/SPOKE_NAME
  {
    "hub":"HUB_NAME",
    "linkedVpcNetwork": {
       "uri": VPC_URI,
       "include_export_ranges": "[INCLUDE_CIDR_RANGE]",
       "exclude_export_ranges": "[EXCLUDE_CIDR_RANGE]",
       "group": "GROUP_NAME"
    },
  }

다음 값을 바꿉니다.

PROJECT_ID: 새 스포크가 포함된 프로젝트의 프로젝트 ID
HUB_NAME: 스포크를 연결할 허브의 이름입니다.
VPC_URI: 이 스포크가 가리키는 VPC 네트워크(예: vpc_uri)
[INCLUDE_CIDR_RANGE]: 허브로 내보내기에 포함할 쉼표로 구분된 IP 주소 범위 목록(최대 16개의 CIDR 범위)(예: 10.1.0.0/16, 192.168.0.0/24, 172.16.1.1/32). 지정된 범위는 VPC 내에서 개별적으로 구성된 서브넷과 같거나 커야 합니다.
[EXCLUDE_CIDR_RANGE]: 허브로 내보내기에서 제외할 쉼표로 구분된 IP 주소 범위 목록(최대 16개의 CIDR 범위)(예: 10.1.0.0/16, 192.168.0.0/24, 172.16.1.1/32).
GROUP_NAME: 이 스포크가 속한 그룹. 스포크 그룹의 이름입니다. 지원되는 값은 메시 토폴로지 허브의 경우 default이고 스타 토폴로지 허브의 경우 center 또는 edge입니다. 이 필드는 스타 토폴로지를 사용하는 스포크 그룹에 필요합니다. 스포크 그룹에 대한 자세한 내용은 스포크 그룹을 참고하세요.

프로듀서 VPC 스포크 만들기

프로듀서 VPC 스포크를 만들기 전에 다음을 실행합니다.

프로듀서 VPC 스포크의 고려사항을 검토합니다.
프로듀서 VPC 스포크에도 적용되는 VPC 스포크 생성 가이드라인을 검토하세요.

이 태스크에 필요한 권한

이 태스크를 수행하려면 다음과 같은 권한 또는 다음과 같은 IAM 역할을 부여받아야 합니다.

권한

피어링된 소비자 VPC 스포크의 networkconnectivity.spokes.use
스포크가 연결되는 허브의 networkconnectivity.groups.use
피어링된 소비자 VPC 네트워크가 있는 프로젝트의 networkconnectivity.spokes.create
그룹을 만들기 위한 허브에 대한 networkconnectivity.groups.create
허브가 아닌 다른 프로젝트의 그룹과 연결된 스포크를 만들기 위한 허브에 대한 networkconnectivity.groups.use

역할

피어링된 소비자 VPC 네트워크의 Compute 네트워크 관리자 역할 (roles/compute.networkAdmin)
피어링된 소비자 VPC 네트워크가 있는 프로젝트의 스포크 관리자 역할 (roles/networkconnectivity.spokeAdmin)

서비스 프로듀서 VPC 네트워크를 특정 프로젝트의 다른 네트워크와 연결하려면 프로듀서 VPC 네트워크를 프로듀서 VPC 스포크에 연결하고 프로듀서 VPC 스포크를 허브에 연결합니다.

Google Cloud CLI 또는 API를 사용하여 프로듀서 VPC 스포크를 스타 토폴로지로 구성된 허브에 연결하는 경우 허브의 기존 소비자 VPC 스포크와 동일한 그룹 이름을 사용해야 합니다. Google Cloud 콘솔을 사용하면 프로듀서 VPC 스포크가 동일한 그룹에 자동으로 추가됩니다.

내보내기 범위 제외 또는 내보내기 범위 포함을 할당하려면 스포크를 만들 때 적절한 옵션을 사용합니다.

프로듀서 VPC 스포크를 만들려면 다음 단계를 따르세요.

콘솔

Google Cloud 콘솔에서 Network Connectivity Center 페이지로 이동합니다.

Network Connectivity Center로 이동
프로젝트 메뉴에서 스포크를 만들 프로젝트를 선택합니다.
스포크 탭을 클릭합니다.
스포크 추가를 클릭합니다.
허브 선택 섹션에서 다음과 같이 허브 위치를 선택합니다.
- 동일한 프로젝트의 허브에 새 스포크를 연결하려면 PROJECT_NAME 프로젝트 내를 선택하고 목록에서 허브 이름을 선택합니다.
- 새 스포크를 다른 프로젝트의 허브에 연결하려면 다른 프로젝트 내를 선택합니다. 새 스포크를 연결할 프로젝트 ID 및 허브 이름을 입력합니다.
다른 프로젝트의 허브를 선택하면 허브 관리자가 제안한 스포크를 검토하고 수락할 때만 스포크가 활성화됩니다. 다른 프로젝트의 허브에 연결된 스포크를 만드는 방법에 대한 자세한 내용은 VPC 스포크 개요를 참조하세요. 허브와 동일한 프로젝트에 프로듀서 VPC 스포크를 만드는 경우 프로듀서 VPC 스포크가 자동으로 허용되고 활성화됩니다.
스포크 이름과 선택사항인 설명을 입력합니다.
스포크 유형으로 프로듀서 VPC 네트워크를 선택합니다.
VPC 네트워크 피어링 연결을 통해 프로듀서 VPC 네트워크의 서비스를 사용하는 허브의 기존 소비자 VPC 스포크 이름을 입력합니다. Google Cloud는 피어링 연결을 통해 프로듀서 네트워크를 식별합니다.
원하는 경우 VPC 스포크 필터를 추가하여, 스포크에서 허브로 내보내기를 제외하거나 포함할 IP 주소 범위를 입력함으로써 경로를 공지하는 방법을 맞춤 설정할 수 있습니다. 스포크가 생성된 후에는 이 필터를 변경할 수 없습니다.
완료를 클릭합니다.
스포크를 더 추가하려면 스포크 추가를 클릭하고 스포크 이름을 입력하여 프로세스를 다시 시작합니다.
스포크 추가를 완료하면 만들기를 클릭합니다. Network Connectivity Center 페이지가 업데이트되어 생성한 스포크에 대한 세부정보가 표시됩니다.

gcloud

프로듀서 VPC 스포크를 만들려면 gcloud network-connectivity spokes linked-producer-vpc-network create 명령어를 사용합니다.

gcloud network-connectivity spokes linked-producer-vpc-network create SPOKE_NAME \
    --hub=HUB \
    --description=DESCRIPTION \
    --network=CONSUMER_VPC_URI \
    --peering=servicenetworking-googleapis-com \
    --exclude-export-ranges=[EXCLUDE_CIDR_RANGE] \
    --include-export-ranges=[INCLUDE_CIDR_RANGE] \
    --global \
    --group=GROUP_NAME

--peering 플래그는 servicenetworking-googleapis-com으로 설정되어야 합니다.

다음을 바꿉니다.

SPOKE_NAME: 만들려는 스포크의 이름(예: producer-vpc-spoke1)
HUB: 스포크의 허브
DESCRIPTION: (선택사항) 스포크를 설명하는 텍스트
CONSUMER_VPC_URI: VPC 네트워크 피어링 연결을 통해 프로듀서 네트워크의 서비스를 사용하는 VPC 네트워크입니다. Google Cloud는 피어링 연결을 통해 프로듀서 VPC 네트워크를 식별합니다. 입력하는 소비자 네트워크도 허브의 스포크여야 합니다. 전체 또는 상대 URI를 입력할 수 있습니다. 다음 예시는 상대 URI인 projects/PROJECT_ID/global/networks/NETWORK_NAME을 보여줍니다.
[EXCLUDE_CIDR_RANGE]: 허브로 내보내기에서 제외할 쉼표로 구분된 IP 주소 범위 목록(최대 16개의 CIDR 범위)(예: 10.1.0.0/16, 192.168.0.0/24, 172.16.1.1/32). 지정된 범위의 프리픽스가 더 길거나 프로듀서 VPC 내에서 개별적으로 구성된 서브넷과 같아야 합니다.
[INCLUDE_CIDR_RANGE]: 허브로 내보내기에 포함할 쉼표로 구분된 IP 주소 범위 목록(최대 16개의 CIDR 범위)(예: 10.1.0.0/16, 192.168.0.0/24, 172.16.1.1/32).
GROUP_NAME: 이 스포크가 속한 그룹(예: center 또는 edge). 이 필드는 스타 토폴로지를 사용하는 스포크 그룹에 필요합니다. 스타 토폴로지를 사용하는 경우 프로듀서 VPC 스포크를 기존 소비자 VPC 스포크와 동일한 그룹에 배치해야 합니다. 스포크 그룹에 대한 자세한 내용은 스포크 그룹을 참조하세요.

API

프로듀서 VPC 스포크를 만들려면 networkconnectivity.spokes.create 메서드를 사용합니다.

  POST https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/spokes/SPOKE_NAME
  {
    "hub":"HUB_NAME",
    "linkedProducerVpcNetwork": {
       "network": "CONSUMER_VPC_URI",
       "peering_name": "servicenetworking-googleapis-com",
       "include_export_ranges": "[INCLUDE_CIDR_RANGE]",
       "exclude_export_ranges": "[EXCLUDE_CIDR_RANGE]",
       "group": "GROUP_NAME"
    },
  }

peering_name 필드는 servicenetworking-googleapis-com로 설정되어야 합니다.

다음 값을 바꿉니다.

PROJECT_ID: 새 스포크가 포함된 프로젝트의 프로젝트 ID
HUB_NAME: 스포크를 연결할 허브의 이름입니다.
SPOKE_NAME: 만들려는 스포크의 이름입니다.
CONSUMER_VPC_URI: VPC 네트워크 피어링 연결을 통해 프로듀서의 서비스를 사용하는 VPC 네트워크입니다. Google Cloud는 피어링 연결을 통해 프로듀서 VPC 네트워크를 식별합니다. 입력하는 소비자 네트워크도 허브의 스포크여야 합니다. 전체 또는 상대 URI를 입력할 수 있습니다. 다음 예시는 상대 URI인 projects/PROJECT_ID/global/networks/NETWORK_NAME을 보여줍니다.
[INCLUDE_CIDR_RANGE]: 허브로 내보내기에 포함할 쉼표로 구분된 IP 주소 범위 목록(최대 16개의 CIDR 범위)(예: 10.1.0.0/16, 192.168.0.0/24, 172.16.1.1/32). 지정된 범위의 프리픽스가 더 길거나 프로듀서 VPC 네트워크 내에서 개별적으로 구성된 서브넷과 같아야 합니다.
[EXCLUDE_CIDR_RANGE]: 허브로 내보내기에서 제외할 쉼표로 구분된 IP 주소 범위 목록(최대 16개의 CIDR 범위)(예: 10.1.0.0/16, 192.168.0.0/24, 172.16.1.1/32).
GROUP_NAME: 이 스포크가 속한 그룹. 지원되는 값은 메시 토폴로지 허브의 경우 default이고 스타 토폴로지 허브의 경우 center 또는 edge입니다. 이 필드는 스타 토폴로지를 사용하는 스포크 그룹에 필요합니다. 스타 토폴로지를 사용하는 경우 프로듀서 VPC 스포크를 기존 소비자 VPC 스포크와 동일한 그룹에 배치해야 합니다. 스포크 그룹에 대한 자세한 내용은 스포크 그룹을 참조하세요.

라우터 어플라이언스 스포크 만들기

라우터 어플라이언스 스포크를 사용해서 Google Cloud 외부 사이트에 연결하려면 다음 안내를 따릅니다.

VLAN 연결 및 VPN 스포크와 달리 라우터 어플라이언스 스포크는 Google Cloud 외부의 단일 위치와 연결될 필요가 없습니다. 하지만 라우터 어플라이언스가 리전별 리소스이기 때문에 근처 위치의 데이터를 수신하도록 구성하는 것이 좋습니다.
동일한 사이트 집합에서 데이터를 수신하도록 여러 라우터 어플라이언스 인스턴스를 구성하는 경우, 해당 인스턴스를 동일한 스포크와 연결하는 것이 좋습니다.

사이트 간 데이터 전송을 위해 라우터 어플라이언스 스포크를 사용하는 경우 다음 안내를 따릅니다.

여러 라우터 어플라이언스 인스턴스를 스포크에 연결할 경우에는 이러한 인스턴스 간에 Network Connectivity Center가 사이트 간 데이터 전송을 제공하지 않도록 해야 합니다. 사이트 간 데이터 전송을 사용하려면 여러 스포크를 설정해야 합니다. 이에 대응하여 Network Connectivity Center는 스포크 간의 데이터 전송을 허용합니다.

라우터 어플라이언스 스포크를 만든 후에는 라우터 어플라이언스 인스턴스와 동일한 리전에 있는 Cloud Router 간에 BGP 피어링을 설정해야 합니다. 자세한 내용은 라우터 어플라이언스 인스턴스 만들기를 참조하세요.

라우터 어플라이언스 스포크를 만드는 데 필요한 리소스를 구성하는 방법에 대한 자세한 내용은 다음 문서를 참조하세요.

이 태스크에 필요한 권한

이 태스크를 수행하려면 다음과 같은 권한 또는 다음과 같은 IAM 역할을 부여받아야 합니다.

권한

networkconnectivity.spokes.create
compute.routers.get
compute.instances.get
Google Cloud 콘솔에서 작업하는 경우 특정 네트워크 리소스를 볼 수 있는 권한이 필요합니다. 자세한 내용은 역할 및 권한을 참조하세요.

역할

다음 중 하나입니다.
- 스포크 관리자(roles/networkconnectivity.spokeAdmin)
- 허브 및 스포크 관리자(roles/networkconnectivity.hubAdmin)
Compute Network Viewer(roles/compute.networkViewer)와 같이 Cloud Router 리소스 읽기 권한을 부여하는 역할과 스포크의 리소스 유형(이 경우에는 VM)
Google Cloud 콘솔에서 작업하는 경우 Compute 네트워크 뷰어(roles/compute.networkViewer)

콘솔

기본 스포크 세부정보 입력

Google Cloud 콘솔에서 Network Connectivity Center 페이지로 이동합니다.

Network Connectivity Center로 이동

프로젝트 메뉴에서 Google Cloud 프로젝트를 선택합니다.
스포크 탭을 클릭합니다.
스포크 추가를 클릭합니다.
새 스포크 양식에서 스포크 유형을 설정합니다.
스포크 이름과 선택사항인 설명을 입력합니다.
새 스포크의 리전 필드를 선택합니다.
사이트 간 데이터 전송에서 설정 또는 해제를 선택합니다. 선택한 리전이 데이터 전송을 지원하지 않으면 필드가 사용 중지됩니다. 이 사용 사례에 대한 자세한 내용은 사이트 간 데이터 전송 개요를 참조하세요.
VPC 네트워크 목록에서 네트워크를 선택합니다. 데이터 전송 기능을 사용하는 스포크가 2개 이상 있으면 모든 스포크가 동일한 VPC 네트워크에 있어야 합니다. 따라서 데이터 전송을 사용하는 스포크를 이미 만든 경우 VPC 네트워크 값이 자동 입력되고 이를 변경할 수 없습니다.

라우터 어플라이언스 세부정보 입력

라우터 어플라이언스 인스턴스를 선택합니다.

인스턴스 추가를 클릭합니다.
인스턴스 드롭다운 메뉴에서 기존 라우터 어플라이언스 인스턴스를 선택합니다.

선택사항: 허브에 공지된 서브넷을 하이브리드 스포크에 전파하려면 하이브리드 스포크 필터에서 허브에서 스포크까지 모든 IPv4 범위 포함을 클릭합니다.
이 스포크에 라우터 어플라이언스 인스턴스를 더 추가하려면 이전 단계를 반복합니다. 완료되면 완료를 클릭하고 계속해서 스포크 저장을 수행합니다.

스포크 저장

스포크를 더 추가하려면 스포크 추가를 클릭하고 스포크 이름을 입력하여 프로세스를 다시 시작합니다.
스포크 추가를 완료하면 만들기를 클릭합니다. Network Connectivity Center 페이지가 업데이트되어 생성한 스포크에 대한 세부정보가 표시됩니다.

gcloud

라우터 어플라이언스 스포크를 만들려면 gcloud network-connectivity spokes linked-router-appliances create 명령어를 사용합니다.

예를 들어 라우터 어플라이언스 인스턴스가 2개 있고 사이트 간 데이터 전송을 사용하는 스포크를 만들려면 다음 명령어를 실행합니다.

이 스포크에 서브넷 IP 주소 범위 가져오기를 사용 설정하려면(미리보기) --include-import-ranges 플래그를 사용하세요.

  gcloud network-connectivity spokes linked-router-appliances create NAME \
      --hub=HUB_NAME \
      --description="DESCRIPTION" \
      --router-appliance=instance="ROUTER_APPLIANCE_URI",ip=IP_ADDRESS \
      --router-appliance=instance="ROUTER_APPLIANCE_URI_2",ip=IP_ADDRESS_2 \
      --region=REGION \
      --labels="KEY"="VALUE" \
      --site-to-site-data-transfer \
      --include-import-ranges=[INCLUDE_IMPORT_RANGES,...]

다음 값을 바꿉니다.

NAME: 스포크 이름
HUB_NAME: 허브의 이름
DESCRIPTION: 스포크를 설명하는 텍스트입니다(선택사항).

ROUTER_APPLIANCE_URI: 첫 번째 라우터 어플라이언스 인스턴스의 URI, 예를 들면 다음과 같습니다.

https://www.googleapis.com/compute/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME

IP_ADDRESS: 첫 번째 라우터 어플라이언스 인스턴스의 내부 IP 주소입니다.
ROUTER_APPLIANCE_URI_2: 두 번째 라우터 어플라이언스 인스턴스의 URI
IP_ADDRESS_2: 두 번째 라우터 어플라이언스 인스턴스의 내부 IP 주소
REGION: 스포크가 있는 Google Cloud 리전(예: us-west1)
KEY: 선택적 라벨 텍스트의 키-값 쌍에 있는 키
VALUE: 선택적 라벨 텍스트의 키-값 쌍에 있는 값입니다.
[INCLUDE_IMPORT_RANGES,...]: 허브 서브넷에서 가져오도록 지정된 IP 주소 범위입니다. 목록에는 ALL_IPV4_RANGES만 추가할 수 있습니다. 비어 있으면 스포크가 허브에서 서브넷을 가져오지 않습니다.

스포크의 데이터 전송을 사용 설정하려면 site-to-site-data-transfer 플래그를 사용합니다. 이 사용 사례에 대한 자세한 내용은 사이트 간 데이터 전송 개요를 참조하세요.

API

라우터 어플라이언스 스포크를 만들려면 networkconnectivity.spokes.create 메서드를 사용합니다. 예를 들어 라우터 어플라이언스 인스턴스 2개가 포함된 스포크를 만들려면 다음 요청을 사용합니다.

  POST https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/spokes/SPOKE_NAME
  {
    "hub": "HUB_NAME",
    "labels": {"KEY": "VALUE"},
    "linkedRouterApplianceInstances": {
      "instances": [
        {
          "virtualMachine": "ROUTER_APPLIANCE_URI",
          "ipAddress": "IP_ADDRESS",
        },
        {
          "virtualMachine": "ROUTER_APPLIANCE_URI_2,
          "ipAddress": "IP_ADDRESS_2",
        }
      ],
      "siteToSiteDataTransfer": BOOLEAN
      "includeImportRanges": [INCLUDE_IMPORT_RANGES,...]
    }
  }

다음 값을 바꿉니다.

PROJECT_ID: 프로젝트의 프로젝트 ID
REGION: 스포크를 찾을 Google Cloud 리전(예: us-west1)
SPOKE_NAME: 스포크 이름
HUB_NAME: 스포크를 연결할 허브의 이름
KEY: 선택적 라벨 텍스트의 키-값 쌍에 있는 키
VALUE: 선택적 라벨 텍스트의 키-값 쌍에 있는 값입니다.

ROUTER_APPLIANCE_URI: 첫 번째 라우터 어플라이언스 인스턴스의 URI, 예를 들면 다음과 같습니다.

https://www.googleapis.com/compute/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME

IP_ADDRESS: 첫 번째 라우터 어플라이언스 인스턴스의 내부 IP 주소입니다.
ROUTER_APPLIANCE_URI_2: 두 번째 라우터 어플라이언스 인스턴스의 URI
IP_ADDRESS_2: 두 번째 라우터 어플라이언스 인스턴스의 내부 IP 주소입니다.
[INCLUDE_IMPORT_RANGES,...]: 허브 서브넷에서 가져오도록 지정된 IP 주소 범위입니다. 목록에는 ALL_IPV4_RANGES만 추가할 수 있습니다. 이 필드가 비어 있으면 스포크가 허브에서 서브넷을 가져오지 않습니다.

VLAN 연결 스포크 만들기

VLAN 연결 스포크를 만들려면 먼저 다음 안내를 고려하세요.

Dedicated Interconnect 또는 Partner Interconnect 연결이 동일한 사이트에 대해 중복해서 구성된 경우 두 연결 모두 단일 스포크로 구성해야 합니다. 이러한 Interconnect 연결과 연관된 중복 VLAN 첨부는 동일한 Google Cloud 리전에 있어야 합니다. 중복 구성에 대한 자세한 내용은 Cloud Interconnect에 대한 권장사항을 참조하세요.
여러 리전에서 Interconnect 연결을 사용하려면 이를 서로 다른 스포크로 구성해야 합니다.

VLAN 연결 스포크를 만드는 데 필요한 리소스 구성에 대한 자세한 내용은 다음 문서를 참조하세요.

VLAN 연결 리소스 확인에 대한 자세한 내용은 다음 문서를 참조하세요.

이 태스크에 필요한 권한

이 태스크를 수행하려면 다음과 같은 권한 또는 다음과 같은 IAM 역할을 부여받아야 합니다.

권한

networkconnectivity.spokes.create
compute.routers.get
compute.interconnectAttachments.get
Google Cloud 콘솔에서 작업하는 경우 특정 네트워크 리소스를 볼 수 있는 권한이 필요합니다. 자세한 내용은 역할 및 권한을 참조하세요.

역할

다음 중 하나입니다.
- 스포크 관리자(roles/networkconnectivity.spokeAdmin)
- 허브 및 스포크 관리자(roles/networkconnectivity.hubAdmin)
Compute Network Viewer(roles/compute.networkViewer)와 같이 Cloud Router 리소스 읽기 권한을 부여하는 역할과 스포크의 리소스 유형(이 경우에는 VLAN 연결)
Google Cloud 콘솔에서 작업하는 경우 Compute 네트워크 뷰어(roles/compute.networkViewer)

콘솔

기본 스포크 세부정보 입력

Google Cloud 콘솔에서 Network Connectivity Center 페이지로 이동합니다.

Network Connectivity Center로 이동

프로젝트 메뉴에서 Google Cloud 프로젝트를 선택합니다.
스포크 탭을 클릭합니다.
스포크 추가를 클릭합니다.
새 스포크 양식에서 스포크 유형을 설정합니다.
스포크 이름과 선택사항인 설명을 입력합니다.
새 스포크의 리전 필드를 선택합니다.
사이트 간 데이터 전송에서 설정 또는 해제를 선택합니다. 선택한 리전이 데이터 전송을 지원하지 않으면 필드가 사용 중지됩니다. 이 사용 사례에 대한 자세한 내용은 사이트 간 데이터 전송 개요를 참조하세요.
VPC 네트워크 목록에서 네트워크를 선택합니다. 데이터 전송 기능을 사용하는 스포크가 2개 이상 있으면 모든 스포크가 동일한 VPC 네트워크에 있어야 합니다. 따라서 데이터 전송을 사용하는 스포크를 이미 만든 경우 VPC 네트워크 값이 자동 입력되고 이를 변경할 수 없습니다.

VLAN 연결 세부정보 입력

VLAN 연결을 선택합니다.
1. 연결 추가를 클릭합니다.
2. VLAN 연결 드롭다운 메뉴에서 기존 연결을 선택합니다.
원하는 경우 허브에 공지된 서브넷을 하이브리드 스포크에 전파하려면 하이브리드 스포크 필터에서 허브에서 스포크로의 모든 IPv4 범위 포함을 클릭합니다.
이 스포크에 연결을 더 추가하려면 이전 단계를 반복합니다. 완료되면 완료를 클릭하고 계속해서 스포크 저장을 수행합니다.

스포크 저장

스포크를 더 추가하려면 스포크 추가를 클릭하고 스포크 이름을 입력하여 프로세스를 다시 시작합니다.
스포크 추가를 완료하면 만들기를 클릭합니다. Network Connectivity Center 페이지가 업데이트되어 생성한 스포크에 대한 세부정보가 표시됩니다.

gcloud

VLAN 연결 스포크를 만들려면 gcloud network-connectivity spokes linked-interconnect-attachments create 명령어를 사용합니다.

예를 들어 VLAN 연결이 2개 있고 사이트 간 데이터 전송을 사용하는 스포크를 만들려면 다음 명령어를 실행합니다.

이 스포크에 서브넷 IP 주소 범위 가져오기를 사용 설정하려면(미리보기) --include-import-ranges 플래그를 사용하세요.

  gcloud network-connectivity spokes linked-interconnect-attachments create SPOKE_NAME \
      --hub=HUB_NAME \
      --description="DESCRIPTION" \
      --interconnect-attachments=VLAN_ATTACHMENT_NAME,VLAN_ATTACHMENT_NAME_2 \
      --region=REGION \
      --labels="KEY"="VALUE" \
      --site-to-site-data-transfer \
      --include-import-ranges=[INCLUDE_IMPORT_RANGES,...]

다음 값을 바꿉니다.

SPOKE_NAME: 스포크 이름
HUB_NAME: 스포크를 연결할 허브의 URI 형식 이름(예:
projects/myproject/locations/global/hubs/us-west-to-uk).
DESCRIPTION: 스포크를 설명하는 텍스트(선택사항)
VLAN_ATTACHMENT_NAME: 스포크에 추가할 첫 번째 VLAN 연결의 이름
VLAN_ATTACHMENT_NAME_2: 두 번째 VLAN 연결(두 번째 VLAN 연결을 포함할 경우 쉼표와 연결 이름 사이에 공백을 생략해야 합니다.)
REGION: 스포크가 있는 Google Cloud 리전
KEY: 라벨 텍스트의 키-값 쌍에 있는 키
VALUE: 라벨 텍스트의 키-값 쌍에 있는 값
[INCLUDE_IMPORT_RANGES,...]: 허브 서브넷에서 가져오도록 지정된 IP 주소 범위입니다. 목록에는 ALL_IPV4_RANGES만 추가할 수 있습니다. 이 필드가 비어 있으면 스포크가 허브에서 서브넷을 가져오지 않습니다.

API

VLAN 연결 스포크를 만들려면 networkconnectivity.spokes.create 메서드를 사용합니다. 예를 들어 VLAN 연결 2개가 포함되어 있고 이 스포크에 서브넷 IP 주소 범위 가져오기가 사용 설정된 스포크를 만들려면 (미리보기) 다음 요청을 사용합니다.

  POST https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/spokes/SPOKE_NAME
  {
    "hub": "HUB_NAME",
    "labels": {"KEY": "VALUE"},
    "linkedInterconnectAttachments": {
      "uris": [
        "VLAN_ATTACHMENT_NAME",
        "VLAN_ATTACHMENT_NAME_2"
      ],
      "siteToSiteDataTransfer": BOOLEAN
      "includeImportRanges": [INCLUDE_IMPORT_RANGES,...]
    }
  }

다음 값을 바꿉니다.

PROJECT_ID: 프로젝트의 프로젝트 ID
REGION: 스포크를 찾을 Google Cloud 리전(예: us-west1)
SPOKE_NAME: 스포크 이름
HUB_NAME: 스포크를 연결할 허브의 이름
KEY: 선택적 라벨 텍스트의 키-값 쌍에 있는 키
VALUE: 선택적 라벨 텍스트의 키-값 쌍에 있는 값
VLAN_ATTACHMENT_NAME: 스포크에 추가할 첫 번째 VLAN 연결의 이름
VLAN_ATTACHMENT_NAME_2: 두 번째 VLAN 연결의 이름
BOOLEAN: 이 스포크에 대해 사이트 간 데이터 전송이 사용 설정되었는지 여부를 확인하는 값. 이 사용 사례에 대한 자세한 내용은 사이트 간 데이터 전송 개요를 참조하세요.
[INCLUDE_IMPORT_RANGES,...]: 허브 서브넷에서 가져오도록 지정된 IP 주소 범위입니다. 목록에는 ALL_IPV4_RANGES만 추가할 수 있습니다. 이 필드가 비어 있으면 스포크가 허브에서 서브넷을 가져오지 않습니다.

VPN 스포크 만들기

VPN 스포크를 만들기 전에 다음 안내를 고려하세요.

HA VPN 터널을 스포크에 연결할 때는 단일 사이트에 연결되는 모든 터널을 모두 단일 스포크로 구성하는 것이 좋습니다. 반대의 경우도 마찬가지입니다. 서로 다른 두 사이트에 연결되는 두 터널은 서로 다른 스포크에 연결해야 합니다. 예를 들어 댈러스의 사무실과 도쿄의 사무실을 연결하려는 경우를 가정해 보겠습니다. 댈러스에 연결되는 터널은 VPC 네트워크를 도쿄에 연결하는 터널과 다른 스포크에 속해 있어야 합니다.
HA VPN 터널을 스포크에 연결할 때는 동일한 Google Cloud 프로젝트에서 서로 다른 리전에 있는 HA VPN 게이트웨이를 서로 연결할 수 없습니다. 이는 HA VPN의 제한사항이며 Network Connectivity Center의 제한사항이 아닙니다.

VPN 스포크를 만드는 데 필요한 리소스 구성에 대한 상세 설명은 다음 문서를 참조하세요.

VPN 리소스 확인에 대한 자세한 내용은 HA VPN 상태 확인을 참조하세요.

이 태스크에 필요한 권한

이 태스크를 수행하려면 다음과 같은 권한 또는 다음과 같은 IAM 역할을 부여받아야 합니다.

권한

networkconnectivity.spokes.create
compute.routers.get
compute.vpnTunnels.get
Google Cloud 콘솔에서 작업하는 경우 특정 네트워크 리소스를 볼 수 있는 권한이 필요합니다. 자세한 내용은 역할 및 권한을 참조하세요.

역할

다음 중 하나입니다.
- 스포크 관리자(roles/networkconnectivity.spokeAdmin)
- 허브 및 스포크 관리자(roles/networkconnectivity.hubAdmin)
Compute Network Viewer(roles/compute.networkViewer)와 같이 Cloud Router 리소스 읽기 권한을 부여하는 역할과 스포크의 리소스 유형(이 경우에는 VPN 터널)
Google Cloud 콘솔에서 작업하는 경우 Compute 네트워크 뷰어(roles/compute.networkViewer)

콘솔

기본 스포크 세부정보 입력

Google Cloud 콘솔에서 Network Connectivity Center 페이지로 이동합니다.

Network Connectivity Center로 이동

프로젝트 메뉴에서 Google Cloud 프로젝트를 선택합니다.
스포크 탭을 클릭합니다.
스포크 추가를 클릭합니다.
새 스포크 양식에서 스포크 유형을 설정합니다.
스포크 이름과 선택사항인 설명을 입력합니다.
새 스포크의 리전 필드를 선택합니다.
사이트 간 데이터 전송에서 설정 또는 해제를 선택합니다. 선택한 리전이 데이터 전송을 지원하지 않으면 필드가 사용 중지됩니다. 이 사용 사례에 대한 자세한 내용은 사이트 간 데이터 전송 개요를 참조하세요.
VPC 네트워크 목록에서 네트워크를 선택합니다. 데이터 전송 기능을 사용하는 스포크가 2개 이상 있으면 모든 스포크가 동일한 VPC 네트워크에 있어야 합니다. 따라서 데이터 전송을 사용하는 스포크를 이미 만든 경우 VPC 네트워크 값이 자동 입력되고 이를 변경할 수 없습니다.

VPN 터널 세부정보 입력

스포크 유형 드롭다운 목록을 VPN 터널로 설정합니다.
스포크의 리전을 선택합니다.
터널을 선택합니다.
1. 터널 추가를 클릭합니다.
2. VPN 터널 드롭다운 메뉴에서 기존 터널을 선택합니다.
원하는 경우 허브에 공지된 서브넷을 하이브리드 스포크에 전파하려면 하이브리드 스포크 필터에서 허브에서 스포크로의 모든 IPv4 범위 포함을 클릭합니다.
이 스포크에 터널을 더 추가하려면 이전 단계를 반복합니다. 완료되면 완료를 클릭하고 계속해서 스포크 저장을 수행합니다.

스포크 저장

스포크를 더 추가하려면 스포크 추가를 클릭하고 스포크 이름을 입력하여 프로세스를 다시 시작합니다.
스포크 추가를 완료하면 만들기를 클릭합니다. Network Connectivity Center 페이지가 업데이트되어 생성한 스포크에 대한 세부정보가 표시됩니다.

gcloud

HA VPN 터널이 포함된 스포크를 만들려면 gcloud network-connectivity spokes linked-vpn-tunnels create 명령어를 사용합니다.

예를 들어 HA VPN 터널이 2개 있고 사이트 간 데이터 전송을 사용하는 스포크를 만들려면 다음 명령어를 입력합니다.

이 스포크에 서브넷 IP 주소 범위 가져오기를 사용 설정하려면(미리보기) --include-import-ranges 플래그를 사용하세요.

  gcloud network-connectivity spokes linked-vpn-tunnels create SPOKE_NAME \
      --hub=HUB_NAME \
      --description="DESCRIPTION" \
      --vpn-tunnels=TUNNEL_NAME,TUNNEL_NAME_2 \
      --region=REGION \
      --labels="KEY"="VALUE" \
      --site-to-site-data-transfer \
      --include-import-ranges=[INCLUDE_IMPORT_RANGES,...]

다음 값을 바꿉니다.

SPOKE_NAME: 스포크 이름
HUB_NAME: 스포크를 연결할 허브의 URI 형식 이름(예:
projects/PROJECT_ID/locations/global/hubs/us-west-to-uk).
DESCRIPTION: 선택사항으로서 스포크를 설명하는 텍스트입니다(예: us-vpn-spoke).
TUNNEL_NAME: 스포크에 추가할 첫 번째 HA VPN 터널 이름입니다.
TUNNEL_NAME_2: 두 번째 HA VPN 터널의 이름(두 번째 터널을 사용할 경우 쉼표와 두 번째 터널 이름 사이에 공백을 생략해야 합니다.)
REGION: 스포크가 있는 Google Cloud 리전
KEY: 선택적 라벨 텍스트의 키-값 쌍에 있는 키
VALUE: 선택적 라벨 텍스트의 키-값 쌍에 있는 값입니다.
[INCLUDE_IMPORT_RANGES,...]: 허브 서브넷에서 가져오도록 지정된 IP 주소 범위입니다. 목록에는 ALL_IPV4_RANGES만 추가할 수 있습니다. 비어 있으면 스포크가 허브에서 서브넷을 가져오지 않습니다.

API

VPN 스포크를 만들려면 networkconnectivity.spokes.create 메서드를 사용합니다. 예를 들어 HA VPN 터널 2개가 포함되어 있고 서브넷 IP 주소 범위 가져오기 포함이 사용 설정된 스포크를 만들려면 다음 요청을 사용합니다.

  POST https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/spokes/SPOKE_NAME
  {
    "hub": "HUB_NAME",
    "labels": {"KEY": "VALUE"},
    "linkedVpnTunnels": {
      "uris": [
        "TUNNEL_NAME",
        "TUNNEL_NAME_2"
      ],
      "siteToSiteDataTransfer": BOOLEAN,
      "includeImportRanges": [INCLUDE_IMPORT_RANGES,...]
    }
  }

다음 값을 바꿉니다.

PROJECT_ID: 프로젝트의 프로젝트 ID
REGION: 스포크를 찾을 Google Cloud 리전(예: us-west1)
SPOKE_NAME: 스포크 이름
HUB_NAME: 스포크를 연결할 허브의 이름
KEY: 선택적 라벨 텍스트의 키-값 쌍에 있는 키
VALUE: 선택적 라벨 텍스트의 키-값 쌍에 있는 값
TUNNEL_NAME: 스포크에 추가할 첫 번째 HA VPN 터널 이름입니다.
TUNNEL_NAME_2: 두 번째 HA VPN 터널의 이름입니다.
BOOLEAN: 이 스포크에 대해 사이트 간 데이터 전송이 사용 설정되었는지 여부를 확인하는 값. 이 사용 사례에 대한 자세한 내용은 사이트 간 데이터 전송 개요를 참조하세요.
[INCLUDE_IMPORT_RANGES,...]: 허브 서브넷에서 가져오도록 지정된 IP 주소 범위입니다. 목록에는 ALL_IPV4_RANGES만 추가할 수 있습니다. 이 필드가 비어 있으면 스포크가 허브에서 서브넷을 가져오지 않습니다.

스포크 나열

스포크를 만들면 항상 허브와 연결됩니다. list spokes 작업을 사용하여 단일 프로젝트 내의 모든 스포크를 나열할 수 있습니다. 이 명령어 모음은 지정된 리전의 스포크를 나열합니다. 허브 설명도 참고하세요.

이 태스크에 필요한 권한

이 태스크를 수행하려면 다음과 같은 권한 또는 다음과 같은 IAM 역할을 부여받아야 합니다.

권한

networkconnectivity.spokes.list

역할

다음 중 하나입니다.
- 허브 및 스포크 뷰어(roles/networkconnectivity.hubViewer)
- 스포크 관리자(roles/networkconnectivity.spokeAdmin
- 허브 및 스포크 관리자(roles/networkconnectivity.hubAdmin)

콘솔

Google Cloud 콘솔에서 Network Connectivity Center 페이지로 이동합니다.

Network Connectivity Center로 이동
프로젝트 메뉴에서 기존 스포크를 표시할 허브가 포함된 프로젝트를 선택합니다.
허브 탭에서 허브를 선택합니다.
스포크 탭을 클릭합니다. 해당 허브에 연결된 모든 스포크가 표시됩니다.
필터 필드를 사용하여 이름, 유형, 상태, ID, 지역, 리소스 수, BGP 세션 또는 설명으로 스포크를 정렬합니다.
특정 스포크의 세부정보를 보려면 스포크 이름을 클릭합니다.

gcloud

기존 스포크를 나열하려면 gcloud network-connectivity spokes list 명령어를 사용합니다.

gcloud network-connectivity spokes list \
    --region=LOCATION

LOCATION을 적절한 리전으로 바꿉니다.

기존 VPC 스포크를 나열하려면 --global 플래그와 함께 동일한 명령어를 사용합니다.

gcloud network-connectivity spokes list \
    --global

필터(미리보기)

특정 그룹에 속한 모든 VPC 스포크를 나열하려면 gcloud network-connectivity hubs list-spokes 명령어를 사용하고 group 필터를 지정합니다.

gcloud network-connectivity hubs list-spokes HUB_NAME \
    --filter="group:GROUP_NAME"

다음 값을 바꿉니다.

HUB_NAME: 스포크를 나열할 허브의 이름
GROUP_NAME: 스포크 그룹의 이름. 지원되는 값은 메시 토폴로지의 경우 default이고 스타 토폴로지 허브의 경우 center 또는 edge입니다.

허브 관리자의 검토 대기 중인 허브와 연결된 모든 VPC 스포크를 나열하려면 동일한 명령어를 사용하고 reason 필터를 지정합니다.

gcloud network-connectivity hubs list-spokes HUB_NAME \
    --filter="reason:PENDING_REVIEW"

HUB_NAME을 스포크를 나열할 허브의 이름으로 바꿉니다.

허브와 연결된 모든 비활성 VPC 스포크를 나열하려면 동일한 명령어를 사용하고 state 필터를 지정합니다.

gcloud network-connectivity hubs list-spokes HUB_NAME \
    --filter="state:INACTIVE"

HUB_NAME을 비활성 스포크를 나열할 허브의 이름으로 바꿉니다.

API

기존 스포크를 나열하려면 networkconnectivity.spokes.list 메서드를 사용합니다.

  GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/spokes

다음 값을 바꿉니다.

PROJECT_ID: 나열할 스포크를 포함하는 프로젝트의 프로젝트 ID
LOCATION: 스포크가 있는 리전(예: VPC 스포크의 경우 us-west1 또는 global)

여러 행의 값이 함께 그룹화되어 하나의 요약 값을 형성하도록 하는 기존 스포크의 집계 목록을 가져오려면 와일드 카드로 locations 뒤에 하이픈 (-)를 가지고 있는 networkconnectivity.spokes.list 메서드를 사용합니다.

  GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/-/spokes

스포크 설명

기존 스포크에 대한 자세한 정보를 확인하려면 다음 안내를 따르세요.

이 태스크에 필요한 권한

이 태스크를 수행하려면 다음과 같은 권한 또는 다음과 같은 IAM 역할을 부여받아야 합니다.

권한

networkconnectivity.spokes.describe
또한 Google Cloud 콘솔에서 작업하는 경우:
- networkconnectivity.hubs.get
- networkconnectivity.hubs.list
- networkconnectivity.spokes.list
- compute.projects.get

역할

다음 중 하나입니다.
- 허브 및 스포크 뷰어(roles/networkconnectivity.hubViewer)
- 스포크 관리자(roles/networkconnectivity.spokeAdmin
- 허브 및 스포크 관리자(roles/networkconnectivity.hubAdmin)
Google Cloud 콘솔에서 작업하는 경우 Compute 네트워크 뷰어(roles/compute.networkViewer)

콘솔

Google Cloud 콘솔에서 Network Connectivity Center 페이지로 이동합니다.

Network Connectivity Center로 이동
프로젝트 메뉴에서 프로젝트를 선택합니다.
허브 탭에서 허브를 선택합니다. 해당 허브에 연결된 모든 스포크가 표시됩니다.
특정 스포크의 세부정보를 보려면 다음 중 하나를 수행합니다.
- 스포크 이름 열에서 스포크를 선택하여 스포크 세부정보 페이지를 봅니다.
- 스포크 탭에서 스포크 이름 열을 클릭한 다음 스포크를 선택하여 스포크 세부정보 페이지를 봅니다.

gcloud

스포크를 설명하려면 gcloud network-connectivity spokes describe 명령어를 사용합니다.

  gcloud network-connectivity spokes describe SPOKE_NAME \
      --region=LOCATION

다음 값을 바꿉니다.

SPOKE_NAME: 스포크 이름
LOCATION: 스포크가 있는 리전

VPC 스포크를 설명하려면 --global 플래그와 함께 동일한 명령어를 사용합니다.

  gcloud network-connectivity spokes describe SPOKE_NAME \
      --global

SPOKE_NAME을 스포크 이름으로 바꿉니다.

API

스포크를 설명하려면 networkconnectivity.spokes.get 메서드를 사용합니다.

 GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/spokes/SPOKE_NAME

다음 값을 바꿉니다.

PROJECT_ID: 스포크가 포함된 프로젝트의 프로젝트 ID
LOCATION: 스포크가 있는 리전(예: VPC 스포크의 경우 us-west1 또는 global)
SPOKE_NAME: 스포크 이름

스포크 업데이트

스포크가 생성된 후 업데이트할 수 있는 항목은 다음과 같습니다.

스포크 설명
스포크에 적용되는 라벨입니다. 라벨에 대한 자세한 내용은 라벨 요구사항을 참조하세요.
스포크가 라우터 어플라이언스 스포크인 경우 기본 리소스를 변경할 수 있습니다. 하지만 새 리소스가 원래 리소스와 동일한 VPC 네트워크에 있어야 합니다.
허브 서브넷에서 가져오도록 지정된 IP 주소 범위

이 태스크에 필요한 권한

이 태스크를 수행하려면 다음과 같은 권한 또는 다음과 같은 IAM 역할을 부여받아야 합니다.

권한

networkconnectivity.spokes.update

역할

다음 중 하나입니다.
- 스포크 관리자(roles/networkconnectivity.spokeAdmin
- 허브 및 스포크 관리자(roles/networkconnectivity.hubAdmin)

콘솔

라우터 어플라이언스 스포크에서 사용하는 리소스를 변경하려면 다음 단계를 완료하세요.

Google Cloud 콘솔에서 Network Connectivity Center 페이지로 이동합니다.

Network Connectivity Center로 이동
프로젝트 메뉴에서 프로젝트를 선택합니다.
스포크 탭을 클릭합니다.
수정하려는 스포크의 이름을 클릭합니다.
다음 작업 중 하나를 수행합니다.
- 리소스를 추가하려면 인스턴스 추가를 클릭하고 표시되는 메시지를 따라 VM을 하나 이상 선택합니다. 완료되면 확인을 클릭합니다.
- 리소스를 삭제하려면 삭제할 VM을 선택하고 인스턴스 삭제를 클릭합니다. 확인 대화상자에서 확인을 클릭합니다.

gcloud

스포크를 업데이트하려면 다음 명령어 중 하나를 사용합니다.

모든 하이브리드 스포크 유형의 목록에 ALL_IPV4_RANGES를 추가하여 허브 서브넷에서 가져오도록 지정된 IP 주소 범위를 업데이트할 수 있습니다.

설명, 라벨 업데이트 및 IP 주소 범위 포함

라우터 어플라이언스 스포크의 설명, 라벨을 업데이트하고 IP 주소 범위를 포함하려면 다음 명령어를 실행합니다.

  gcloud network-connectivity spokes linked-router-appliances update SPOKE_NAME \
      --description="DESCRIPTION" \
      --region=LOCATION \
      --update-labels="KEY"="VALUE" \
      --include-import-ranges="[INCLUDE_IMPORT_RANGES,...]"

다음 값을 바꿉니다.

SPOKE_NAME: 업데이트할 스포크의 이름
DESCRIPTION: 스포크에 대한 새 설명
LOCATION: 스포크가 있는 Google Cloud 리전(예: us-west1 또는 global)
KEY: 키-값 쌍에 있는 키
VALUE: 키-값 쌍에 있는 값
[INCLUDE_IMPORT_RANGES,...]: 허브 서브넷에서 가져오도록 지정된 IP 주소 범위입니다. 목록에는 ALL_IPV4_RANGES만 추가할 수 있습니다. 이 필드가 비어 있으면 스포크가 허브에서 서브넷을 가져오지 않습니다.

라우터 어플라이언스 스포크의 기본 리소스 업데이트

필요한 경우 새 리소스가 원래 리소스와 동일한 VPC 네트워크에 있는 한 다른 라우터 어플라이언스 인스턴스를 사용하도록 라우터 어플라이언스 스포크를 업데이트할 수 있습니다. 기존 리소스를 새 리소스로 바꾸려면 다음 명령어를 실행합니다.

  gcloud network-connectivity spokes linked-router-appliances update SPOKE_NAME \
      --region=LOCATION \
      --router-appliance=instance="ROUTER_APPLIANCE_URI",ip=IP_ADDRESS

다음 값을 바꿉니다.

SPOKE_NAME: 스포크 이름
LOCATION: 스포크가 있는 Google Cloud 리전입니다(예: us-west1).
ROUTER_APPLIANCE_URI: 스포크와 연결할 새 라우터 어플라이언스 인스턴스의 URI, 예를 들면 다음과 같습니다.
```
"https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME"
```
IP_ADDRESS: 새 라우터 어플라이언스 인스턴스의 내부 IP 주소입니다.

API

스포크를 업데이트하려면 networkconnectivity.spokes.patch 메서드를 사용합니다.

설명 및 라벨 업데이트

라우터 어플라이언스 스포크의 설명 및 라벨을 업데이트하려면 다음 요청을 사용합니다.

 PATCH https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/spokes/SPOKE_NAME
 {
   "description": "DESCRIPTION"
   "labels": {
     "KEY": "VALUE"
     "includeImportRanges": [INCLUDE_IMPORT_RANGES,...]
   }
 }

다음 값을 바꿉니다.

PROJECT_ID: 스포크가 포함된 프로젝트의 프로젝트 ID
REGION: 스포크가 있는 리전(예: us-west1)
SPOKE_NAME: 업데이트할 스포크의 이름
DESCRIPTION: 스포크에 대한 새 설명
KEY: 키-값 쌍에 있는 키
VALUE: 키-값 쌍에 있는 값
[INCLUDE_IMPORT_RANGES,...]: 허브 서브넷에서 가져오도록 지정된 IP 주소 범위입니다. 목록에는 ALL_IPV4_RANGES만 추가할 수 있습니다. 이 필드가 비어 있으면 스포크가 허브에서 서브넷을 가져오지 않습니다.

라우터 어플라이언스 스포크의 기본 리소스 업데이트

필요한 경우 새 리소스가 원래 리소스와 동일한 VPC 네트워크에 있는 한 다른 라우터 어플라이언스 인스턴스를 사용하도록 라우터 어플라이언스 스포크를 업데이트할 수 있습니다. 기존 리소스를 새 리소스로 바꾸려면 다음 요청을 사용합니다.

 PATCH https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/spokes/SPOKE
 {
   "linkedRouterApplianceInstances": {
     "instances": [
       {
         "virtualMachine": "ROUTER_APPLIANCE_URI",
         "ipAddress": "IP_ADDRESS",
       }
     ]
   }
 }

다음 값을 바꿉니다.

PROJECT_ID: 스포크가 포함된 프로젝트의 프로젝트 ID
REGION: 스포크가 있는 리전(예: us-west1)
SPOKE: 스포크 이름입니다.
ROUTER_APPLIANCE_URI: 스포크와 연결할 새 라우터 어플라이언스 인스턴스의 URI, 예를 들면 다음과 같습니다.
```
"https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME"
```
IP_ADDRESS: 새 라우터 어플라이언스 인스턴스의 내부 IP 주소입니다.

스포크 삭제

스포크를 삭제하면 해당 스포크의 리소스도 분리됩니다. 즉, 스포크를 삭제해도 리소스가 삭제되지 않으며 스포크에서 연결만 해제됩니다.

프로듀서 VPC 스포크 (미리보기)와 연결된 VPC 스포크를 삭제하려면 먼저 프로듀서 VPC 스포크를 삭제해야 합니다.

이 태스크에 필요한 권한

이 태스크를 수행하려면 다음과 같은 권한 또는 다음과 같은 IAM 역할을 부여받아야 합니다.

권한

networkconnectivity.spokes.delete
또한 Google Cloud 콘솔에서 작업하는 경우:
- networkconnectivity.hubs.get
- networkconnectivity.hubs.list
- networkconnectivity.spokes.list
- compute.projects.get

역할

다음 중 하나입니다.
- 스포크 관리자(roles/networkconnectivity.spokeAdmin
- 허브 및 스포크 관리자(roles/networkconnectivity.hubAdmin)
Google Cloud 콘솔에서 작업하는 경우 Compute 네트워크 뷰어(roles/compute.networkViewer)

콘솔

Google Cloud 콘솔에서 Network Connectivity Center 페이지로 이동합니다.

Network Connectivity Center로 이동
프로젝트 메뉴에서 프로젝트를 선택합니다.
스포크 탭을 클릭합니다.
프로젝트의 스포크 이름 목록을 봅니다.
삭제할 스포크를 선택합니다.
스포크 삭제를 클릭합니다.
확인 대화상자에서 다음 중 하나를 수행합니다.
- 스포크를 삭제하지 않으려면 취소를 클릭합니다.
- 스포크를 삭제하려면 삭제를 클릭합니다.

gcloud

스포크를 삭제하려면 gcloud network-connectivity spokes delete 명령어를 사용합니다.

  gcloud network-connectivity spokes delete SPOKE_NAME \
      --region=REGION

다음 값을 바꿉니다.

SPOKE_NAME: 삭제할 스포크의 이름
REGION: 스포크가 있는 리전. 이 옵션은 전체 스포크 이름에서 나열된 리전 외에 추가로 필요한 항목입니다. VPC 스포크를 삭제하는 경우 --global을 지정해야 합니다.

API

기존 스포크를 삭제하려면 networkconnectivity.spokes.delete 메서드를 사용합니다.

  DELETE https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/spokes/SPOKE_NAME

다음 값을 바꿉니다.

PROJECT_ID: 삭제할 스포크가 포함된 프로젝트의 프로젝트 ID
LOCATION: 스포크가 있는 리전(예: VPC 스포크의 경우 us-west1 또는 --global).
SPOKE_NAME: 삭제할 스포크의 이름

다음 단계

솔루션이 Network Connectivity Center와 통합된 파트너 목록을 보려면 Network Connectivity Center 파트너를 참조하세요.
라우터 어플라이언스 문제의 해결 방법은 문제 해결 참조하기
API 및 Google Cloud CLI 명령어에 대한 자세한 내용은 API 및 참조 살펴보기