Crie uma app Go 1.11 no ambiente padrão do App Engine

Crie uma app Go 1.11 no ambiente padrão do App Engine

ID da região

O REGION_ID é um código abreviado que a Google atribui com base na região que seleciona quando cria a sua app. O código não corresponde a um país ou uma província, embora alguns IDs de regiões possam parecer semelhantes aos códigos de países e províncias usados frequentemente. Para apps criadas após fevereiro de 2020, REGION_ID.r está incluído nos URLs do App Engine. Para apps existentes criadas antes desta data, o ID da região é opcional no URL.

Saiba mais acerca dos IDs de regiões.

OK

Esta página mostra como implementar uma aplicação básica do App Engine que apresenta uma mensagem curta. Para uma introdução mais detalhada ao Go no App Engine, consulte o artigo Criar uma app.

O App Engine é a opção de computação certa para si? Veja outras opções para alojar a sua aplicação em Google Cloud.

Custos

Não existem custos associados à execução deste guia. A execução desta app de exemplo sozinha não excede a sua quota gratuita.

Antes de começar

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.

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 (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 Cloud Build 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

Install the Google Cloud CLI.

Se estiver a usar um fornecedor de identidade (IdP) externo, tem primeiro de iniciar sessão na CLI gcloud com a sua identidade federada.

Para inicializar a CLI gcloud, execute o seguinte comando:

gcloud init

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 (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 Cloud Build 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

Install the Google Cloud CLI.

Se estiver a usar um fornecedor de identidade (IdP) externo, tem primeiro de iniciar sessão na CLI gcloud com a sua identidade federada.

Para inicializar a CLI gcloud, execute o seguinte comando:

gcloud init

Pré-requisitos adicionais

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

   gcloud app create --project=[YOUR_PROJECT_ID]
   

   Quando lhe for pedido, selecione a região onde quer localizar a sua aplicação do App Engine.

   Atenção: não pode alterar a região de uma app depois de a definir.

2. Instale os seguintes pré-requisitos:

   • Transfira e instale o Git.

• Execute o seguinte comando para instalar o componente gcloud que inclui a extensão do App Engine para o Go 1.11:

  gcloud components install app-engine-go
  

Localizações do App Engine

O App Engine é regional, o que significa que a infraestrutura que executa as suas apps está localizada numa região específica e é gerida pela Google para estar disponível de forma redundante em todas as zonas dessa região.

O cumprimento dos requisitos de latência, disponibilidade ou durabilidade são fatores principais para selecionar a região onde as suas apps são executadas. Geralmente, pode selecionar a região mais próxima dos utilizadores da sua app, mas deve considerar as localizações onde o App Engine está disponível, bem como as localizações dos outrosGoogle Cloud produtos e serviços que a sua app usa. A utilização de serviços em várias localizações pode afetar a latência da sua app, bem como os respetivos preços.

Não pode alterar a região de uma app depois de a definir.

Nota: duas localizações, denominadas europe-west e us-central nos comandos do App Engine e na Google Cloud consola, são denominadas europe-west1 e us-central1, respetivamente, noutras partes da documentação da Google.

Se já tiver criado uma aplicação do App Engine, pode ver a respetiva região através de uma das seguintes ações:

• Execute o comando gcloud app describe.

• Abra o painel de controlo do App Engine na Google Cloud consola. A região aparece junto à parte superior da página.

OK

Este início rápido pressupõe que conhece a linguagem de programação Go e que instalou o Go.

Transfira a app Hello World

Criámos uma app simples Hello World para Go para que possa experimentar rapidamente a implementação de uma app na Google Cloud Platform. Siga estes passos para transferir o Hello World para o seu computador local.

Transfira a app de exemplo e navegue para o diretório da app:

1. Clone o repositório da app de exemplo Hello World:

   git clone https://github.com/GoogleCloudPlatform/golang-samples
   

   Em alternativa, transfira o exemplo como um ficheiro ZIP e extraia-o.

2. Altere para o diretório que contém o código de exemplo:

   cd golang-samples/appengine/go11x/helloworld/
   

Implementar o Hello World no App Engine

1. Implemente a app Hello World no App Engine executando o seguinte comando a partir do diretório golang-samples/appengine/go11x/helloworld:

   gcloud app deploy
   

2. Veja a app em direto em https://PROJECT_ID.REGION_ID.r.appspot.com:

   gcloud app browse
   

A mensagem Olá, mundo! é agora fornecida por um servidor Web em execução numa instância do App Engine.

Parabéns! Implementou com êxito um serviço Web Go no App Engine!

Limpar

Se quiser continuar a saber mais sobre o App Engine, pode manter o seu projeto e seguir as instruções em Criar uma app. Google Cloud

Em alternativa, pode eliminar o seu Google Cloud projeto para parar a faturação de todos os recursos usados nesse projeto.

Atenção: a eliminação de um projeto tem os seguintes efeitos:
• Tudo no projeto é eliminado. Se usou um projeto existente para as tarefas neste documento, quando o elimina, também elimina qualquer outro trabalho que tenha feito no projeto.
• Os IDs dos projetos personalizados são perdidos. Quando criou este projeto, pode ter criado um ID do projeto personalizado que quer usar no futuro. Para preservar os URLs que usam o ID do projeto, como um URL appspot.com, elimine os recursos selecionados no projeto em vez de eliminar 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.

O que se segue?

Agora que tem experiência na implementação de um serviço Web no App Engine, receba uma introdução mais detalhada ao Go no App Engine lendo o artigo Criar uma app.