Descripción de las fases de actualización de Azure Local

Se aplica a: implementaciones hiperconvergidas de Azure Local

En este artículo se describen las fases de preparación e instalación del flujo de trabajo de actualización de Azure Local, incluido cómo se descargan, validan, comprueban y instalan las actualizaciones. También se explica cómo se notifica el progreso de la actualización en varias fases.

Para obtener información más detallada sobre los informes de progreso, consulte Use Administrador de actualizaciones de Azure para actualizar Azure Local y Update Azure Local a través de PowerShell.

Visión general

Azure Local actualizaciones siguen un flujo de trabajo de dos fases:

1. Preparación: descargue contenido, valide y extraiga paquetes y ejecute comprobaciones de estado para confirmar que el clúster está listo.
2. Instalación: aplique la actualización en el clúster a través de un plan de acción orquestado.

Cada fase genera un UpdateRun recurso que registra el progreso, el tiempo y los errores detectados paso a paso. Puede consultar los detalles de esta ejecución en la página Update Progress en Administrador de actualizaciones de Azure o mediante el cmdlet Get-SolutionUpdateRun en PowerShell.

Fase de preparación

1. Cumplir los requisitos previos

   Antes de la preparación, la actualización podría estar en un AdditionalContentRequired estado. Este estado indica que el paquete de actualización requiere contenido del proveedor de hardware. Este requisito se aplica a las actualizaciones de la extensión del Generador de soluciones (SBE) y a la solución combinada más las actualizaciones de SBE. El paquete SBE instalado del proveedor de hardware no admite la descarga automática de ese contenido.

   Si la actualización está en estado AdditionalContentRequired, debe importar el contenido para poder comenzar la preparación o la instalación. Para más información, consulte Actualización a través de PowerShell.

2. Actualización del desencadenador (opcional)

   La fase de preparación se desencadena como parte del inicio de cada actualización; sin embargo, tiene la opción de ejecutar de forma independiente la preparación sin desencadenar la fase de instalación. Para obtener más información, consulte la fase de instalación.

   • Para realizar solo la fase de preparación, inicie la actualización ejecutando Start-SolutionUpdate -PrepareOnly. Este paso descarga y valida el contenido de actualización y ejecuta comprobaciones de estado sin iniciar la instalación. Úselo para realizar actualizaciones previas o validar la preparación del clúster antes de una ventana de mantenimiento.
   • Para realizar la fase de preparación y la fase de instalación, inicie la actualización ejecutando Start-SolutionUpdate.

3. Fases preparatorias previas a la ejecución

   El flujo de trabajo de preparación pasa por las siguientes fases en orden.

Descargar

La fase de descarga recupera el paquete de actualización del origen de actualización configurado.

• Descarga estándar: Update Service descarga el paquete de actualización de la solución principal (paquetes NuGet) directamente desde el catálogo de actualizaciones.
• Seguimiento de progreso: el ProgressPercentage campo de la UpdateStateProperties propiedad en los informes de actualización descarga el progreso como un valor de 0 a 100.

Durante esta fase, el objeto Update pasa al Downloading estado. En caso de error, el estado se convierte en DownloadFailed.

Conector de descarga de SBE (si procede)

Cualquier actualización que incluya una actualización de SBE requiere contenido adicional del proveedor de hardware. Si el SBE proporciona un conector de descarga, update Service lo usa para controlar parte de la descarga:

• Update Service comprueba si el SBE instalado admite un conector de descarga.
• Si se admite, un plan de acción de Orchestrator invoca la acción de descarga de SBE para recuperar paquetes de proveedor de hardware, como firmware y controladores.
• Normalmente, el proveedor de hardware incluye una comprobación de estado de conectividad de descarga que debe pasar antes de que se inicie la descarga.

Si se produce un error en la descarga al usar el conector de descarga de SBE, el estado de actualización se convierte en DownloadFailed. Para ver el mensaje de error detallado, examine los detalles de preparación en Administrador de actualizaciones de Azure en el portal o use el objeto /UpdateRun de Get-SolutionUpdateRun.

Validar y extraer

Una vez descargado todo el contenido, Update Service valida la integridad del archivo y extrae los archivos de actualización.

Si se produce un error en la UpdateRun validación o extracción, registra el error y el estado Update se convierte en PreparationFailed.

Comprobación de estado

Antes de la instalación, el clúster ejecuta comprobaciones de estado de actualización previa. Estas comprobaciones validan que el clúster está en un estado correcto. También identifican los problemas que podrían interferir con una instalación correcta.

Cada comprobación de estado tiene un nivel de gravedad asignado:

Si inicia la actualización en -PrepareOnly modo, la actualización cambia al ReadyToInstall estado cuando se superan las comprobaciones de estado. Si las comprobaciones de estado encuentran problemas críticos o de advertencia (y no especifica -IgnoreWarnings), el estado se convierte en HealthCheckFailed.

Puede inspeccionar los resultados de la verificación de estado en el objeto de actualización usando:

# View health check results
(Get-SolutionUpdate).HealthCheckResult |
Where-Object { ($_.Status -ne "Success") -and ($_.Severity -ne "Informational") } |
Format-List Title, Status, Severity, Description, Remediation

De forma predeterminada, una actualización del ReadyToInstall estado pasa a un HealthCheckExpired estado después de tres días. Si se desencadena una instalación de actualización en este estado, la comprobación de estado se repite antes de iniciar el plan de acción de instalación.

Para obtener ayuda con la resolución de errores de comprobación de estado, consultar Solución de problemas de actualizaciones.

Supervisión de la fase de preparación

Supervise la fase de preparación mediante el Get-SolutionUpdateRun cmdlet .

Cada vez que ejecute Start-SolutionUpdate, con o sin -PrepareOnly, cree un UpdateRun recurso. Para recuperar los detalles del paso de preparación, use:

# Get the most recent update run for an update
Get-SolutionUpdate -Id <UpdateResourceId> | Get-SolutionUpdateRun | % Progress | % Steps

Cuando falla una ejecución de preparación, la propiedad UpdateRunState se establece en Failed, y el árbol de pasos de progreso contiene detalles del error en el paso que encontró el problema.

Fase de instalación

La actualización puede entrar en la fase de la instalación cuando se ejecuta Start-SolutionUpdate sin -PrepareOnly.

Al iniciar la actualización de esta manera, comienza la instalación:

• Inmediatamente : si ha ejecutado recientemente la fase de preparación y la actualización ya estaba en estado ReadyToInstall .
• Una vez completada la preparación , si la actualización aún no estaba preparada y solo está en estado Ready .

Iniciar la instalación

Para iniciar una actualización completa que incluya tanto la preparación como la instalación, use:

# Start a full update (preparation + installation)
Get-SolutionUpdate -Id <UpdateResourceId> | Start-SolutionUpdate

Cuando se inicia la instalación, el estado de actualización cambia a Instalando y se crea un nuevo UpdateRun. Esto UpdateRun representa el progreso de la instalación y reemplaza el que anteriormente representaba la UpdateRun preparación.

Progreso de la instalación

Durante la instalación, la UpdateRunProgress propiedad contiene el árbol de ejecución del plan de acción completo. Esta propiedad es una estructura jerárquica de Step objetos donde cada paso representa una fase, un rol o una tarea individual en la actualización.

Cada paso del árbol de progreso expone las siguientes propiedades:

Supervisión del progreso de la instalación

Dado que el objeto UpdateRun tiene una estructura compleja, se recomienda supervisar el estado de instalación de la actualización a través del portal de Azure.

Para supervisar la actualización en PowerShell, supervise directamente el estado del plan de acción subyacente.

# Get the action plan instance ID from the update run, then monitor
$run = Get-SolutionUpdate | where State -eq "Installing" | Get-SolutionUpdateRun | where State -eq "InProgress"
$id = ($run.ResourceId -split '/')[-1]
Start-MonitoringActionplanInstanceToComplete -actionPlanInstanceID $id

Este comando proporciona una salida de consola en tiempo real que se actualiza automáticamente. Presione Ctrl+C para salir del monitor sin detener la actualización.

Cambios de estado de instalación

La actualización pasa por estos estados durante la instalación:

Solución de errores de instalación

Cuando se produzca un error en la instalación, revise los detalles del error en el portal de Azure o mediante el cmdlet Get-SolutionUpdateRun. Para obtener instrucciones de solución de problemas, consulte Solución de problemas de actualizaciones.

Después de revisar y mitigar el error, o determinar que es transitorio, reanude la actualización desde el portal de Azure o mediante el cmdlet Start-SolutionUpdate:

Get-SolutionUpdate | where State -eq "InstallationFailed" | Start-SolutionUpdate

Después de ejecutar este cmdlet, el estado de actualización cambia de InstallationFailed a Installing.

Pasos siguientes

Obtenga más información sobre cómo solucionar problemas de actualizaciones.