Criar um aplicativo Go 1.12+ no ambiente padrão do App Engine

Guia de início rápido: criar um aplicativo Go 1.12+ no ambiente padrão do App Engine

Criar um aplicativo Go 1.12+ no ambiente padrão 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

Python 2.7/3 |Java 8/11/17 |PHP 5/7+ |Ruby |Go 1.11 /1.12+ |Node.js

Nesta página, mostramos como implantar um aplicativo básico do App Engine que exibe uma mensagem curta. Para ver uma introdução mais detalhada sobre o Go no App Engine, consulte Como criar um aplicativo.

O App Engine é a opção de computação certa para você? Veja outras opções para hospedar seu aplicativo no Google Cloud.

Custos

Não há custos associados à execução deste guia. A execução deste aplicativo de amostra não excede sua cota gratuita.

Antes de começar

1. Faça login na sua conta do Google Cloud. Se você começou a usar o Google Cloud agora, 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.

2. No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

   Observação: se você não pretende manter os recursos criados neste procedimento, crie um projeto novo em vez de selecionar um que já existe. Depois de concluir essas etapas, é possível excluir o projeto. Para fazer isso, basta remover todos os recursos associados a ele.

   Acessar o seletor de projetos

3. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

4. Ative a Cloud Build API.

   Ative a API

5. Instale a CLI do Google Cloud.

6. Para inicializar a CLI gcloud, execute o seguinte comando:

   gcloud init

7. No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

   Observação: se você não pretende manter os recursos criados neste procedimento, crie um projeto novo em vez de selecionar um que já existe. Depois de concluir essas etapas, é possível excluir o projeto. Para fazer isso, basta remover todos os recursos associados a ele.

   Acessar o seletor de projetos

8. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

9. Ative a Cloud Build API.

   Ative a API

10. Instale a CLI do Google Cloud.

11. Para inicializar a CLI gcloud, execute o seguinte comando:

    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:

   • Fazer o download e instalar o Git.

• Execute o comando abaixo para instalar o componente gcloud, que inclui a extensão do App Engine para Go 1.12+:

  gcloud components install app-engine-go
  

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 app. 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 ver 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 este guia de início rápido, você precisa conhecer a linguagem de programação Go e instalar esse ambiente (em inglês).

Fazer o download do app Hello World

Criamos um app Hello World simples para Go. Assim, é possível ter uma ideia de como implantar um aplicativo no Google Cloud. Siga estas etapas para fazer o download do app Hello World para sua máquina local.

Faça o download do app de amostra e acesse o diretório dele:

1. Clone o repositório do aplicativo de exemplo Hello World:

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

   Outra opção é fazer o download do exemplo como um arquivo zip e extraí-lo.

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

   cd golang-samples/appengine/go11x/helloworld
   

Como implantar o Hello World no App Engine

1. Implante o aplicativo Hello World no App Engine executando o seguinte comando no diretório golang-samples/appengine/go11x/helloworld:

   gcloud app deploy
   

2. Veja o app ativo em https://PROJECT_ID.REGION_ID.r.appspot.com:

   gcloud app browse
   

Agora a mensagem Hello, world! será enviada por um servidor da Web executado em uma instância do App Engine.

Parabéns! Você acabou de implantar um serviço da Web do Go no App Engine!

Limpeza

Se você quiser continuar aprendendo sobre o App Engine, armazene seu projeto do Cloud e acompanhe Como criar um aplicativo.

Como alternativa, é possível excluir seu projeto do Cloud para interromper o faturamento de todos os recursos usados nesse 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. No Console do 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.

A seguir

Agora que você já sabe implantar um serviço da Web no App Engine, consulte Como criar um aplicativo para ver uma introdução mais detalhada sobre o Go no App Engine.