Set-AksHciConfig
Sinopsis
Establece o actualiza las opciones 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 las opciones de configuración del host de Azure Kubernetes Service. Si va a implementar en un clúster local de Azure de 2 a 4 nodos o en un clúster de conmutación por error de Windows Server 2019 Datacenter, debe especificar los -workingDir parámetros 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, se recomienda usar una implementación de clúster de Azure Local de 2 a 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
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 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 junto con el -offlineDownload parámetro y -stagingShare .
-modo
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 VM 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 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 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 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 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
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
-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 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