Publicar una aplicación de ASP.NET Core en Azure con Visual Studio Code

En este tutorial aprenderá a crear una aplicación MVC ASP.Net Core y a implementarla en Visual Studio Code. Para realizar el tutorial debe estar familiarizado con VS Code. Para obtener más información, consulte Introducción a VS Code. Este tutorial funcionará en entornos Windows, macOS o Linux. Asegúrese de usar los caracteres separadores de ruta correctos (\ frente a /) para su entorno.

Important

Versiones preliminares de ASP.NET Core con Azure App Service

Las versiones preliminares de ASP.NET Core no se implementan de forma predeterminada en Azure App Service. Para alojar una aplicación que usa una versión preliminar de ASP.NET Core, consulte Implementar una versión preliminar de ASP.NET Core en Azure App Service.

Para solucionar un problema con la implementación de App Service, vea Solución de problemas de ASP.NET Core en Azure App Service e IIS.

Prerequisites

Creación de un proyecto MVC ASP.Net Core

  1. Abra el terminal integrado.

  2. Establezca el directorio de trabajo (cd) en el directorio que contendrá el proyecto.

  3. Ejecute los comandos siguientes:

    dotnet new mvc -o MyMVCapp
    code -r MyMVCapp
    

    Para los comandos anteriores:

    • dotnet new mvc -o MyMVCapp
      • Crea un nuevo proyecto ASP.NET Core MVC en la carpeta MyMVCapp .
    • code -r MyMVCapp
      • Carga el archivo de proyecto MyMVCapp.csproj en Visual Studio Code.
      • Visual Studio Code sitúa el terminal integrado en el directorio del proyecto.

Note

Se muestra un cuadro de diálogo con el texto Faltan los recursos necesarios para compilar y depurar desde "MyMVCapp". ¿Desea agregarlos?; seleccione Sí.

Se crea un nuevo proyecto ASP.NET Core MVC en una carpeta MyMVCapp con una estructura similar a la siguiente:

      appsettings.Development.json
      appsettings.json
<DIR> bin
<DIR> Controllers
<DIR> Models
      MyMVCapp.csproj
<DIR> obj
      Program.cs
<DIR> Properties
<DIR> Views
<DIR> wwwroot

Se creará una carpeta .vscode dentro de la estructura del proyecto. Contendrá archivos de utilidad para ayudarte a compilar y depurar tu aplicación web con ASP.NET Core.

Prueba el proyecto

Antes de implementar la aplicación en Azure, asegúrese de que se ejecuta correctamente en la máquina local.

  1. Abra el terminal integrado (si es necesario).

  2. Configure un certificado de desarrollo HTTPS de confianza:

    • Para confiar en el certificado de desarrollo de HTTPS, ejecute el comando siguiente:

      dotnet dev-certs https --trust
      

      El comando anterior requiere el SDK de .NET 9 o posterior en Linux. Para Linux en .NET 8.0.401 o un SDK anterior, consulte la documentación de la distribución de Linux para confiar en un certificado.

      El comando anterior muestra el siguiente cuadro de diálogo, siempre que el certificado no se haya considerado de confianza previamente:

      Cuadro de diálogo de advertencia de seguridad

    • Si acepta confiar en el certificado de desarrollo, seleccione Sí.

      Para obtener más información, consulte la sección Confiar en el certificado de desarrollo HTTPS de ASP.NET Core del artículo Aplicación de SSL.

    Para obtener información sobre cómo confiar en el explorador Firefox, consulte Error de certificado SEC_ERROR_INADEQUATE_KEY_USAGE de Firefox.

  3. Ejecute el comando siguiente:

    dotnet run
    

    El comando anterior:

    • Inicia Kestrel, servidor web integrado de ASP.NET Core.
    • Muestra una URL para probar la aplicación web, como http://localhost:<port>, donde <port> es el número de puerto aleatorio asignado en Properties\launchSettings.json al crear el proyecto.

    La salida muestra mensajes similares al siguiente, que indican que la aplicación se está ejecutando y esperando solicitudes:

    $ dotnet run
    Building...
    info: Microsoft.Hosting.Lifetime[14]
        Now listening on: https://localhost:7064
    info: Microsoft.Hosting.Lifetime[14]
        Now listening on: http://localhost:5119
    info: Microsoft.Hosting.Lifetime[0]
        Application started. Press Ctrl+C to shut down.
    info: Microsoft.Hosting.Lifetime[0]
        Hosting environment: Development
    info: Microsoft.Hosting.Lifetime[0]
        Content root path: D:\Src\MyMVCapp\
    
  4. Ctrl+Haga clic en la dirección URL HTTPS de la salida para probar la aplicación web en un explorador. En el ejemplo anterior, la dirección URL es https://localhost:7064.

  5. Presione Ctrl+C en el terminal integrado para apagar la aplicación web después de probarla.

Generación del paquete de implementación localmente

  1. En el terminal integrado, use el siguiente comando para generar un paquete Release en una carpeta ubicada en bin/Publish:

    dotnet publish -c Release -o ./bin/Publish
    

    Se creará una nueva subcarpeta Publish en la carpeta bin. Esta carpeta contiene los archivos que se van a implementar en Azure.

    Estructura de carpetas de publicación

Publicación en Azure App Service

Aproveche la extensión de Azure App Service para Visual Studio Code y siga los pasos que se indican a continuación para publicar el sitio web directamente en Azure App Service.

Crear un nuevo recurso de aplicación web de Azure

Si no tiene un recurso de aplicación web de Azure existente para publicar, debe crear uno.

  1. En la pestaña Extensión de Azure, en el panel RECURSOS , expanda la suscripción que desea usar.
  2. Haga clic con el botón derecho en App Services y seleccione Crear nueva aplicación web....
  3. Siga las instrucciones:
    1. Introduzca un nombre único para la aplicación web.
    2. Seleccione el entorno de ejecución de .NET estable más reciente (por ejemplo, .NET 6 (LTS)). No seleccione el entorno de ejecución de ASP.NET, que es para las aplicaciones de .NET Framework.
    3. Seleccione del plan de tarifa. Gratis (F1) es aceptable para este tutorial.

Publicación en Azure

  1. Haga clic con el botón derecho en la carpeta bin\Publish, seleccione Deploy to Web App... y siga las indicaciones.

    1. Seleccione la suscripción donde se encuentra el recurso de la aplicación web de Azure.
    2. Seleccione el recurso de la aplicación web de Azure en el que va a publicar.
    3. Seleccione Implementar cuando se le solicite un cuadro de diálogo de confirmación.
  2. Una vez que se haya terminado la implementación, haga clic en Browse Website para validar la implementación.

    Mensaje en el que se indica que la implementación se ha realizado correctamente

    Al hacer clic en Browse Website, navegará ahí con su explorador predeterminado:

    Nueva aplicación web desplegada correctamente

Tip

Puede repetir los pasos anteriores para volver a implementar la aplicación en el mismo recurso de la aplicación web de Azure según sea necesario. Asegúrese de volver a ejecutar dotnet publish antes de realizar la implementación en Azure.

Pasos siguientes