Actualización de la versión de Service Fabric que se ejecuta en el clúster

Artículo
10/15/2024

En cualquier sistema moderno, la capacidad de actualización es clave para el éxito a largo plazo del producto. Un clúster de Azure Service Fabric es un recurso que usted posee. En este artículo se describe cómo actualizar la versión de Service Fabric que se ejecuta en el clúster independiente.

Nota:

Asegúrese de que el clúster siempre ejecuta una versión compatible de Service Fabric. Cuando Microsoft anuncia el lanzamiento de una nueva versión de Service Fabric, se marca la versión anterior para que finalice el soporte después de un mínimo de 60 días a partir de la fecha del anuncio. Las versiones nuevas se anuncian en el blog del equipo de Service Fabric. La nueva versión estará disponible para su elección a partir de ese momento.

Puede actualizar el clúster a la nueva versión solo si usa una configuración de nodo de estilo de producción, donde cada nodo de Service Fabric se asigna a una máquina virtual o física independiente. Si tiene un clúster de desarrollo, donde hay más de un nodo de Service Fabric en una única máquina física o virtual, debe volver a crear el clúster con la nueva versión.

Hay dos flujos de trabajo distintos para actualizar el clúster a la versión más reciente o a una versión de Service Fabric compatible. Uno de los flujos es para los clústeres que tienen conectividad para descargar automáticamente la versión más reciente. El otro es para los clústeres que no tienen conectividad para descargar la versión más reciente de Service Fabric.

Habilitación de la actualización automática de la versión de Service Fabric del clúster

Para establecer el clúster para que descargue actualizaciones de Service Fabric cuando Microsoft publica una nueva versión, establezca la configuración del clúster fabricClusterAutoupgradeEnabled en true. Para seleccionar manualmente una versión compatible de Service Fabric en la que quiera que esté el clúster, establezca la configuración del clúster fabricClusterAutoupgradeEnabled en false.

Actualización de los clústeres con conectividad para descargar el código y la configuración más recientes

Siga estos pasos para actualizar el clúster a una versión compatible, si los nodos del clúster tienen conectividad a Internet al Centro de descarga de Microsoft.

Para los clústeres con conectividad al Centro de descarga de Microsoft, Microsoft comprueba periódicamente la disponibilidad de nuevas versiones de Service Fabric.

Cuando una nueva versión de Service Fabric está disponible, el paquete se descarga localmente en el clúster y se aprovisiona para la actualización. Además, para informar al cliente de esta nueva versión, el sistema muestra una advertencia de estado de clúster explícita similar a la siguiente:

"La compatibilidad con la versión [versión] de clúster actual finaliza el [Fecha]."

Después de que el clúster ejecuta la versión más reciente, se quita la advertencia.

Cuando vea la advertencia de mantenimiento del clúster, actualícelo:

Conéctese al clúster desde cualquier máquina con acceso de administrador a todas las máquinas que se muestran como nodos en el clúster. La máquina donde se ejecuta este script no tiene que formar parte del clúster.

###### connect to the secure cluster using certs
$ClusterName= "mysecurecluster.something.com:19000"
$CertThumbprint= "70EF5E22ADB649799DA3C8B6A6BF7FG2D630F8F3"
Connect-serviceFabricCluster -ConnectionEndpoint $ClusterName -KeepAliveIntervalInSec 10 `
    -X509Credential `
    -ServerCertThumbprint $CertThumbprint  `
    -FindType FindByThumbprint `
    -FindValue $CertThumbprint `
    -StoreLocation CurrentUser `
    -StoreName My

Obtenga la lista de versiones de Service Fabric a las que puede actualizar.
```
###### Get the list of available Service Fabric versions
Get-ServiceFabricRegisteredClusterCodeVersion
```
Debería obtener una salida similar a esta:
Inicie una actualización de clúster a una versión disponible mediante el comando de Windows PowerShell Start-ServiceFabricClusterUpgrade.
```
Start-ServiceFabricClusterUpgrade -Code -CodePackageVersion <codeversion#> -Monitored -FailureAction Rollback

###### Here is a filled-out example

Start-ServiceFabricClusterUpgrade -Code -CodePackageVersion 5.3.301.9590 -Monitored -FailureAction Rollback
```
Para supervisar el progreso de la actualización, puede usar Service Fabric Explorer o ejecutar el siguiente comando de PowerShell:
```
Get-ServiceFabricClusterUpgrade
```
Si no se cumplen las directivas de mantenimiento del clúster, la actualización se revierte. Para especificar las directivas de mantenimiento personalizado para el comando Start-ServiceFabricClusterUpgrade consulte la documentación de Start-ServiceFabricClusterUpgrade.

Después de corregir los problemas que provocaron la reversión, debe iniciar la actualización de nuevo, siguiendo los mismos pasos descritos anteriormente.

Actualización de los clústeres sin conectividad para descargar el código y la configuración más recientes

Siga estos pasos para actualizar el clúster a una versión compatible, si los nodos del clúster no tienen conectividad a Internet al Centro de descarga de Microsoft.

Nota:

Si está ejecutando un clúster que no está conectado a Internet, tendrá que supervisar el blog del equipo de Service Fabric para conocer más información acerca de nuevas versiones. El sistema no muestra ninguna advertencia de mantenimiento de clúster para informarle de una nueva versión.

Aprovisionamiento automático frente a aprovisionamiento manual

Para habilitar la descarga y el registro automáticos de la última versión del código, configure el servicio de actualización de Service Fabric. Consulte el archivo Tools\ServiceFabricUpdateService.zip\Readme_InstructionsAndHowTos.txt en el paquete independiente.

Para el proceso manual, siga estas instrucciones.

Modifique la configuración del clúster para establecer la siguiente propiedad en false antes de iniciar una actualización de la configuración:

"fabricClusterAutoupgradeEnabled": false,

Consulte el comando Start-ServiceFabricClusterConfigurationUpgrade de PowerShell para conocer los detalles de uso. Asegúrese de actualizar 'clusterConfigurationVersion' en JSON antes de iniciar la actualización de la configuración.

    Start-ServiceFabricClusterConfigurationUpgrade -ClusterConfigPath <Path to Configuration File>

Flujo de trabajo de actualización de clúster

Ejecute Get-ServiceFabricClusterUpgrade desde uno de los nodos del clúster y apunte el valor de TargetCodeVersion.
Ejecute lo siguiente en un equipo conectado a Internet para enumerar todas las versiones de actualización compatibles con la versión actual y descargar el paquete correspondiente de los vínculos de descarga asociados:
```
###### Get list of all upgrade compatible packages  
Get-ServiceFabricRuntimeUpgradeVersion -BaseVersion <TargetCodeVersion as noted in Step 1> 
```

###### Get the list of available Service Fabric versions
Copy-ServiceFabricClusterPackage -Code -CodePackagePath <name of the .cab file including the path to it> -ImageStoreConnectionString "fabric:ImageStore"

###### Here is a filled-out example
Copy-ServiceFabricClusterPackage -Code -CodePackagePath .\MicrosoftAzureServiceFabric.5.3.301.9590.cab -ImageStoreConnectionString "fabric:ImageStore"

Copie el paquete descargado en el almacén de imágenes del clúster.

Registre el paquete copiado.

###### Get the list of available Service Fabric versions
Register-ServiceFabricClusterPackage -Code -CodePackagePath <name of the .cab file>

###### Here is a filled-out example
Register-ServiceFabricClusterPackage -Code -CodePackagePath MicrosoftAzureServiceFabric.5.3.301.9590.cab

Inicie una actualización del clúster a una versión disponible.
```
Start-ServiceFabricClusterUpgrade -Code -CodePackageVersion <codeversion#> -Monitored -FailureAction Rollback

###### Here is a filled-out example
Start-ServiceFabricClusterUpgrade -Code -CodePackageVersion 5.3.301.9590 -Monitored -FailureAction Rollback
```
Puede supervisar el progreso de la actualización en Service Fabric Explorer o puede ejecutar el siguiente comando de PowerShell:
```
Get-ServiceFabricClusterUpgrade
```
Si no se cumplen las directivas de mantenimiento del clúster, la actualización se revierte. Para especificar las directivas de mantenimiento personalizado para el comando Start-ServiceFabricClusterUpgrade consulte la documentación de Start-ServiceFabricClusterUpgrade.

Después de corregir los problemas que provocaron la reversión, debe iniciar la actualización de nuevo, siguiendo los mismos pasos descritos anteriormente.

Pasos siguientes

Actualización de la configuración de un clúster independiente
Personalización de algunas de las opciones de configuración del clúster de Service Fabric
Escalar o reducir horizontalmente el clúster

Compartir a través de