Tutorial: Implementación de una aplicación de contenedor con CI/CD en un clúster de Service Fabric

Este tutorial es la segunda parte de una serie y describe cómo configurar la integración y la implementación continuas de una aplicación de contenedor de Azure Service Fabric mediante Visual Studio y Azure DevOps. Se necesita una aplicación existente de Service Fabric; a modo de ejemplo se usa la aplicación creada en Tutorial: Implementación de una aplicación .NET de un contenedor de Windows en Azure Service Fabric.

En la segunda parte de la serie, se aprende a:

• Agregar un control de código fuente al proyecto
• Crear una definición de compilación en Visual Studio Team Explorer
• Crear una definición de versión en Visual Studio Team Explorer
• Implementar y actualizar una aplicación automáticamente

Prerrequisitos

Antes de empezar este tutorial:

• Tener un clúster en Azure o crear uno con este tutorial
• Implementar una aplicación en contenedores en él

Preparar un perfil de publicación

Ahora que ha implementado una aplicación de contenedor, está preparado para configurar la integración continua. En primer lugar, prepare un perfil de publicación en la aplicación que se use durante el proceso de implementación que se ejecuta en Azure DevOps. El perfil de publicación debe configurarse para que tenga como destino el clúster que ha creado antes. Inicie Visual Studio y abra un proyecto de aplicación existente de Service Fabric. En el Explorador de soluciones, haga clic con el botón derecho en la aplicación y seleccione Publicar... .

Elija un perfil de destino en el proyecto de la aplicación que vaya a usar para el flujo de trabajo de integración continua (por ejemplo, Cloud). Especifique el punto de conexión de la conexión del clúster. Marque la casilla Actualizar la aplicación para que la esta se actualice para cada implementación de Azure DevOps. Haga clic en el hipervínculo Guardar para guardar la configuración en el perfil de publicación y, luego, haga clic en Cancelar para cerrar el cuadro de diálogo.

Solución de Visual Studio compartida en un nuevo repositorio Git de Azure DevOps

Comparta los archivos de origen de su aplicación en un proyecto de equipo de Azure DevOps para poder generar compilaciones.

Cree un repositorio Git local para el proyecto seleccionando Agregar al control de código fuente ->Git en la barra de estado situada en la esquina inferior derecha de Visual Studio.

En la vista Inserción de Team Explorer, seleccione el botón Publicar repositorio Git en Push to Azure DevOps (Insertar en Azure DevOps).

Compruebe su correo electrónico y seleccione su organización en la lista desplegable Cuenta. Si no tiene alguna organización, es posible que deba configurar una. Escriba el nombre del repositorio y seleccione Publicar repositorio.

La publicación del repositorio crea un proyecto de equipo en su cuenta con el mismo nombre que el repositorio local. Para crear el repositorio en un proyecto de equipo existente, haga clic en Avanzado, junto al nombre del repositorio, y seleccione un proyecto de equipo. Puede ver el código en la web seleccionando Ver en la web.

Configuración de la entrega continua con Azure Pipelines

Una definición de compilación de Azure DevOps describe un flujo de trabajo que consta de una serie de pasos de compilación que se ejecutan de manera secuencial. Cree una definición de compilación que genere un paquete de aplicación de Service Fabric y otros artefactos para implementarlos en un clúster de Service Fabric. Más información sobre las definiciones de compilación de Azure DevOps.

Las definiciones de versión de Azure DevOps describen un flujo de trabajo que implementa un paquete de aplicación en un clúster. Cuando se usan juntas, la definición de compilación y la de versión ejecutan el flujo de trabajo completo empezando por los archivos de origen y terminando por la ejecución de una aplicación en el clúster. Más información sobre las definiciones de versión de Azure DevOps.

Creación de una definición de compilación

Abra el nuevo proyecto de equipo, para lo que debe ir a https://dev.azure.com en un explorador web y seleccionar su organización, seguida del nuevo proyecto.

Seleccione la opción Canalizaciones en el panel izquierdo y, después, haga clic en Nueva canalización.

Nota:

Si no ve la plantilla de definición de compilación, asegúrese de que la característica Nueva experiencia de creación de canalizaciones de YAML está desactivada. Esta característica se configura en la sección Características en vista previa de la cuenta de DevOps.

Seleccione GIT de Azure Repos como origen, el nombre de proyecto del equipo, el repositorio del proyecto y la rama predeterminada maestra o las compilaciones manuales y programadas. A continuación, haga clic en Continue (Continuar).

En Seleccionar una plantilla, seleccione la plantilla de la aplicación de Azure Service Fabric con compatibilidad para Docker y haga clic en Aplicar.

En Tareas, seleccione Hosted VS2017 como Grupo de agentes.

Haga clic en Tag images (Etiquetar imágenes).

En Tipo de Container Registry, seleccione Azure Container Registry. Seleccione una suscripción de Azure y haga clic en Autorizar. Seleccione una instancia de Azure Container Registry.

Haga clic en Push images (Insertar imágenes).

En Tipo de Container Registry, seleccione Azure Container Registry. Seleccione una suscripción de Azure y haga clic en Autorizar. Seleccione una instancia de Azure Container Registry.

En la pestaña Desencadenadores, habilite la integración continua, para lo que debe seleccionar Habilitar la integración continua. En Filtros de rama, haga clic en + Agregary el valor predeterminado de Especificación de rama será maestro.

En el cuadro de diálogo Guardar y poner en cola la canalización de compilación, haga clic en Guardar y poner en cola para empezar manualmente una compilación.

Las compilaciones también se desencadenan después de una inserción o una protección. Para comprobar el progreso de la compilación, vaya a la pestaña Compilaciones. Cuando haya comprobado que la compilación se ejecuta correctamente, defina una definición de versión que implemente la aplicación en un clúster.

Creación de una definición de versión

Seleccione la opción Canalizaciones en el panel izquierdo, después Versiones y, finalmente, +Nueva canalización. En Seleccionar una plantilla, seleccione la plantilla Implementación de Azure Service Fabric de la lista y haga clic en Aplicar.

Seleccione Tareas, Entorno 1 y +Nuevo para agregar una nueva conexión de clúster.

En la vista Agregar nueva conexión de Service Fabric, seleccione la autenticación Basada en certificado o Microsoft Entra ID. Especifique como nombre de conexión "mysftestcluster" y como punto de conexión del clúster "tcp://mysftestcluster.southcentralus.cloudapp.azure.com:19000" (o el punto de conexión del clúster en el que se va a implementar).

Para la autenticación basada en certificados, agregue la Huella digital del certificado de servidor del certificado de servidor utilizado para crear el clúster. En Certificado de cliente, agregue la codificación en base 64 del archivo del certificado de cliente. Consulte la ventana de ayuda emergente de ese campo para obtener información sobre cómo obtener esa representación codificada en base 64 del certificado. Agregue también un valor de Contraseña del certificado. Puede utilizar el certificado del clúster o del servidor si no tiene un certificado de cliente independiente.

Para las credenciales de Microsoft Entra, agregue la Huella digital del certificado de servidor del certificado de servidor utilizado para crear el clúster y las credenciales que desea usar para conectarse al clúster en los campos Nombre de usuario y Contraseña.

Haga clic en Agregar para guardar la conexión del clúster.

En la fase del agente, haga clic en Implementar aplicación de Service Fabric. Haga clic en Configuración de Docker y en Configurar las opciones de Docker. En Origen de credenciales del Registro, seleccione Azure Resource Manager Service Connection (Conexión de servicio de Azure Resource Manager). Después, seleccione la suscripción a Azure.

A continuación, agregue un artefacto de compilación a la canalización para que la definición de la versión pueda encontrar la salida de la compilación. Seleccione Canalización y Artefactos->+Agregar. En Origen (Definición de compilación) , seleccione la definición de compilación que creó anteriormente. Haga clic en Agregar para guardar el artefacto de compilación.

Habilite un desencadenador de implementación continua para que se cree automáticamente una versión cuando finalice la compilación. Haga clic en el icono de rayo en el artefacto, habilite el desencadenador y haga clic en Guardar para guardar la definición de la versión.

Seleccione +Versión ->Crear versión ->Crear para crear manualmente una versión. El progreso de la versión se puede supervisar en la pestaña Versiones.

Compruebe que la implementación se haya efectuado correctamente y que la aplicación se está ejecutando en el clúster. Abra un explorador web y vaya a http://mysftestcluster.southcentralus.cloudapp.azure.com:19080/Explorer/. Observe que la versión de la aplicación de este ejemplo es "1.0.0.20170616.3".

Confirmar e insertar cambios y desencadenar una versión

Para verificar que la canalización de integración continua funciona, inserte en el repositorio algunos cambios de código para Azure DevOps.

A medida que escribe el código, los cambios se controlan automáticamente con Visual Studio. Para confirmar los cambios en el repositorio de Git local, seleccione el icono de cambios pendientes () en la barra de estado de la parte inferior derecha.

En la vista Cambios de Team Explorer, agregue un mensaje que describa la actualización y confirme los cambios.

Seleccione el icono de la barra de estado de los cambios no publicados () o la vista Sincronización en Team Explorer. Seleccione Insertar para actualizar el código en Azure DevOps.

La inserción de los cambios en Azure DevOps desencadena automáticamente una compilación. Cuando la definición de compilación se haya completado correctamente, se creará automáticamente una versión y se empezará a actualizar la aplicación en el clúster.

Para comprobar el progreso de la compilación, vaya a la pestaña Compilaciones de Team Explorer en Visual Studio. Cuando haya comprobado que la compilación se ejecuta correctamente, defina una definición de versión que implemente la aplicación en un clúster.

Compruebe que la implementación se haya efectuado correctamente y que la aplicación se está ejecutando en el clúster. Abra un explorador web y vaya a http://mysftestcluster.southcentralus.cloudapp.azure.com:19080/Explorer/. Observe que la versión de la aplicación de este ejemplo es "1.0.0.20170815.3".

Actualizar la aplicación

Efectúe cambios de código en la aplicación. Guarde y confirme los cambios siguiendo los pasos anteriores.

Cuando haya comenzado la actualización de la aplicación, podrá ver el progreso de la actualización en Service Fabric Explorer:

La actualización de la aplicación puede tardar varios minutos. Una vez concluida la actualización, la aplicación ejecutará la próxima versión. En este ejemplo "1.0.0.20170815.4".

Pasos siguientes

En este tutorial, ha aprendido a:

• Agregar un control de código fuente al proyecto
• Creación de una definición de compilación
• Creación de una definición de versión
• Implementar y actualizar una aplicación automáticamente

En la siguiente parte del tutorial, puede aprender a configurar la supervisión del contenedor.