Actualización de aplicaciones de Service Fabric con PowerShell
El enfoque de actualización recomendado y usado con mayor frecuencia es la actualización gradual supervisada. Azure Service Fabric supervisa el estado de la aplicación que se está actualizando en función de un conjunto de directivas de mantenimiento. Después de actualizar un dominio de actualización (UD), Service Fabric evalúa el estado de la aplicación y, o bien continúa con el siguiente dominio de actualización, o no realiza la actualización, según las directivas de mantenimiento.
Se puede realizar una actualización de la aplicación supervisada mediante las API nativas o administradas, PowerShell, la CLI de Azure, Java o REST. Para obtener instrucciones sobre cómo realizar una actualización con Visual Studio, consulte Actualización de la aplicación con Visual Studio.
Con la actualización gradual supervisada de Service Fabric, el Administrador de aplicaciones puede configurar la directiva de evaluación de estado que Service Fabric usa para determinar que la aplicación es correcta. Además, el Administrador puede configurar la acción que se realizará cuando la evaluación de estado encuentre errores (por ejemplo, realizar una reversión automática). En esta sección se ofrece orientación sobre una actualización supervisada para uno de los ejemplos del SDK que PowerShell utiliza.
Nota:
Los valores de ApplicationParameters no se conservan cuando se actualiza una aplicación. Para conservar los parámetros actuales de la aplicación, el usuario debe obtener primero los parámetros y luego pasarlos a la llamada API de actualización, como se indica a continuación:
$myApplication = Get-ServiceFabricApplication -ApplicationName fabric:/myApplication
$appParamCollection = $myApplication.ApplicationParameters
$applicationParameterMap = @{}
foreach ($pair in $appParamCollection)
{
$applicationParameterMap.Add($pair.Name, $pair.Value);
}
Start-ServiceFabricApplicationUpgrade -ApplicationName fabric:/myApplication -ApplicationTypeVersion 2.0.0 -ApplicationParameter $applicationParameterMap -Monitored -FailureAction Rollback
Paso 1: Crear e implementar el ejemplo de objetos visuales
Para compilar y publicar la aplicación, haga clic con el botón derecho en el proyecto de aplicación, VisualObjectsApplication, y seleccione el comando Publicar. Para más información, consulte el tutorial sobre la actualización de aplicaciones de Service Fabric. También puede usar PowerShell para implementar la aplicación.
Nota:
Antes de que se pueda usar cualquiera de los comandos de Service Fabric en PowerShell, hay que conectarse primero al clúster mediante el cmdlet Connect-ServiceFabricCluster. Del mismo modo, se supone que el clúster ya se ha configurado en la máquina local. Vea el artículo sobre configuración del entorno de desarrollo de Service Fabric.
Después de compilar el proyecto en Visual Studio, puede utilizar el comando de PowerShell Copy-ServiceFabricApplicationPackage para copiar el paquete de aplicación en ImageStore. Si quiere comprobar el paquete de la aplicación de forma local, use el cmdlet ServiceFabricApplicationPackage prueba. El siguiente paso es registrar la aplicación en el runtime de Service Fabric mediante el cmdlet Register-ServiceFabricApplicationType. El siguiente paso es iniciar una instancia de la aplicación mediante el cmdlet New-ServiceFabricApplication. Estos tres pasos son análogos al uso del elemento de menú Implementar en Visual Studio. Una vez completado el aprovisionamiento, es preciso limpiar el paquete de aplicación copiado del almacén de imágenes para reducir el consumo de recursos. Si algún tipo de aplicación deja de requerirse, se debe anular su registro por el mismo motivo. Para más información, consulte Actualización de aplicaciones de Service Fabric con PowerShell.
Ahora, puede usar el explorador de Service Fabric para ver el clúster y la aplicación. La aplicación tiene un servicio web hasta el que se puede navegar en Internet Explorer; para ello, escriba http://localhost:8081/visualobjects en la barra de direcciones. Debería ver algunos objetos visuales flotantes desplazándose por la pantalla. Además, se puede usar Get-ServiceFabricApplication para comprobar el estado de la aplicación.
Paso 2: Actualizar el ejemplo de objetos visuales
Puede que observe que con la versión que se implementó en el Paso 1, los objetos visuales no giran. Vamos a actualizar esta aplicación a una donde los objetos visuales giren.
Elija el proyecto VisualObjects.ActorService dentro de la solución VisualObjects y abra el archivo StatefulVisualObjectActor.cs. Dentro de ese archivo, vaya al método MoveObject, comente this.State.Move() y quite la marca de comentario de this.State.Move(true). Este cambio gira los objetos después de que se actualiza el servicio.
También necesitamos actualizar el archivo ServiceManifest.xml (debajo de PackageRoot) del proyecto VisualObjects.ActorService. Actualice el CodePackage y la versión del servicio a 2.0 y las líneas correspondientes del archivo ServiceManifest.xml. Puede utilizar la opción Edit Manifest Files (Editar archivos de manifiesto) de Visual Studio después de hacer clic con el botón derecho en la solución para realizar los cambios del archivo de manifiesto.
Una vez realizados los cambios, el manifiesto debe ser similar al siguiente (las partes resaltadas muestran los cambios):
<ServiceManifestName="VisualObjects.ActorService" Version="2.0" xmlns="http://schemas.microsoft.com/2011/01/fabric" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance">
<CodePackageName="Code" Version="2.0">
Ahora el archivo ApplicationManifest.xml (que se encuentra en el proyecto VisualObjects en la solución VisualObjects) se actualiza a la versión 2.0 del proyecto VisualObjects.ActorService. Además, la versión de la aplicación se actualiza a la 2.0.0.0 desde la 1.0.0.0. El archivo ApplicationManifest.xml debe parecerse a este fragmento de código:
<ApplicationManifestxmlns:xsd="https://www.w3.org/2001/XMLSchema" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" ApplicationTypeName="VisualObjects" ApplicationTypeVersion="2.0.0.0" xmlns="http://schemas.microsoft.com/2011/01/fabric">
<ServiceManifestRefServiceManifestName="VisualObjects.ActorService" ServiceManifestVersion="2.0" />
Ahora, compile el proyecto; para ello, seleccione solamente el proyecto ActorService y luego haga clic con el botón derecho y seleccione la opción Compilar en Visual Studio. Si selecciona Volver a generar todo, debe actualizar las versiones de todos los proyectos, ya que el código habrá cambiado. A continuación, vamos a empaquetar la aplicación actualizada; para ello, haga clic con el botón derecho en VisualObjectsApplication, seleccione el menú de Service Fabric y elija Paquete. Esta acción crea un paquete de aplicación que se puede implementar. La aplicación actualizada está lista para implementarse.
Paso 3: Decidir sobre las directivas de mantenimiento y parámetros de actualización
Familiarícese con los parámetros de actualización de la aplicación y el proceso de actualización para obtener una buena comprensión de los distintos parámetros de actualización, los tiempos de espera y el criterio de estado aplicados. En este tutorial, el criterio de evaluación de estado del servicio se establecerá en los valores predeterminados (y recomendados), lo que significa que todos los servicios e instancias deben ser correctos tras la actualización.
Sin embargo, vamos a aumentar HealthCheckStableDuration a 180 segundos (de modo que los servicios sean correctos durante al menos 120 segundos antes de que la actualización continúe con el siguiente dominio de actualización). Vamos a configurar también UpgradeDomainTimeout para que sea 1200 segundos y UpgradeTimeout para que sea 3000 segundos.
Por último, vamos a establecer también el valor de UpgradeFailureAction en reversión. Esta opción requiere Service Fabric revierta la aplicación a la versión anterior si encuentra algún problema durante la actualización. Por lo tanto, al iniciar la actualización (en el paso 4), se especifican los parámetros siguientes:
FailureAction = Rollback
HealthCheckStableDurationSec = 180
UpgradeDomainTimeoutSec = 1200
UpgradeTimeout = 3000
Paso 4: Preparar la aplicación para la actualización
Ahora, la aplicación se ha creado y está lista para actualizarse. Si abre una ventana de PowerShell como administrador y escribe Get-ServiceFabricApplication, debe indicarle que la aplicación que se ha implementado es el tipo de aplicación 1.0.0.0 de VisualObjects.
El paquete de aplicación se almacena en la siguiente ruta de acceso relativa donde descomprimió el SDK de Service Fabric: Samples\Services\Stateful\VisualObjects\VisualObjects\obj\x64\Debug. Debería encontrará una carpeta "Paquete" en ese directorio, que es donde se almacena el paquete de aplicación. Compruebe las marcas de tiempo para asegurarse de que es la última compilación (puede que necesite además modificar las rutas de acceso adecuadamente).
Ahora vamos a copiar el paquete de la aplicación actualizada a la ImageStore de Service Fabric (donde se almacenan los paquetes de la aplicación por Service Fabric). El parámetro ApplicationPackagePathInImageStore informa a Service Fabric sobre dónde puede encontrar el paquete de la aplicación. Hemos puesto la aplicación actualizada en "VisualObjects_V2" con el siguiente comando (es posible que tenga que modificar las rutas de nuevo correctamente).
Copy-ServiceFabricApplicationPackage -ApplicationPackagePath .\Samples\Services\Stateful\VisualObjects\VisualObjects\obj\x64\Debug\Package -ApplicationPackagePathInImageStore "VisualObjects\_V2"
El siguiente paso es registrar esta aplicación con Service Fabric, que se puede realizar con el comando Register-ServiceFabricApplicationType:
Register-ServiceFabricApplicationType -ApplicationPathInImageStore "VisualObjects\_V2"
Si el comando anterior no es correcto, es probable que necesite una recompilación de todos los servicios. Como se mencionó en el Paso 2, puede que tenga que actualizar además la versión de WebService.
Se recomienda que quite el paquete de aplicación después de que la aplicación se haya registrado correctamente. Al eliminar los paquetes de aplicación del almacén de imágenes, se liberan recursos del sistema. Mantener los paquetes de aplicación sin usar consume almacenamiento en disco y conduce a problemas de rendimiento de la aplicación.
Remove-ServiceFabricApplicationPackage -ApplicationPackagePathInImageStore "VisualObjects\_V2" -ImageStoreConnectionString fabric:ImageStore
Paso 5: Iniciar la actualización de la aplicación
Ahora ya se puede iniciar la actualización de la aplicación con el comando Start-ServiceFabricApplicationUpgrade:
Start-ServiceFabricApplicationUpgrade -ApplicationName fabric:/VisualObjects -ApplicationTypeVersion 2.0.0.0 -HealthCheckStableDurationSec 60 -UpgradeDomainTimeoutSec 1200 -UpgradeTimeout 3000 -FailureAction Rollback -Monitored
Tenga en cuenta que el nombre de aplicación es el mismo que se ha descrito en el archivo ApplicationManifest.xml . Service Fabric usa este nombre para identificar qué aplicación se está actualizando. Si establece los tiempos de expiración para que sean demasiado breves, puede que reciba un mensaje de error que indique el problema. Consulte la sección de solución de problemas o aumente los tiempos de expiración.
Ahora, a medida que continúa la actualización de la aplicación, puede supervisarla mediante Service Fabric Explorer o con el comando de PowerShell Get-ServiceFabricApplicationUpgrade:
Get-ServiceFabricApplicationUpgrade fabric:/VisualObjects
En unos minutos, el estado obtenido con el comando de PowerShell anterior debe indicar que todos los dominios de actualización se han actualizado (completados). Y debería advertir que los objetos visuales de la ventana del explorador ahora han empezado a girar.
Como ejercicio, puede intentar actualizar de la versión 2 a la versión 3 o de la versión 2 a la versión 1. El cambio de la versión 2 a la versión 1 también se considera una actualización. Juegue con los tiempos de espera y las directivas de mantenimiento para familiarizarse. Cuando se va a implementar en un clúster de Azure, los parámetros se deben establecer de forma adecuada. Es una buena idea establecer los tiempos de espera de manera conservadora.
Pasos siguientes
Actualización de la aplicación con Visual Studio ofrece información para actualizar una aplicación mediante Visual Studio.
Puede controlar cómo se actualiza una aplicación usando parámetros de actualización.
Consiga que sus actualizaciones de aplicaciones sean compatibles aprendiendo a usar la serialización de datos.
Aprenda a usar funcionalidades avanzadas para actualizar una aplicación. Para ello, consulte los temas avanzados.
Solucione problemas habituales en las actualizaciones de aplicaciones consultando los pasos que figuran en Solución de problemas de las actualizaciones de aplicaciones.