Introdução ao .NET no Compute Engine

Neste tutorial, você aprenderá como começar a usar o Compute Engine. Siga este tutorial implantando um aplicativo da web Hello World .NET no Compute Engine. Para receber ajuda com os primeiros passos no App Engine, consulte o ambiente padrão do App Engine.

Objetivos

• Implantar um app de amostra "Hello World" em uma única instância do Compute Engine.

Custos

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

• 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 um teste sem custo financeiro.

Antes de começar

Faça login na sua conta do Google Cloud . Se você começou a usar o Google Cloud, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

Verify that billing is enabled for your Google Cloud project.

Enable the Compute Engine API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

Verify that billing is enabled for your Google Cloud project.

Enable the Compute Engine API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

1. Instale o .NET Core SDK 2.1 ou posterior em sua máquina local executando o Microsoft Windows.
2. Instale o Web Deploy 3.6 ou posterior em sua máquina local executando o Microsoft Windows.

Como executar o aplicativo localmente

1. Faça o download e descompacte ou clone o repositório de amostra do github:

   git clone https://github.com/GoogleCloudPlatform/getting-started-dotnet.git
   

2. Em uma janela do PowerShell, entre no diretório HelloWorld:

   cd getting-started-dotnet\HelloWorld
   

3. Inicie um servidor da Web local:

   dotnet run
   

4. Abra um navegador da Web para localhost:8080.

   No seu navegador da Web, você vê o texto Hello World, veiculado na sua máquina local.

5. Quando estiver pronto para seguir em frente, pare o servidor da Web local pressionando Control+C.

Implantar em uma instância única

Veja nesta seção como executar uma única instância do aplicativo no Compute Engine.

Criar e configurar uma instância do Compute Engine

Com o Google Cloud Marketplace, é possível iniciar uma instância do Windows executando o Microsoft IIS no Compute Engine.

1. No console do Google Cloud , acesse a página ASP.NET Framework do Cloud Marketplace.

   Acesse o Cloud Marketplace.

2. Clique em Iniciar.

3. Deixe as configurações definidas com seus valores padrão e clique em Implantar.

   Aguarde a instância do Compute Engine para implantar. Geralmente, a implantação leva cerca de 5 minutos.

4. Para exibir informações de recursos, clique em Instância da VM.

5. Para editar a instância da VM, clique em Gerenciar recurso.

6. Clique em Definir senha do Windows e anote o nome de usuário.

7. Copie a nova senha do Windows e clique em Fechar.

8. Na página Detalhes da instância da VM, anote o endereço IP externo.

9. Na máquina Windows local, edite o arquivo HelloWorld/Properties/PublishProfiles/ComputeEngine.pubxml.

10. Digite o endereço IP externo da instância da VM entre <MSDeployServiceURL> e </MSDeployServiceURL>. Por exemplo, <MSDeployServiceURL>203.0.113.22</MSDeployServiceURL>

11. Digite o nome de usuário da instância que você anotou anteriormente entre <UserName> e </UserName>.

12. Salve suas alterações no arquivo ComputeEngine.pubxml.

13. Em uma janela do PowerShell, publique seu aplicativo na instância do Compute Engine:

    dotnet publish -c Release `
      /p:PublishProfile=Properties\PublishProfiles\ComputeEngine.pubxml `
      "/p:Password=YOUR-PASSWORD"
    

    Substitua YOUR-PASSWORD pela senha que você copiou anteriormente.

14. Abra um navegador da Web para o endereço IP externo da sua instância.

    No seu navegador da Web, você vê algum texto do Hello World, veiculado na sua instância do Compute Engine.

Gerenciar e monitorar uma instância

Use o console do Google Cloud para monitorar e gerenciar a instância.

1. Para visualizar todos os registros gerados pelos recursos do Compute Engine, acesse a página Análise de registros.

   Acessar a Análise de registros

   O Cloud Logging é configurado automaticamente para reunir registros de vários serviços comuns, incluindo o syslog.

Limpar

Para evitar cobranças na sua conta do Google Cloud pelos recursos usados no tutorial, exclua o projeto que os contém ou mantenha o projeto e exclua os recursos individuais.

Excluir o projeto

Cuidado: excluir um projeto tem os seguintes efeitos:

• Tudo no projeto é excluído. Se você tiver usado um projeto atual para as tarefas neste documento, a exclusão dele incluirá a exclusão de quaisquer outros trabalhos feitos nele.
• Os IDs do projeto personalizados são perdidos. Ao criar o projeto, você pode ter criado um ID 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 explorar várias arquiteturas, tutoriais e guias de início rápido, a reutilização de projetos pode evitar que você exceda limites da cota.

1. No console Google Cloud , acesse a página Gerenciar recursos.

   Acessar "Gerenciar recursos"

2. Na lista de projetos, selecione o projeto que você quer excluir e clique em Excluir .
3. Na caixa de diálogo, digite o ID do projeto e clique em Encerrar para excluí-lo.

Excluir recursos individuais

gcloud compute instances delete my-app-instance --zone=YOUR_ZONE --delete-disks=all
gcloud compute firewall-rules delete default-allow-http-80

A seguir

• Confira arquiteturas de referência, diagramas, tutoriais e práticas recomendadas do Google Cloud. Confira o Centro de arquitetura do Cloud.

• Para outros recursos .NET para criar seus aplicativos, consulte o seguinte:

  • Gerencie e monitore a implantação do grupo de instâncias em Compute Engine > Grupos de instâncias.
  • Gerencie sua configuração de balanceamento de carga, incluindo mapas de URL e serviços de back-end em Serviços de rede > Balanceamento de carga.
  • Implantar um app no Google Kubernetes Engine
  • Conheça outros serviços doGoogle Cloud .