IP 블록 파일

이 페이지에서는 Google Distributed Cloud 설정에 사용되는 IP 블록 파일의 필드를 설명합니다.

IP 블록 파일을 사용하여 노드 머신 집합과 머신이 연결된 네트워크를 설명합니다. 클러스터마다 별도의 IP 블록 파일을 만듭니다. 관리자 및 사용자 클러스터 구성 파일에는 network.ipMode.ipBlockFilePath라는 필드가 있습니다. 이 필드에 IP 블록의 절대 경로 또는 상대 경로를 지정합니다.

다음과 같은 경우 IP 블록 파일을 사용하여 IP 주소와 호스트 이름(선택사항)을 나열합니다.

  • 사용자 클러스터:

    • 사용자 클러스터 구성 파일에서 network.ipMode.type이 "static"로 설정된 경우 사용자 클러스터 IP 블록 파일에 워커 노드의 IP 주소를 나열합니다.

    • 관리자 클러스터 구성 파일에 infraConfigFilePath가 구성된 경우 (토폴로지 도메인 사용 설정) 사용자 클러스터 IP 블록 파일에 컨트롤 플레인 노드의 IP 주소를 나열합니다. 워커 노드에서 DHCP를 사용하더라도 컨트롤 플레인 노드의 IP 주소는 항상 고정 IP 주소입니다.

  • 관리자 클러스터:

    • 관리자 클러스터 구성 파일에 infraConfigFilePath가 구성된 경우 (토폴로지 도메인 사용 설정) 관리자 클러스터 IP 블록 파일에 컨트롤 플레인 노드의 IP 주소를 나열합니다.

    • 1.16 이하 비HA 관리자 클러스터: 관리자 클러스터 IP 블록 파일에 컨트롤 플레인 노드 및 부가기능 노드의 IP 주소를 나열합니다.

    • 1.16 이하 HA 관리자 클러스터: IP 블록 파일에 부가기능 노드의 IP 주소를 나열합니다.

    • 1.29 이하 kubeception 사용자 클러스터: 관리자 클러스터 IP 블록 파일에 사용자 클러스터 컨트롤 플레인 노드의 IP 주소를 나열합니다.

템플릿

IP 블록 파일의 필드 입력

이 섹션에서는 IP 블록 파일의 필드를 설명합니다.

blocks

객체의 배열이며, 각각 호스트 집합을 설명합니다.

blocks[i].netmask

문자열. 호스트 집합의 서브넷 마스크입니다. 예를 들면 다음과 같습니다.

blocks:
- netmask: "255.255.252.0"

blocks[i].gateway

문자열. 호스트 집합의 기본 게이트웨이의 주소입니다. 예를 들면 다음과 같습니다.

blocks:
- netmask: "255.255.252.0"
  gateway: "172.16.23.254"

blocks[i].ips

객체의 배열. 각 객체에는 개별 IP 주소 또는 IP 주소의 CIDR 블록이 있습니다.

  • 객체에 개별 IP 주소가 있다면 선택적으로 호스트 이름도 있을 수 있습니다.

  • ip을 CIDR 블록으로 설정하면 hostname의 값을 지정하지 마세요.

  • hostname 값을 지정하지 않으면 Google Distributed Cloud는 vSphere의 VM 이름을 호스트 이름으로 사용합니다.

blocks[i].isControlPlane

관리자 클러스터 구성 파일에 infraConfigFilePath가 구성되어 있고 IP 주소가 컨트롤 플레인 노드용인 경우 isControlPlane: true를 포함합니다. 사용자 클러스터 워커 노드의 경우 false을 지정하거나 기본값이 false이므로 필드를 생략합니다.

구성 파일 예시

이 섹션에서는 예시 값이 채워진 몇 가지 구성을 제공합니다.

예 1

이 예시에서는 6개의 IP 주소(개별 주소 2개 및 4개 주소의 CIDR 블록)를 지정합니다.

blocks:
- netmask: "255.255.252.0"
  gateway: "203.0.113.1"
  ips:
  - ip: 198.51.100.10
    hostname: worker-node1
  - ip: 198.51.100.11
    hostname: worker-node2
  - ip: 198.51.100.12/30  # 198.51.100.12 - 198.51.100.15

예 2

이 예에서는 토폴로지 도메인에 맞게 구성된 IP 블록 파일을 보여줍니다.

blocks:
- netmask: 255.255.255.0
  gateway: 100.115.222.254
  ips:
  - ip: 100.115.222.204
    hostname: worker-1
  - ip: 100.115.222.205
    hostname: cp-1
    isControlPlane: true
  - ip: 100.115.222.206
    hostname: cp-2
    isControlPlane: true
  - ip: 100.115.222.207
    hostname: cp-3
    isControlPlane: true
  - ip: 100.115.222.220/28 # 100.115.222.208 - 100.115.222.223
- netmask: 255.255.255.0
  gateway: 100.115.223.254
  ips:
  - ip: 100.115.223.206
    hostname: worker-2
  - ip: 100.115.223.220/28 # 100.115.223.208 - 100.115.223.223
- netmask: 255.255.255.0
  gateway: 100.115.224.254
  ips:
  - ip: 100.115.224.206
    hostname: worker-3
  - ip: 100.115.224.220/28 # 100.115.224.208 - 100.115.224.223

이 예시 IP 블록 파일은 서브넷 3개에서 IP 주소를 예약했으며 각 서브넷은 blocks[i]로 표시됩니다. blocks[i].gateway는 IP 블록의 식별자로 작동하므로 중요합니다. vSphere 인프라 구성 파일 내의 VSphereInfraConfig 커스텀 리소스에 있는 topologyDomains[i].network.gateway에 동일한 IP 주소를 추가합니다.

isControlPlane: true로 구성된 IP가 3개 있습니다. 이는 이러한 IP 주소가 컨트롤 플레인 노드 전용으로 예약되어 있음을 나타냅니다. 관리자 클러스터 또는 사용자 클러스터의 IP 블록 파일에는 컨트롤 플레인 노드용으로 예약된 IP 주소가 3개 있어야 합니다. 클러스터의 해당 토폴로지에 따라 대상 서브넷에 예약합니다.

컨트롤 플레인 노드는 단일 토폴로지 도메인에 있어야 하므로 컨트롤 플레인 노드의 IP 주소는 동일한 IP 블록에 있어야 합니다.