Set-AksHciConfig

Sinopsis

Establece o actualiza los valores de configuración del host de Azure Kubernetes Service.

Sintaxis

Establecer configuración para el host

Set-AksHciConfig  -imageDir <String>
                  -workingDir <String>
                  -cloudConfigLocation <String>
                  -vnet <Virtual Network>
                 [-createAutoConfigContainers {true, false}]
                 [-offlineDownload]
                 [-offsiteTransferCompleted]
                 [-mode {minimum, full}]
                 [-stagingShare <String>]
                 [-nodeConfigLocation <String>]
                 [-controlPlaneVmSize <VmSize>]
                 [-sshPublicKey <String>]
                 [-macPoolStart <String>]
                 [-macPoolEnd <String>]       
                 [-proxySettings <ProxySettings>]
                 [-cloudServiceCidr <String>]
                 [-version <String>]
                 [-nodeAgentPort <int>]
                 [-nodeAgentAuthorizerPort <int>]
                 [-cloudAgentPort <int>]
                 [-cloudAgentAuthorizerPort <int>]
                 [-clusterRoleName <String>]
                 [-cloudLocation <String>]
                 [-concurrentDownloads <int>]
                 [-skipHostLimitChecks]
                 [-skipRemotingChecks]
                 [-skipValidationChecks]
                 [-insecure]
                 [-skipUpdates]
                 [-forceDnsReplication]   

Descripción

Establece los valores de configuración del host de Azure Kubernetes Service. Si va a realizar la implementación en un clúster Azure Stack HCI de 2 a 4 nodos o un clúster de conmutación por error de Windows Server 2019 Datacenter, debe especificar los parámetros -workingDir y -cloudConfigLocation. Para un centro de datos de Windows Server 2019 de un solo nodo, todos los parámetros son opcionales y se establecen en sus valores predeterminados. Sin embargo, para obtener un rendimiento óptimo, le recomendamos usar una implementación de clúster de Azure Stack HCI de entre 2 y 4 nodos.

Ejemplos

Para implementar en un clúster de 2 a 4 nodos con redes DHCP

PS C:\> $vnet = New-AksHciNetworkSetting -name newNetwork -vswitchName "DefaultSwitch" -vipPoolStart "172.16.255.0" -vipPoolEnd "172.16.255.254" 

Set-AksHciConfig -workingDir c:\ClusterStorage\Volume1\WorkDir -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16"

Para implementar con redes IP estáticas

PS C:\> $vnet = New-AksHciNetworkSetting -name newNetwork -vswitchName "DefaultSwitch" -k8snodeippoolstart "172.16.10.0" -k8snodeippoolend "172.16.10.255" -vipPoolStart "172.16.255.0" -vipPoolEnd "172.16.255.254" -ipaddressprefix "172.16.0.0/16" -gateway "172.16.0.1" -dnsservers "172.16.0.1" 

Set-AksHciConfig -workingDir c:\ClusterStorage\Volume1\WorkDir -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16"

Para implementar con un servidor proxy

PS C:\> $proxySettings = New-AksHciProxySetting -name "corpProxy" -http http://contosoproxy:8080 -https https://contosoproxy:8443 -noProxy localhost,127.0.0.1,.svc,10.96.0.0/12,10.244.0.0/16 -credential $proxyCredential

Set-AksHciConfig -workingDir c:\ClusterStorage\Volume1\WorkDir -cloudConfigLocation c:\clusterstorage\volume1\Config -proxySetting $proxySettings -vnet $vnet -cloudservicecidr "172.16.10.10/16"

Parámetros

-imageDir

Ruta de acceso al directorio en el que AKS híbrido almacena sus imágenes de VHD. Este parámetro es obligatorio. La ruta de acceso debe apuntar a una ruta de acceso de almacenamiento compartida, como C:\ClusterStorage\Volume2\ImageStore, o un recurso compartido SMB, como \\FileShare\ImageStore.

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

Required: False
Position: Named
Default value: %systemdrive%\AksHciImageStore
Accept pipeline input: False
Accept wildcard characters: False

-workingDir

Un directorio de trabajo para que el módulo lo use para almacenar archivos pequeños. Este parámetro es obligatorio. La ruta de acceso debe apuntar a una ruta de acceso de almacenamiento compartida, como c:\ClusterStorage\Volume2\ImageStore.

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

Required: True
Position: Named
Default value: %systemdrive%\AksHci
Accept pipeline input: False
Accept wildcard characters: False

-cloudConfigLocation

Ubicación en la que el agente en la nube almacena su configuración. Este parámetro es obligatorio. La ruta de acceso debe apuntar a una ruta de acceso de almacenamiento compartida, como C:\ClusterStorage\Volume2\ImageStore, o un recurso compartido SMB, como \\FileShare\ImageStore. La ubicación debe estar en un recurso compartido de alta disponibilidad para que siempre sea accesible el almacenamiento.

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

Required: True
Position: Named
Default value: %systemdrive%\wssdcloudagent
Accept pipeline input: False
Accept wildcard characters: False

-vnet

Nombre del objeto AksHciNetworkSetting creado con el New-AksHciNetworkSetting comando .

Type: VirtualNetwork
Parameter Sets: (All)
Aliases:

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

-createAutoConfigContainers

Permite deshabilitar la distribución automática de datos de máquina virtual en los volúmenes compartidos del clúster (CSV). Para deshabilitar la distribución automática, use false como argumento para este parámetro. Si la distribución automática está deshabilitada, solo se usa el ARCHIVO CSV seleccionado para imageDir . El valor predeterminado es true.

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

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

-offlineDownload

Invoca la descarga sin conexión durante Install-AksHci. También debe ejecutar Enable-AksHciOfflineDownload. Esta marca se usa junto con el -stagingShare parámetro .

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

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

-offsiteTransferCompleted

Establece la implementación para usar artefactos descargados fuera del sitio y transferidos al servidor de implementación durante Install-AksHci. Esta marca se usa en conjunto con el -offlineDownload parámetro y -stagingShare .

-Modo

Modo de descarga que desea usar para la descarga sin conexión. Use minimum si quiere las imágenes mínimas para la implementación híbrida de AKS. Esta opción incluye las imágenes de Linux necesarias y solo la imagen de Kubernetes necesaria. Use full si desea todas las imágenes para la implementación híbrida de AKS. Esta opción incluye todas las imágenes de Linux y Windows y todas las imágenes de Kubernetes compatibles. Use este parámetro en conjunto con el -offlineDownload parámetro . El valor predeterminado es full.

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

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

-stagingShare

Ruta de acceso local a la que desea que se descarguen las imágenes. Use en conjunto con el offlineDownload parámetro .

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

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

-nodeConfigLocation

Ubicación en la que los agentes de nodo almacenan su configuración. Cada nodo tiene un agente de nodo, por lo que su configuración es local para ese nodo. Esta ubicación debe ser una ruta de acceso local. El valor predeterminado es %systemdrive%\programdata\wssdagent para todas las implementaciones.

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

Required: False
Position: Named
Default value: %systemdrive%\programdata\wssdagent
Accept pipeline input: False
Accept wildcard characters: False

-controlPlaneVmSize

Tamaño de la máquina virtual que se va a crear para el plano de control. Para obtener una lista de los tamaños de máquina virtual disponibles, ejecute Get-AksHciVmSize.

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

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

-sshPublicKey

Ruta de acceso a un archivo de clave pública de SSH. Con esta clave pública, puede iniciar sesión en cualquiera de las máquinas virtuales creadas por la implementación híbrida de AKS. Si tiene su propia clave pública SSH, pase su ubicación aquí. Si no se proporciona ninguna clave, buscamos una en %systemdrive%\akshci\.ssh\akshci_rsa.pub. Si el archivo no existe, se genera un par de claves SSH en esta ubicación y se usa.

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

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

-macPoolStart

Especifica el inicio de la dirección MAC del grupo de direcciones MAC que quiere usar en la VM del host de Azure Kubernetes Service. La sintaxis de la dirección MAC requiere que el bit menos significativo del primer byte siempre sea 0 y el primer byte siempre debe ser un número par (es decir, 00, 02, 04, 06...). Una dirección MAC típica puede tener este aspecto: 02:1E:2B:78:00:00. Use grupos de direcciones MAC para las implementaciones de larga duración para que las direcciones MAC asignadas sean coherentes. Los grupos de direcciones MAC resultan útiles si tiene un requisito de que las VM tengan direcciones MAC específicas. El valor predeterminado es None.

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

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

-macPoolEnd

Especifica el final de la dirección MAC del grupo de direcciones MAC que quiere usar en la VM del host de Azure Kubernetes Service. La sintaxis de la dirección MAC requiere que el bit menos significativo del primer byte siempre sea 0. Asimismo, el primer byte siempre debe ser un número par (por ejemplo, 00, 02, 04, 06...). El primer byte de la dirección que se ha pasado como -macPoolEnd debe ser el mismo que el que se pasó como -macPoolStart. Use grupos de direcciones MAC para las implementaciones de larga duración para que las direcciones MAC asignadas sean coherentes. Los grupos de direcciones MAC resultan útiles si tiene un requisito de que las VM tengan direcciones MAC específicas. El valor predeterminado es None.

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

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

-proxySettings

Objeto proxy creado mediante New-AksHciProxySetting.

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

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

-cloudServiceCidr

Proporciona un prefijo de red o IP estático que se asignará al servicio MOC CloudAgent. Este valor debe proporcionarse con el formato CIDR; por ejemplo, 192.168.1.2/16. Es posible que desee especificar este parámetro para asegurarse de que cualquier cosa importante en la red siempre es accesible, ya que la dirección IP no cambia. El valor predeterminado es None.

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

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

-version

La versión de AKS híbrida que quiere implementar. El valor predeterminado es la versión más reciente. No se recomienda cambiar el valor predeterminado.

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

Required: False
Position: Named
Default value: Latest version
Accept pipeline input: False
Accept wildcard characters: False

-nodeAgentPort

Número de puerto TCP/IP en el que los agentes de nodo deben escuchar, que tiene como valor predeterminado 45000.  No se recomienda cambiar el valor predeterminado.

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

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

-nodeAgentAuthorizerPort

Número de puerto TCP/IP que los agentes del nodo deben usar para el puerto de autorización. Su valor predeterminado es 45001. No se recomienda cambiar el valor predeterminado.

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

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

-cloudAgentPort

Número de puerto TCP/IP en el que debe escuchar el agente en la nube. El valor predeterminado es 55000. No se recomienda cambiar el valor predeterminado.

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

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

-cloudAgentAuthorizerPort

Número de puerto TCP/IP que el agente en la nube debe usar para su puerto de autorización. El valor predeterminado es 65000. No se recomienda cambiar el valor predeterminado.

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

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

-clusterRoleName

Especifica el nombre que se va a usar al crear el agente en la nube como un servicio genérico dentro del clúster. Este parámetro tiene como valor predeterminado un nombre único con un prefijo de ca - y un sufijo GUID. No se recomienda cambiar el valor predeterminado.

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

Required: False
Position: Named
Default value: A unique name with a prefix of ca- and a guid suffix
Accept pipeline input: False
Accept wildcard characters: False

-cloudLocation

Proporciona un nombre de ubicación en la nube operado por Microsoft. El nombre predeterminado es MocLocation. No se recomienda cambiar el valor predeterminado.

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

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

-skipHostLimitChecks

Solicita que el script omita las comprobaciones para confirmar que la memoria y el espacio en disco están disponibles antes de permitir que la implementación continúe. No se recomienda usar esta configuración.

Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:

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

-skipRemotingChecks

Solicita que el script omita las comprobaciones para confirmar las funcionalidades de comunicación remota en nodos locales y remotos. No se recomienda usar esta configuración.

Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:

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

-insecure

Implementa componentes híbridos de AKS, como agentes en la nube y agentes de nodo, en modo no seguro (sin conexiones protegidas con TLS).   No es aconsejable usar el modo no seguro en entornos de producción.

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

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

-skipUpdates

Use esta marca si quiere omitir cualquier actualización disponible. No se recomienda usar esta configuración.

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

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

-forceDnsReplication

La replicación de DNS puede tardar hasta una hora en completarse en algunos sistemas. Esto hace que la implementación sea lenta. Si experimenta este problema, verá que Install-AksHci está bloqueado en un bucle. Para solucionar este problema, intente usar esta marca. Tenga en cuenta que la marca -forceDnsReplication no es una solución garantizada. Si se produce un error en la lógica detrás de la marca, el error se oculta y el comando continúa como si no se proporcionara la marca.

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

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

-skipValidationChecks

Use esta marca si desea omitir las comprobaciones de validación de la entrada de configuración de usuario y la infraestructura del entorno. Estas comprobaciones resaltan posibles problemas que se deben solucionar antes de continuar con la instalación. No se recomienda usar esta configuración.

Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:

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

Pasos siguientes

Referencia de AksHci para PowerShell