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

Se já instalou o Visual Studio 2022:

  1. Instale as atualizações mais recentes no Visual Studio ao selecionar Ajuda>Procurar Atualizações.
  2. Adicione a carga de trabalho ao selecionar Ferramentas>Obter Ferramentas e Funcionalidades.
Instale o SDK .NET 6.0 mais recente.
Instale o SDK .NET 6.0 mais recente.
Instale o SDK .NET 6.0 mais recente.

Criar uma aplicação Web ASP.NET

  1. Abra o Visual Studio e, em seguida, selecione Criar um novo projeto.

  2. Em Criar um novo projeto, localize e selecione ASP.NET Core Aplicação Web e, em seguida, selecione Seguinte.

  3. Em Configurar o novo projeto, atribua o nome MyFirstAzureWebApp à aplicação e, em seguida, selecione Seguinte.

    Captura de ecrã do Visual Studio – Configurar ASP.NET aplicação Web 6.0.

  4. Selecione .NET 6.0 (Suporte a longo prazo).

  5. Certifique-se de que o Tipo de Autenticação está definido como Nenhum. Selecione Criar.

    Captura de ecrã do Visual Studio – Informações adicionais ao selecionar .NET 6.0.

  6. No menu do Visual Studio, selecione Depurar>Iniciar Sem Depuração para executar a aplicação Web localmente.

    Captura de ecrã do Visual Studio - ASP.NET Core 6.0 em execução localmente.

  1. Na janela do terminal, crie uma nova pasta com o nome MyFirstAzureWebApp e abra-a no Visual Studio Code.

    mkdir MyFirstAzureWebApp
    code MyFirstAzureWebApp
    
  2. No Visual Studio Code, abra a janela Terminal ao escrever Ctrl + `.

  3. 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
    
  4. No Terminal do Visual Studio Code, execute a aplicação localmente com o dotnet run comando .

    dotnet run --urls=https://localhost:5001/
    
  5. 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.

    Captura de ecrã do Visual Studio Code – execute o .NET 6.0 no browser localmente.

  1. 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 recém-criada.

    dotnet new webapp -n MyFirstAzureWebApp --framework net6.0
    cd MyFirstAzureWebApp
    
  2. Na mesma sessão de terminal, execute a aplicação localmente com o dotnet run comando .

    dotnet run --urls=https://localhost:5001/
    
  3. Abra um browser e navegue para a aplicação em https://localhost:5001.

    Verá o modelo ASP.NET Core aplicação Web 6.0 apresentado na página.

    Captura de ecrã do Visual Studio Code - ASP.NET Core 6.0 no browser local.

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 o 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 para a 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:

  1. Em Explorador de Soluções, clique com o botão direito do rato no projeto MyFirstAzureWebApp e selecione Publicar.

  2. Em Publicar, selecione Azure e, em seguida , Seguinte.

    Captura de ecrã do Visual Studio – Publicar a aplicação Web e o Azure de destino.

  3. 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 direcionar ASP.NET Framework 4.8, utilize Serviço de Aplicações do Azure (Windows).

  4. As suas opções dependem se já tem sessão iniciada no Azure e se tem uma conta do Visual Studio ligada 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.

    Captura de ecrã do Visual Studio – selecione iniciar sessão na caixa de diálogo do Azure.

  5. À direita de Serviço de Aplicações instâncias, selecione +.

    Captura de ecrã da caixa de diálogo Visual Studio - Nova aplicação Serviço de Aplicações.

  6. Para Subscrição, aceite a subscrição listada ou selecione uma nova na lista pendente.

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

  8. Para Plano de Alojamento, selecione Novo.

  9. 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.

    Captura de ecrã a mostrar o ecrã Criar novo Plano de Alojamento no portal do Azure.

  10. Em Nome, introduza um nome de aplicação exclusivo que inclua apenas os carateres válidos: a-z, A-Z, 0-9e -. 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.

  11. Selecione Criar para criar os recursos do Azure.

    Captura de ecrã a mostrar a caixa de diálogo Visual Studio – Criar recursos de aplicações.

    Assim que o assistente for concluído, os recursos do Azure são criados automaticamente e está pronto para publicar o seu projeto de ASP.NET Core.

  12. 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.

  13. 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 ASP.NET Core aplicação Web 6.0 apresentada na página.

    Captura de ecrã do Visual Studio - ASP.NET Core aplicação Web 6.0 no Azure.

  1. No Visual Studio Code, abra a Paleta de Comandos, Ctrl+Shift+P.

  2. Procure e selecione "Serviço de Aplicações do Azure: Implementar na Aplicação Web".

  3. Responda aos pedidos da seguinte forma:

    1. Selecione MyFirstAzureWebApp como a pasta a implementar.
    2. Selecione Adicionar Configuração quando lhe for pedido.
    3. Se lhe for pedido, inicie sessão na sua conta do Azure.
    4. Selecione a sua Subscrição.
    5. Selecione Criar nova Aplicação Web... Avançado.
    6. Para Introduzir um nome globalmente exclusivo, utilize um nome exclusivo em todo o Azure (os carateres válidos são a-z, 0-9e -). Um bom padrão é utilizar uma combinação do nome da sua empresa e de um identificador de aplicação.
    7. Selecione Criar novo grupo de recursos e forneça um nome como myResourceGroup.
    8. 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
    1. Selecione um sistema operativo (Windows ou Linux).
      • Para .NET Framework 4.8, o Windows será selecionado implicitamente.
    2. Selecione uma localização próxima de si.
    3. Selecione Criar um novo plano de Serviço de Aplicações, forneça um nome e selecione o escalão de preçoGratuito F1.
    4. Selecione Ignorar por agora para o recurso do Application Insights.
  4. 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.

  5. 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.

    Captura de ecrã do Visual Studio Code - ASP.NET Core aplicação Web 6.0 no Azure.

  1. Inicie sessão na sua conta do Azure com o az login comando e siga a linha de comandos:

    az login
    
  2. 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ão a-z, 0-9e -). 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> ou windowslinux . Tem de utilizar windows 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 o az 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
    
  3. Abra um browser e navegue para o URL:

    Verá a ASP.NET Core aplicação Web 6.0 apresentada na página.

    Captura de ecrã da CLI - ASP.NET Core aplicação Web 6.0 no Azure.

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.

  1. Inicie sessão na sua conta do Azure com o Connect-AzAccount comando e siga a linha de comandos:

    Connect-AzAccount
    
  1. 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ão a-z, 0-9e -). 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 o Get-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.

  2. 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
    
  3. 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
    
  4. 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.

  5. Abra um browser e navegue para o URL:

    Verá a ASP.NET Core aplicação Web 6.0 apresentada na página.

    Captura de ecrã da CLI - ASP.NET Core aplicação Web 6.0 no Azure.

  1. Escreva serviços de aplicações na pesquisa. Em Serviços, selecione Serviços de Aplicações.

    Captura de ecrã a mostrar a pesquisa do portal no portal do Azure.

  2. Na página Serviços de Aplicações , selecione + Criar.

  3. 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.

    Captura de ecrã a mostrar a secção Detalhes do projeto que mostra onde seleciona a subscrição do Azure e o grupo de recursos da aplicação Web.

  4. 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.

    Captura de ecrã a mostrar os Detalhes da Instância do Serviço de Aplicações com um runtime .NET 6.

  5. 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.

    Captura de ecrã da secção Conta de administrador onde fornece o nome de utilizador e a palavra-passe do administrador.

  6. Selecione o botão Seguinte: Implementação > na parte inferior da página.

  7. No separador Implementação, em GitHub Actions definições, certifique-se de que a implementação contínua é Ativar.

  8. 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.

    Captura de ecrã das opções de implementação de uma aplicação com o runtime .NET 6.

  9. Selecione o botão Rever + criar na parte inferior da página.

    Captura de ecrã a mostrar o botão Rever e criar na parte inferior da página.

  10. Após a validação ser executada, selecione o botão Criar na parte inferior da página.

  11. Depois de concluída a implementação, selecione Ir para recurso.

    Captura de ecrã a mostrar o passo seguinte de aceder ao recurso.

  12. 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:

  1. No Explorador de Soluções, no projeto, abra Index.cshtml.

  2. 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.

  3. 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.

  4. 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.

    Captura de ecrã do Visual Studio – Atualização ASP.NET Core aplicação Web 6.0 no Azure.

  1. Abra o Index.cshtml.

  2. 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.

  3. No Visual Studio Code, abra a Paleta de Comandos, Ctrl+Shift+P.

  4. Procure e selecione "Serviço de Aplicações do Azure: Implementar na Aplicação Web".

  5. Selecione Implementar quando lhe for pedido.

  6. 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.

    Captura de ecrã do Visual Studio Code - Atualização ASP.NET Core aplicação Web 6.0 no Azure.

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.

Captura de ecrã da CLI – Atualização ASP.NET Core aplicação Web 6.0 no Azure.

  1. 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>
    
  2. 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
    
  3. 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
    
  4. 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.

  5. 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.

    Captura de ecrã da CLI – Atualização ASP.NET Core aplicação Web 6.0 no Azure.

  1. Navegue para o fork do GitHub do código de exemplo.

  2. 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.

  3. Abra o Index.cshtml.

    Index.cshtml está localizado na Pages pasta .

    Captura de ecrã da janela Do Explorador do Visual Studio Code no browser, a realçar o Index.cshtml no repositório dotnetcore-docs-hello-world.

  4. 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.

  5. No menu Controlo de Origem , selecione o botão Alterações de Fase para testar a alteração.

  6. Introduza uma mensagem de consolidação, como We love Azure. Em seguida, selecione Consolidar e Emitir.

  7. 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.

    Captura de ecrã da CLI – Atualização ASP.NET Core aplicação Web 6.0 no Azure.

Gerir a aplicação do Azure

Para gerir a sua aplicação Web, aceda ao portal do Azure e procure e selecione Serviços de Aplicações.

Captura de ecrã a mostrar a opção portal do Azure - Selecionar Serviços aplicacionais.

Na página Serviços de Aplicações , selecione o nome da sua aplicação Web.

Captura de ecrã da página portal do Azure - Serviços de Aplicações com uma aplicação Web de exemplo selecionada.

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.

Captura de ecrã da página de descrição geral portal do Azure - Serviço de Aplicações.

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.

  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 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.

  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 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 esperar 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.

  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 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: