Início Rápido: Implementar uma aplicação Web ASP.NET
Neste início rápido, irá aprender a criar e implementar a sua primeira aplicação Web ASP.NET para Serviço de Aplicações do Azure. Serviço de Aplicações suporta várias versões de aplicações .NET e fornece um serviço de alojamento Na Web altamente dimensionável e com correção automática. ASP.NET aplicações Web são multiplataforma e podem ser alojadas no Linux ou Windows. Quando tiver terminado, terá um grupo de recursos do Azure composto por um plano de alojamento Serviço de Aplicações e um Serviço de Aplicações com uma aplicação Web implementada.
Em alternativa, pode implementar uma aplicação Web ASP.NET como parte de um contentor do Windows ou Linux no Serviço de Aplicações.
Pré-requisitos
- Uma conta do Azure com uma subscrição ativa. Crie uma conta gratuitamente.
- Visual Studio 2022 com a carga de trabalho ASP.NET e desenvolvimento Web .
Se já instalou o Visual Studio 2022:
- Instale as atualizações mais recentes no Visual Studio ao selecionar Ajuda>Procurar Atualizações.
- Adicione a carga de trabalho ao selecionar Ferramentas>Obter Ferramentas e Funcionalidades.
- Uma conta do Azure com uma subscrição ativa. Crie uma conta gratuitamente.
- Visual Studio Code.
- A extensão das Ferramentas do Azure .
- Uma conta do Azure com uma subscrição ativa. Crie uma conta gratuitamente.
- A CLI do Azure.
- O SDK .NET (inclui o runtime e a CLI).
- Uma conta do Azure com uma subscrição ativa. Crie uma conta gratuitamente.
- A Azure PowerShell.
- O SDK .NET (inclui o runtime e a CLI).
- Uma conta do Azure com uma subscrição ativa. Crie uma conta gratuitamente.
- Uma conta do GitHub Crie uma conta gratuitamente.
Criar uma aplicação Web ASP.NET
Abra o Visual Studio e, em seguida, selecione Criar um novo projeto.
Em Criar um novo projeto, localize e selecione ASP.NET Core Aplicação Web e, em seguida, selecione Seguinte.
Em Configurar o novo projeto, atribua o nome MyFirstAzureWebApp à aplicação e, em seguida, selecione Seguinte.
Selecione .NET 6.0 (Suporte a longo prazo).
Certifique-se de 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 a aplicação Web localmente.
Na janela do terminal, crie uma nova pasta com o nome MyFirstAzureWebApp e abra-a no Visual Studio Code.
mkdir MyFirstAzureWebApp code MyFirstAzureWebApp
No Visual Studio Code, abra a janela Terminal ao escrever
Ctrl
+`
.No terminal do Visual Studio Code, crie uma nova aplicação Web .NET com o
dotnet new webapp
comando .dotnet new webapp -f net6.0
No Terminal do Visual Studio Code, execute a aplicação localmente com o
dotnet run
comando .dotnet run --urls=https://localhost:5001/
Abra um browser e navegue para a aplicação em
https://localhost:5001
.Verá o modelo ASP.NET Core aplicação Web 6.0 apresentada na página.
Abra uma janela de terminal no seu computador para um diretório de trabalho. Crie uma nova aplicação Web .NET com o
dotnet new webapp
comando e, em seguida, altere os diretórios para a aplicação criada recentemente.dotnet new webapp -n MyFirstAzureWebApp --framework net6.0 cd MyFirstAzureWebApp
Na mesma sessão de terminal, execute a aplicação localmente com o
dotnet run
comando .dotnet run --urls=https://localhost:5001/
Abra um browser e navegue para a aplicação em
https://localhost:5001
.Verá o modelo ASP.NET Core aplicação Web 6.0 apresentada na página.
Neste passo, vamos criar um fork de um projeto de demonstração para implementar.
- Aceda à aplicação de exemplo .NET 6.0.
- Selecione o botão Fork no canto superior direito na página do GitHub.
- Selecione Proprietário e deixe o nome do Repositório predefinido.
- Selecione Criar fork.
Publicar a sua aplicação Web
Para publicar a sua aplicação Web, primeiro tem de criar e configurar uma nova Serviço de Aplicações na qual possa publicar a sua aplicação.
Como parte da configuração do Serviço de Aplicações, irá criar:
- Um novo grupo de recursos para conter todos os recursos do Azure para o serviço.
- Um novo Plano de Alojamento que especifica a localização, o tamanho e as funcionalidades do farm de servidores Web que aloja a sua aplicação.
Siga estes passos para criar os recursos Serviço de Aplicações e publicar o projeto:
No Explorador de Soluções, clique com o botão direito do rato no projeto MyFirstAzureWebApp e selecione Publicar.
Em Publicar, selecione Azure e, em seguida , Seguinte.
Selecione o Destino específico, Serviço de Aplicações do Azure (Linux) ou Serviço de Aplicações do Azure (Windows). Em seguida, selecione Seguinte.
Importante
Ao filtrar ASP.NET Framework 4.8, utilize Serviço de Aplicações do Azure (Windows).
As suas opções dependem se já tem sessão iniciada no Azure e se tem uma conta do Visual Studio associada a uma conta do Azure. Selecione Adicionar uma conta ou Iniciar sessão para iniciar sessão na sua subscrição do Azure. Se já tiver sessão iniciada, selecione a conta que pretende.
À direita de Serviço de Aplicações instâncias, selecione +.
Em Subscrição, aceite a subscrição listada ou selecione uma nova na lista pendente.
Em Grupo de recursos, selecione Novo. Em Novo nome do grupo de recursos, introduza myResourceGroup e selecione OK.
Para Plano de Alojamento, selecione Novo.
Na caixa de diálogo Plano de Alojamento: Criar novo , introduza os valores especificados na tabela seguinte:
Definiçã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 Gratuito O escalão de preço determina as funcionalidades do alojamento. Em Nome, introduza um nome de aplicação exclusivo que inclua apenas os carateres válidos:
a-z
,A-Z
,0-9
e-
. 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.
Assim que o assistente for concluído, os recursos do Azure são criados automaticamente e estará pronto para publicar o seu projeto ASP.NET Core.
Na caixa de diálogo Publicar, certifique-se de que a nova aplicação Serviço de Aplicações está selecionada na instância Serviço de Aplicações e, em seguida, selecione Concluir. O Visual Studio cria um perfil de publicação para si para a aplicação Serviço de Aplicações selecionada.
Na página Publicar , selecione Publicar. Se vir uma mensagem de aviso, selecione Continuar.
O Visual Studio cria, empacota e publica a aplicação no Azure e, em seguida, inicia a aplicação no browser predefinido.
Verá a aplicação Web ASP.NET Core 6.0 apresentada na página.
No Visual Studio Code, abra a Paleta de Comandos, Ctrl+Shift+P.
Procure e selecione "Serviço de Aplicações do Azure: Implementar na Aplicação Web".
Responda aos pedidos da seguinte forma:
- Selecione MyFirstAzureWebApp como a pasta a implementar.
- Selecione Adicionar Configuração quando lhe for pedido.
- Se lhe for pedido, inicie sessão na sua conta do Azure.
- Selecione a sua Subscrição.
- Selecione Criar nova Aplicação Web... Avançado.
- Para Introduzir um nome globalmente exclusivo, utilize um nome exclusivo em todo o Azure (os carateres válidos são
a-z
,0-9
e-
). Um bom padrão é utilizar uma combinação do nome da sua empresa e de um identificador de aplicação. - Selecione Criar novo grupo de recursos e forneça um nome como
myResourceGroup
. - Quando lhe for pedido para Selecionar uma pilha de runtime:
- Para .NET 6.0, selecione .NET 6
- Para .NET Framework 4.8, selecione ASP.NET V4.8
- Selecione um sistema operativo (Windows ou Linux).
- Para .NET Framework 4.8, o Windows será selecionado implicitamente.
- Selecione uma localização próxima de si.
- Selecione Criar um novo plano de Serviço de Aplicações, forneça um nome e selecione o escalão de preçoGratuito F1.
- Selecione Ignorar por agora para o recurso do Application Insights.
No pop-up Implemente sempre a área de trabalho "MyFirstAzureWebApp" no <nome> da aplicação", selecione Sim para que o Visual Studio Code seja implementado na mesma aplicação Serviço de Aplicações sempre que estiver nessa área de trabalho.
Quando a publicação estiver concluída, selecione Procurar Site na notificação e selecione Abrir quando lhe for pedido.
Verá a ASP.NET Core aplicação Web 6.0 apresentada na página.
Inicie sessão na sua conta do Azure com o
az login
comando e siga a linha de comandos:az login
Implemente o código no diretório MyFirstAzureWebApp local com o
az webapp up
comando:az webapp up --sku F1 --name <app-name> --os-type <os>
- Se o
az
comando não for reconhecido, certifique-se de que tem a CLI do Azure instalada conforme descrito em Pré-requisitos. - Substitua
<app-name>
por um nome exclusivo em todo o Azure (os carateres válidos sãoa-z
,0-9
e-
). Um bom padrão é utilizar uma combinação do nome da sua empresa e de um identificador de aplicação. - O
--sku F1
argumento cria a aplicação Web no escalão de preçoGratuito. Omita este argumento para utilizar um escalão premium mais rápido, que implica um custo por hora. - Substitua por
<os>
ouwindows
linux
. Tem de utilizarwindows
ao direcionar o ASP.NET Framework 4.8. - Opcionalmente, pode incluir o argumento
--location <location-name>
em que<location-name>
se trata de uma região do Azure disponível. Pode obter uma lista de regiões permitidos para a sua conta do Azure ao executar oaz account list-locations
comando .
O comando pode demorar alguns minutos a concluir. Durante a execução, fornece mensagens sobre como criar o grupo de recursos, o plano Serviço de Aplicações e alojar a aplicação, configurar o registo e, em seguida, executar a implementação ZIP. Em seguida, mostra uma mensagem com o URL da aplicação:
You can launch the app at http://<app-name>.azurewebsites.net
- Se o
Abra um browser e navegue para o URL:
Verá a ASP.NET Core aplicação Web 6.0 apresentada na página.
Nota
Azure PowerShell é recomendado para criar aplicações na plataforma de alojamento do Windows. Para criar aplicações no Linux, utilize uma ferramenta diferente, como a CLI do Azure.
Inicie sessão na sua conta do Azure com o
Connect-AzAccount
comando e siga a linha de comandos:Connect-AzAccount
Crie uma nova aplicação com o comando New-AzWebApp :
New-AzWebApp -Name <app-name> -Location westeurope
- Substitua
<app-name>
por um nome exclusivo em todo o Azure (os carateres válidos sãoa-z
,0-9
e-
). Uma combinação do nome da sua empresa e de um identificador de aplicação é um bom padrão. - Opcionalmente, pode incluir o parâmetro
-Location <location-name>
em que<location-name>
se trata de uma região do Azure disponível. Pode obter uma lista de regiões permitidos para a sua conta do Azure ao executar oGet-AzLocation
comando .
O comando pode demorar alguns minutos a concluir. Durante a execução, cria um grupo de recursos, um plano de Serviço de Aplicações e o recurso Serviço de Aplicações.
- Substitua
Na pasta raiz da aplicação, prepare a sua aplicação MyFirstAzureWebApp local para implementação com o
dotnet publish
comando:dotnet publish --configuration Release
Altere para o diretório de versão e crie um ficheiro zip a partir do conteúdo:
cd bin\Release\net6.0\publish Compress-Archive -Path * -DestinationPath deploy.zip
Publique o ficheiro zip na aplicação do Azure com 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 ficheiro zip.Abra um browser e navegue para o URL:
Verá a ASP.NET Core aplicação Web 6.0 apresentada na página.
Escreva serviços de aplicações na pesquisa. Em Serviços, selecione Serviços de Aplicações.
Na página Serviços de Aplicações , selecione + Criar.
No separador Noções Básicas , em Detalhes do projeto, certifique-se de que a subscrição correta está selecionada e, em seguida, selecione Criar novo grupo de recursos. Escreva myResourceGroup para o nome.
Em Detalhes da instância:
- Em Nome, escreva um nome globalmente exclusivo para a sua aplicação Web.
- Em Publicar, selecione Código.
- Em Pilha de tempo de execução , selecione .NET 6 (LTS).
- Selecione um Sistema Operativo e uma Região a partir da qual pretende servir a sua aplicação.
Em Serviço de Aplicações Plano, selecione Criar novo Plano de Serviço de Aplicações. Escreva myAppServicePlan para o nome. Para mudar para o escalão Gratuito, selecione Alterar tamanho, selecione Dev/Test separador, selecione F1 e selecione o botão Aplicar na parte inferior da página.
Selecione o botão Seguinte: Implementação > na parte inferior da página.
No separador Implementação, em GitHub Actions definições, certifique-se de que a implementação contínua é Ativar.
Em GitHub Actions detalhes, autentique-se com a sua conta do GitHub e selecione as seguintes opções:
- Em Organização , selecione a organização onde forkou o projeto de demonstração.
- Para Repositório , selecione o projeto dotnetcore-docs-hello-world .
- Em Ramo , selecione mestre.
Selecione o botão Rever + criar na parte inferior da página.
Após a validação ser executada, selecione o botão Criar na parte inferior da página.
Depois de concluída a implementação, selecione Ir para recurso.
Navegue para a aplicação implementada no browser no URL
http://<app-name>.azurewebsites.net
.
Atualizar a aplicação e reimplementar
Siga estes passos para atualizar e reimplementar a sua aplicação Web:
No Explorador de Soluções, no 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>
Guarde as alterações.
Para voltar a implementar no Azure, clique com o botão direito do rato no projeto MyFirstAzureWebApp no Explorador 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.
Verá a aplicação Web atualizada ASP.NET Core 6.0 apresentada 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>
Guarde as alterações.
No Visual Studio Code, abra a Paleta de Comandos, Ctrl+Shift+P.
Procure e selecione "Serviço de Aplicações do Azure: Implementar na Aplicação Web".
Selecione Implementar quando lhe for pedido.
Quando a publicação estiver concluída, selecione Procurar Site na notificação e selecione Abrir quando lhe for pedido.
Verá a aplicação Web atualizada ASP.NET Core 6.0 apresentada na página.
No diretório local, abra o ficheiro 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>
Guarde as alterações e, em seguida, volte a implementar a aplicação com o az webapp up
comando:
ASP.NET Core 6.0 é multiplataformas, com base na sua implementação anterior, substitua <os>
por linux
ou windows
.
az webapp up --os-type <os>
Este comando utiliza valores que são colocados em cache localmente no ficheiro .azure/config, incluindo o nome da aplicação, o grupo de recursos e Serviço de Aplicações plano.
Assim que a implementação estiver concluída, regresse à janela do browser que abriu no passo Navegar para a aplicação e prima atualizar.
Verá a aplicação Web atualizada ASP.NET Core 6.0 apresentada na página.
No diretório local, abra o ficheiro 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 da aplicação, prepare a sua aplicação MyFirstAzureWebApp local para implementação com o
dotnet publish
comando :dotnet publish --configuration Release
Mude para o diretório de versão e crie um ficheiro zip a partir do conteúdo:
cd bin\Release\net6.0\publish Compress-Archive -Path * -DestinationPath deploy.zip
Publique o ficheiro zip na aplicação do Azure com 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 ficheiro zip.Assim que a implementação estiver concluída, regresse à janela do browser que abriu no passo Navegar para a aplicação e prima atualizar.
Verá a aplicação Web atualizada ASP.NET Core 6.0 apresentada na página.
Navegue para o fork do GitHub do código de exemplo.
Na página do seu repositório, prima
.
para iniciar o Visual Studio Code no browser.Nota
O URL mudará de GitHub.com para GitHub.dev. Esta funcionalidade só funciona com repositórios com ficheiros. Isto 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>
Guarde as alterações.
No menu Controlo de Origem , selecione o botão Alterações de Fase para testar a alteração.
Introduza uma mensagem de consolidação, como
We love Azure
. Em seguida, selecione Consolidar e Emitir.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.
Verá a aplicação Web atualizada ASP.NET Core 6.0 apresentada na página.
Gerir a aplicação do Azure
Para gerir a sua aplicação Web, aceda à portal do Azure e procure e selecione Serviços Aplicacionais.
Na página Serviços Aplicacionais , selecione o nome da sua aplicação Web.
A página Descrição geral da sua aplicação Web contém opções para gestão básica, como procurar, parar, iniciar, reiniciar e eliminar. O menu esquerdo fornece mais páginas para configurar a sua aplicação.
Limpar os 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.
Limpar os 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.
Limpar os 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.
Limpar os recursos
Nos passos anteriores, criou os recursos do Azure num grupo de recursos. Se não quiser precisar destes recursos no futuro, elimine o grupo de recursos ao executar o seguinte comando do PowerShell:
Remove-AzResourceGroup -Name myResourceGroup
Este comando pode demorar alguns minutos a ser executado.
Limpar os 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.
Passos seguintes
Neste início rápido, criou e implementou uma aplicação Web ASP.NET para Serviço de Aplicações do Azure.
Avance para o artigo seguinte para saber como criar uma aplicação .NET Core e ligá-la a um Base de Dados SQL: