Compartir a través de

Uso de la herramienta de soporte técnico para solucionar y corregir problemas relacionados con AKS Arc

La herramienta de soporte técnico es un módulo de PowerShell que proporciona funcionalidades de diagnóstico y corrección para entornos de AKS Arc. Antes de abrir una solicitud de soporte técnico, puede ejecutar los comandos especificados en este módulo para ayudar a diagnosticar y resolver posibles problemas.

Ventajas

La herramienta de soporte técnico usa comandos sencillos para identificar problemas sin conocimientos expertos sobre productos. La herramienta proporciona:

  • Correcciones para problemas de instalación y actualización: identifica e intenta corregir los problemas comunes que se producen durante el proceso de instalación y actualización.
  • Comprobaciones de diagnóstico: proporciona verificaciones de diagnóstico basadas en problemas comunes, incidentes y datos de telemetría.
  • Habilitación de la característica de grupo de nodos de Windows: permite a los usuarios habilitar grupos de nodos de Windows y descargar los VHD necesarios antes de crear grupos de nodos de Windows.
  • Actualizaciones periódicas: actualizaciones con nuevas comprobaciones y comandos útiles para administrar, solucionar y diagnosticar problemas en AKS Arc.

Problemas comunes en los que la herramienta de soporte técnico puede ayudar

Debe ejecutar los comandos si experimenta alguno de los síntomas siguientes:

  • Se produce un error en la actualización de la solución en el estado de los archivos binarios de MOC.
  • Se produce un error en la actualización de la solución en la fase de Arc Resource Bridge.
  • El servicio MOC no se mantiene en línea.
  • Arc Resource Bridge está sin conexión.

Prerrequisitos

Antes de comenzar, asegúrese de que:

  • Tiene acceso a un sistema local de Azure con una versión 2311 o superior. El sistema debe registrarse con Azure.
  • Tiene acceso a un cliente que puede conectarse a Azure Local.

Conexión a la instancia local de Azure

Siga estos pasos en el cliente para conectarse a una de las máquinas de Azure Local.

  1. Ejecute PowerShell como administrador en el cliente que use para conectarse al sistema.

  2. Abra una sesión remota de PowerShell en una máquina de la instancia local de Azure. Ejecute el siguiente comando y proporcione las credenciales de la máquina cuando se le solicite:

    $cred = Get-Credential
Enter-PSSession -ComputerName "<Azure Local node IP>" -Credential $cred

    Note

    Inicie sesión con las credenciales de la cuenta de usuario de implementación. Esta es la cuenta que creó al preparar Active Directory y que utilizó para implementar Azure Local.

    Expanda esta sección para ver una salida de ejemplo.

    Este es un ejemplo de salida:

    PS C:\Users\Administrator> $cred = Get-Credential
  
cmdlet Get-Credential at command pipeline position 1
Supply values for the following parameters:
Credential
PS C:\Users\Administrator> Enter-PSSession -ComputerName "100.100.100.10" -Credential $cred 
[100.100.100.10]: PS C:\Users\Administrator\Documents>

Installation

Para instalar el módulo Herramienta de soporte técnico, ejecute los siguientes comandos:

Install-Module -Name Support.AksArc
Import-Module Support.AksArc -force

Si ya tiene instalado el módulo, puede actualizarlo mediante el siguiente cmdlet:

Update-Module -Name Support.AksArc

Note

Al importar el módulo, intenta actualizarlo automáticamente desde la galería de PowerShell. También puede actualizar manualmente mediante los métodos siguientes.

Asegúrese de que tiene el módulo más reciente cargado en la instancia actual quitando e importando el módulo:

Remove-Module -Name Support.AksArc
Import-Module -Name Support.AksArc

Uso de la herramienta de soporte técnico de AKS Arc

En esta sección se proporcionan ejemplos de los distintos cmdlets disponibles en la herramienta de soporte técnico.

Note

Asegúrese de ejecutar estos comandos de PowerShell localmente, no en una sesión remota de PowerShell.

Visualización de cmdlets disponibles

Para ver una lista de los cmdlets disponibles en el módulo de PowerShell, ejecute el siguiente cmdlet:

Get-Command -Module Support.AksArc

Realización de comprobaciones de diagnóstico

Puede realizar una comprobación de estado de diagnóstico en el sistema para ayudar a detectar problemas comunes:

Test-SupportAksArcKnownIssues

En la salida del ejemplo siguiente del Test-SupportAksArcKnownIssues comando se muestran los resultados de una prueba con error:

Test Name                                                  Status Message
---------                                                  --------------
Validate Failover Cluster Service Responsiveness           Passed Failover Cluster service is responsive.
Validate Missing MOC Cloud Agents                          Passed No missing MOC cloud agents found.
Validate MOC Cloud Agent Running                           Passed MOC Cloud Agent is running
Validate Missing MOC Node Agents                           Passed All MOC nodes have the Node Agent service installed and healthy.
Validate Missing MOC Host Agents                           Passed All nodes have MOC host agents installed and healthy
Validate MOC is on Latest Patch Version                    Failed MOC is not on the latest patch version. Current: 1.15.5.10626, Latest: 1.15.7.10719
Validate Expired Certificates                              Passed No expired certificates found
Validate MOC Nodes Not Active                              Passed All MOC nodes are in the 'Active' state
Validate Multiple MOC Cloud Agent Instances                Passed No multiple instances of MOC Cloud Agent found
Validate Windows Event Log Running                         Passed Windows Event Log is running
Validate Gallery Image Stuck In Deleting                   Passed No gallery images are stuck in deleting state
Validate Virtual Machine Stuck In Pending                  Passed No virtual machines are stuck in pending state
Validate Virtual Machine Management Service Responsiveness Passed Virtual Machine Management service is responsive

En la salida de ejemplo siguiente se muestra un resultado correcto para todas las pruebas:

Test Name                                                  Status Message
---------                                                  --------------
Validate Failover Cluster Service Responsiveness           Passed  Failover Cluster service is responsive.
Validate Missing MOC Cloud Agents                          Passed  No missing MOC cloud agents found.
Validate MOC Cloud Agent Running                           Passed  MOC Cloud Agent is running
Validate Missing MOC Node Agents                           Passed  All MOC nodes have the Node Agent service installed and healthy.
Validate Missing MOC Host Agents                           Passed  All nodes have MOC host agents installed and healthy.
Validate MOC is on Latest Patch Version                    Passed  MOC is on the latest patch version.
Validate Expired Certificates                              Passed  No expired certificates found.
Validate MOC Nodes Not Active                              Passed  All NMC nodes are in the 'Active' state.
Validate NMC Nodes Sync with Cluster Nodes                 Passed  All NMC nodes are in sync with cluster nodes.
Validate Multiple NMC Cloud Agent Instances                Passed  No multiple instances of NMC Cloud Agent found.
Validate NMC Powershell Not Stuck in Updating              Passed  NMC Powershell is not stuck in updating state.
Validate Windows Event Log Running                         Passed  Windows Event Log is running
Validate Gallery Image Stuck In Deleting                   Passed  No gallery images are stuck in deleting state.
Validate Virtual Machine Stuck In Pending                  Passed  No virtual machines are stuck in pending state.
Validate Virtual Machine Management Service Responsiveness Passed  Virtual Machine Management service is responsive.

Corrección de problemas comunes

Este comando prueba y corrige problemas conocidos con una versión de solución determinada:

Invoke-SupportAksArcRemediation

Habilitación de la característica grupo de nodos de Windows

Este comando habilita la característica grupo de nodos de Windows en el clúster de AKS Arc:

Invoke-SupportAksArcRemediation_EnableWindowsNodepool -Verbose

Deshabilitación de la característica de grupo de nodos de Windows

Este comando deshabilita la característica del grupo de nodos de Windows en el clúster de AKS Arc. Antes de ejecutar este comando, asegúrese de que no tiene grupos de nodos de Windows que se ejecuten en el clúster:

Invoke-SupportAksArcRemediation_DisableWindowsNodepool -Verbose

Pasos siguientes

Uso de la herramienta de comprobador de diagnóstico para identificar problemas comunes del entorno

  • Last updated on