노드 IP 주소 관리

이 문서에서는 Google Distributed Cloud의 관리자 클러스터와 사용자 클러스터에 필요한 IP 주소 수에 대한 안내를 제공합니다.

DHCP 또는 고정

네트워크에 DHCP 서버가 있는 경우 DHCP 서버에서 워커 노드의 IP 주소를 가져오도록 관리자 클러스터 또는 사용자 클러스터를 구성할 수 있습니다. 클러스터 구성 파일에서 network.ipMode.type을 "dhcp"로 설정합니다.

클러스터에 고정 IP 주소를 지정하려면 network.ipMode.type을 'static'으로 설정합니다.

관리자 클러스터에 필요한 IP 주소는 몇 개인가요?

고가용성(HA) 관리자 클러스터에는 제어 영역 노드에 사용할 수 있는 IP 주소 3개가 있어야 합니다.

관리자 클러스터는 하나 이상의 사용자 클러스터를 관리합니다. 사용자 클러스터에 Controlplane V2가 사용 설정되었으면 사용자 클러스터 제어 영역 노드가 사용자 클러스터에서 실행됩니다. Controlplane V2가 사용 설정된 사용자 클러스터는 관리자 클러스터에 필요한 IP 주소 수에 영향을 미치지 않습니다.

사용자 클러스터에 Controlplane V2가 사용 설정되지 않은 경우 사용자 클러스터의 제어 영역은 관리자 클러스터(kubeception)의 하나 이상의 노드에서 실행됩니다. kubeception의 경우 관리자 클러스터에는 다음 IP 주소도 필요합니다.

각 HA 사용자 클러스터의 경우 사용자 클러스터의 제어 영역을 실행하려면 관리자 클러스터에 3개의 노드가 필요합니다.
각 비HA 사용자 클러스터의 경우 사용자 클러스터의 제어 영역을 실행하려면 관리자 클러스터에 1개의 노드가 필요합니다.

Controlplane V2가 사용 설정되지 않은 상태에서 사용자 클러스터를 추가하려면 먼저 사용자 클러스터 제어 영역 노드에 대한 관리자 클러스터에 사용 가능한 IP 주소가 충분한지 확인합니다. DHCP를 사용하는 경우 DHCP 서버가 추가 IP 주소를 제공할 수 있는지 확인하세요.

예시:

설명	IP 주소 수
Controlplane V2 사용자 클러스터를 관리하는 HA 관리자 클러스터 제어 영역 노드 3개	3
HA kubeception 사용자 클러스터를 관리하는 HA 관리자 클러스터 제어 영역 노드 3개 + 사용자 클러스터 제어 영역 노드 3개	6

사용자 클러스터에 필요한 IP 주소는 몇 개인가요?

Controlplane V2가 사용 설정되었으면 (기본적으로) 사용자 클러스터에서 제어 영역을 실행하기 위해 1개 또는 3개의 노드가 존재합니다.
- 고가용성이 아닌(비HA) 사용자 클러스터용 노드 1개
- HA 사용자 클러스터용 노드 3개
각 워커 노드(워크로드를 실행하는 노드)용 IP 주소 1개
업그레이드, 업데이트, 자동 복구 중에 임시 노드로 사용할 추가 IP 주소 1개

Controlplane V2가 사용 설정된 상태에서 사용자 클러스터에 워커 노드를 추가하려면 먼저 제어 영역 코드에 대한 사용자 클러스터에 사용 가능한 IP 주소가 충분한지 확인합니다. DHCP를 사용하는 경우 DHCP 서버가 추가 IP 주소를 제공할 수 있는지 확인하세요.

예시:

설명	IP 주소 수
비HA 사용자 클러스터, Controlplane V2 워커 노드 3개 + 제어 영역 노드 1개 + 추가 노드 1개	5
HA 사용자 클러스터, Controlplane V2 워커 노드 3개 + 제어 영역 노드 3개 + 추가 노드 1개	7
사용자 클러스터, kubeception 워커 노드 3개 + 추가 노드 1개	4

관리자 클러스터용 고정 IP 주소

이 섹션에서는 관리자 클러스터의 고정 IP 주소를 관리하는 방법을 설명합니다.

관리자 클러스터 제어 영역 노드에 3개의 IP 주소를 지정해야 합니다. 관리자 클러스터 구성 파일의 network.controlPlaneIPBlock 섹션에 이러한 주소를 지정합니다.

kubeception 사용자 클러스터를 만들려면 사용자 클러스터의 제어 영역 노드에 사용할 IP 주소를 지정해야 합니다. IP 블록 파일에 이러한 주소를 지정합니다. 그런 다음 관리자 클러스터 구성 파일에서 network.ipMode.ipBlockFilePath 필드에 IP 블록 파일의 경로를 제공합니다.

예를 들어 2개의 kubeception 사용자 클러스터, HA 1개 및 비HA 1개를 만든다고 가정합니다. HA 사용자 클러스터는 관리 클러스터에 3개의 제어 영역 노드가 있으며 비HA 사용자 클러스터는 관리자 클러스터에 1개의 제어 영역 노드를 가집니다. 따라서 4개의 IP 주소와 업데이트 중 사용할 추가 IP 주소를 지정해야 합니다.

다음은 IP 주소가 5개 있는 IP 블록 파일의 예시입니다.

blocks:
  - netmask: 255.255.255.0
    gateway: 172.16.20.1
    ips:
    - ip: 172.16.20.50
      hostname: admin-vm-1
    - ip: 172.16.20.51
      hostname: admin-vm-2
    - ip: 172.16.20.52
      hostname: admin-vm-3
    - ip: 172.16.20.53
      hostname: admin-vm-4
    - ip: 172.16.20.54
      hostname: admin-vm-5

IP 주소를 관리자 클러스터에 추가

관리자 클러스터의 노드에 더 많은 IP 주소를 사용하려면 주소를 IP 블록 파일에 추가한 후 다음 명령어를 실행하여 관리자 클러스터를 업데이트합니다.

gkectl update admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG--config ADMIN_CLUSTER_CONFIG

다음을 바꿉니다.

ADMIN_CLUSTER_KUBECONFIG: 관리자 클러스터 kubeconfig 파일의 경로
ADMIN_CLUSTER_CONFIG: 관리자 클러스터 구성 파일의 경로

사용자 클러스터용 고정 IP 주소

이 섹션에서는 사용자 클러스터의 고정 IP 주소를 관리하는 방법을 설명합니다.

사용자 클러스터 노드에 사용할 수 있는 IP 주소 확인

사용자 클러스터의 IP 블록 파일이 사용자 클러스터 구성 파일에 network.ipMode.ipBlockFilePath 값으로 나열되어 있습니다. IP 블록 파일에서 사용자 클러스터의 에 사용할 수 있는 IP 주소를 확인할 수 있습니다.

예를 들어 IP 주소가 4개 있는 IP 블록 파일은 다음과 같습니다.

blocks:
  - netmask: 255.255.255.0
    gateway: 172.16.20.1
    ips:
    - ip: 172.16.20.55
      hostname: user-vm-1
    - ip: 172.16.20.56
      hostname: user-vm-2
    - ip: 172.16.20.57
      hostname: user-vm-3
    - ip: 172.16.20.58
      hostname: user-vm-4

IP 블록 파일에는 사용자 클러스터의 제어 영역 노드에 대한 주소가 포함되지 않습니다. 사용자 클러스터에 Controlplane V2가 사용 설정되었으면 제어 영역 노드의 IP 주소는 사용자 클러스터 구성 파일의 network.controlPlaneIPBlock 섹션에 있습니다. 그렇지 않으면 사용자 클러스터의 제어 영역 노드의 IP 주소는 관리자 클러스터의 IP 블록 파일에 있습니다.

사용자 클러스터에 IP 주소 추가

사용자 클러스터의 노드에 더 많은 IP 주소를 사용하려면 IP 블록 파일에 주소를 추가한 후 다음 명령어를 실행하여 사용자 클러스터를 업데이트합니다.

gkectl update cluster --kubeconfig ADMIN_CLUSTER_KUBECONFIG--config USER_CLUSTER_CONFIG