Criar um aplicativo Go 1.11 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.
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
- 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.
-
Verifique se a cobrança está ativada para o seu projeto do Google Cloud.
-
Enable the Cloud Build API.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Verifique se a cobrança está ativada para o seu projeto do Google Cloud.
-
Enable the Cloud Build API.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
Pré-requisitos adicionais
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.
Instale os pré-requisitos a seguir:
Execute o comando a seguir para instalar o componente do gcloud, que inclui a extensão do App Engine para Go 1.11:
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 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.
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.
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 aplicativo Hello World
Criamos um aplicativo, o Hello World, para o Go. Com ele, você tem uma ideia rápida da implantação de um aplicativo no Google Cloud Platform. Siga estas etapas para fazer o download do Hello World na máquina local.
Faça o download do aplicativo de exemplo e acesse o diretório dele:
Clone o repositório do aplicativo de exemplo Hello World:
git clone https://github.com/GoogleCloudPlatform/golang-samples
Outra opção é fazer o download do exemplo como um arquivo zip e extraí-lo.
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
Implante o aplicativo Hello World no App Engine executando o seguinte comando no diretório
golang-samples/appengine/go11x/helloworld
:gcloud app deploy
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!
Limpar
Se você quiser continuar aprendendo sobre o App Engine, armazene seu projeto do Google Cloud e acompanhe Como criar um aplicativo.
Como alternativa, é possível excluir seu projeto do Google Cloud para interromper o faturamento de todos os recursos usados nesse projeto.
- In the Google Cloud console, go to the Manage resources page.
- In the project list, select the project that you want to delete, and then click Delete.
- In the dialog, type the project ID, and then click Shut down to delete the project.
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.