New-AksHciClusterNetwork

摘要

创建虚拟网络,以便为控制平面、负载均衡器、代理终结点设置 DHCP 或静态 IP 地址,并为工作负载群集设置静态 IP 范围。

语法

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>                              

说明

创建虚拟网络,以便为控制平面、负载均衡器、代理终结点设置 DHCP 或静态 IP 地址,并为工作负载群集中的节点设置静态 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

参数

-name

虚拟网络的描述性名称。 若要获取可用虚拟网络的名称列表,请运行命令 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

-gateway

子网默认网关的 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”。

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 参考