Guia de início rápido: implantar um aplicativo Web ASP.NET

Se já instalaste o Visual Studio 2026:

1. Instale as atualizações mais recentes no Visual Studio selecionando Ajuda>Verificar atualizações.
2. Adicione a carga de trabalho selecionando Ferramentas>Obter ferramentas e recursos.

• Uma conta do Azure com uma subscrição ativa. Crie uma conta gratuitamente.
• Código do Visual Studio.
• A extensão Ferramentas do Azure.
• O mais recente SDK .NET 10.0.

• Uma conta do Azure com uma subscrição ativa. Crie uma conta gratuitamente.
• CLI do Azure.
• O mais recente SDK .NET 10.0.

• Uma conta do Azure com uma subscrição ativa. Crie uma conta gratuitamente.
• O Azure PowerShell.
• O mais recente SDK .NET 10.0.

• Uma conta do Azure com uma subscrição ativa. Crie uma conta gratuitamente.
• Uma conta no GitHub Crie uma conta gratuitamente.

Saltar para o fim

Você pode implantar rapidamente o aplicativo de exemplo ASP.NET Core neste tutorial usando a CLI do Desenvolvedor do Azure e vê-lo em execução no Azure. Basta executar os seguintes comandos no Azure Cloud Shell e seguir o prompt:

mkdir dotnetcore-quickstart
cd dotnetcore-quickstart
azd init --template https://github.com/Azure-Samples/quickstart-deploy-aspnet-core-app-service.git
azd up

E, para excluir os recursos:

azd down

Criar uma aplicação Web ASP.NET

1. Abra uma janela de terminal no seu computador num diretório de trabalho. Crie um novo aplicativo Web .NET usando o comando dotnet new webapp e altere os diretórios para o aplicativo recém-criado.

   dotnet new blazor -n MyFirstAzureWebApp --framework net10.0
   cd MyFirstAzureWebApp
   

2. Na mesma sessão de terminal, execute o aplicativo localmente usando o comando dotnet run .

   dotnet run --urls=https://localhost:5001/
   

3. Abra um browser e navegue para a aplicação em https://localhost:5001.

   Vê o modelo de aplicação web ASP.NET Core 10.0 exibido na página.

   

Nesta etapa, fazes um fork de um projeto de demonstração para implantar.

1. No Gerenciador de Soluções, clique com o botão direito do mouse no projeto MyFirstAzureWebApp e selecione Publicar.

2. Em Publicar, selecione Azure e, em seguida, Avançar.

   

3. Escolha o destino específico, Serviço de Aplicativo do Azure (Linux) ou Serviço de Aplicativo do Azure (Windows). Selecione Seguinte.

   Importante

   Quando utilizar o ASP.NET Framework 4.8, utilize o Serviço de Aplicativo do Azure (Windows).

4. Suas opções dependem se você já está conectado ao Azure e se tem uma conta do Visual Studio vinculada a uma conta do Azure. Selecione Adicionar uma conta ou Entrar para entrar em sua assinatura do Azure. Se já tiver sessão iniciada, selecione a conta pretendida.

   

5. Selecione Criar novo.

   

6. Para Assinatura, aceite a assinatura listada ou selecione uma nova na lista suspensa.

7. Para Grupo de recursos, selecione Novo. Em Novo nome do grupo de recursos, digite myResourceGroup e selecione OK.

8. Para Plano de hospedagem, selecione Novo.

9. Na caixa de diálogo Plano de hospedagem: Criar novo, insira os valores especificados na tabela a seguir:

   Configuração	Valor sugerido	Descrição
   Plano de Alojamento	MyFirstAzureWebAppPlan	Nome do plano de serviço de aplicações.
   Localização	Europa Ocidental	O centro de dados onde o a aplicação Web está alojada.
   Tamanho	Escolha o nível mais baixo.	Os níveis de preços definem os recursos de hospedagem.

10. Em Nome, insira um nome de aplicativo exclusivo. Inclua apenas caracteres a-z, A-Z, 0-9e -. Você pode aceitar o nome exclusivo gerado automaticamente.

11. Selecione Criar para criar os recursos do Azure.

    

    Quando o processo é concluído, os recursos do Azure são criados para você. Você está pronto para publicar seu projeto ASP.NET Core.

12. Na caixa de diálogo Publicar, verifique se o novo aplicativo do Serviço de Aplicativo está selecionado, selecione Concluir e Fechar. O Visual Studio cria um perfil de publicação para você para o aplicativo do Serviço de Aplicativo selecionado.

13. Na página Publicar, selecione Publicar. Se vir uma mensagem de aviso, selecione Continuar.

    O Visual Studio cria, empacota e publica o aplicativo no Azure e, em seguida, inicia o aplicativo no navegador padrão.

    • .NET 10
    • .NET Framework 4.8

    Vê a aplicação web ASP.NET Core 10.0 exibida na página.

    

1. Abra o Visual Studio Code a partir do diretório raiz do seu projeto.

   code .
   

2. Se solicitado, selecione Sim, confio nos autores.

   Gorjeta

   Se você tiver uma conta do GitHub Copilot, tente obter os recursos do GitHub Copilot para o Visual Studio Code.

3. No Visual Studio Code, selecione View>Command Palette para abrir a Command Palette.

4. Procure e selecione Serviço de Aplicativo do Azure: Criar Novo Aplicativo Web (Avançado).

5. Responda às solicitações da seguinte maneira:

   1. Se solicitado, entre na sua conta do Azure.
   2. Selecione a sua Subscrição.
   3. Selecione uma localização próxima de si.
   4. Selecione Proteger nome de host padrão exclusivo.
   5. Selecione Criar novo grupo de recursos e forneça um nome como myResourceGroup.
   6. Introduza um nome para a nova aplicação web.
   7. Quando solicitado a selecionar um stack de runtime, selecione .NET 10 (LTS).
   8. Selecione um sistema operacional (Windows ou Linux).
   9. Selecione Criar novo plano do Serviço de Aplicativo, forneça um nome e selecione o nível de preço Gratuito (F1).
   10. Para o recurso do Application Insights, selecione Ignorar por enquanto.

   Espere que o Visual Studio termine de criar os recursos do Azure.

6. No Visual Studio Code, selecione novamente Ver>Paleta de Comandos .

7. Procure e selecione Serviço de Aplicativo do Azure: Implantar na Aplicação Web.

   1. Selecione MyFirstAzureWebApp como a pasta a ser implantada.
   2. Selecione Adicionar configuração quando solicitado.
   3. Selecione a sua Subscrição.
   4. Selecione a sua aplicação web.
   5. Quando solicitado, selecione Implantar.

8. Na caixa de diálogo Sempre implantar o espaço de trabalho "MyFirstAzureWebApp" no <nome> do aplicativo", selecione Sim para que o Visual Studio Code seja implantado no mesmo aplicativo do Serviço de Aplicativo sempre que você estiver nesse espaço de trabalho.

9. Quando a publicação for concluída, selecione Navegar pelo site na notificação.

   Vês a aplicação web Blazor exibida na página.

   

1. Entre em sua conta do Azure usando o comando az login e seguindo o prompt:

   az login
   

   • Se o az comando não for reconhecido, certifique-se de ter a CLI do Azure instalada conforme descrito em Pré-requisitos.

2. Use az webapp up para implantar o código em seu diretório local MyFirstAzureWebApp :

   az webapp up --sku F1 --name <app-name> --os-type <os>
   

   • Substitua <app-name> por um nome exclusivo em todo o Azure. Os carateres válidos são a-z, 0-9 e -. Um bom padrão é usar uma combinação do nome da sua empresa e um identificador de aplicativo.
   • O --sku F1 argumento cria o aplicativo Web no nível de preço gratuito. Omita este argumento para usar um nível premium mais rápido, que acarreta um custo por hora.
   • Substitua <os> por linux ou windows.
   • Opcionalmente, você pode incluir o argumento --location <location-name> onde <location-name> é uma região do Azure disponível. Para obter uma lista de regiões permitidas para sua conta do Azure, execute o comando az account list-locations .

   O comando pode levar alguns minutos para ser concluído. À medida que é executado, o comando fornece mensagens sobre como criar o grupo de recursos, o plano do App Service e a aplicação de alojamento, configurar o registo de logs e depois executar a implementação ZIP. Em seguida, mostra uma mensagem com o URL do aplicativo.

3. Abra um navegador da Web e navegue até o URL. Vê a aplicação web ASP.NET Core 10.0 exibida na página.

   

1. Entre em sua conta do Azure usando o comando Connect-AzAccount e seguindo o prompt:

   Connect-AzAccount
   

2. Crie um novo aplicativo usando o comando New-AzWebApp :

   New-AzWebApp -ResourceGroupName myResourceGroup -Name <app-name> -Location westeurope
   

   • Substitua <app-name> por um nome exclusivo em todo o Azure. Os caracteres válidos são a-z, 0-9e - Uma combinação do nome da sua empresa e um identificador de aplicativo é um bom padrão.
   • Opcionalmente, você pode incluir o parâmetro -Location <location-name> onde <location-name> é uma região do Azure disponível. Para obter uma lista de regiões permitidas para sua conta do Azure, execute o comando Get-AzLocation .

   O comando pode levar alguns minutos para ser concluído. O comando cria um grupo de recursos, um plano do Serviço de Aplicativo e o recurso do Serviço de Aplicativo.

3. Na pasta raiz do aplicativo, execute o comando dotnet publish para preparar seu aplicativo MyFirstAzureWebApp local para implantação:

   dotnet publish --configuration Release
   

4. Mude para o diretório de liberação e crie um arquivo zip a partir do conteúdo:

   cd bin\Release\net10.0\publish
   Compress-Archive -Path * -DestinationPath deploy.zip
   

5. Publique o arquivo zip no aplicativo do Azure usando o comando Publish-AzWebApp :

   Publish-AzWebApp -ResourceGroupName myResourceGroup -Name <app-name> -ArchivePath (Get-Item .\deploy.zip).FullName -Force
   

   Nota

   -ArchivePath precisa do caminho completo do arquivo zip.

6. Abra um navegador da Web e navegue até o URL. Vês a aplicação web Blazor exibida na página.

   

1. No portal Azure, escreva serviços de aplicação na pesquisa. Em Serviços, selecione Serviços de Aplicativo.

   

2. Na página Serviços de Aplicativo , selecione Criar>Aplicativo Web.

3. Na guia Noções básicas:

   • .NET 10
   • .NET Framework 4.8

   • Em Grupo de recursos, selecione Criar novo. Digite myResourceGroup para o nome.
   • Em Nome, insira um nome globalmente exclusivo para seu aplicativo Web.
   • Em Publicar, selecione Código.
   • Em Pilha de tempo de execução, selecione .NET 8 (LTS).
   • Em Sistema Operacional, selecione Windows. Se selecionar Linux, não poderá configurar a implementação do GitHub na próxima etapa, mas ainda poderá fazê-lo depois de criar a aplicação na página Centro de Implementação.
   • Selecione uma região a partir da qual pretende servir a sua aplicação.
   • Em Plano do Serviço de Aplicativo, selecione Criar novo e digite myAppServicePlan para o nome.
   • Em Plano de preços, selecione F1 grátis.

   

4. Selecione o separador Implantação no topo da página

5. Em Configurações de ações do GitHub, defina Implantação contínua como Habilitar.

6. Em Detalhes das ações do GitHub, autentique-se com sua conta do GitHub e selecione as seguintes opções:

   • .NET 10
   • .NET Framework 4.8

   • Em Organização, selecione a organização onde você bifurcou o projeto de demonstração.
   • Em Repository, selecione o projeto dotnetcore-docs-hello-world .
   • Em Ramo, selecione principal.

   

7. Selecione Rever + criar na parte inferior da página.

8. Após a execução da validação, selecione Criar na parte inferior da página.

9. Após a conclusão da implantação, selecione Ir para o recurso.

   

10. Para navegar até o aplicativo criado, selecione o domínio padrão na página Visão geral . Se você vir a mensagem Seu aplicativo Web está em execução e aguardando seu conteúdo, a implantação do GitHub ainda está em execução. Aguarde alguns minutos e atualize a página.

    • .NET 10
    • .NET Framework 4.8

    

1. No Explorador de Soluções, encontre a página padrão do seu projeto e substitua o conteúdo da seguinte forma:

   • .NET 10
   • .NET Framework 4.8

   Em Components/Pages/Home.razor, substitua tudo pelo seguinte código:

   @page "/"
   
   <PageTitle>Home</PageTitle>
   
   <h1>.NET 💜 Azure</h1>
   
   Example .NET app to Azure App Service.
   

   Gorjeta

   Com o GitHub Copilot habilitado no Visual Studio, tente as seguintes etapas:

   1. Tipo Alt+/.
   2. Pergunte ao Copilot, "Mude para um cartão de Bootstrap onde está escrito .NET 💜 Azure."

   Guardar as suas alterações.

2. Para reimplantar no Azure, clique com o botão direito do mouse no projeto MyFirstAzureWebApp no Gerenciador de Soluções e selecione Publicar.

3. Na página Publicar resumo, selecione Publicar.

   Quando a publicação estiver concluída, o Visual Studio inicia um browser para o URL da aplicação Web.

   • .NET 10
   • .NET Framework 4.8

   Vê a aplicação web atualizada ASP.NET Core 10.0 exibida na página.

   

1. No seu espaço de trabalho, encontre Components/Pages/Home.razor e substitua tudo pelo seguinte código:

   @page "/"
   
   <PageTitle>Home</PageTitle>
   
   <h1>.NET 💜 Azure</h1>
   
   Example .NET app to Azure App Service.
   

   Gorjeta

   Experimente esta abordagem com o GitHub Copilot:

   1. Selecione o conteúdo e selecione .
   2. Selecione e Modifique.
   3. Inscreva "Mudar para um cartão Bootstrap que diga .NET 💜 Azure."

   Guardar as suas alterações.

2. No Visual Studio Code, selecione novamente Ver>Paleta de Comandos .

3. Procure e selecione Serviço de Aplicativo do Azure: Implantar na Aplicação Web.

4. Selecione a assinatura e o aplicativo Web que você usou anteriormente.

5. Quando solicitado, selecione Implantar.

6. Quando a publicação for concluída, selecione Navegar pelo site na notificação.

   Vê a aplicação web atualizada ASP.NET Core 10.0 exibida na página.

   

1. No diretório local, encontre Components/Pages/Home.razor e substitua tudo pelo seguinte código:

   @page "/"
   
   <PageTitle>Home</PageTitle>
   
   <h1>.NET 💜 Azure</h1>
   
   Example .NET app to Azure App Service.
   

2. Salve as alterações e, em seguida, reimplante o aplicativo usando o az webapp up comando novamente e substitua <os> por um linux ou windows.

   az webapp up --os-type <os>
   

   Este comando usa valores que são 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.

3. Após a conclusão da implantação, volte para a janela do navegador aberta na etapa Procurar até o aplicativo e atualize.

   Vê a aplicação web atualizada ASP.NET Core 10.0 exibida na página.

   

1. No diretório local, abra Components/Pages/Home.razor e substitua tudo pelo seguinte código:

   @page "/"
   
   <PageTitle>Home</PageTitle>
   
   <h1>.NET 💜 Azure</h1>
   
   Example .NET app to Azure App Service.
   

2. Na pasta raiz da aplicação, prepare a sua aplicação local MyFirstAzureWebApp para deployment usando o comando dotnet publish:

   dotnet publish --configuration Release
   

3. Mude para o diretório de liberação e crie um arquivo zip a partir do conteúdo:

   cd bin\Release\net10.0\publish
   Compress-Archive -Path * -DestinationPath deploy.zip -Force
   

4. Publique o arquivo zip no aplicativo do Azure usando o comando Publish-AzWebApp :

   Publish-AzWebApp -ResourceGroupName myResourceGroup -Name <app-name> -ArchivePath (Get-Item .\deploy.zip).FullName -Force
   

   Nota

   -ArchivePath precisa do caminho completo do arquivo zip.

5. Após a conclusão da implantação, volte para a janela do navegador aberta na etapa Procurar até o aplicativo e atualize.

   Vê a aplicação web Blazor atualizada exibida na página.

   

1. Navegue até o seu fork no GitHub do código de exemplo.

2. Na página do repositório, crie um espaço de código selecionando Code>Create codespace on main.

   • .NET 10
   • .NET Framework 4.8

   

3. No Explorador de Soluções, encontre a página padrão do seu projeto e substitua o conteúdo da seguinte forma:

   • .NET 10
   • .NET Framework 4.8

   Em Components/Pages/Home.razor, substitui tudo pelo código seguinte. As alterações são guardadas automaticamente.

   @page "/"
   
   <PageTitle>Home</PageTitle>
   
   <h1>.NET 💜 Azure</h1>
   
   Example .NET app to Azure App Service.
   

   Gorjeta

   Experimente esta abordagem com o GitHub Copilot:

   1. Selecione todo o conteúdo e selecione .
   2. Pergunte ao Copilot, "Mude para um cartão de Bootstrap onde está escrito .NET 💜 Azure."

4. No menu controlo de código-fonte, insira uma mensagem de confirmação, como Modify homepage. Em seguida, selecione Confirmar e confirme a preparação das alterações selecionando Sim.

   • .NET 10
   • .NET Framework 4.8

   

5. Selecione Sincronizar alterações 1 e, em seguida, confirme selecionando OK.

6. Demora alguns minutos para a implantação ocorrer. Para ver o progresso, navegue até https://github.com/<your-github-alias>/dotnetcore-docs-hello-world/actions.

7. Retorne à janela do navegador que foi aberta durante a etapa Procurar até o aplicativo e atualize a página.

   • .NET 10
   • .NET Framework 4.8

   Vê a aplicação web atualizada ASP.NET Core 10.0 exibida na página.

   

Limpar recursos

Nos passos anteriores, criou os recursos do Azure num grupo de recursos. Se provavelmente não necessitar desses recursos no futuro, pode eliminá-los ao eliminar o grupo de recursos.

1. Na página Descrição geral da sua aplicação Web no portal do Azure, selecione a ligação myResourceGroup em Grupo de recursos.
2. Na página do grupo de recursos, confirme que os recursos apresentados são aqueles que pretende eliminar.
3. Selecione Excluir grupo de recursos, digite myResourceGroup na caixa de texto e selecione Excluir.
4. Confirme novamente selecionando Excluir.

Limpar recursos

Nos passos anteriores, criou os recursos do Azure num grupo de recursos. Se provavelmente não necessitar desses recursos no futuro, pode eliminá-los ao eliminar o grupo de recursos.

1. Na página Descrição geral da sua aplicação Web no portal do Azure, selecione a ligação myResourceGroup em Grupo de recursos.
2. Na página do grupo de recursos, confirme que os recursos apresentados são aqueles que pretende eliminar.
3. Selecione Excluir grupo de recursos, digite myResourceGroup na caixa de texto e selecione Excluir.
4. Confirme novamente selecionando Excluir.

Nos passos anteriores, criou os recursos do Azure num grupo de recursos. Se achar que não vai precisar destes recursos no futuro, execute o seguinte comando no Cloud Shell para eliminar o grupo de recursos:

az group delete

Para sua conveniência, o comando az webapp up que você executou anteriormente neste projeto salva o nome do grupo de recursos como o valor padrão sempre que você executa az comandos deste projeto.

Limpar recursos

Nos passos anteriores, criou os recursos do Azure num grupo de recursos. Se você não espera precisar desses recursos no futuro, exclua o grupo de recursos executando o seguinte comando do PowerShell:

Remove-AzResourceGroup -Name myResourceGroup

Este comando pode demorar um pouco a ser executado.

Limpar recursos

Nos passos anteriores, criou os recursos do Azure num grupo de recursos. Se provavelmente não necessitar desses recursos no futuro, pode eliminá-los ao eliminar o grupo de recursos.

1. Na página Descrição geral da sua aplicação Web no portal do Azure, selecione a ligação myResourceGroup em Grupo de recursos.
2. Na página do grupo de recursos, confirme que os recursos apresentados são aqueles que pretende eliminar.
3. Selecione Excluir grupo de recursos, digite myResourceGroup na caixa de texto e selecione Excluir.
4. Confirme novamente selecionando Excluir.