Set-AksHciConfig

Synopsis

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

Syntax

Establecimiento de la configuración del 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]

Description

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

Examples

Para implementar en un clúster de 2-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"

Parameters

-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

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 CSV seleccionado para imageDir . El valor por defecto 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 junto con el -offlineDownload parámetro y -stagingShare .

-mode

Modo de descarga que desea usar para la descarga sin conexión. Use minimum si desea 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 junto 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 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 MAC que desea usar para la máquina virtual 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 MAC para implementaciones de larga duración para que las direcciones MAC asignadas sean coherentes. Los grupos de MAC son útiles si tiene un requisito de que las máquinas virtuales 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 MAC que desea usar para la máquina virtual 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...). El primer byte de la dirección pasada como -macPoolEnd debe ser el mismo que el primer byte de la dirección pasada como -macPoolStart. Use grupos de MAC para implementaciones de larga duración para que las direcciones MAC asignadas sean coherentes. Los grupos de MAC son útiles si tiene un requisito de que las máquinas virtuales 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 con 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 siempre es accesible cualquier cosa importante en la red, 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

Versión de AKS híbrida que desea 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 de nodo deben usar para su puerto de autorización. El 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 de nube operado Microsoft personalizado. 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

Solicitudes que el script omite 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

-inseguro

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 se recomienda 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 desea omitir las actualizaciones disponibles. 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 algunos sistemas. Esto hace que la implementación sea lenta. Si experimenta este problema, verá que Install-AksHci está bloqueado en un bucle. Para superar este problema, intente usar esta marca. La -forceDnsReplication marca no es una correcció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 infraestructura del entorno y la entrada de configuración de usuario. Estas comprobaciones resaltan posibles problemas para 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 PowerShell de AksHci

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2023-04-11