Contenedorización de aplicaciones de ASP.NET y migración a Azure Kubernetes Service

Artículo
07/14/2023

En este artículo, aprenderá a incluir en contenedores las aplicaciones ASP.NET y a migrarlas a Azure Kubernetes Service (AKS) mediante la herramienta Azure Migrate: App Containerization. El proceso de contenedorización no requiere acceso a su código base y proporciona una manera sencilla de incluir las aplicaciones existentes en contenedores. La herramienta usa el estado de ejecución de las aplicaciones en un servidor para determinar los componentes de la aplicación y ayuda a empaquetarlos en una imagen de contenedor. A continuación, la aplicación contenedorizada se puede implementar en Azure Kubernetes Service (AKS).

La herramienta Azure Migrate: Contenedorización de aplicaciones admite actualmente las siguientes acciones:

Inclusión en contenedores de las aplicaciones ASP.NET e implementación en contenedores de Windows en Azure Kubernetes Service.
Inclusión en contenedores de las aplicaciones ASP.NET e implementación en contenedores de Windows en Azure App Service. Más información.
Contenedorización de aplicaciones web de Java en Apache Tomcat (en servidores Linux) e implementación en contenedores Linux en AKS Más información.
Contenedorización de aplicaciones web de Java en Apache Tomcat (en servidores Linux) e implementación en contenedores de Linux en App Service Más información.

La herramienta Azure Migrate: Contenedorización de aplicaciones le ayuda a hacer lo siguiente:

Detectar la aplicación: la herramienta se conecta de forma remota a los servidores de aplicaciones que ejecutan la aplicación ASP.NET y detecta los componentes de la aplicación. La herramienta crea un archivo Dockerfile que se puede usar para crear una imagen de contenedor para la aplicación.
Compilar la imagen de contenedor: puede inspeccionar y personalizar aún más el archivo Dockerfile según los requisitos de la aplicación y usarlo para compilar la imagen de contenedor de la aplicación. La imagen de contenedor de la aplicación se inserta en la instancia de Azure Container Registry que especifique.
Implementar en Azure Kubernetes Service: la herramienta genera los archivos YAML de definición de recursos de Kubernetes necesarios para implementar la aplicación contenedorizada en el clúster Azure Kubernetes Service clúster. Puede personalizar los archivos YAML y usarlos para implementar la aplicación en AKS.

Nota

La herramienta de contenedorización de Azure Migrate le ayuda a detectar tipos de aplicación específicos (ASP.NET y aplicaciones web de Java en Apache Tomcat), así como sus componentes, en un servidor de aplicaciones. Para detectar servidores y el inventario de las aplicaciones, roles y características que se ejecutan en máquinas locales, use la funcionalidad de detección y valoración de Azure Migrate. Más información

Aunque todas las aplicaciones no se beneficiarán de un cambio directo a los contenedores sin realizar un rediseño significativo, estas son algunas de las ventajas de migrar las aplicaciones existentes a los contenedores sin rescribirlas:

Uso mejorado de la infraestructura: con los contenedores, varias aplicaciones pueden compartir recursos y hospedarse en la misma infraestructura. Esto puede ayudarlo a consolidar la infraestructura y mejorar su utilización.
Administración simplificada: el hospedaje de aplicaciones en una plataforma administrada moderna, como AKS y App Service, permite simplificar las prácticas de administración. Puede conseguirlo al retirar o reducir los procesos de administración y mantenimiento de la infraestructura que tradicionalmente realizaría con una infraestructura de su propiedad.
Portabilidad de la aplicación: debido a la mayor adopción y estandarización de los formatos y las plataformas de especificación de contenedores, la portabilidad de la aplicación ya no es un problema.
Adopción de la administración moderna con DevOps: ayuda a adoptar y normalizar los procedimientos modernos de administración y seguridad, y la transición a DevOps.

En este tutorial, aprenderá a:

Configurar una cuenta de Azure.
Instalar la herramienta Azure Migrate: App Containerization.
Detectar la aplicación ASP.NET.
Compile la imagen de contenedor.
Ejecutar la aplicación contenedorizada en AKS.

Nota

En los tutoriales se muestra la ruta de implementación más sencilla para un escenario, de modo que pueda configurar rápidamente una prueba de concepto. En ellos se usan las opciones predeterminadas siempre que es posible y no muestran todos los valores y rutas de acceso posibles.

Requisitos previos

Antes de comenzar este tutorial, debe:

Requisito	Detalles
Identificar una máquina en la que instalar la herramienta	Una máquina Windows para instalar y ejecutar la herramienta de contenedorización de aplicaciones de Azure Migrate. La máquina Windows puede ser un sistema operativo de servidor (Windows Server 2016 o posterior) o de cliente (Windows 10), lo que significa que la herramienta también puede ejecutarse en el escritorio. La máquina Windows que ejecuta la herramienta debe tener conectividad de red con los servidores o las máquinas virtuales que hospedan las aplicaciones ASP.NET que se incluirán en contenedores. Asegúrese de que haya disponible 6 GB de espacio en la máquina Windows que ejecuta la herramienta de contenedorización de aplicaciones de Azure Migrate a fin de almacenar los artefactos de la aplicación. La máquina Windows debe tener acceso a Internet, ya sea directamente o a través de un proxy. Instale la herramienta Microsoft Web Deploy en el equipo que ejecuta la herramienta auxiliar de contenedorización de aplicaciones y el servidor de aplicaciones si aún no está instalado. Puede descargar la herramienta desde aquí.
Servidores de aplicaciones	Habilite la comunicación remota con PowerShell en los servidores de aplicaciones: inicie sesión en el servidor de aplicaciones y siga estas instrucciones para activar la comunicación remota con PowerShell. Asegúrese de que PowerShell 5.1 está instalado en el servidor de aplicaciones. Siga las instrucciones que se indican en Instalación y configuración de WMF 5.1 para descargar e instalar PowerShell 5.1 en el servidor de aplicaciones. Instale la herramienta Microsoft Web Deploy en el equipo que ejecuta la herramienta auxiliar de contenedorización de aplicaciones y el servidor de aplicaciones si aún no está instalado. Puede descargar la herramienta desde aquí.
Aplicación ASP.NET	La herramienta admite actualmente: - aplicaciones ASP.NET que usan Microsoft .NET Framework 3.5 o posterior. - Servidores de aplicaciones que ejecutan Windows Server 2012 R2 o posterior (los servidores de aplicaciones deben ejecutar la versión 5.1 de PowerShell). - aplicaciones que se ejecutan en Internet Information Services (IIS) versión 7.5 o posterior. La herramienta no admite actualmente: - Aplicaciones que requieren autenticación de Windows (la herramienta de contenedorización de aplicaciones actualmente no admite gMSA). - aplicaciones que dependen de otros servicios de Windows hospedados fuera de IIS.

Preparación de una cuenta de usuario de Azure

Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.

Una vez configurada la suscripción, necesitará una cuenta de usuario de Azure que tenga lo siguiente:

Permisos de propietario en la suscripción a Azure.
Permisos para registrar aplicaciones de Microsoft Entra.

Si acaba de crear una cuenta de Azure gratuita, es el propietario de la suscripción. Si no es el propietario, trabaje con él para asignar los permisos, como se indica a continuación:

En Azure Portal, busque "suscripciones" y, en Servicios, seleccione Suscripciones.
En la página Suscripciones, seleccione aquella en la que desee crear un proyecto de Azure Migrate.
Seleccione Access Control (IAM) .
Seleccione Agregar>Agregar asignación de roles para abrir la página Agregar asignación de roles.
Asigne el siguiente rol. Para obtener los pasos detallados, consulte Asignación de roles de Azure mediante Azure Portal.

Configuración Valor

Role Propietario

Asignar acceso a Usuario

Members azmigrateuser (en este ejemplo)
Su cuenta de Azure también necesita permisos para registrar aplicaciones de Microsoft Entra.
En Azure Portal, vaya a Microsoft Entra ID>Usuarios>Configuración de usuario.
En Configuración de usuario, compruebe que los usuarios de Microsoft Entra puedan registrar aplicaciones (establecido en Sí de forma predeterminada).
Si la configuración de "Registros de aplicaciones" se ha establecido en "No", solicite al administrador global o de inquilinos que asigne el permiso necesario. Como alternativa, el administrador global o de inquilinos puede asignar el rol Desarrollador de aplicaciones a una cuenta para permitir el registro de aplicaciones de Microsoft Entra. Más información.

Configuración	Valor
Role	Propietario
Asignar acceso a	Usuario
Members	azmigrateuser (en este ejemplo)

Descarga e instalación de la herramienta de contenedorización de aplicaciones de Azure Migrate

Descargue el instalador de la contenedorización de aplicaciones de Azure Migrate en una máquina Windows.
Inicie PowerShell en modo de administrador y cambie el directorio de PowerShell a la carpeta que contiene el instalador.
Ejecute el script de instalación mediante el comando siguiente.
```
.\AppContainerizationInstaller.ps1
```

Nota:

En Windows Server 2022, edite la línea 135 y quite PowerShell-ISE de la lista de características, ya que ya no se admite.

Inicio de la herramienta de contenedorización de aplicaciones

Abra un explorador en cualquier máquina que pueda conectarse a la máquina Windows que ejecuta la herramienta de contenedorización de aplicaciones y abra su dirección URL: https://nombre de la máquina o dirección IP: 44369.

También puede abrir la aplicación desde el escritorio, para lo que debe seleccionar el acceso directo de la aplicación.
Si ve una advertencia que indica que la conexión no es privada, seleccione Opciones avanzadas y elija Continuar al sitio web. Se muestra esta advertencia, ya que la interfaz web usa un certificado TLS/SSL autofirmado.
En la pantalla Inicio de sesión, use la cuenta de administrador local en la máquina para iniciar sesión.
Seleccione Aplicaciones web ASP.NET como el tipo de aplicación que quiere incluir en un contenedor.
Para especificar el servicio de Azure de destino, seleccione Contenedores en Azure Kubernetes Service.

Requisitos previos completos de la herramienta

Acepte los términos de licencia y lea la información de terceros.
En la aplicación web de la herramienta >Configurar los requisitos previos, complete los pasos siguientes:
- Conectividad: la herramienta comprueba que la máquina Windows tenga acceso a Internet. Si la máquina usa un proxy:
  - Seleccione Configurar el proxy para especifique la dirección del proxy (con los formatos de dirección IP o FQDN) y el puerto de escucha.
  - Especifique las credenciales si el proxy requiere autenticación.
  - Solo se admite un proxy HTTP.
  - Si ha agregado detalles del proxy o ha deshabilitado el proxy o la autenticación, seleccione Guardar para desencadenar de nuevo la comprobación de conectividad.
- Instalación de actualizaciones: la herramienta buscará automáticamente las actualizaciones más recientes y las instalará. También puede instalar manualmente la versión más reciente de la herramienta desde aquí.
- Instale la herramienta Microsoft Web Deploy: se comprobará que la herramienta Microsoft Web Deploy está instalada en la máquina Windows que ejecuta la herramienta Azure Migrate: App Containerization.
- Habilite la comunicación remota de PowerShell: la herramienta le informará de que está habilitada la comunicación remota de PowerShell en los servidores de aplicaciones que ejecutan las aplicaciones ASP.NET que se incluirán en contenedores.

Seleccione Iniciar sesión para iniciar sesión en su cuenta de Azure.
Necesitará un código de dispositivo para autenticarse con Azure. Al seleccionar Iniciar sesión, se abrirá una ventana modal con el código del dispositivo.
Seleccione Copiar código e iniciar sesión para copiar el código del dispositivo y abrir un símbolo del sistema de inicio de sesión de Azure en una nueva pestaña del explorador. Si no aparece, asegúrese de que ha deshabilitado el bloqueador de elementos emergentes en el explorador.
En la pestaña nueva, pegue el código del dispositivo y complete el inicio de sesión con las credenciales de la cuenta de Azure. Puede cerrar la pestaña del explorador una vez que se complete el inicio de sesión y volver a la pantalla de la herramienta de contenedorización de aplicaciones.
Seleccione el inquilino de Azure que quiere usar.
Especifique la suscripción a Azure que quiera usar.

Supervisión de aplicaciones ASP.NET

La herramienta auxiliar de contenedorización de aplicaciones se conecta de forma remota a los servidores de aplicaciones con las credenciales proporcionadas e intenta detectar las aplicaciones ASP.NET hospedadas en dichos servidores de aplicaciones.

Especifique la dirección IP/FQDN y las credenciales del servidor que ejecuta la aplicación ASP.NET que se deben usar para conectarse de forma remota al servidor para la detección de las aplicaciones.
- Las credenciales especificadas deben corresponder a un administrador local (Windows) en el servidor de aplicaciones.
- En el caso de las cuentas de dominio (el usuario debe ser un administrador en el servidor de aplicaciones), anteponga el nombre de dominio con el formato <dominio\nombre de usuario>.
- Puede ejecutar la detección de aplicaciones para hasta cinco servidores de manera simultánea.
Seleccione Validar para comprobar que puede acceder al servidor de aplicaciones desde la máquina que ejecuta la herramienta y que las credenciales son válidas. Una vez validada correctamente, la columna Estado tendrá el valor Asignado.
Seleccione Continuar para iniciar la detección de aplicaciones en los servidores de aplicaciones seleccionados.
Después de completar correctamente la detección de la aplicación, puede seleccionar la lista de aplicaciones para incluir en contenedores.
Use la casilla para seleccionar las aplicaciones que se incluirán en contenedores.
Especifique el nombre del contenedor: especifique un nombre para el contenedor de destino de cada aplicación seleccionada. El nombre del contenedor debe especificarse como <name:tag>, donde la etiqueta se use para la imagen del contenedor. Por ejemplo, puede especificar el nombre del contenedor de destino como appname:v1.

Parametrización de las configuraciones de la aplicación

Al parametrizar la configuración, esta pasa a estar disponible como parámetro en el momento de la implementación. Esto le permite configurar este valor al implementar la aplicación, en lugar de codificar dicho valor de forma rígida en un valor específico en la imagen del contenedor. Por ejemplo, esta opción es útil para parámetros como las cadenas de conexión de base de datos.

Seleccione Configuraciones de aplicaciones para revisar las configuraciones detectadas.
Active la casilla para parametrizar las configuraciones de aplicaciones detectadas.
Seleccione Aplicar después de seleccionar las configuraciones que parametrizarán.

Externalización de las dependencias del sistema de archivos

Puede agregar otras carpetas que use la aplicación. Especifique si deben formar parte de la imagen de contenedor o se externalizarán a través de volúmenes persistentes en el recurso compartido de archivos de Azure. El uso de volúmenes persistentes funciona bien con las aplicaciones con estado que almacenan dicho estado fuera del contenedor o almacenan otro contenido estático en el sistema de archivos. Más información.

En Carpetas de la aplicación, seleccione Editar para revisar las carpetas detectadas de la aplicación. Las carpetas de la aplicación detectadas se han identificado como artefactos obligatorios que la aplicación necesita y se copiarán en la imagen del contenedor.
Seleccione Agregar carpetas y especifique las rutas de acceso de las carpetas que se van a agregar.
Para agregar varias carpetas al mismo volumen, especifique valores separados por comas (,).
Seleccione Volumen persistente como opción de almacenamiento si quiere que las carpetas se almacenen fuera del contenedor en un volumen persistente.
Seleccione Guardar después de revisar las carpetas de la aplicación.
Seleccione Continuar para continuar con la fase de compilación de la imagen de contenedor.

Compilar la imagen del contenedor

Importante

Si usa AKS 1.23 o versiones posteriores, edite los scripts tal como se muestra a continuación antes de compilar la imagen de Docker para garantizar una migración sin problemas.

Cambio del script siguiente

# Run entrypoint script.
COPY ./Entryscript.ps1 c:/Entryscript.ps1
ENTRYPOINT powershell c:/Entryscript.ps1

# Run entrypoint script.
COPY ["./Entryscript.ps1", "c:/Entryscript.ps1"]
ENTRYPOINT ["powershell", "c:/Entryscript.ps1"]

Para compilar una imagen de contenedor, siga estos pasos:

Seleccione una instancia de Azure Container Registry: use la lista desplegable para seleccionar una instancia de Azure Container Registry que se usará para compilar y almacenar las imágenes de contenedor de las aplicaciones. Puede usar una instancia de Azure Container Registry existente o crear una mediante la opción Crear nuevo registro.
Revisar el archivo Dockerfile: el archivo Dockerfile necesario para compilar las imágenes de contenedor de cada aplicación seleccionada se genera al principio del paso de compilación. Seleccione Revisar para revisar el archivo Dockerfile. También puede agregar cualquier personalización necesaria al archivo Dockerfile en el paso de revisión y guardar los cambios antes de iniciar el proceso de compilación.
Desencadenar el proceso de compilación: seleccione las aplicaciones para las que se van a compilar imágenes y luego Compilar. Al seleccionar la opción de compilar, se iniciará la compilación de la imagen de contenedor para cada aplicación. La herramienta supervisa continuamente el estado de la compilación y le permitirá continuar con el paso siguiente tras completar la compilación correctamente.
Hacer un seguimiento del estado de la compilación: también puede supervisar el progreso del paso de compilación si selecciona el vínculo Compilación en curso en la columna Estado. El vínculo tarda un par de minutos en activarse después de haber desencadenado el proceso de compilación.
Una vez completada la compilación, seleccione Continuar para especificar la configuración de implementación.

Implementación de la aplicación contenedorizada en AKS

Una vez compilada la imagen de contenedor, el paso siguiente es implementar la aplicación como un contenedor en Azure Kubernetes Service (AKS).

Seleccione el clúster de Azure Kubernetes Service: especifique el clúster de AKS en el que se debe implementar la aplicación.
- El clúster de AKS seleccionado debe tener un grupo de nodos de Windows.
- El clúster debe estar configurado para permitir la extracción de imágenes desde la instancia de Azure Container Registry que se seleccionó para almacenar las imágenes.
  - Ejecute el comando siguiente en la CLI de Azure para conectar el clúster de AKS a la instancia de ACR.
```
az aks update -n <cluster-name> -g <cluster-resource-group> --attach-acr <acr-name>
```
- Si no tiene un clúster de AKS o quiere crear uno en el cual implementar la aplicación, puede optar por crear uno desde la herramienta. Para ello, seleccione Creación de un nuevo clúster de AKS.
  - El clúster de AKS creado mediante la herramienta se creará con un grupo de nodos de Windows. El clúster se configurará para que pueda extraer imágenes de la instancia de Azure Container Registry que se creó anteriormente (si se eligió la opción Crear un nuevo registro).
- Seleccione Continuar después de seleccionar el clúster de AKS.
Especifique el almacén de secretos: si ha optado por parametrizar las configuraciones de la aplicación, especifique el almacén de secretos que se usará para la aplicación. Puede elegir Azure Key Vault o la configuración de la aplicación App Service para administrar los secretos de la aplicación. Más información
- Si ha seleccionado la configuración de la aplicación de App Service para administrar los secretos, seleccione Continuar.
- Si prefiere usar una instancia de Azure Key Vault para administrar los secretos de aplicación, especifique la que quiera usar.
  - Si no tiene una instancia de Azure Key Vault o quiere crear una, puede optar por hacerlo desde la herramienta si selecciona Crear una instancia de Azure Key Vault.
  - La herramienta asignará automáticamente los permisos necesarios para administrar secretos por medio de la instancia de Key Vault.
Especifique el recurso compartido de archivos de Azure: si agregó más carpetas y seleccionó la opción de volumen persistente, especifique el recurso compartido de archivos de Azure que debe usar la herramienta de contenedorización de aplicaciones de Azure Migrate durante el proceso de implementación. La herramienta creará directorios nuevos en este recurso compartido de archivos de Azure para copiarlos a las carpetas de la aplicación que están configuradas para el almacenamiento de volumen persistente. Una vez completada la implementación de la aplicación, la herramienta limpiará el recurso compartido de archivos de Azure mediante la eliminación de los directorios que se crearon.
- Si no tiene un recurso compartido de archivos de Azure o quiere crear uno, puede optar por crearlo desde la herramienta. Para ello, seleccione Crear nueva cuenta de almacenamiento y recurso compartido de archivos.
Configuración de la implementación de aplicaciones: una vez completados los pasos anteriores, deberá especificar la configuración de implementación de la aplicación. Haga clic en Configurar para personalizar la implementación de la aplicación. En el paso de configuración puede especificar las siguientes personalizaciones:
- Cadena de prefijo: especifique una cadena de prefijo que se usará en el nombre de todos los recursos que se creen para la aplicación contenedorizada en el clúster de AKS.
- Certificado SSL: si la aplicación requiere un enlace de sitio HTTPS, especifique el archivo PFX que contiene el certificado que se usará para el enlace. El archivo PFX no debe estar protegido por contraseña y el sitio original no debe tener varios enlaces.
- Conjuntos de réplicas: especifique el número de instancias de aplicación (pods) que deben ejecutarse dentro de los contenedores.
- Tipo de equilibrador de carga: seleccione Externo si la aplicación contenedorizada debe ser accesible desde redes públicas.
- Configuración de la aplicación: para cualquier configuración de aplicación que se haya parametrizado, especifique los valores que se usarán para la implementación actual.
- Almacenamiento: para todas las carpetas de aplicación que se hayan configurado para el almacenamiento de volumen persistente, especifique si el volumen debe compartirse entre instancias de la aplicación, o bien si debe inicializarse individualmente con cada instancia del contenedor. De manera predeterminada, todas las carpetas de aplicación en volúmenes persistentes están configuradas como compartidas.
- Seleccione Aplicar para guardar la configuración de implementación.
- Seleccione Continuar para implementar la aplicación.
Implemente la aplicación: una vez guardada la configuración de implementación de la aplicación, la herramienta generará el archivo YAML de implementación de Kubernetes para la aplicación.
- Seleccione Revisar a fin de revisar y personalizar el archivo YAML de implementación de Kubernetes para las aplicaciones.
- Seleccione la aplicación que quiere implementar.
- Seleccione Implementar para iniciar la implementación de las aplicaciones seleccionadas.
- Tras implementar la aplicación, puede seleccionar la columna Estado de implementación a fin de realizar el seguimiento de los recursos que se implementaron para la aplicación.

Descarga de artefactos generados

Todos los artefactos que se usan para compilar e implementar la aplicación en AKS, incluidos los archivos de especificación YAML de Dockerfile y Kubernetes, se almacenan en el equipo que ejecuta la herramienta. Los artefactos se encuentran en C:\ProgramData\Microsoft Azure Migrate App Containerization.

Se crea una sola carpeta para cada servidor de aplicaciones. Puede ver y descargar todos los artefactos intermedios que se usan en el proceso de contenedorización si se desplaza a esta carpeta. La carpeta correspondiente al servidor de aplicaciones se limpiará al principio de cada ejecución de la herramienta para un servidor determinado.

Solución de problemas

Para solucionar cualquier problema con la herramienta, puede ver los archivos de registro en la máquina Windows que ejecuta la herramienta de contenedorización de aplicaciones. Los archivos de registro de la herramienta se encuentran en C:\ProgramData\Microsoft Azure Migrate App Containerization\Logs.

Pasos siguientes

Inclusión en contenedores de las aplicaciones web de ASP.NET e implementación en contenedores de Windows en App Service. Más información.
Inclusión en contenedores de aplicaciones web de Java en Apache Tomcat (en servidores Linux) e implementación en contenedores de Linux en AKS. Más información.
Inclusión en contenedores de aplicaciones web de Java en Apache Tomcat (en servidores Linux) e implementación en contenedores de Linux en App Service. Más información.