Depuración de aplicaciones en un contenedor de Docker local

Visual Studio proporciona una manera coherente de desarrollar contenedores de Docker y validar la aplicación localmente. Puede ejecutar y depurar las aplicaciones en contenedores de Linux o Windows que se ejecutan en el escritorio local de Windows con Docker instalado y no tiene que reiniciar el contenedor cada vez que realice un cambio de código.

En este artículo se muestra cómo usar Visual Studio para iniciar una aplicación en un contenedor de Docker local, realizar cambios y, a continuación, actualizar el explorador para ver los cambios. También se muestra cómo establecer puntos de interrupción para la depuración de aplicaciones en contenedores. Entre los tipos de proyecto admitidos se incluyen aplicaciones web, aplicaciones de consola y funciones de Azure destinadas a .NET Framework y .NET Core. Los ejemplos presentados en este artículo son un proyecto de tipo ASP.NET Core Web App y un proyecto de tipo Aplicación de consola (.NET Framework).

Si ya tiene un proyecto de un tipo admitido, Visual Studio puede crear un Dockerfile y configurar el proyecto para que se ejecute en un contenedor. Consulte Herramientas de contenedor de Visual Studio.

Prerrequisitos

Para depurar aplicaciones en un contenedor de Docker local, se deben instalar las siguientes herramientas:

• Visual Studio 2022 con la carga de trabajo Desarrollo web instalada.

Para ejecutar contenedores de Docker localmente, debe tener un cliente de Docker local. Puedes usar Docker Desktop, que requiere Windows 10 o posterior.

Creación de una aplicación web

Si tiene un proyecto y ha agregado compatibilidad con Docker como se describe en la información general de , omita esta sección.

1. En la ventana de inicio de Visual Studio, seleccione Crear un nuevo proyecto.

2. Seleccione ASP.NET Core Web Appy, a continuación, seleccione Siguiente.

3. Escriba un nombre para la nueva aplicación (o use el nombre predeterminado), especifique la ubicación en el disco y, a continuación, seleccione Siguiente.

4. Seleccione la versión de .NET a la que desea dirigirse. Si no está seguro, elija la versión LTS (soporte técnico a largo plazo).

   

5. Elija si desea compatibilidad con SSL marcando o desmarcando la casilla Configurar para HTTPS.

6. Active la casilla Habilitar compatibilidad con Docker.

7. Use la lista desplegable del sistema operativo Docker de para seleccionar el tipo de contenedor que desee: Windows o Linux.

8. Seleccione Crear para completar el proceso.

Edita tus páginas de Razor y actualiza

Para iterar cambios rápidamente en páginas de Razor, puede iniciar la aplicación en un contenedor. A continuación, continúe realizando cambios, viéndolos como lo haría con Internet Information Services (IIS) Express.

1. Asegúrese de que Docker está configurado para usar el tipo de contenedor (Linux o Windows) que está usando. Haga clic con el botón derecho en el icono de Docker de la barra de tareas y elija Cambiar a contenedores de Linux o Cambiar a contenedores de Windows según corresponda.

2. La edición del código y la actualización del sitio en ejecución tal y como se describe en esta sección no está habilitada en las plantillas predeterminadas de .NET Core y .NET 5 y versiones posteriores. Para habilitarlo, agregue el paquete NuGet Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation. Agregue una llamada al método de extensión AddRazorRuntimeCompilation al código del método Startup.ConfigureServices. Solo necesita esto habilitado en modo DEBUG, por lo que debe codificarlo como se indica a continuación en el método Main:

   // Add services to the container.
   var mvcBuilder = builder.Services.AddRazorPages();
   #if DEBUG
       if (Env.IsDevelopment())
       {
           mvcBuilder.AddRazorRuntimeCompilation();
       }
   #endif
   

   Para más información, vea Compilación de archivos de Razor en ASP.NET Core. El código exacto puede variar, en función de la plataforma de destino y de la plantilla de proyecto que usó.

3. Establezca Configuración de solución en Depurar. A continuación, presione Ctrl+F5 para compilar la imagen de Docker y ejecutarla localmente.

   Cuando la imagen de contenedor se compila y se ejecuta en un contenedor de Docker, Visual Studio inicia la aplicación web en el explorador predeterminado.

4. Vaya a la página Índice. Realizaremos cambios en esta página.

5. Vuelva a Visual Studio y abra Index.cshtml.

6. Agregue el siguiente contenido HTML al final del archivo y, a continuación, guarde los cambios.

   <h1>Hello from a Docker container!</h1>
   

7. En la ventana de salida, cuando finalice la compilación de .NET y vea las líneas siguientes, vuelva al explorador y actualice la página:

   Now listening on: http://*:80
   Application started. Press Ctrl+C to shut down.
   

¡Se han aplicado los cambios!

Depurar con puntos de interrupción

A menudo, los cambios requieren una mayor inspección. Puede usar las características de depuración de Visual Studio para esta tarea.

1. En Visual Studio, abra Index.cshtml.cs.

2. Reemplace el contenido del método OnGet por el código siguiente:

       ViewData["Message"] = "Your application description page from within a container";
   

3. A la izquierda de la línea de código, establezca un punto de interrupción.

4. Presione F5 para iniciar la depuración y alcanzar el punto de interrupción.

5. Cambie a Visual Studio para ver el punto de interrupción. Inspeccione los valores.

   

Recarga activa

Además, en Visual Studio 17.10 y versiones posteriores, se admite la recarga activa en contenedores, aunque tenga en cuenta que en un contenedor, debe actualizar la página para ver los cambios. Si el cambio es a un archivo CSS, tendrá que actualizar la página para ver esos cambios. Tenga en cuenta también que las actualizaciones de los archivos CSS con alcance (archivos .razor.css, consulte aislamiento de CSS de ASP.NET Core Blazor) no se admiten como parte de la recarga activa.

Creación de una aplicación de consola de .NET Framework

En esta sección se muestra cómo depurar un proyecto de aplicación de consola de .NET Framework en un contenedor de Docker local mostrando primero cómo agregar compatibilidad con Docker al proyecto. Es importante reconocer que los distintos tipos de proyecto tienen distintos niveles de compatibilidad con Docker. Incluso hay diferentes niveles de compatibilidad de Docker con proyectos de aplicación de consola de .NET Core (incluidos .NET 5 y versiones posteriores) frente a proyectos de aplicaciones de consola de .NET Framework.

Cuando se crea un proyecto de aplicación de consola de .NET Framework, no hay ninguna opción para habilitar la compatibilidad con Docker. Después de crear este proyecto, no hay ninguna manera de agregar explícitamente compatibilidad con Docker al proyecto. En el caso de un proyecto de aplicación de consola de .NET Framework, es posible agregar compatibilidad con la orquestación de contenedores. Un efecto secundario de agregar compatibilidad de orquestación al proyecto de aplicación de consola de .NET Framework es que agrega compatibilidad con Docker al proyecto.

En el procedimiento siguiente se muestra cómo agregar compatibilidad de orquestación a un proyecto de aplicación de consola de .NET Framework, que posteriormente agrega compatibilidad con Docker al proyecto y permite depurar el proyecto en un contenedor de Docker local.

1. Cree un nuevo proyecto de aplicación de consola de .NET Framework.
2. En el Explorador de soluciones, haga clic con el botón derecho en el nodo del proyecto y, a continuación, seleccione Agregar compatibilidad con la orquestación de contenedores>. En el cuadro de diálogo que aparece, seleccione Docker Compose. Se agrega un dockerfile al proyecto y se agrega un proyecto de Docker Compose con archivos de soporte técnico asociados.

Depurar con puntos de interrupción

1. En el Explorador de soluciones, abra Program.cs.

2. Reemplace el contenido del método Main por el código siguiente:

       System.Console.WriteLine("Hello, world!");
   

3. Establezca un punto de interrupción a la izquierda de la línea de código.

4. Presione F5 para iniciar la depuración y alcanzar el punto de interrupción.

5. Cambie a Visual Studio para ver el punto de interrupción e inspeccionar los valores.

Autenticación en servicios de Azure mediante el proxy de token

Al usar servicios de Azure desde un contenedor, puede usar defaultAzureCredential (con el VisualStudioCredential habilitado) para autenticarse con los servicios de Azure con su cuenta de Microsoft Entra sin ninguna configuración adicional en el contenedor. Para activar esto, consulte Cómo configurar las herramientas de contenedor de Visual Studio. Además, debe configurar la autenticación de Azure en Visual Studio siguiendo las instrucciones de Autenticación de Visual Studio con Azure. La compatibilidad con VisualStudioCredential en un contenedor está disponible en la versión 17.6 y posteriores de Visual Studio.

Comprobación de

Si va a depurar un proyecto integrado de Azure Functions y usa el proxy de token en el contenedor para controlar la autenticación en los servicios de Azure, debe copiar el entorno de ejecución de .NET en el contenedor para que se ejecute el proxy de token. Si está depurando un proyecto de Azure Functions aislado, ya tiene el entorno de ejecución de .NET, por lo que no es necesario realizar este paso adicional.

Para asegurarse de que el entorno de ejecución de .NET está disponible para el proxy de token, agregue o modifique la capa de debug en el Dockerfile que copia el entorno de ejecución de .NET en la imagen del contenedor. En el caso de los contenedores de Linux, puede agregar el código siguiente al Dockerfile:

# This layer is to support debugging, VS's Token Proxy requires the runtime to be installed in the container
FROM mcr.microsoft.com/dotnet/runtime:8.0 AS runtime
FROM base as debug
COPY --from=runtime /usr/share/dotnet /usr/share/dotnet
RUN ln -s /usr/share/dotnet/dotnet /usr/bin/dotnet

Además, en el proyecto de Visual Studio, debe realizar algunos cambios para especificarlo como la capa que se usará al depurar en modo rápido. Para obtener una explicación del modo rápido, consulte Personalización de contenedores de Docker en Visual Studio. Para escenarios de contenedor único (no Docker Compose), establezca la propiedad MSBuild DockerfileFastModeStage en debug para poder usar esa capa para la depuración. Para Docker Compose, modifique el docker-compose.vs.debug.yml de la siguiente manera:

# Set the stage to debug to use an image with the .NET runtime in it
services:
  functionappintegrated:
    build:
      target: debug

Para obtener un ejemplo de código de autenticación con Azure Functions, incluidos los escenarios integrados y aislados, consulte VisualStudioCredentialExample.

Reutilización de contenedores

Cuando se usa el modo rápido, que Visual Studio usa normalmente para la configuración de depuración, Visual Studio vuelve a generar solo las imágenes de contenedor y el propio contenedor cuando se cambia el Dockerfile. Si no cambia el Dockerfile, Visual Studio reutiliza el contenedor de una ejecución anterior.

Si modificó manualmente el contenedor y desea reiniciar con una imagen de contenedor limpia, use el comando Build>Clean en Visual Studio y, a continuación, compile como de costumbre.

Cuando no se usa el modo rápido, que es habitual para la configuración de versión, Visual Studio vuelve a generar el contenedor cada vez que se compila el proyecto.

Puede configurar cuándo se utiliza el Modo Rápido; consulte Cómo configurar las Herramientas de Contenedores de Visual Studio.

Solución de problemas

Aprenda a solucionar problemas de desarrollo de Visual Studio con Docker.

Contenido relacionado

Para obtener más detalles, lea Cómo Visual Studio compila aplicaciones en contenedores.

Más información sobre Docker con Visual Studio, Windows y Azure

• Obtenga más información sobre desarrollo de contenedores con Visual Studio.
• Para compilar e implementar un contenedor de Docker, consulte integración de Docker para Azure Pipelines.
• Para obtener un índice de artículos de Windows Server y Nano Server, vea Contenedores en la documentación de Windows.
• Obtenga información sobre Azure Kubernetes Service y revise la documentación de Azure Kubernetes Service.