Compartir vía


Publicación de 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 la ruta de acceso correcta separando los caracteres (\ frente a /) para su entorno.

Importante

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 hospedar una aplicación que usa una versión preliminar de ASP.NET Core, vea 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.

Requisitos previos

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 de ASP.NET Core MVC en la carpeta MvcMovie.
    • code -r MyMVCapp
      • Carga el archivo de proyecto MyMVCapp.csproj en Visual Studio Code.
      • Visual Studio Code actualiza el terminal integrado en el directorio del proyecto.

Nota

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

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 en la estructura del proyecto. Contendrá archivos de utilidad que le ayudarán a compilar y depurar su aplicación web de ASP.NET Core.

Prueba del 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 .NET 9 SDK o posterior en Linux. Para Linux en el SDK de .NET 8.0.401 y versiones anteriores, consulta la documentación de tu distribución de Linux para confiar en un certificado.

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

      Cuadro de diálogo de advertencia de seguridad

    • Si aceptas confiar en el certificado de desarrollo, seleccione .

      Para obtener más información, consulta 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 dirección URL para probar la aplicación web, como http://localhost:<port>, donde <port> es el número de puerto aleatorio establecido en Properties\launchSettings.json en la creación del 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+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.

Creación de un 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.

Publicar 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 presente 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 implementada correctamente

Sugerencia

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

Recursos adicionales