Acessar serviços incluídos legados para o Go

Nesta página, descrevemos como instalar e usar os serviços incluídos com o ambiente de execução do Go no ambiente padrão do App Engine. O aplicativo pode acessar os serviços incluídos pelo SDK de serviços do App Engine para Go.

Antes de começar

• Consulte a lista de APIs de serviços legados agrupados que podem ser chamados no ambiente de execução do Go.
• Antes de iniciar um projeto de migração para o Go, consulte a visão geral da migração no ambiente de execução e as considerações sobre migração ao usar os serviços incluídos legados.

Como instalar o SDK de serviços do App Engine

Para chamar as APIs legadas de serviços incluídos com o Go, é necessário usar o SDK mais recente. Siga estas etapas:

1. Atualize o arquivo app.yaml para especificar um ou mais serviços legados incluídos. Exemplo:

   app_engine_bundled_services:
   - datastore_v3
   - memcache
   - user
   

   Se você usar recursos como login: admin na seção handlers do arquivo app.yaml, ative a API Users configurando a definição user na lista app_engine_bundled_services.

2. Adicione uma referência ao SDK mais recente no go.mod executando go get no terminal da seguinte maneira:

   go get google.golang.org/appengine/v2
   

   A principal diferença ao fazer upgrade para o Go ou versões mais recente é usar a v2 do SDK de serviços do App Engine.

3. No app, modifique as instruções de importação inserindo /v2/ nos nomes de pacotes antigos. Por exemplo, se você estiver usando o Memcache, faça o seguinte:

   import (
     "google.golang.org/appengine/v2"
     "google.golang.org/appengine/v2/memcache"
   )
   

   Para ver a lista completa de nomes de pacotes disponíveis, consulte a documentação de referências da API de serviços legados em pacote.

4. Execute go mod tidy para limpar as referências no arquivo go.mod.

   go mod tidy
   

Observação: ao fazer upgrade para uma nova versão principal de uma dependência do Go, como um pacote ou uma biblioteca, inclua o número da versão principal da dependência nas instruções de importação. Se você executar go mod tidy e descobrir que ele ainda está importando uma versão mais antiga do SDK dos serviços do App Engine para Go, provavelmente perdeu o upgrade de uma instrução de importação.

Considerações sobre a migração

Esteja ciente das seguintes considerações se você estiver migrando para o ambiente de execução do Go e se o aplicativo usar serviços incluídos legados:

• Para testar a funcionalidade dos serviços incluídos legados no aplicativo Go, execute o aplicativo no ambiente local com as ferramentas de desenvolvimento que você costuma usar, como go run.
• Para implantar o aplicativo, use o comando gcloud app deploy.