Início Rápido: Criar um aplicativo Web ASP.NET Core no AzureQuickstart: Create an ASP.NET Core web app in Azure

Neste guia de início rápido, você aprenderá a criar e implantar seu primeiro aplicativo Web ASP.NET Core no Serviço de Aplicativo do Azure.In this quickstart, you'll learn how to create and deploy your first ASP.NET Core web app to Azure App Service. O Serviço de Aplicativo dá suporte a aplicativos .NET 5.0.App Service supports .NET 5.0 apps.

Quando terminar, você terá um grupo de recursos do Azure que consistirá em um plano de hospedagem do Serviço de Aplicativo e um Serviço de Aplicativo com um aplicativo Web implantado.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.

Pré-requisitosPrerequisites

  • Uma conta do Azure com uma assinatura ativa.An Azure account with an active subscription. Crie uma conta gratuitamente.Create an account for free.

  • Instale o Visual Studio 2019 com a carga de trabalho de desenvolvimento Web e do ASP.NET.Install Visual Studio 2019 with the ASP.NET and web development workload.

    Se você já instalou o Visual Studio 2019:If you've installed Visual Studio 2019 already:

    • Instale as atualizações mais recentes no Visual Studio selecionando Ajuda > Verificar Atualizações.Install the latest updates in Visual Studio by selecting Help > Check for Updates. As atualizações mais recentes contêm o SDK do .NET 5.0.The latest updates contain the .NET 5.0 SDK.
    • Adicione a carga de trabalho selecionando Ferramentas > Obter Ferramentas e Recursos.Add the workload by selecting Tools > Get Tools and Features.

Criar um aplicativo Web ASP.NET CoreCreate an ASP.NET Core web app

Crie um aplicativo Web ASP.NET Core no Visual Studio seguindo estas etapas:Create an ASP.NET Core web app in Visual Studio by following these steps:

  1. Abra o Visual Studio e selecione Criar um projeto.Open Visual Studio and select Create a new project.

  2. Em Criar um projeto, selecione Aplicativo Web ASP.NET Core e confirme se C# está listado nas linguagens para essa escolha e, em seguida, selecione Avançar.In Create a new project, select ASP.NET Core Web Application and confirm that C# is listed in the languages for that choice, then select Next.

  3. Em Configurar seu novo projeto, dê ao projeto de aplicativo Web o nome myFirstAzureWebApp e selecione Criar.In Configure your new project, name your web application project myFirstAzureWebApp, and select Create.

    Configurar seu projeto de aplicativo Web

  4. Você pode implantar qualquer tipo de aplicativo Web ASP.NET Core no Azure, mas para este guia de início rápido, escolha o modelo Aplicativo Web.You can deploy any type of ASP.NET Core web app to Azure, but for this quickstart, choose the Web Application template. Defina Autenticação como Sem Autenticação e não deixe nenhuma outra opção selecionada.Make sure Authentication is set to No Authentication, and that no other option is selected. Em seguida, selecione Criar.Then, select Create.

    Criar um aplicativo Web ASP.NET Core

  5. No menu do Visual Studio, selecione Depurar > Iniciar Sem Depuração para executar o aplicativo Web localmente.From the Visual Studio menu, select Debug > Start Without Debugging to run your web app locally.

    Aplicativo Web em execução local

Publicar seu aplicativo WebPublish your web app

Para publicar o aplicativo Web, você deve primeiro criar e configurar um novo Serviço de Aplicativo no qual você possa publicá-lo.To publish your web app, you must first create and configure a new App Service that you can publish your app to.

Como parte da configuração do Serviço de Aplicativo, você criará:As part of setting up the App Service, you'll create:

  • Um novo grupo de recursos para conter todos os recursos do Azure para o serviço.A new resource group to contain all of the Azure resources for the service.
  • Um novo Plano de Hospedagem que especifica o local, o tamanho e os recursos do farm de servidores Web que hospeda o aplicativo.A new Hosting Plan that specifies the location, size, and features of the web server farm that hosts your app.

Siga estas etapas para criar seu Serviço de Aplicativo e publicar o aplicativo Web:Follow these steps to create your App Service and publish your web app:

  1. No Gerenciador de Soluções, clique com o botão direito do mouse no projeto myFirstAzureWebApp e selecione Publicar.In Solution Explorer, right-click the myFirstAzureWebApp project and select Publish.

  2. Em Publicar, selecione Azure e clique em Avançar.In Publish, select Azure and click Next.

  3. As opções dependem de você já ter entrado no Azure e de ter uma conta do Visual Studio vinculada a uma conta do 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. Selecione Adicionar uma conta ou Entrar para entrar em sua assinatura do Azure.Select either Add an account or Sign in to sign in to your Azure subscription. Se você já estiver conectado, selecione a conta que deseja.If you're already signed in, select the account you want.

    Entrar no Azure

  4. À direita de Instâncias do Serviço de Aplicativo, clique em + .To the right of App Service instances, click +.

    Novo aplicativo do Serviço de Aplicativo

  5. Em Assinatura, aceite a assinatura que está listada ou selecione uma nova na lista suspensa.For Subscription, accept the subscription that is listed or select a new one from the drop-down list.

  6. Para Grupo de recursos, selecione Novo.For Resource group, select New. Em Nome do novo grupo de recursos, insira myResourceGroup e selecione OK.In New resource group name, enter myResourceGroup and select OK.

  7. Em Plano de Hospedagem, selecione Novo.For Hosting Plan, select New.

  8. Na caixa de diálogo Plano de Hospedagem: Criar novo, insira os valores especificados na tabela a seguir:In the Hosting Plan: Create new dialog, enter the values specified in the following table:

    ConfiguraçãoSetting Valor sugeridoSuggested Value DescriçãoDescription
    Plano de hospedagemHosting Plan myFirstAzureWebAppPlanmyFirstAzureWebAppPlan O nome do plano do Serviço de Aplicativo.Name of the App Service plan.
    LocalidadeLocation Oeste da EuropaWest Europe O datacenter onde o aplicativo Web está hospedado.The datacenter where the web app is hosted.
    TamanhoSize GratuitoFree O Tipo de preço determina os recursos de hospedagem.Pricing tier determines hosting features.

    Criar um Plano de Hospedagem

  9. Em Nome, insira um nome de aplicativo exclusivo que inclua somente os caracteres válidos a-z, A-Z, 0-9 e -.In Name, enter a unique app name that includes only the valid characters are a-z, A-Z, 0-9, and -. Você pode aceitar o nome exclusivo gerado automaticamente.You can accept the automatically generated unique name. A URL do aplicativo Web é http://<app-name>.azurewebsites.net, em que <app-name> é o nome do aplicativo.The URL of the web app is http://<app-name>.azurewebsites.net, where <app-name> is your app name.

  10. Selecione Criar para criar os recursos do Azure.Select Create to create the Azure resources.

    Criar recursos de aplicativos

    Quando o assistente for concluído, os recursos do Azure serão criados para você e você estará pronto para publicar.Once the wizard completes, the Azure resources are created for you and you are ready to publish.

  11. Escolha Concluir para fechar o assistente.Select Finish to close the wizard.

  12. Na página Publicar, clique em Publicar.In the Publish page, click Publish. O Visual Studio compila, empacota e publica o aplicativo no Azure e, em seguida, inicia o aplicativo no navegador padrão.Visual Studio builds, packages, and publishes the app to Azure, and then launches the app in the default browser.

    Aplicativo Web ASP.NET publicado em execução no Azure

Parabéns!Congratulations! Seu aplicativo Web ASP.NET Core está em execução no Serviço de Aplicativo do Azure.Your ASP.NET Core web app is running live in Azure App Service.

Atualizar o aplicativo e reimplantarUpdate the app and redeploy

Siga estas etapas para atualizar e reimplantar seu aplicativo Web:Follow these steps to update and redeploy your web app:

  1. No Gerenciador de Soluções, em seu projeto, abra Páginas > Index.cshtml.In Solution Explorer, under your project, open Pages > Index.cshtml.

  2. Substitua toda a marcação <div> pelo seguinte código:Replace the entire <div> tag with the following code:

    <div class="jumbotron">
        <h1>ASP.NET in Azure!</h1>
        <p class="lead">This is a simple app that we've built that demonstrates how to deploy a .NET app to Azure App Service.</p>
    </div>
    
  3. Para implantar novamente no Azure, clique com o botão direito do mouse no projeto myFirstAzureWebApp, no Gerenciador de Soluções e selecione Publicar.To redeploy to Azure, right-click the myFirstAzureWebApp project in Solution Explorer and select Publish.

  4. Na página de resumo Publicar, selecione Publicar.In the Publish summary page, select Publish.

    Quando a publicação está concluída, o Visual Studio inicia um navegador para a URL do aplicativo Web.When publishing completes, Visual Studio launches a browser to the URL of the web app.

    Aplicativo Web ASP.NET atualizado em execução no Azure

Gerenciar o aplicativo do AzureManage the Azure app

Para gerenciar o aplicativo Web, acesse o portal do Azure e procure e selecione Serviços de Aplicativos.To manage your web app, go to the Azure portal, and search for and select App Services.

Selecionar Serviços de Aplicativos

Na página Serviços de Aplicativos, selecione o nome do seu aplicativo Web.On the App Services page, select the name of your web app.

Captura de tela da página Serviços de Aplicativos com um aplicativo Web de exemplo selecionado.

A página Visão Geral do aplicativo Web contém opções para gerenciamento básico, como procurar, parar, iniciar, reiniciar e excluir.The Overview page for your web app, contains options for basic management like browse, stop, start, restart, and delete. O menu à esquerda fornece páginas adicionais para configurar o aplicativo.The left menu provides further pages for configuring your app.

Serviço de Aplicativo no portal do Azure

Limpar os recursosClean up resources

Nas etapas anteriores, você criou os recursos do Azure em um grupo de recursos.In the preceding steps, you created Azure resources in a resource group. Se você não espera precisar desses recursos no futuro, poderá excluí-los ao excluir o grupo de recursos.If you don't expect to need these resources in the future, you can delete them by deleting the resource group.

No menu do portal do Azure ou na Página inicial, selecione Grupos de recursos.From the Azure portal menu or Home page, select Resource groups. Em seguida, na página Grupos de recursos, selecione myResourceGroup.Then, on the Resource groups page, select myResourceGroup.

Na página myResourceGroup, certifique-se de que os recursos listados são aqueles que deseja excluir.On the myResourceGroup page, make sure that the listed resources are the ones you want to delete.

Selecione Excluir grupo de recursos, digite myResourceGroup na caixa de texto para confirmar e selecione Excluir.Select Delete resource group, type myResourceGroup in the text box to confirm, and then select Delete.

Próximas etapasNext steps

Neste guia de início rápido, você usou o Visual Studio para criar e implantar um aplicativo Web ASP.NET Core no Serviço de Aplicativo do Azure.In this quickstart, you used Visual Studio to create and deploy an ASP.NET Core web app to Azure App Service.

Avance para o próximo artigo para saber como criar um aplicativo .NET Core e conectá-lo a um Banco de Dados SQL:Advance to the next article to learn how to create a .NET Core app and connect it to a SQL Database:

O Serviço de Aplicativo no Linux fornece um serviço de hospedagem na Web altamente escalonável e com aplicação automática de patches usando o sistema operacional Linux.App Service on Linux provides a highly scalable, self-patching web hosting service using the Linux operating system. Este guia de início rápido mostra como criar um aplicativo .NET Core no Serviço de Aplicativo no Linux.This quickstart shows how to create a .NET Core app on App Service on Linux. Crie o aplicativo usando a CLI do Azure e use o Git para implantar o código .NET Core no aplicativo.You create the app using the Azure CLI, and you use Git to deploy the .NET Core code to the app.

Aplicativo de exemplo em execução no Azure

Você pode seguir as etapas deste artigo usando um computador Mac, Windows ou Linux.You can follow the steps in this article using a Mac, Windows, or Linux machine.

Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.If you don't have an Azure subscription, create a free account before you begin.

Configurar o seu ambiente inicialSet up your initial environment

Está com problemas? Fale conosco.Having issues? Let us know.

Criar o aplicativo localmenteCreate the app locally

Em uma janela de terminal no computador, crie um diretório chamado hellodotnetcore e altere o diretório atual para ele.In a terminal window on your machine, create a directory named hellodotnetcore and change the current directory to it.

mkdir hellodotnetcore
cd hellodotnetcore

Crie um aplicativo .NET Core.Create a new .NET Core app.

dotnet new web

Executar o aplicativo localmenteRun the app locally

Execute o aplicativo no local para ver como ele deve ficar quando o implantar no Azure.Run the application locally so that you see how it should look when you deploy it to Azure.

dotnet run

Abra um navegador da Web e navegue até o aplicativo em http://localhost:5000.Open a web browser, and navigate to the app at http://localhost:5000.

Você vê a mensagem Olá, Mundo no aplicativo de exemplo exibido na página.You see the Hello World message from the sample app displayed in the page.

Testar com um navegador

Está com problemas? Fale conosco.Having issues? Let us know.

Entrar no AzureSign into Azure

Na janela do terminal, faça logon no Azure com o seguinte comando:In your terminal window, log into Azure with the following command:

az login

Implantar o aplicativoDeploy the app

Implante o código na pasta local (hellodotnetcore) usando o comando az webapp up:Deploy the code in your local folder (hellodotnetcore) using the az webapp up command:

az webapp up --sku F1 --name <app-name> --os-type linux
  • Se o comando az não for reconhecido, verifique se você tem a CLI do Azure instalada, conforme descrito em Configurar seu ambiente inicial.If the az command isn't recognized, be sure you have the Azure CLI installed as described in Set up your initial environment.
  • Substitua <app-name> por um nome que seja exclusivo em todo o Azure (os caracteres válidos são a-z, 0-9 e - ).Replace <app-name> with a name that's unique across all of Azure (valid characters are a-z, 0-9, and -). Um bom padrão é usar uma combinação do nome da empresa e um identificador de aplicativo.A good pattern is to use a combination of your company name and an app identifier.
  • O argumento --sku F1 cria o aplicativo Web no tipo de preço Gratuito.The --sku F1 argument creates the web app on the Free pricing tier. Omita esse argumento para usar um nível Premium mais rápido, o que incorre em um custo por hora.Omit this argument to use a faster premium tier, which incurs an hourly cost.
  • Opcionalmente, você pode incluir o argumento --location <location-name>, em que <location-name> é uma região do Azure disponível.You can optionally include the argument --location <location-name> where <location-name> is an available Azure region. Você pode recuperar uma lista de regiões permitidas para sua conta do Azure executando o 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.

O comando pode demorar um pouco para ser concluído.The command may take a few minutes to complete. Durante a execução, ele fornece mensagens sobre como criar o grupo de recursos, o plano do Serviço de Aplicativo e o aplicativo de hospedagem, configurar o registro em log e executar a implantação ZIP.While running, it provides messages about creating the resource group, the App Service plan and hosting app, configuring logging, then performing ZIP deployment. Em seguida, ele fornece a mensagem "Você pode iniciar o aplicativo em http://<nome-do-aplicativo>.azurewebsites.net", que é a URL do aplicativo no Azure.It then gives the message, "You can launch the app at http://<app-name>.azurewebsites.net", which is the app's URL on Azure.

Está com problemas? Fale conosco.Having issues? Let us know.

Observação

O comando az webapp up realiza as seguintes ações:The az webapp up command does the following actions:

Navegar até o aplicativoBrowse to the app

Navegue até o aplicativo implantado usando o navegador da Web.Browse to the deployed application using your web browser.

http://<app_name>.azurewebsites.net

O código de exemplo .NET Core está em execução no Serviço de Aplicativo no Linux com uma imagem interna.The .NET Core sample code is running in App Service on Linux with a built-in image.

Aplicativo de exemplo em execução no Azure

Parabéns!Congratulations! Você implantou seu primeiro aplicativo .NET Core no Serviço de Aplicativo no Linux.You've deployed your first .NET Core app to App Service on Linux.

Está com problemas? Fale conosco.Having issues? Let us know.

Atualizar e reimplantar o códigoUpdate and redeploy the code

No diretório local, abra o arquivo Startup.cs.In the local directory, open the Startup.cs file. Faça uma pequena alteração no texto na chamada do método context.Response.WriteAsync:Make a small change to the text in the method call context.Response.WriteAsync:

await context.Response.WriteAsync("Hello Azure!");

Salve suas alterações e reimplante o aplicativo usando o comando az webapp up novamente:Save your changes, then redeploy the app using the az webapp up command again:

az webapp up --os-type linux

Esse comando usa valores armazenados em cache localmente no arquivo .azure/config, incluindo o nome do aplicativo, o grupo de recursos e o plano do Serviço de Aplicativo.This command uses values that are cached locally in the .azure/config file, including the app name, resource group, and App Service plan.

Depois que a implantação for concluída, mude de volta para a janela do navegador aberta na etapa Navegar até o aplicativo e clique em Atualizar.Once deployment has completed, switch back to the browser window that opened in the Browse to the app step, and hit refresh.

Aplicativo de exemplo atualizado em execução no Azure

Está com problemas? Fale conosco.Having issues? Let us know.

Gerenciar seu novo aplicativo do AzureManage your new Azure app

Acesse o portal do Azure para gerenciar o aplicativo que você criou.Go to the Azure portal to manage the app you created.

No menu à esquerda, clique em Serviços de Aplicativos e, em seguida, clique no nome do aplicativo do Azure.From the left menu, click App Services, and then click the name of your Azure app.

Captura de tela da página Serviços de Aplicativos mostrando um exemplo de aplicativo do Azure selecionado.

Você verá a página Visão geral do aplicativo.You see your app's Overview page. Aqui você pode executar tarefas básicas de gerenciamento como procurar, parar, iniciar, reiniciar e excluir.Here, you can perform basic management tasks like browse, stop, start, restart, and delete.

Página Serviço de Aplicativo no portal do Azure

O menu à esquerda fornece páginas diferentes para configurar seu aplicativo.The left menu provides different pages for configuring your app.

Limpar os recursosClean up resources

Nas etapas anteriores, você criou os recursos do Azure em um grupo de recursos.In the preceding steps, you created Azure resources in a resource group. Se você acha que não precisará desses recursos no futuro, exclua o grupo de recursos executando o seguinte comando no 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

Esse comando pode demorar um pouco para ser executado.This command may take a minute to run.

Está com problemas? Fale conosco.Having issues? Let us know.

Próximas etapasNext steps