Guia de início rápido do Go 1.11 no ambiente padrão do App Engine

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 o aplicativo no Google Cloud Platform.

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

Antes de executar e implantar este início rápido, instale o SDK do Cloud e, em seguida, configure um projeto do GCP para o App Engine:

  1. Faça o download e instale o SDK do Cloud:

    Fazer o download do SDK

    Observação: se o SDK do Cloud já estiver instalado, atualize-o executando o seguinte comando:

    gcloud components update
    
  2. Crie um novo projeto:

    gcloud projects create [YOUR_PROJECT_ID] --set-as-default
    

    Verifique se o projeto foi criado:

    gcloud projects describe [YOUR_PROJECT_ID]
    

    Você verá detalhes do projeto parecidos com o seguinte:

    createTime: year-month-hour
    lifecycleState: ACTIVE
    name: project-name
    parent:
    id: '433637338589'
    type: organization
    projectId: project-name-id
    projectNumber: 499227785679
    
  3. Inicialize seu aplicativo do App Engine com o projeto e escolha a região dele:

    gcloud app create --project=[YOUR_PROJECT_ID]
    

    Quando solicitado, selecione a região em que o aplicativo do App Engine será armazenado.

  4. Verifique se o faturamento está ativado no projeto. Uma conta de faturamento precisa estar vinculada ao projeto para que o aplicativo seja implantado no App Engine.

    Ativar faturamento

  5. Instale os seguintes pré-requisitos:

    • 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

Como o App Engine é regional, a infraestrutura de execução dos apps está em uma determinada região e é gerenciada pelo Google. Assim, ela fica 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 seus aplicativos. Em geral, você escolhe a região mais próxima dos usuários do aplicativo. No entanto, pense também no local dos outros produtos e serviços do GCP utilizados pelo aplicativo. O uso de serviços em vários locais pode afetar a latência e o preço do seu aplicativo.

O App Engine está disponível nas seguintes regiões:

  • northamerica-northeast1 (Montreal)
  • us-central (Iowa)
  • us-west2 (Los Angeles)
  • us-east1 (Carolina do Sul)
  • us-east4 (Virgínia do Norte)
  • southamerica-east1 (São Paulo)
  • europe-west (Bélgica)
  • europe-west2 (Londres)
  • europe-west3 (Frankfurt)
  • europe-west6 (Zurique)
  • asia-northeast1 (Tóquio)
  • asia-northeast2 (Osaka)
  • asia-east2 (Hong Kong)
  • asia-south1 (Mumbai)
  • australia-southeast1 (Sydney)

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

Se você já tiver criado um aplicativo do App Engine, para ver a região, execute o comando gcloud app describe ou abra o Painel do App Engine no Console do GCP. A região do seu aplicativo do App Engine será listada em http://[YOUR_PROJECT_ID].appspot.com.

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:

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

    go get -u -d github.com/GoogleCloudPlatform/golang-samples
    

    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 $GOPATH/src/github.com/GoogleCloudPlatform/golang-samples/appengine/go11x/helloworld
    

Como implantar o Hello World no App Engine

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

    gcloud app deploy
    
  2. Veja o aplicativo ativo em https://[YOUR_PROJECT_ID].appspot.com:

    gcloud app browse
    

Agora, a mensagem Hello, world! é enviada por um servidor da Web em execução 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 saber mais sobre o App Engine, é possível manter seu projeto do GCP e acompanhar os procedimentos em Como criar um app.

Ou então, você pode excluir seu projeto do GCP para interromper o faturamento de todos os recursos usados nele.

  1. No Console do GCP, acesse a página "Projetos".

    Acessar a página Projetos

  2. Na lista de projetos, selecione um e clique em Excluir projeto.
  3. Na caixa de diálogo, digite o código 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.

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Documentação do ambiente padrão do Google App Engine para Go 1.11