Início Rápido: Implantar um aplicativo Web ASP.NET
Neste guia de início rápido, você aprenderá a criar e implantar seu primeiro aplicativo Web ASP.NET no Serviço de Aplicativo do Azure. O Serviço de Aplicativo dá suporte a várias versões de aplicativos .NET e fornece um serviço de hospedagem na Web altamente escalonável e com aplicação de patch automática. Os aplicativos Web ASP.NET são multiplataforma e podem ser hospedados no Linux ou no Windows. 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.
Como alternativa, você pode implantar um aplicativo Web ASP.NET como parte de um contêiner do Windows ou Linux no Serviço de Aplicativo.
Este vídeo mostra como implantar um aplicativo Web de ASP.NET.
As etapas no vídeo também são descritas nas seções a seguir.
Pré-requisitos
- Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.
- Visual Studio 2022 com a carga de trabalho de desenvolvimento Web e do ASP.NET.
Se você já instalou o Visual Studio 2022:
- Instale as atualizações mais recentes no Visual Studio selecionando Ajuda>Verificar Atualizações.
- Adicione a carga de trabalho selecionando Ferramentas>Obter Ferramentas e Recursos.
- Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.
- Visual Studio Code.
- A extensão de Ferramentas do Azure.
- O SDK mais recente do .NET 7.0.
- Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.
- O CLI do Azure.
- O SDK mais recente do .NET 7.0.
- Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.
- O Azure PowerShell.
- O SDK mais recente do .NET 7.0.
- Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.
- Uma conta do GitHub Criar uma conta gratuitamente.
- Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.
- A Azure Developer CLI
- O SDK mais recente do .NET 7.0.
1. Criar um aplicativo Web ASP.NET
1. Inicializar o modelo de aplicativo Web ASP.NET
Abra o Visual Studio e selecione Criar novo projeto.
Em Criar um novo projeto, localize e selecione Aplicativo Web ASP.NET Core e selecione Avançar.
Em Configurar seu novo projeto, dê ao aplicativo o nome MyFirstAzureWebApp e selecione, Avançar.
Selecione .NET 7.0 (suporte de prazo padrão).
Garanta que o Tipo de Autenticação está definido como Nenhum. Selecione Criar.
No menu do Visual Studio, selecione Depurar>Iniciar sem Depuração para executar o aplicativo Web localmente. Se você vir uma mensagem solicitando que confie em um certificado autoassinado, selecione Sim.
Abra uma janela do terminal em seu computador para um diretório de trabalho. Crie um aplicativo Web .NET usando o comando
dotnet new webapp
e altere os diretórios para o aplicativo recém-criado.dotnet new webapp -n MyFirstAzureWebApp --framework net7.0 cd MyFirstAzureWebApp
Na mesma sessão do terminal, execute o aplicativo localmente usando o comando
dotnet run
.dotnet run --urls=https://localhost:5001/
Abra um navegador da Web e navegue até o aplicativo em
https://localhost:5001
.Você verá o modelo do aplicativo Web ASP.NET Core 7.0 exibido na página.
Nesta etapa, você criará um fork de um projeto de demonstração para ser implantado.
- Acesse o aplicativo de exemplo .NET 7.0.
- Selecione o botão Fork no canto superior direito na página do GitHub.
- Selecione o Proprietário e deixe o nome padrão do Repositório.
- Selecione Criar fork.
Este início rápido usa a Azure Developer CLI (azd
) para criar recursos do Azure e implantar código nele. Para obter mais informações sobre a Azure Developer CLI, visite a documentação ou o caminho de treinamento.
Recupere e inicialize o modelo de aplicativo Web ASP.NET Core para este início rápido usando as seguintes etapas:
Abra uma janela do terminal em seu computador para um diretório de trabalho vazio. Inicialize o modelo
azd
usando o comandoazd init
.azd init --template https://github.com/Azure-Samples/quickstart-deploy-aspnet-core-app-service.git
Quando for solicitado um nome de ambiente, digite
dev
.Na mesma sessão do terminal, execute o aplicativo localmente usando o comando
dotnet run
. Use o parâmetro--project
para especificar o diretóriosrc
do modeloazd
, que é onde reside o código do aplicativo.dotnet run --project src --urls=https://localhost:5001/
Abra um navegador da Web e navegue até o aplicativo em
https://localhost:5001
. O modelo de aplicativo Web ASP.NET Core 7.0 é exibido na página.
2. Publicar seu aplicativo Web
O modelo do AZD contém arquivos que gerarão os seguintes recursos necessários para que seu aplicativo seja executado no Serviço de Aplicativo:
- Um novo grupo de recursos para conter todos os recursos do Azure para o serviço.
- Um novo plano do Serviço de Aplicativo especifica o local, tamanho e recursos do farm de servidores Web que hospeda o aplicativo.
- Uma nova instância do Serviço de Aplicativo para executar o aplicativo implantado.
Siga estas etapas para criar seus recursos do Serviço de Aplicativo e publicar o projeto:
No Gerenciador de Soluções, clique com o botão direito do mouse no projeto MyFirstAzureWebApp e selecione Publicar.
Em Publicar, selecione Azure e Avançar.
Escolha o Destino específico: Serviço de Aplicativo do Azure (Linux) ou Serviço de Aplicativo do Azure (Windows) . Em seguida, selecione Avançar.
Importante
Ao direcionar o ASP.NET Framework 4.8, você usará o Serviço de Aplicativo do Azure (Windows) .
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. Selecione Adicionar uma conta ou Entrar para entrar em sua assinatura do Azure. Se você já estiver conectado, selecione a conta que deseja.
À direita das instâncias do Serviço de Aplicativo, selecione +.
Em Assinatura, aceite a assinatura que está listada ou selecione uma nova na lista suspensa.
Para Grupo de recursos, selecione Novo. Em Nome do novo grupo de recursos, insira myResourceGroup e selecione OK.
Em Plano de Hospedagem, selecione Novo.
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 hospedagem MyFirstAzureWebAppPlan O nome do plano do Serviço de Aplicativo. Localidade Oeste da Europa O datacenter onde o aplicativo Web está hospedado. Tamanho Gratuito O Tipo de preço determina os recursos de hospedagem. Em Nome, insira um nome de aplicativo exclusivo que inclua somente os caracteres válidos
a-z
,A-Z
,0-9
e-
. Você pode aceitar o nome exclusivo gerado automaticamente. A URL do aplicativo Web éhttp://<app-name>.azurewebsites.net
, em que<app-name>
é o nome do aplicativo.Selecione Criar para criar os recursos do Azure.
Quando o assistente for concluído, os recursos do Azure serão criados para você e você estará pronto para publicar o projeto do ASP.NET Core.
Na caixa de diálogo Publicar, verifique se o novo aplicativo do Serviço de Aplicativo está selecionado, selecione Concluir e, em seguida, Fechar. O Visual Studio cria um perfil de publicação para você para o aplicativo do Serviço de Aplicativo selecionado.
Na página de Publicação, selecione Publicar. Se você vir uma mensagem de aviso, selecione Continuar.
O Visual Studio compila, empacota e publica o aplicativo no Azure e, em seguida, inicia o aplicativo no navegador padrão.
Você verá o aplicativo Web ASP.NET Core 7.0 exibido na página.
No Visual Studio Code, abra a Paleta de Comandos selecionando Exibir>Paleta de Comandos.
Pesquise e selecione “Serviço de Aplicativo do Azure: Criar Novo Aplicativo Web (Avançado)”.
Responda aos prompts da seguinte maneira:
- Se solicitado, entre em sua conta do Azure.
- Selecione sua Assinatura.
- Selecione Criar Aplicativo Web... Avançado.
- Para Inserir um nome globalmente exclusivo, use um nome que seja exclusivo em todo o Azure (os caracteres válidos são
a-z
,0-9
e-
). Um bom padrão é usar uma combinação do nome da empresa e um identificador de aplicativo. - Selecione Criar grupo de recursos e forneça um nome como
myResourceGroup
. - Quando solicitado a Selecionar uma pilha de runtime, selecione .NET 7 (STS).
- Selecione um sistema operacional (Windows ou Linux).
- Selecione uma localização próxima de você.
- Selecione Criar um plano do Serviço de Aplicativo, forneça um nome e escolha o tipo de preçoF1 Gratuito.
- Selecione Ignorar por enquanto para o recurso do Application Insights.
- Quando solicitado, clique em Implantar.
- Selecione MyFirstAzureWebApp como a pasta a ser implantada.
- Selecione Adicionar Configuração quando solicitado.
No pop-up Sempre implante o espaço de trabalho "MyFirstAzureWebApp" para <app-name>", selecione Sim para que o Visual Studio Code seja implantado no mesmo aplicativo do Serviço de Aplicativo sempre você está nesse espaço de trabalho.
Quando a publicação for concluída, selecione Procurar Site na notificação e selecione Abrir quando solicitado.
Você verá o aplicativo Web ASP.NET Core 7.0 exibido na página.
Entre em sua conta do Azure usando o comando
az login
e seguindo o prompt:az login
- Se o comando
az
não for reconhecido, garanta que você tenha a CLI do Azure instalada conforme descrito em Pré-requisitos.
- Se o comando
Implante o código no seu diretório MyFirstAzureWebApp local usando o comando
az webapp up
:az webapp up --sku F1 --name <app-name> --os-type <os>
- Substitua
<app-name>
por um nome que seja exclusivo em todo o Azure (os caracteres válidos sãoa-z
,0-9
e-
). Um bom padrão é usar uma combinação do nome da empresa e um identificador de aplicativo. - O argumento
--sku F1
cria o aplicativo Web no tipo de preçoGratuito. Omita esse argumento para usar um nível Premium mais rápido, o que incorre em um custo por hora. - Substitua
<os>
porlinux
ouwindows
. - Opcionalmente, você pode incluir o argumento
--location <location-name>
, em que<location-name>
é uma região do Azure disponível. Você pode recuperar uma lista de regiões permitidas para sua conta do Azure executando o comandoaz account list-locations
.
O comando pode levar alguns minutos para ser concluído. Durante a execução, o comando 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. Em seguida, ele mostra uma mensagem com a URL do aplicativo:
You can launch the app at http://<app-name>.azurewebsites.net
- Substitua
Abra um navegador da Web e navegue até a URL:
Você verá o aplicativo Web ASP.NET Core 7.0 exibido na página.
Observação
O Azure PowerShell é recomendado para criar aplicativos na plataforma de hospedagem do Windows. Para criar aplicativos no Linux, use uma ferramenta diferente, como a CLI do Azure.
Entre em sua conta do Azure usando o comando
Connect-AzAccount
e seguindo o prompt:Connect-AzAccount
Crie um novo aplicativo usando o comando New-AzWebApp:
New-AzWebApp -Name <app-name> -Location westeurope
- Substitua
<app-name>
por um nome que seja exclusivo em todo o Azure (os caracteres válidos sãoa-z
,0-9
e-
). Uma combinação do nome da empresa e um identificador de aplicativo é um bom padrão. - Opcionalmente, você pode incluir o parâmetro
-Location <location-name>
, em que<location-name>
é uma região do Azure disponível. Você pode recuperar uma lista de regiões permitidas para sua conta do Azure executando o comandoGet-AzLocation
.
O comando pode levar alguns minutos para ser concluído. Durante a execução, o comando cria um grupo de recursos, um plano do Serviço de Aplicativo e o recurso do Serviço de Aplicativo.
- Substitua
Na pasta raiz do aplicativo, prepare seu aplicativo MyFirstAzureWebApp local para implantação usando o comando
dotnet publish
:dotnet publish --configuration Release
Altere para o diretório de liberação e crie um arquivo zip com base no conteúdo:
cd bin\Release\net7.0\publish Compress-Archive -Path * -DestinationPath deploy.zip
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
Observação
-ArchivePath
precisa do caminho completo do arquivo zip.Abra um navegador da Web e navegue até a URL:
Você verá o aplicativo Web ASP.NET Core 7.0 exibido na página.
Digite serviços de aplicativos na pesquisa. Em Serviços, selecione Serviços de Aplicativos.
Na página Serviços de Aplicativos, selecione + Criar.
Na guia Básico:
- Em Grupo de recursos, selecione Criar. Digite myResourceGroup para o nome.
- Em Nome: digite um nome globalmente exclusivo para seu aplicativo Web.
- Em Publicar, selecione Código.
- Na Pilha de runtime, selecione .NET 7 (STS).
- Selecione Sistema operacional e uma Região da qual você deseja atender o aplicativo.
- Em Plano do Serviço de Aplicativo, selecione Criar novo e nomeie-o como myAppServicePlan.
- Em Plano de preços, selecione F1 gratuito.
Selecione a guia Implantação na parte superior da página.
Em Configurações do GitHub Actions, defina Implantação contínua, para Habilitar.
Em detalhes do GitHub Actions, faça a autenticação com sua conta do GitHub e selecione as seguintes opções:
- Em Organização, selecione a organização na qual você criou o fork do projeto de demonstração.
- EmRepositório, selecione o projeto dotnetcore-docs-hello-world.
- Em Branch, selecione master.
Observação
Por padrão, o assistente de criação desabilita a autenticação básica e a implantação do GitHub Actions é criada usando uma identidade atribuída pelo usuário. Se você receber um erro de permissões durante a criação de recursos, sua conta do Azure poderá não ter permissões suficientes. Você pode configurar a implantação do GitHub Actions mais tarde com uma identidade gerada por um administrador do Azure ou também habilitar a autenticação básica em vez disso.
Selecione o botão Examinar + criar na parte inferior da página.
Após a execução da validação, selecione o botão Criar na parte inferior da página.
Após a conclusão da implantação, selecione Ir para o recurso.
Navegue até o aplicativo implantado no navegador da Web na URL
http://<app-name>.azurewebsites.net
.
Entre em sua conta do Azure usando o comando az login e seguindo o prompt:
azd auth login
Crie os recursos do Azure e implante seu aplicativo usando o comando
azd up
:azd up
O comando
azd up
pode levar alguns minutos para ser concluído.azd up
usa os arquivos Bicep em seus projetos para criar o grupo de recursos, o Plano do Serviço de Aplicativo e o aplicativo de hospedagem. Ele também executa determinadas configurações, como habilitar o registro em log e implantar o código do aplicativo compilado. Durante a execução, o comando fornece mensagens sobre o processo de provisionamento e implantação, incluindo um link para a implantação no Azure. Quando ele é concluído, o comando também exibe um link para o aplicativo de implantação.Abra um navegador da Web e navegue até a URL:
Você verá o aplicativo Web ASP.NET Core 7.0 exibido na página.
3. Atualizar o aplicativo e reimplantar
Siga estas etapas para atualizar e reimplantar seu aplicativo Web:
No Gerenciador de Soluções, no seu projeto, abra Index.cshtml.
Substitua o primeiro elemento
<div>
pelo seguinte código:<div class="jumbotron"> <h1>.NET 💜 Azure</h1> <p class="lead">Example .NET app to Azure App Service.</p> </div>
Salve suas alterações.
Para implantar novamente no Azure, clique com o botão direito do mouse no projeto MyFirstAzureWebApp no Gerenciador de Soluções e selecione Publicar.
Na página de resumo Publicar, selecione Publicar.
Quando a publicação está concluída, o Visual Studio inicia um navegador para a URL do aplicativo Web.
Você verá o aplicativo Web ASP.NET Core 7.0 atualizado exibido na página.
Abra index.cshtml.
Substitua o primeiro elemento
<div>
pelo seguinte código:<div class="jumbotron"> <h1>.NET 💜 Azure</h1> <p class="lead">Example .NET app to Azure App Service.</p> </div>
Salve suas alterações.
No Visual Studio Code, abra a Paleta de Comandos, Ctrl+Shift+P.
Pesquise e selecione "Serviço de Aplicativo do Azure: Implantar no aplicativo Web".
Selecione Implantar quando solicitado.
Quando a publicação for concluída, selecione Procurar Site na notificação e selecione Abrir quando solicitado.
Você verá o aplicativo Web ASP.NET Core 7.0 atualizado exibido na página.
No diretório local, abra o arquivo Index.cshtml. Substitua o primeiro elemento <div>
:
<div class="jumbotron">
<h1>.NET 💜 Azure</h1>
<p class="lead">Example .NET app to Azure App Service.</p>
</div>
Salve suas alterações e reimplante o aplicativo usando o comando az webapp up
novamente:
O ASP.NET Core 7.0 é multiplataforma. Com base em sua implantação anterior, substitua <os>
por linux
ou windows
.
az webapp up --os-type <os>
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.
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.
Você verá o aplicativo Web ASP.NET Core 7.0 atualizado exibido na página.
No diretório local, abra o arquivo Index.cshtml. Substitua o primeiro elemento
<div>
:<div class="jumbotron"> <h1>.NET 💜 Azure</h1> <p class="lead">Example .NET app to Azure App Service.</p> </div>
Na pasta raiz do aplicativo, prepare seu aplicativo MyFirstAzureWebApp local para implantação usando o comando
dotnet publish
:dotnet publish --configuration Release
Altere para o diretório de liberação e crie um arquivo zip com base no conteúdo:
cd bin\Release\net7.0\publish Compress-Archive -Path * -DestinationPath deploy.zip
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
Observação
-ArchivePath
precisa do caminho completo do arquivo zip.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.
Você verá o aplicativo Web ASP.NET Core 7.0 atualizado exibido na página.
Navegue até o fork do GitHub do código de exemplo.
Em sua página de repositório, pressione
.
para iniciar o Visual Studio Code no navegador.Observação
A URL mudará de GitHub.com para GitHub.dev. Esse recurso só funciona com repositórios que têm arquivos. Isso não funciona em repositórios vazios.
Abra index.cshtml.
Index.cshtml está localizado na pasta
Pages
.Substitua o primeiro elemento
<div>
pelo seguinte código:<div class="jumbotron"> <h1>.NET 💜 Azure</h1> <p class="lead">Example .NET app to Azure App Service.</p> </div>
Salve suas alterações.
No menu Controle do Código-Fonte, selecione o botão Preparar Alterações para preparar a alteração.
Escreva uma mensagem de confirmação, tal como
We love Azure
. Em seguida, selecione Confirmar e Efetuar Push.Depois que a implantação for concluída, retorne para a janela do navegador que foi aberta durante a etapa Navegar até o aplicativo e atualize a página.
Você verá o aplicativo Web ASP.NET Core 7.0 atualizado exibido na página.
No diretório local, abra o arquivo Index.cshtml. Substitua o primeiro elemento <div>
:
<div class="jumbotron">
<h1>.NET 💜 Azure</h1>
<p class="lead">Example .NET app to Azure App Service.</p>
</div>
Salve suas alterações e reimplante o aplicativo usando o comando azd up
novamente:
azd up
azd up
ignorará a etapa de recursos de provisionamento desta vez e reimplantará seu código, pois não houve alterações nos arquivos Bicep.
Depois que a implantação for concluída, o navegador será aberto para o aplicativo Web ASP.NET Core 7.0 atualizado.
4. Gerenciar o aplicativo do Azure
Para gerenciar o aplicativo Web, acesse o portal do Azure e procure e selecione Serviços de Aplicativos.
Na página Serviços de Aplicativos, selecione o nome do seu aplicativo Web.
A página Visão Geral do aplicativo Web contém opções para gerenciamento básico, como procurar, parar, iniciar, reiniciar e excluir. O menu à esquerda fornece páginas adicionais para configurar o aplicativo.
Limpar os recursos
Nas etapas anteriores, você criou os recursos do Azure em um grupo de recursos. Se você não espera precisar desses recursos no futuro, poderá excluí-los ao excluir o grupo de recursos.
- Na página Visão geral do seu aplicativo Web no portal do Azure, selecione o link myResourceGroup em Grupo de recursos.
- Na página do grupo de recursos, certifique-se de que os recursos listados são aqueles que deseja excluir.
- Selecione Excluir, digite myResourceGroup na caixa de texto e selecione Excluir.
Limpar os recursos
Nas etapas anteriores, você criou os recursos do Azure em um grupo de recursos. Se você não espera precisar desses recursos no futuro, poderá excluí-los ao excluir o grupo de recursos.
- Na página Visão geral do seu aplicativo Web no portal do Azure, selecione o link myResourceGroup em Grupo de recursos.
- Na página do grupo de recursos, certifique-se de que os recursos listados são aqueles que deseja excluir.
- Selecione Excluir, digite myResourceGroup na caixa de texto e selecione Excluir.
Limpar os recursos
Nas etapas anteriores, você criou os recursos do Azure em um grupo de recursos. Se você acha que não precisará desses recursos no futuro, exclua o grupo de recursos executando o seguinte comando no Cloud Shell:
az group delete --name myResourceGroup
Esse comando pode demorar um pouco para ser executado.
Limpar os recursos
Nas etapas anteriores, você criou os recursos do Azure em um grupo de recursos. Se você achar que não precisará desses recursos no futuro, exclua o grupo de recursos executando o seguinte comando do PowerShell:
Remove-AzResourceGroup -Name myResourceGroup
Esse comando pode demorar um pouco para ser executado.
Limpar os recursos
Nas etapas anteriores, você criou os recursos do Azure em um grupo de recursos. Se você não espera precisar desses recursos no futuro, poderá excluí-los ao excluir o grupo de recursos.
- Na página Visão geral do seu aplicativo Web no portal do Azure, selecione o link myResourceGroup em Grupo de recursos.
- Na página do grupo de recursos, certifique-se de que os recursos listados são aqueles que deseja excluir.
- Selecione Excluir, digite myResourceGroup na caixa de texto e selecione Excluir.
Limpar os recursos
Use o comando azd down
para remover o grupo de recursos e todos os recursos associados a ele:
azd down
Visite a documentação da Azure Developer CLI para ver as próximas etapas sobre como trabalhar com modelos azd
e recursos adicionais.
Próximas etapas
Avance para o próximo artigo para saber como criar um aplicativo .NET Core e conectá-lo a um Banco de Dados SQL: