Criar um aplicativo .NET no ambiente flexível do App Engine

Criar um aplicativo .NET no ambiente flexível do App Engine

ID da região

O REGION_ID é um código abreviado que o Google atribui com base na região que você selecionou ao criar o aplicativo. O código não corresponde a um país ou estado, ainda que alguns IDs de região sejam semelhantes aos códigos de país e estado geralmente usados. Para apps criados após fevereiro de 2020, o REGION_ID.r está incluído nos URLs do App Engine. Para apps existentes criados antes dessa data, o ID da região é opcional no URL.

Saiba mais sobre IDs de região.

OK

Neste guia de início rápido, você verá como criar e implantar um app que exibe uma mensagem curta. É possível usar o aplicativo de exemplo neste guia de início rápido para qualquer versão compatível do .NET. Basta especificar a versão do ambiente de execução. e sistema operacional no arquivo app.yaml. Por padrão, o App Engine usa a versão mais recente do LTS .NET disponível, se você não especifique uma versão de ambiente de execução no arquivo app.yaml.

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 Cloud Build API.

   Enable the API

5. Install the Google Cloud CLI.

6. To initialize the gcloud CLI, run the following command:

   gcloud init

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

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

9. Enable the Cloud Build API.

   Enable the API

10. Install the Google Cloud CLI.

11. To initialize the gcloud CLI, run the following command:

    gcloud init

Pré-requisitos adicionais

1. Inicialize seu aplicativo do App Engine com o projeto e escolha a região:

   gcloud app create --project=[YOUR_PROJECT_ID]
   

   Quando solicitado, selecione a região em que você quer localizar o aplicativo do App Engine.

   Cuidado: não é possível alterar a região de um aplicativo depois de defini-la.

2. Instale os pré-requisitos a seguir:

• Instale o SDK do .NET Core, versão LTS (em inglês).

• Se você estiver usando o Visual Studio, é preciso ter a versão 2015 ou posterior. As imagens estão disponíveis para aplicativos ASP.NET Core (em inglês) escritos para o .NET Core 1.0, 1.1, 2.0 e 2.1.

• Para implantar no App Engine diretamente do Visual Studio, instale o Cloud Tools for Visual Studio.

Locais do App Engine

O App Engine é regional. Isso significa que a infraestrutura que executa os aplicativos está em uma determinada região que é gerenciada pelo Google para estar disponível de modo redundante em todas as zonas dessa região.

Atender aos requisitos de latência, disponibilidade ou durabilidade são os principais fatores para selecionar a região de execução dos aplicativos. Geralmente, é possível selecionar a região mais próxima dos usuários do aplicativo, mas considere os locais em que o App Engine está disponível, bem como os locais dos outros produtos e serviços do Google Cloud usados pelo aplicativo. O uso de serviços em vários locais pode afetar a latência e o preço do aplicativo.

Não é possível alterar a região de um aplicativo depois de defini-la.

Observação: dois locais, chamados europe-west e us-central nos comandos do App Engine e no console do Google Cloud, são chamados europe-west1 e us-central1, respectivamente, em todos os outros lugares da documentação do Google.

Se você já criou um aplicativo do App Engine, será possível consultar a região dele com um dos seguintes procedimentos:

• Execute o comando gcloud app describe.‏

• Abra o Painel do App Engine no console do Google Cloud. A região aparece perto do topo da página.

OK

Para seguir este guia de início rápido, você precisa estar familiarizado com a criação de aplicativos da Web com o C#.

faça o download do app Hello World

Criamos um app Hello World para App Engine. Assim, é possível ter uma ideia de como implantar um app no Google Cloud. O app Hello World é semelhante ao criado pelo Visual Studio quando um app vazio do ASP.NET Core é criado. O app de amostra adiciona um arquivo app.yaml. O app.yaml é um arquivo de configuração do App Engine. Nele, você especifica o ambiente de execução e outras configurações do App Engine.

1. Clone o repositório do app de amostra Hello World na máquina local.

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

   Outra opção é fazer o download da amostra (em inglês) como um arquivo ZIP e extraí-lo.

2. Acesse o diretório que contém o código de amostra.

      cd dotnet-docs-samples/appengine/flexible/HelloWorld
   

Execute o Hello World na máquina local

1. Execute os seguintes comandos no diretório dotnet-docs-samples/appengine/flexible/HelloWorld/HelloWorld.Sample:

   dotnet restore
   dotnet run
   

2. No seu navegador da Web, acesse http://localhost:5000/. Você verá a mensagem "Hello World" do aplicativo de amostra exibida na página. Na janela do terminal, pressione Ctrl+C para sair do servidor da Web.

Implante e execute o Hello World no App Engine

1. Execute gcloud app deploy na linha de comando.
2. Inicie o navegador e acesse o aplicativo em https://PROJECT_ID.REGION_ID.r.appspot.com gcloud app browse

Nesse momento, a página que exibe a mensagem “Hello World” é enviada por um servidor da Web em execução em uma instância do App Engine.

Parabéns! Você implantou seu primeiro aplicativo do App Engine no ambiente flexível do App Engine.

Se você encontrar erros na implantação do app, verifique as dicas de solução de problemas.

Confira as seções a seguir para informações sobre limpeza e links das próximas etapas.

Limpar

Para evitar cobranças, você pode excluir seu projeto do Google Cloud para interromper o faturamento de todos os recursos usados naquele projeto.

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.
1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

A seguir

Conheça a plataforma inteira

Agora que você sabe como é desenvolver e implantar aplicativos do App Engine, explore o restante do Google Cloud. Você já tem a Google Cloud CLI instalada, o que oferece as ferramentas para interagir com produtos como Cloud SQL, Cloud Storage, Firestore e muitos outros.

Saiba mais sobre o ambiente flexível do App Engine

Listamos alguns tópicos para você continuar aprendendo sobre o App Engine:

• Uma visão geral do App Engine
• Roteamento de solicitações
• Processamento de solicitações
• Como gerenciar instâncias

Revisão do código do Hello World

O Hello World é o app mais simples possível do App Engine. Nele, há apenas um serviço e uma versão, e todo o código é armazenado no diretório raiz. Cada arquivo do aplicativo é descrito em detalhes nesta seção.

Program.cs

O app Hello World é um aplicativo ASP.NET simples:

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.MapGet("/", () => builder.Configuration["My:Greeting"]);

app.Run();

app.yaml

O arquivo app.yaml descreve a seguinte configuração para seu app:

• Define env: flex, indicando que o aplicativo usa o ambiente flexível do App Engine.

• Especifica o ambiente de execução usado pelo app.

  runtime: aspnetcore
  env: flex
  
  runtime_config:
    operating_system: ubuntu22
  
  # This sample incurs costs to run on the App Engine flexible environment. 
  # The settings below are to reduce costs during testing and are not appropriate
  # for production use. For more information, see:
  # https://cloud.google.com/appengine/docs/flexible/dotnet/configuring-your-app-with-app-yaml
  manual_scaling:
    instances: 1
  resources:
    cpu: 1
    memory_gb: 0.5
    disk_size_gb: 10
  
  env_variables:
    # The __ in My__Greeting will be translated to a : by ASP.NET.
    My__Greeting: Hello AppEngine!
  

  • Para mais informações sobre o funcionamento do ambiente de execução do .NET, consulte Ambiente de execução do .NET.

  • Para aprender a projetar seu aplicativo para aproveitar mais as versões e os serviços, consulte Visão geral do App Engine.

  • Para mais detalhes sobre as configurações do App Engine, consulte Como configurar um app com o arquivo app.yaml.