Guia de início rápido: implantar um aplicativo Web ASP.NET
Neste 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 oferece suporte a várias versões de aplicativos .NET e fornece um serviço de hospedagem na Web altamente escalável e auto-corrigido. ASP.NET aplicações Web são multiplataforma e podem ser alojadas em Linux ou Windows. Quando terminar, você terá um grupo de recursos do Azure que consiste 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 Windows ou Linux no Serviço de Aplicativo.
Este vídeo mostra como implantar um aplicativo Web 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 subscrição ativa. Crie uma conta gratuitamente.
- Visual Studio 2022 com a carga de trabalho de desenvolvimento ASP.NET e web.
Se você já tiver instalado 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 subscrição ativa. Crie uma conta gratuitamente.
- Visual Studio Code.
- A extensão Ferramentas do Azure.
- O SDK mais recente do .NET 7.0.
- Uma conta do Azure com uma subscrição ativa. Crie uma conta gratuitamente.
- CLI do Azure.
- O SDK mais recente do .NET 7.0.
- Uma conta do Azure com uma subscrição ativa. Crie uma conta gratuitamente.
- O Azure PowerShell.
- O SDK mais recente do .NET 7.0.
- Uma conta do Azure com uma subscrição ativa. Crie uma conta gratuitamente.
- Uma conta no GitHub Crie uma conta gratuitamente.
- Uma conta do Azure com uma subscrição ativa. Crie uma conta gratuitamente.
- A CLI do desenvolvedor do Azure
- O SDK mais recente do .NET 7.0.
1. Criar um aplicativo Web ASP.NET
1. Inicialize o modelo de aplicativo Web ASP.NET
Abra o Visual Studio e selecione Criar um novo projeto.
Em Criar um novo projeto, localize e selecione ASP.NET Core Web App e, em seguida, selecione Avançar.
Em Configurar seu novo projeto, nomeie o aplicativo MyFirstAzureWebApp e selecione Avançar.
Selecione .NET 7.0 (Suporte de prazo padrão).
Verifique se Tipo de autenticação está definido como Nenhum. Selecione Criar.
No menu Visual Studio, selecione Depurar>Iniciar Sem Depuração para executar o aplicativo Web localmente. Se vir uma mensagem a pedir-lhe para confiar num certificado autoassinado, selecione Sim.
Abra uma janela de terminal na sua máquina para um diretório de trabalho. Crie um novo aplicativo Web .NET usando o comando e altere os diretórios para o
dotnet new webapp
aplicativo recém-criado.dotnet new webapp -n MyFirstAzureWebApp --framework net7.0 cd MyFirstAzureWebApp
Na mesma sessão de terminal, execute o aplicativo localmente usando o
dotnet run
comando.dotnet run --urls=https://localhost:5001/
Abra um browser e navegue para a aplicação em
https://localhost:5001
.Você vê o modelo ASP.NET aplicativo Web Core 7.0 exibido na página.
Nesta etapa, você bifurca um projeto de demonstração para implantar.
- Vá para o aplicativo de exemplo .NET 7.0.
- Selecione o botão Fork no canto superior direito da página do GitHub.
- Selecione o Proprietário e deixe o nome padrão do repositório.
- Selecione Criar bifurcação.
Este guia de início rápido usa a CLI do Desenvolvedor do Azure (azd
) para criar recursos do Azure e implantar código nele. Para obter mais informações sobre a CLI do Azure Developer, 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 de terminal na sua máquina para um diretório de trabalho vazio. Inicialize o modelo usando o
azd
azd init
comando.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 de terminal, execute o aplicativo localmente usando o
dotnet run
comando. Use o parâmetro para especificar osrc
azd
diretório do modelo, que é onde o--project
código do aplicativo vive.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. Publique seu aplicativo Web
O modelo 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 que especifica o local, o tamanho e os recursos do farm de servidores Web que hospeda seu aplicativo.
- Uma nova instância do aplicativo Serviço de Aplicativo para executar o aplicativo implantado.
Siga estas etapas para criar seus recursos do Serviço de Aplicativo e publicar seu 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, em seguida, 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 Seguinte.
Importante
Ao direcionar ASP.NET Framework 4.8, use o Serviço de Aplicativo do Azure (Windows).
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.
À direita das instâncias do Serviço de Aplicativo, selecione +.
Para Assinatura, aceite a assinatura listada ou selecione uma nova na lista suspensa.
Para Grupo de recursos, selecione Novo. Em Novo nome do grupo de recursos, digite myResourceGroup e selecione OK.
Para Plano de hospedagem, selecione Novo.
Na caixa de diálogo Plano de hospedagem: Criar novo, insira os valores especificados na tabela a seguir:
Definição Valor sugerido Description 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 Gratuito O escalão de preço determina as funcionalidades do alojamento. Em Nome, insira um nome de aplicativo exclusivo que inclua apenas os caracteres válidos são
a-z
, ,A-Z
0-9
e-
. Você pode aceitar o nome exclusivo gerado automaticamente. O URL da aplicação Web éhttp://<app-name>.azurewebsites.net
, em que<app-name>
é o nome da aplicação.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 seu projeto ASP.NET Core.
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.
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.
Você vê 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.
Procure e selecione "Serviço de Aplicativo do Azure: Criar Novo Aplicativo Web (Avançado)".
Responda às solicitações da seguinte maneira:
- Se solicitado, entre na sua conta do Azure.
- Selecione a sua Subscrição.
- Selecione Criar novo aplicativo Web... Avançado.
- Para Insira um nome globalmente exclusivo, use um nome exclusivo em todo o Azure (caracteres 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. - Selecione Criar novo grupo de recursos e forneça um nome como
myResourceGroup
. - Quando solicitado a Selecionar uma pilha de tempo de execução, selecione .NET 7 (STS).
- Selecione um sistema operacional (Windows ou Linux).
- Selecione uma localização próxima de si.
- Selecione Criar um novo plano do Serviço de Aplicativo, forneça um nome e selecione o nível de preço F1 Free.
- 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 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.
Quando a publicação for concluída, selecione Procurar site na notificação e selecione Abrir quando solicitado.
Você vê o aplicativo Web ASP.NET Core 7.0 exibido na página.
Entre em sua conta do Azure usando o comando e seguindo o
az login
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.
- Se o
Implante o código em seu diretório local MyFirstAzureWebApp usando o
az webapp up
comando:az webapp up --sku F1 --name <app-name> --os-type <os>
- Substitua
<app-name>
por um nome exclusivo em todo o Azure (caracteres válidos sãoa-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 esse argumento para usar um nível premium mais rápido, que incorre em um custo por hora. - Substitua
<os>
por um oulinux
windows
. - Opcionalmente, você pode incluir o argumento
--location <location-name>
onde<location-name>
é uma região do Azure disponível. Você pode recuperar uma lista de regiões permitidas para sua conta do Azure executando oaz account list-locations
comando.
O comando pode levar alguns minutos para ser concluído. Enquanto está em 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 do ZIP. Em seguida, mostra uma mensagem com o URL do aplicativo:
You can launch the app at http://<app-name>.azurewebsites.net
- Substitua
Abra um navegador da Web e navegue até o URL:
Você vê o aplicativo Web ASP.NET Core 7.0 exibido na página.
Nota
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 e seguindo o
Connect-AzAccount
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 exclusivo em todo o Azure (caracteres válidos sãoa-z
,0-9
e-
). 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. Você pode recuperar uma lista de regiões permitidas para sua conta do Azure executando oGet-AzLocation
comando.
O comando pode levar alguns minutos para ser concluído. Enquanto está em 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
dotnet publish
comando:dotnet publish --configuration Release
Mude para o diretório de liberação e crie um arquivo zip a partir do 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
Nota
-ArchivePath
precisa do caminho completo do arquivo zip.Abra um navegador da Web e navegue até o URL:
Você vê o aplicativo Web ASP.NET Core 7.0 exibido na página.
Digite serviços de aplicativo na pesquisa. Em Serviços, selecione Serviços de Aplicativo.
Na página Serviços de Aplicativo, selecione + Criar.
Na guia Noções básicas:
- Em Grupo de recursos, selecione Criar novo. Digite myResourceGroup para o nome.
- Em Nome, digite um nome globalmente exclusivo para seu aplicativo Web.
- Em Publicar, selecione Código.
- Em Pilha de tempo de execução, selecione .NET 7 (STS).
- Selecione um Sistema Operativo e 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.
Selecione a guia Implantação na parte superior da página
Em Configurações de ações do GitHub, defina Implantação contínua como Habilitar.
Em Detalhes das ações do GitHub, autentique-se com sua conta do GitHub e selecione as seguintes opções:
- Em Organização , selecione a organização onde você bifurcou o projeto de demonstração.
- Para Repository , selecione o projeto dotnetcore-docs-hello-world .
- Em Ramo, selecione mestre.
Nota
Por padrão, o assistente de criação desabilita a autenticação básica e a implantação das Ações do GitHub é 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 pode não ter permissões suficientes. Você pode configurar a implantação de Ações do GitHub posteriormente com uma identidade gerada para você por um administrador do Azure ou também pode habilitar a autenticação básica.
Selecione o botão Rever + 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 em seu 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
azd up
comando:azd up
O
azd up
comando 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 implanta o código compilado do aplicativo. Enquanto está em execução, o comando fornece mensagens sobre o processo de provisionamento e implantação, incluindo um link para a implantação no Azure. Quando terminar, o comando também exibirá um link para o aplicativo deploy.Abra um navegador da Web e navegue até o URL:
Você vê o aplicativo Web ASP.NET Core 7.0 exibido na página.
3. Atualize o aplicativo e reimplante
Siga estas etapas para atualizar e reimplantar seu aplicativo Web:
No Gerenciador de Soluções, em seu projeto, abra Index.cshtml.
Substitua o primeiro
<div>
elemento pelo seguinte código:<div class="jumbotron"> <h1>.NET 💜 Azure</h1> <p class="lead">Example .NET app to Azure App Service.</p> </div>
Guardar as suas alterações.
Para reimplantar no Azure, clique com o botão direito do mouse no projeto MyFirstAzureWebApp no Gerenciador de Soluções e selecione Publicar.
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.
Você vê o aplicativo Web ASP.NET Core 7.0 atualizado exibido na página.
Abra o Index.cshtml.
Substitua o primeiro
<div>
elemento pelo seguinte código:<div class="jumbotron"> <h1>.NET 💜 Azure</h1> <p class="lead">Example .NET app to Azure App Service.</p> </div>
Guardar as suas alterações.
No Visual Studio Code, abra a Paleta de comandos, Ctrl+Shift+P.
Procure 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ê vê 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 <div>
elemento:
<div class="jumbotron">
<h1>.NET 💜 Azure</h1>
<p class="lead">Example .NET app to Azure App Service.</p>
</div>
Salve as alterações e reimplante o aplicativo usando o az webapp up
comando novamente:
ASP.NET Core 7.0 é multiplataforma, com base na sua implantação anterior, 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.
Depois de concluída a implementação, volte para a janela do browser aberta no passo Navegar para a aplicação e clique em “atualizar”.
Você vê 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
<div>
elemento:<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
dotnet publish
comando:dotnet publish --configuration Release
Mude para o diretório de liberação e crie um arquivo zip a partir do 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
Nota
-ArchivePath
precisa do caminho completo do arquivo zip.Depois de concluída a implementação, volte para a janela do browser aberta no passo Navegar para a aplicação e clique em “atualizar”.
Você vê o aplicativo Web ASP.NET Core 7.0 atualizado exibido na página.
Navegue até a bifurcação do GitHub do código de exemplo.
Na página de repositório, pressione
.
para iniciar o Visual Studio Code no navegador.Nota
O URL mudará de GitHub.com para GitHub.dev. Esse recurso só funciona com repositórios que tenham arquivos. Isso não funciona em repositórios vazios.
Abra o Index.cshtml.
Index.cshtml está localizado na
Pages
pasta.Substitua o primeiro
<div>
elemento pelo seguinte código:<div class="jumbotron"> <h1>.NET 💜 Azure</h1> <p class="lead">Example .NET app to Azure App Service.</p> </div>
Guardar as suas alterações.
No menu Controle do código-fonte, selecione o botão Alterações de estágio para preparar a alteração.
Insira uma mensagem de confirmação, como
We love Azure
. Em seguida, selecione Confirmar e Enviar.Depois de concluída a implementação, volte para a janela do browser aberta durante o passo Navegar para a aplicação e atualize a página.
Você vê 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 <div>
elemento:
<div class="jumbotron">
<h1>.NET 💜 Azure</h1>
<p class="lead">Example .NET app to Azure App Service.</p>
</div>
Salve as alterações e reimplante o aplicativo usando o azd up
comando novamente:
azd up
azd up
ignorará a etapa de recursos de provisionamento desta vez e apenas reimplantará seu código, já que não houve alterações nos arquivos do Bicep.
Quando 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 gerir a sua aplicação Web, aceda ao portal do Azure e procure e selecione Serviços de Aplicação.
Na página Serviços de Aplicativo, selecione o nome do seu aplicativo Web.
A página Visão geral do seu aplicativo Web contém opções para gerenciamento básico, como procurar, parar, iniciar, reiniciar e excluir. O menu à esquerda fornece mais páginas para configurar seu aplicativo.
Clean up resources (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.
- Na página Descrição geral da sua aplicação Web no portal do Azure, selecione a ligação myResourceGroup em Grupo de recursos.
- Na página do grupo de recursos, confirme que os recursos apresentados são aqueles que pretende eliminar.
- Selecione Eliminar, introduza myResourceGroup na caixa de texto e, em seguida, selecione Eliminar.
Clean up resources (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.
- Na página Descrição geral da sua aplicação Web no portal do Azure, selecione a ligação myResourceGroup em Grupo de recursos.
- Na página do grupo de recursos, confirme que os recursos apresentados são aqueles que pretende eliminar.
- Selecione Eliminar, introduza myResourceGroup na caixa de texto e, em seguida, selecione Eliminar.
Clean up resources (Limpar recursos)
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 --name myResourceGroup
Este comando pode demorar alguns minutos a ser executado.
Clean up resources (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 alguns minutos a ser executado.
Clean up resources (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.
- Na página Descrição geral da sua aplicação Web no portal do Azure, selecione a ligação myResourceGroup em Grupo de recursos.
- Na página do grupo de recursos, confirme que os recursos apresentados são aqueles que pretende eliminar.
- Selecione Eliminar, introduza myResourceGroup na caixa de texto e, em seguida, selecione Eliminar.
Clean up resources (Limpar recursos)
Use o comando para remover o azd down
grupo de recursos e todos os recursos associados a ele:
azd down
Visite a documentação da CLI do Desenvolvedor do Azure para conhecer as próximas etapas sobre como trabalhar com azd
modelos e recursos adicionais.
Próximos passos
Avance para o próximo artigo para saber como criar um aplicativo .NET Core e conectá-lo a um Banco de Dados SQL: