Implantar um aplicativo ASP.NET no Compute Engine

---

Neste tutorial, descrevemos como implantar um aplicativo da Web .NET no Compute Engine.

Este tutorial é destinado a desenvolvedores e engenheiros de DevOps que têm conhecimento básico do Microsoft .NET e do Compute Engine.

Objetivos

Implante um aplicativo da Web ASP.NET Core que usa o .NET 6 e é executado no Linux em uma única instância do Compute Engine.

Observação: para informações sobre como implantar um aplicativo da Web ASP.NET Model-View-Controller (MVC) que use o .NET Framework 4 e seja executado no Windows, consulte Implantar um aplicativo MVC ASP.NET no Compute Engine.

Neste tutorial, mostramos como concluir as seguintes tarefas para alcançar seu objetivo:

• Implantar uma VM do Compute Engine
• Configure o balanceamento de carga.
• Implantar o aplicativo ASP.NET

Custos

Neste documento, você usará os seguintes componentes faturáveis do Google Cloud:

• Instâncias de máquina virtual (VM) do Compute Engine
• Discos permanentes do Compute Engine

Para gerar uma estimativa de custo baseada na projeção de uso deste tutorial, use a calculadora de preços. Novos usuários do Google Cloud podem estar qualificados para uma avaliação gratuita.

Ao concluir as tarefas descritas neste documento, é possível evitar o faturamento contínuo excluindo os recursos criados. Saiba mais em Limpeza.

Antes de começar

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Compute Engine API.

   Enable the API

5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

6. Make sure that billing is enabled for your Google Cloud project.

7. Enable the Compute Engine API.

   Enable the API

Implantar uma VM do Compute Engine

Nesta seção, você verá como criar uma VM do Linux ou uma VM do Windows Server que executa servidores da Web dos Serviços de Informações da Internet (IIS, na sigla em inglês) da Microsoft no Compute Engine.

1. Defina valores padrão para o ID do projeto e a zona do Compute Engine. Isso ajuda a economizar tempo.

   gcloud config set project PROJECT_ID
   gcloud config set compute/zone ZONE
   

   Substitua:

   • PROJECT_ID pelo ID do seu projeto do Google Cloud.
   • ZONE pelo nome da zona que você usará para criar recursos. Se não tiver certeza sobre qual zona escolher, use a zona geograficamente localizada mais próxima de você.

   Exemplo:

   gcloud config set project test-project-12345
   gcloud config set compute/zone us-central1-a
   

2. Crie uma instância de VM:

   Para criar uma VM do Linux, faça o seguinte:

   1. Crie um script de inicialização para a instância de VM. O script é executado durante a inicialização da VM e instala o ambiente de execução do .NET:

      "if ! dpkg-query -W aspnetcore-runtime-6.0
      then
          curl https://packages.microsoft.com/config/debian/11/packages-microsoft-prod.deb  -O
          sudo dpkg -i packages-microsoft-prod.deb
          rm packages-microsoft-prod.deb
          sudo apt-get update && sudo apt-get install -y aspnetcore-runtime-6.0
      fi
      " | Out-File -Encoding ASCII startup.sh
      

   2. Crie a instância de VM e use startup.sh como script de inicialização:

      gcloud compute instances create clouddemo-1 `
          --image-family debian-11 `
          --image-project debian-cloud `
          --machine-type n1-standard-2 `
          --boot-disk-type pd-ssd `
          --tags loadbalancer-backend `
          --metadata-from-file startup-script=startup.sh
      

3. Monitore o processo de inicialização da VM visualizando a saída da porta serial:

   gcloud compute instances tail-serial-port-output clouddemo-1
   

   Aguarde cerca de cinco minutos até ver a saída Instance setup finished ou Startup finished e pressione Ctrl+C. Neste momento, a instalação dos pré-requisitos está concluída e a instância de VM está pronta para ser usada.

Configure o balanceamento de carga.

Para disponibilizar seu aplicativo ASP.NET pela Internet, você precisa usar um balanceador de carga HTTPS. Para associar a instância de VM ao balanceador de carga, crie um grupo de instâncias e atribua-o ao balanceador de carga:

1. Crie um grupo de instâncias não gerenciadas e adicione a instância de VM:

   gcloud compute instance-groups unmanaged create clouddemo-1
   gcloud compute instance-groups unmanaged add-instances clouddemo-1 --instances clouddemo-1
   

2. Crie uma verificação de integridade para saber se o servidor da Web está em execução:

   gcloud compute http-health-checks create clouddemo-health `
       --check-interval 5s `
       --unhealthy-threshold 2 `
       --request-path / `
       --port 5000
   gcloud compute instance-groups set-named-ports clouddemo-1 --named-ports=http:5000
   

3. Crie um serviço de back-end do balanceador de carga que use a verificação de integridade HTTP e o grupo de instâncias criado anteriormente:

   gcloud compute backend-services create clouddemo-backend `
     --http-health-checks clouddemo-health `
     --port-name http `
     --protocol HTTP `
     --global
   gcloud compute backend-services add-backend clouddemo-backend `
     --instance-group clouddemo-1 `
     --global `
     --instance-group-zone $(gcloud config get-value compute/zone)
   

4. Crie um front-end para o balanceador de carga:

   gcloud compute url-maps create clouddemo-map --default-service clouddemo-backend
   gcloud compute target-http-proxies create clouddemo-proxy --url-map clouddemo-map
   gcloud compute forwarding-rules create clouddemo-frontend --global --target-http-proxy clouddemo-proxy --ports 80
   

5. Crie uma regra de firewall que permita que o balanceador de carga envie solicitações HTTP para instâncias que foram anotadas com a tag loadbalancer-backend.

   gcloud compute firewall-rules create loadbalancer-backend `
     --source-ranges "130.211.0.0/22,35.191.0.0/16" `
     --target-tags loadbalancer-backend `
     --allow tcp:80,tcp:5000
   

6. Pesquise o endereço IP do balanceador de carga:

   gcloud compute forwarding-rules describe clouddemo-frontend --global --format "value(IPAddress)"
   

   Anote o endereço IP. Você precisará dessas informações posteriormente.

Implantar o aplicativo ASP.NET

1. Abra um console do PowerShell.

2. Faça o download e descompacte o zip (em inglês) ou clone o repositório de amostra do GitHub:

   git clone https://github.com/GoogleCloudPlatform/dotnet-docs-samples.git
   

3. Crie o pacote de implantação:

   1. Alterne para o diretório que contém o aplicativo de amostra:

      cd dotnet-docs-samples\applications\clouddemo\netcore
      

   2. Crie a solução:

      dotnet publish -c Release
      

4. Copie o pacote de implantação para a VM:

   1. Copie o conteúdo da pasta publish para seu diretório principal na VM:

      gcloud compute scp --recurse CloudDemo.MvcCore\bin\Release\net6.0\publish clouddemo-1:
      

   2. Conecte-se à VM usando SSH.

   3. Na VM, crie uma pasta /var/www/clouddemo e copie os arquivos do aplicativo para ela:

      sudo mkdir -p /var/www/clouddemo
      sudo chown -R www-data:www-data /var/www/clouddemo
      sudo cp -r publish/* /var/www/clouddemo
      

   4. Registre o aplicativo como uma unidade do sistema:

      cat <<EOF > kestrel-clouddemo.service
      [Unit]
      Description=Cloud Demo ASP.NET app
      
      [Service]
      WorkingDirectory=/var/www/clouddemo
      ExecStart=/usr/bin/dotnet /var/www/clouddemo/CloudDemo.MvcCore.dll
      Restart=always
      Environment=ASPNETCORE_ENVIRONMENT=Production
      Environment=ASPNETCORE_URLS=http://0.0.0.0:5000
      
      [Install]
      WantedBy=multi-user.target
      EOF
      
      sudo mv kestrel-clouddemo.service /etc/systemd/system/
      sudo systemctl daemon-reload
      sudo systemctl start kestrel-clouddemo
      

5. No computador local, abra um navegador da Web e navegue até o seguinte endereço:

   http://LOADBALANCER_IP/
   

   Substitua LOADBALANCER_IP pelo endereço IP que você recebeu depois de implantar o balanceador de carga.

   Agora você verá o aplicativo de demonstração e o título This app is running on Compute Engine.

Limpeza

Depois de concluir o tutorial, você pode limpar os recursos que criou para que eles parem de usar a cota e gerar cobranças. Nas seções a seguir, descrevemos como excluir ou desativar esses recursos.

Excluir o projeto

O jeito mais fácil de evitar cobranças é excluindo o projeto que você criou para este tutorial.

Cuidado: excluir um projeto tem os seguintes efeitos:

• Tudo no projeto é excluído. Se você tiver usado um projeto existente para as tarefas neste documento, a exclusão dele incluirá a exclusão de quaisquer outros trabalhos feitos no projeto.
• Os IDs do projeto personalizados são perdidos. Ao criar o projeto, você pode ter criado um código do projeto personalizado para ser usado no futuro. Para preservar os URLs que usam o ID do projeto, como um URL appspot.com, exclua recursos específicos do projeto, em vez de excluir o projeto inteiro.

Se você planeja passar por várias arquiteturas, tutoriais ou guias de início rápido, a reutilização de projetos pode evitar que você exceda os limites da cota do projeto.

Delete a Google Cloud project:

gcloud projects delete PROJECT_ID

Excluir recursos individuais

Você precisará excluir individualmente todos os recursos criados para o projeto (por exemplo: grupos de instâncias, verificações de integridade, serviços de back-end, proxy http e regras de encaminhamento). Não é possível excluir as instâncias de VM até que todos esses recursos sejam excluídos.

A seguir

• Saiba mais sobre como criar e executar máquinas virtuais na infraestrutura do Google.
• Analise as práticas recomendadas no Framework de arquitetura do Google Cloud.
• Confira arquiteturas de referência, diagramas, tutoriais e práticas recomendadas do Google Cloud. Confira o Centro de arquitetura do Cloud.