Aceda aos serviços incluídos antigos para o Go

Esta página descreve como instalar e usar os serviços agrupados com o tempo de execução do Go para o ambiente padrão do App Engine. A sua app pode aceder aos serviços incluídos através do SDK dos serviços do App Engine para Go.

Antes de começar

• Consulte a lista de APIs de serviços agrupados antigos que pode chamar no tempo de execução do Go.
• Antes de iniciar um projeto de migração para o Go, consulte a vista geral da migração em tempo de execução e as considerações de migração quando usar serviços agrupados antigos.

Instalar o SDK dos serviços do App Engine

Para chamar as APIs de serviços agrupados antigos com Go, tem de usar o SDK mais recente. Siga estes passos:

1. Atualize o ficheiro app.yaml para incluir a seguinte linha:

   app_engine_apis: true
   

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

   go get google.golang.org/appengine/v2
   

   A principal diferença ao atualizar para o Go é a utilização da v2 do SDK dos serviços do App Engine.

3. Na sua app, modifique as declarações de importação inserindo /v2/ nos nomes dos pacotes antigos. Por exemplo, se usar 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 agrupados antigos.

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

   go mod tidy
   

Nota: quando atualizar para uma nova versão principal de uma dependência do Go, como um pacote ou uma biblioteca, certifique-se de que inclui o número da versão principal da dependência nas suas declarações de importação. Se executar go mod tidy e verificar que ainda está a importar uma versão mais antiga do SDK dos serviços do App Engine para Go, provavelmente, não atualizou uma declaração de importação.

Considerações sobre a migração

Deve ter em atenção as seguintes considerações se estiver a migrar para o tempo de execução do Go e a sua app usar serviços agrupados antigos:

• Para testar a funcionalidade dos serviços agrupados antigos na sua app Go, execute a aplicação no seu ambiente local com as ferramentas de desenvolvimento que usa habitualmente, como go run.
• Para implementar a sua app, use o comando gcloud app deploy.