New-AksHciClusterNetwork

아티클
04/27/2023

개요

가상 네트워크를 만들어 컨트롤 플레인, 부하 분산 장치, 에이전트 엔드포인트 및 워크로드 클러스터에 대한 고정 IP 범위에 대한 DHCP 또는 고정 IP 주소를 설정합니다.

Syntax

DHCP 가상 네트워크 구성

VLAN이 없는 DHCP 구성의 경우:

New-AksHciClusterNetwork -name <String>
                         -vswitchName <String>
                         -vipPoolStart <IP address>
                         -vipPoolEnd <IP address>

VLAN을 사용하는 DHCP 구성의 경우:

New-AksHciClusterNetwork -name <String>
                         -vswitchName <String>
                         -vipPoolStart <IP address>
                         -vipPoolEnd <IP address>
                         -vlanID <int>

고정 IP 가상 네트워크 구성

VLAN이 없는 고정 IP 구성의 경우:

New-AksHciClusterNetwork -name <String>
                         -vswitchName <String>
                         -gateway <String>
                         -dnsServers <String[]>
                         -ipAddressPrefix <String> 
                         -vipPoolStart <IP address>
                         -vipPoolEnd <IP address>
                         -k8sNodeIpPoolStart <IP address>
                         -k8sNodeIpPoolEnd <IP address>

VLAN을 사용하는 고정 IP 구성의 경우:

New-AksHciClusterNetwork -name <String>
                         -vswitchName <String>
                         -gateway <String>
                         -dnsServers <String[]>
                         -ipAddressPrefix <String>
                         -vipPoolStart <IP address>
                         -vipPoolEnd <IP address>
                         -k8sNodeIpPoolStart <IP address>
                         -k8sNodeIpPoolEnd <IP address>
                         -vlanID <int>

Description

가상 네트워크를 만들어 컨트롤 플레인, 부하 분산 장치, 에이전트 엔드포인트 및 워크로드 클러스터의 노드에 대한 고정 IP 범위에 대한 DHCP 또는 고정 IP 주소를 설정합니다. 이 cmdlet은 새 워크로드 클러스터를 만들 때 구성 단계의 뒷부분에서 사용할 수 있는 VirtualNetwork 개체를 반환합니다. 필요한 만큼의 가상 네트워크를 만들 수 있습니다.

예제

아래 예제를 사용하여 고정 IP 또는 DHCP를 사용하여 가상 네트워크를 구성합니다. 환경에 대한 예제에 지정된 값을 사용자 지정해야 합니다. 고정 IP 또는 DHCP를 사용하여 가상 네트워크를 구성한 후 New-AksHciCluster 를 실행하여 클러스터를 배포합니다.

VLAN 없이 고정 IP 환경을 사용하여 배포

$vnet = New-AksHciClusterNetwork -name <String> -vswitchName <String> -gateway <String> -dnsServers <String[]> -ipAddressPrefix <String> -vipPoolStart <IP address> -vipPoolEnd <IP address> -k8sNodeIpPoolStart <IP address> -k8sNodeIpPoolEnd <IP address>

고정 IP 환경 및 VLAN을 사용하여 배포

$vnet = New-AksHciClusterNetwork -name <String> -vswitchName <String> -gateway <String> -dnsServers <String[]> -ipAddressPrefix <String> -vipPoolStart <IP address> -vipPoolEnd <IP address> -k8sNodeIpPoolStart <IP address> -k8sNodeIpPoolEnd <IP address> -vlanID <int>

VLAN 없이 DHCP 환경으로 배포

$vnet = New-AksHciClusterNetwork -name MyClusterNetwork -vnetName "External" -vipPoolStart "172.16.255.0" -vipPoolEnd "172.16.255.254"

DHCP 환경 및 VLAN을 사용하여 배포

$vnet = New-AksHciClusterNetwork -name MyClusterNetwork -vnetName "External" -vipPoolStart "172.16.255.0" -vipPoolEnd "172.16.255.254" -vlanID 7

매개 변수

-이름

가상 네트워크의 설명이 포함된 이름입니다. 사용 가능한 가상 네트워크의 이름 목록을 얻으려면 Get-AksHciClusterNetwork 명령을 실행합니다.

Type: System.String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-vswitchName

외부 스위치의 이름입니다. 사용 가능한 스위치의 이름 목록을 얻으려면 명령을 Get-VMSwitch실행합니다.

Type: System.String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-게이트웨이

서브넷의 기본 게이트웨이 IP 주소입니다.

Type: System.String
Parameter Sets: (StaticIP)
Aliases:
Required: False (This is required when creating a network with a static IP.)
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-dnsServers

고정 IP를 사용하여 네트워크를 만들 때 필요합니다. 이 매개 변수는 서브넷에 사용할 DNS 서버를 가리키는 IP 주소 배열을 만듭니다. "8.8.8.8","192.168.1.1"과 같이 최소 1개 및 최대 3개의 서버를 제공할 수 있습니다.

Type: System.String[]
Parameter Sets: (StaticIP)
Aliases:
Required: False (This is required when creating a network with a static IP.)
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ipAddressPrefix

고정 IP 할당에 사용할 주소 접두사입니다.

Type: System.String
Parameter Sets: (StaticIP)
Aliases:
Required: False (This is required when creating a network with a static IP.)
Position: Named
Default value: external
Accept pipeline input: False
Accept wildcard characters: False

-vipPoolStart

VIP 풀의 시작 IP 주소입니다. 주소는 DHCP 서버에서 제공하는 범위 또는 서브넷 CIDR에 제공된 범위 내에 있어야 합니다. VIP 풀의 IP 주소는 API 서버 및 Kubernetes 서비스에 사용됩니다. DHCP를 사용하는 경우 가상 IP 주소가 DHCP IP 예약의 일부인지 확인합니다. 고정 IP를 사용하는 경우 가상 IP가 동일한 서브넷에 있는지 확인합니다.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-vipPoolEnd

VIP 풀의 끝 IP 주소입니다. 주소는 DHCP 서버에서 제공하는 범위 또는 서브넷 CIDR에 제공된 범위 내에 있어야 합니다. VIP 풀의 IP 주소는 API 서버 및 Kubernetes 서비스에 사용됩니다. DHCP를 사용하는 경우 가상 IP 주소가 DHCP IP 예약의 일부인지 확인합니다. 고정 IP를 사용하는 경우 가상 IP가 동일한 서브넷에 있는지 확인합니다.

Type: System.String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-k8sNodeIpPoolStart

VM 풀의 시작 IP 주소입니다. 주소는 서브넷 범위에 있어야 합니다. 이는 고정 IP 배포에 필요합니다.

Type: System.String
Parameter Sets: (StaticIP)
Aliases:
Required: False (This is required when creating a network with a static IP.)
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-k8sNodeIpPoolEnd

VM 풀의 끝 IP 주소입니다. 주소는 서브넷 범위에 있어야 합니다. 이는 고정 IP 배포에 필요합니다.

Type: System.String
Parameter Sets: (StaticIP)
Aliases:
Required: False (This is required when creating a network with a static IP.)
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-vlanID

네트워크의 VLAN ID를 지정합니다. 생략하면 네트워크에 태그가 지정되지 않습니다.

Type: System.Int32
Parameter Sets: (All)
Aliases:
Required: False (This parameter is required if you configure a virtual network with a VLAN.)
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

다음 단계

AksHci PowerShell 참조