Inicio rápido: Implementación de una aplicación web de ASP.NETQuickstart: Deploy an ASP.NET web app

En este inicio rápido, aprenderá a crear e implementar su primera aplicación web de ASP.NET en Azure App Service.In this quickstart, you'll learn how to create and deploy your first ASP.NET web app to Azure App Service. App Service admite varias versiones de aplicaciones .NET y proporciona un servicio de hospedaje web muy escalable y con aplicación de revisiones.App Service supports various versions of .NET apps, and provides a highly scalable, self-patching web hosting service. Las aplicaciones web de ASP.NET son multiplataforma y se pueden hospedar tanto en Linux como en Windows.ASP.NET web apps are cross-platform and can be hosted on Linux or Windows. Cuando termine, tendrá un grupo de recursos de Azure que consta de un plan de hospedaje de App Service y una aplicación web implementada.When you're finished, you'll have an Azure resource group consisting of an App Service hosting plan and an App Service with a deployed web application.

Sugerencia

.NET Core 3.1 es la versión actual del soporte técnico a largo plazo (LTS) de .NET..NET Core 3.1 is the current long-term support (LTS) release of .NET. Para más información, consulte la directiva de soporte técnico de .NET.For more information, see .NET support policy.

Requisitos previosPrerequisites

  • Una cuenta de Azure con una suscripción activa.An Azure account with an active subscription. Cree una cuenta gratuita.Create an account for free.

  • Visual Studio 2019 con la carga de trabajo ASP.NET y desarrollo web.Visual Studio 2019 with the ASP.NET and web development workload.

    Si ya ha instalado Visual Studio 2019:If you've already installed Visual Studio 2019:

    • Para instalar las actualizaciones más recientes de Visual Studio, seleccione Ayuda > Buscar actualizaciones.Install the latest updates in Visual Studio by selecting Help > Check for Updates.
    • Para agregar la carga de trabajo, seleccione Herramientas > Obtener herramientas y características.Add the workload by selecting Tools > Get Tools and Features.

Instale el SDK de .NET Core 3.1 más reciente. Install the latest .NET Core 3.1 SDK.

Instale el SDK de .NET Core 3.1 más reciente. Install the latest .NET Core 3.1 SDK.

Creación de una aplicación web de ASP.NETCreate an ASP.NET web app

  1. Abra Visual Studio y seleccione Crear un proyecto.Open Visual Studio and then select Create a new project.

  2. En Crear un proyecto, busque y elija Aplicación web ASP.NET Core y, después, seleccione Siguiente.In Create a new project, find, and choose ASP.NET Web Core App, then select Next.

  3. En Configurar el nuevo proyecto, asigne a la aplicación el nombre MyFirstAzureWebApp y seleccione Siguiente.In Configure your new project, name the application MyFirstAzureWebApp, and then select Next.

    Configurar una aplicación de ASP.NET Core 3.1

  4. Seleccione .NET Core 3.1 (soporte técnico a largo plazo) .Select .NET Core 3.1 (Long-term support).

  5. Asegúrese de que en Tipo de autenticación está seleccionada la opción Ninguno.Make sure Authentication Type is set to None. Seleccione Crear.Select Create.

    Visual Studio: seleccione .NET Core 3.1 y Ninguno en Tipo de autenticación.

  6. En el menú de Visual Studio, seleccione Depurar > Iniciar sin depurar para ejecutar la aplicación web localmente.From the Visual Studio menu, select Debug > Start Without Debugging to run the web app locally.

    Visual Studio: exploración local de .NET Core 3.1

Cree una carpeta denominada MyFirstAzureWebApp y ábrala en Visual Studio Code.Create a new folder named MyFirstAzureWebApp, and open it in Visual Studio Code. Abra la ventana Terminal y cree una aplicación web de .NET con el comando dotnet new webapp .Open the Terminal window, and create a new .NET web app using the dotnet new webapp command.

dotnet new webapp -f netcoreapp3.1

En Visual Studio Code, desde el Terminal ejecute la aplicación localmente mediante el comando dotnet run.From the Terminal in Visual Studio Code, run the application locally using the dotnet run command.

dotnet run

Abra un explorador web y vaya a la aplicación en https://localhost:5001.Open a web browser, and navigate to the app at https://localhost:5001.

Verá que la aplicación web de ASP.NET Core 3.1 de la plantilla se muestra en la página.You'll see the template ASP.NET Core 3.1 web app displayed in the page.

Visual Studio Code: ejecute .NET Core 3.1 en un explorador localmente.

Abra una ventana de terminal en la máquina en un directorio de trabajo.Open a terminal window on your machine to a working directory. Cree una aplicación web de .NET con el comando dotnet new webapp y vaya a los directorios de la aplicación recién creada.Create a new .NET web app using the dotnet new webapp command, and then change directories into the newly created app.

dotnet new webapp -n MyFirstAzureWebApp -f netcoreapp3.1 && cd MyFirstAzureWebApp

En la misma sesión de terminal, ejecute la aplicación localmente mediante el comando dotnet run.From the same terminal session, run the application locally using the dotnet run command.

dotnet run

Abra un explorador web y vaya a la aplicación en https://localhost:5001.Open a web browser, and navigate to the app at https://localhost:5001.

Verá que la aplicación web de ASP.NET Core 3.1 de la plantilla se muestra en la página.You'll see the template ASP.NET Core 3.1 web app displayed in the page.

Visual Studio Code: ASP.NET Core 3.1 en un explorador local.

Publicación de la aplicación webPublish your web app

Para publicar la aplicación web, primero debe crear y configurar una nueva instancia de App Service en la que pueda publicar la aplicación.To publish your web app, you must first create and configure a new App Service that you can publish your app to.

Como parte de la configuración de la instancia de App Service, creará:As part of setting up the App Service, you'll create:

  • Un nuevo grupo de recursos que contendrá todos los recursos de Azure para el servicio.A new resource group to contain all of the Azure resources for the service.
  • Un plan de hospedaje que especifique la ubicación, el tamaño y las características de la granja de servidores web que hospeda la aplicación.A new Hosting Plan that specifies the location, size, and features of the web server farm that hosts your app.

Siga estos pasos para crear la instancia de App Service y publicar la aplicación web:Follow these steps to create your App Service and publish your web app:

  1. En el Explorador de soluciones, haga clic con el botón derecho en el proyecto MyFirstAzureWebApp y seleccione Publicar.In Solution Explorer, right-click the MyFirstAzureWebApp project and select Publish.

  2. En Publicar, seleccione Azure y, después, Siguiente.In Publish, select Azure and then Next.

    Visual Studio: publique la aplicación web y use Azure como destino.

  3. Las opciones dependen de si ya ha iniciado sesión en Azure y de si tiene una cuenta de Visual Studio vinculada a una cuenta de Azure.Your options depend on whether you're signed in to Azure already and whether you have a Visual Studio account linked to an Azure account. Seleccione Agregar una cuenta o Iniciar sesión para iniciar sesión en la suscripción de Azure.Select either Add an account or Sign in to sign in to your Azure subscription. Si ya ha iniciado sesión, seleccione la cuenta que desee.If you're already signed in, select the account you want.

    Visual Studio: seleccione iniciar sesión en el cuadro de diálogo de Azure.

  4. Elija el valor de Destino específico, sea Azure App Service (Linux) o Azure App Service (Windows) .Choose the Specific target, either Azure App Service (Linux) or Azure App Service (Windows).

    Importante

    Cuando el destino sea ASP.NET Framework 4.8, usará Azure App Service (Windows) .When targeting ASP.NET Framework 4.8, you will use Azure App Service (Windows).

  5. A la derecha de App Service instances (Instancias de App Service), seleccione + .To the right of App Service instances, select +.

    Visual Studio: cuadro de diálogo de la aplicación del nuevo App Service.

  6. En Suscripción, acepte la suscripción que aparece o seleccione otra en la lista desplegable.For Subscription, accept the subscription that is listed or select a new one from the drop-down list.

  7. En Grupo de recursos, seleccione Nuevo.For Resource group, select New. En Nuevo nombre de grupo de recursos, escriba myResourceGroup y seleccione Aceptar.In New resource group name, enter myResourceGroup and select OK.

  8. En Plan de hospedaje, seleccione Nuevo.For Hosting Plan, select New.

  9. En el cuadro de diálogo Plan de hospedaje: Crear nuevo, escriba los valores especificados en la tabla siguiente:In the Hosting Plan: Create new dialog, enter the values specified in the following table:

    ConfiguraciónSetting Valor sugeridoSuggested value DescripciónDescription
    Plan de hospedajeHosting Plan MyFirstAzureWebAppPlanMyFirstAzureWebAppPlan Nombre del plan de App Service.Name of the App Service plan.
    UbicaciónLocation Oeste de EuropaWest Europe El centro de datos donde se hospeda la aplicación web.The datacenter where the web app is hosted.
    TamañoSize GratisFree Plan de tarifa determina las características de hospedaje.Pricing tier determines hosting features.

    Creación de un nuevo plan de hospedaje

  10. En Nombre, escriba un nombre de aplicación único que incluya solo los caracteres válidos, que son a-z, A-Z, 0-9 y -.In Name, enter a unique app name that includes only the valid characters are a-z, A-Z, 0-9, and -. Puede aceptar el nombre único generado automáticamente.You can accept the automatically generated unique name. La dirección URL de la aplicación web es http://<app-name>.azurewebsites.net, donde <app-name> es el nombre de la aplicación.The URL of the web app is http://<app-name>.azurewebsites.net, where <app-name> is your app name.

  11. Seleccione Crear para crear los recursos de Azure.Select Create to create the Azure resources.

    Visual Studio: cuadro de diálogo de creación de recursos de la aplicación.

    Una vez finalizado el asistente, los recursos de Azure se crean automáticamente y ya puede publicarlos.Once the wizard completes, the Azure resources are created for you and you are ready to publish.

  12. Seleccione Finalizar para cerrar el asistente.Select Finish to close the wizard.

  13. En la página Publicar, seleccione Publicar.In the Publish page, select Publish. Visual Studio compila, empaqueta y publica la aplicación en Azure y, luego, la inicia en el explorador predeterminado.Visual Studio builds, packages, and publishes the app to Azure, and then launches the app in the default browser.

    Verá que la aplicación web de ASP.NET Core 3.1 se muestra en la página.You'll see the ASP.NET Core 3.1 web app displayed in the page.

    Visual Studio: aplicación web de ASP.NET Core 3.1 en Azure.

Para implementar una aplicación web con la extensión Azure Tools para Visual Studio:To deploy your web app using the Visual Studio Azure Tools extension:

  1. En Visual Studio Code, abra la paleta de comandos, Ctrl+Shift+P.In Visual Studio Code, open the Command Palette, Ctrl+Shift+P.

  2. Busque y seleccione "Azure App Service: Implementar en aplicación web".Search for and select "Azure App Service: Deploy to Web App".

  3. Responda a los mensajes como se indica a continuación:Respond to the prompts as follows:

    • Seleccione MyFirstAzureWebApp como la carpeta que se va a implementar.Select MyFirstAzureWebApp as the folder to deploy.
    • Seleccione Agregar configuración cuando se le solicite.Select Add Config when prompted.
    • Si se le pide, inicie sesión en su cuenta de Azure.If prompted, sign in to your existing Azure account.

    Visual Studio Code: inicio de sesión en Azure .

    • Seleccione su suscripción.Select your Subscription.
    • Seleccione Create new Web App...Advanced (Crear aplicación web...Avanzada).Select Create new Web App... Advanced.
    • En Enter a globally unique name, (Especificar un nombre único global) use un nombre que sea único en todo Azure (los caracteres válidos son a-z, 0-9 y - ).For Enter a globally unique name, use a name that's unique across all of Azure (valid characters are a-z, 0-9, and -). Un buen patrón es usar una combinación del nombre de la empresa y un identificador de la aplicación.A good pattern is to use a combination of your company name and an app identifier.
    • Seleccione Crear nuevo grupo de recursos y escriba un nombre, por ejemplo, myResourceGroup.Select Create new resource group and provide a name like myResourceGroup.
    • Cuando se le pida, seleccione una pila en tiempo de ejecución:When prompted to Select a runtime stack:
      • En el caso de .NET Core 3.1, seleccione .NET Core 3.1 (LTS)For .NET Core 3.1, select .NET Core 3.1 (LTS)
      • En el caso de .NET 5.0, seleccione .NET 5For .NET 5.0, select .NET 5
      • En el caso de .NET Framework 4.8, seleccione ASP.NET v4.8For .NET Framework 4.8, select ASP.NET V4.8
    • Seleccione un sistema operativo (Windows o Linux).Select an operating system (Windows or Linux).
      • En el caso de .NET Framework 4.8, Windows se seleccionará implícitamente.For .NET Framework 4.8, Windows will be selected implicitly.
    • Seleccione Crear un nuevo plan de App Service, especifique un nombre y seleccione el plan de tarifa F1 Gratis.Select Create a new App Service plan, provide a name, and select the F1 Free pricing tier.
    • Seleccione Omitir por ahora para el recurso de Application Insights.Select Skip for now for the Application Insights resource.
    • Seleccione una ubicación cerca de usted.Select a location near you.
  4. Cuando se complete la publicación, seleccione Examinar sitio web en la notificación y seleccione Abrir cuando se le solicite.When publishing completes, select Browse Website in the notification and select Open when prompted.

    Verá que la aplicación web de ASP.NET Core 3.1 se muestra en la página.You'll see the ASP.NET Core 3.1 web app displayed in the page.

    Visual Studio Code: aplicación web de ASP.NET Core 3.1 en Azure.

Implemente el código en el directorio MyFirstAzureWebApp local, para lo que debe usar el comando az webapp up:Deploy the code in your local MyFirstAzureWebApp directory using the az webapp up command:

az webapp up --sku F1 --name <app-name> --os-type <os>
  • Si no se reconoce el comando az, asegúrese de tener instalada la CLI de Azure, como se describe en los requisitos previos.If the az command isn't recognized, be sure you have the Azure CLI installed as described in Prerequisites.
  • Reemplace <app-name> por un nombre que sea único en todo Azure (los caracteres válidos son a-z, 0-9 y - ).Replace <app-name> with a name that's unique across all of Azure (valid characters are a-z, 0-9, and -). Un buen patrón es usar una combinación del nombre de la empresa y un identificador de la aplicación.A good pattern is to use a combination of your company name and an app identifier.
  • El argumento --sku F1 crea la aplicación web en el plan de tarifa Gratis.The --sku F1 argument creates the web app on the Free pricing tier. Omita este argumento para usar un nivel Premium más rápido, lo que supondrá un costo por hora.Omit this argument to use a faster premium tier, which incurs an hourly cost.
  • Reemplace <os> por linux o windows.Replace <os> with either linux or windows. Debe usar windows cuando el destino sea ASP.NET Framework 4.8.You must use windows when targeting ASP.NET Framework 4.8.
  • Opcionalmente, incluya el argumento --location <location-name>, donde <location-name> es una región de Azure disponible.You can optionally include the argument --location <location-name> where <location-name> is an available Azure region. Puede recuperar una lista de las regiones permitidas para su cuenta de Azure mediante la ejecución del comando az account list-locations.You can retrieve a list of allowable regions for your Azure account by running the az account list-locations command.

El comando puede tardar varios minutos en completarse.The command may take a few minutes to complete. Mientras se ejecuta, proporciona mensajes sobre cómo crear el grupo de recursos, el plan de App Service y la aplicación de hospedaje, configurar el registro y, a continuación, realizar la implementación del archivo ZIP.While running, it provides messages about creating the resource group, the App Service plan, and hosting app, configuring logging, then performing ZIP deployment. A continuación, genera un mensaje con la dirección URL de la aplicación:It then outputs a message with the app's URL:

You can launch the app at http://<app-name>.azurewebsites.net

Abra un explorador web y vaya a dicha dirección:Open a web browser and navigate to the URL:

Verá que la aplicación web de ASP.NET Core 3.1 se muestra en la página.You'll see the ASP.NET Core 3.1 web app displayed in the page.

CLI: aplicación web de ASP.NET Core 3.1 en Azure.

Actualización de la aplicación y nueva implementaciónUpdate the app and redeploy

Siga estos pasos para actualizar y volver a implementar la aplicación web:Follow these steps to update and redeploy your web app:

  1. En el Explorador de soluciones, en el proyecto, abra index.cshtml.In Solution Explorer, under your project, open Index.cshtml.

  2. Reemplace el primer elemento <div> por el código siguiente:Replace the first <div> element with the following code:

    <div class="jumbotron">
        <h1>.NET 💜 Azure</h1>
        <p class="lead">Example .NET app to Azure App Service.</p>
    </div>
    

    Guarde los cambios.Save your changes.

  3. Para volver a realizar la implementación en Azure, haga clic con el botón derecho en el proyecto MyFirstAzureWebApp en el Explorador de soluciones y seleccione Publicar.To redeploy to Azure, right-click the MyFirstAzureWebApp project in Solution Explorer and select Publish.

  4. En la página de resumen Publicar, seleccione Publicar.In the Publish summary page, select Publish.

    Cuando se completa la publicación, Visual Studio inicia un explorador en la dirección URL de la aplicación web.When publishing completes, Visual Studio launches a browser to the URL of the web app.

    Verá que la aplicación web de ASP.NET Core 3.1 actualizada se muestra en la página.You'll see the updated ASP.NET Core 3.1 web app displayed in the page.

    Visual Studio: aplicación web de ASP.NET Core 3.1 actualizada en Azure.

  1. Abra index.cshtml.Open Index.cshtml.

  2. Reemplace el primer elemento <div> por el código siguiente:Replace the first <div> element with the following code:

    <div class="jumbotron">
        <h1>.NET 💜 Azure</h1>
        <p class="lead">Example .NET app to Azure App Service.</p>
    </div>
    

    Guarde los cambios.Save your changes.

  3. Abra la barra lateral de Visual Studio Code y seleccione el icono de Azure para expandir sus opciones.Open the Visual Studio Code Side Bar, select the Azure icon to expand its options.

  4. En el nodo APP SERVICE, expanda su suscripción y haga clic con el botón derecho en MyFirstAzureWebApp.Under the APP SERVICE node, expand your subscription and right-click on the MyFirstAzureWebApp.

  5. Seleccione Implementar en aplicación web...Select the Deploy to Web App....

  6. Cuando se le solicite, seleccione Implementar.Select Deploy when prompted.

  7. Cuando se complete la publicación, seleccione Examinar sitio web en la notificación y seleccione Abrir cuando se le solicite.When publishing completes, select Browse Website in the notification and select Open when prompted.

    Verá que la aplicación web de ASP.NET Core 3.1 actualizada se muestra en la página.You'll see the updated ASP.NET Core 3.1 web app displayed in the page.

    Visual Studio Code: aplicación web de ASP.NET Core 3.1 actualizada en Azure.

En el directorio local, abra el archivo Index.cshtml.In the local directory, open the Index.cshtml file. Reemplace el primer elemento <div>:Replace the first <div> element:

<div class="jumbotron">
    <h1>.NET 💜 Azure</h1>
    <p class="lead">Example .NET app to Azure App Service.</p>
</div>

Guarde los cambios y vuelva a implementar la aplicación con el comando az webapp up:Save your changes, then redeploy the app using the az webapp up command again:

ASP.NET Core 3.1 es multiplataforma, en función de la implementación anterior, reemplace <os> por linux o windows.ASP.NET Core 3.1 is cross-platform, based on your previous deployment replace <os> with either linux or windows.

az webapp up --os-type <os>

Este comando utiliza valores que se almacenan en caché de forma local en el archivo .azure/config, incluidos el nombre de la aplicación, el grupo de recursos y el plan de App Service.This command uses values that are cached locally in the .azure/config file, including the app name, resource group, and App Service plan.

Una vez que la implementación haya finalizado, vuelva a cambiar la ventana del explorador que se abrió en el paso Navegación hasta la aplicación y actualice la vista.Once deployment has completed, switch back to the browser window that opened in the Browse to the app step, and hit refresh.

Verá que la aplicación web de ASP.NET Core 3.1 actualizada se muestra en la página.You'll see the updated ASP.NET Core 3.1 web app displayed in the page.

CLI: aplicación web de ASP.NET Core 3.1 actualizada en Azure.

Administración de la aplicación de AzureManage the Azure app

Para administrar la aplicación web, vaya a Azure Portal y busque y seleccione App Services.To manage your web app, go to the Azure portal, and search for and select App Services.

Azure Portal: seleccione la opción App Services.

En la página App Services, seleccione el nombre de la aplicación web.On the App Services page, select the name of your web app.

Azure Portal: la página de App Services con una aplicación web de ejemplo seleccionada.

La página Información general de la aplicación web contiene opciones para la administración básica como examinar, detener, iniciar, reiniciar y eliminar.The Overview page for your web app, contains options for basic management like browse, stop, start, restart, and delete. El menú izquierdo proporciona varias páginas para configurar la aplicación.The left menu provides further pages for configuring your app.

Azure Portal: página de información general de App Service.

Limpieza de recursosClean up resources

En los pasos anteriores, creó recursos de Azure en un grupo de recursos.In the preceding steps, you created Azure resources in a resource group. Si no prevé necesitar estos recursos en el futuro, puede eliminarlos mediante la eliminación del grupo de recursos.If you don't expect to need these resources in the future, you can delete them by deleting the resource group.

  1. En la página Información general de la aplicación web de Azure Portal, seleccione el vínculo myResourceGroup en Grupo de recursos.From your web app's Overview page in the Azure portal, select the myResourceGroup link under Resource group.
  2. En la página del grupo de recursos, asegúrese de que los recursos que aparecen son los que quiere eliminar.On the resource group page, make sure that the listed resources are the ones you want to delete.
  3. Seleccione Eliminar, escriba myResourceGroup en el cuadro de texto y luego seleccione Eliminar.Select Delete, type myResourceGroup in the text box, and then select Delete.

Limpieza de recursosClean up resources

En los pasos anteriores, creó recursos de Azure en un grupo de recursos.In the preceding steps, you created Azure resources in a resource group. Si no prevé necesitar estos recursos en el futuro, puede eliminarlos mediante la eliminación del grupo de recursos.If you don't expect to need these resources in the future, you can delete them by deleting the resource group.

  1. En la página Información general de la aplicación web de Azure Portal, seleccione el vínculo myResourceGroup en Grupo de recursos.From your web app's Overview page in the Azure portal, select the myResourceGroup link under Resource group.
  2. En la página del grupo de recursos, asegúrese de que los recursos que aparecen son los que quiere eliminar.On the resource group page, make sure that the listed resources are the ones you want to delete.
  3. Seleccione Eliminar, escriba myResourceGroup en el cuadro de texto y luego seleccione Eliminar.Select Delete, type myResourceGroup in the text box, and then select Delete.

Limpieza de recursosClean up resources

En los pasos anteriores, creó recursos de Azure en un grupo de recursos.In the preceding steps, you created Azure resources in a resource group. Si prevé que no necesitará estos recursos en el futuro, elimine el grupo de recursos ejecutando el siguiente comando en Cloud Shell:If you don't expect to need these resources in the future, delete the resource group by running the following command in the Cloud Shell:

az group delete --name myResourceGroup

Este comando puede tardar varios segundos en ejecutarse.This command may take a minute to run.

Pasos siguientesNext steps

En este inicio rápido, ha creado e implementado una aplicación web de ASP.NET en Azure App Service.In this quickstart, you created and deployed an ASP.NET web app to Azure App Service.

Pase al siguiente artículo para aprender a crear una aplicación de .NET Core y conectarla a una instancia de SQL Database:Advance to the next article to learn how to create a .NET Core app and connect it to a SQL Database: