Acessar serviços incluídos legados para o Go 1.12+

Nesta página, descrevemos como instalar e usar os serviços incluídos com o ambiente de execução do Go 1.12+ 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 1.12+.

Antes de começar

Como instalar o SDK de serviços do App Engine

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

  1. Atualize o arquivo app.yaml para incluir esta linha:

    app_engine_apis: true
    
  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 1.12 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
    

Considerações sobre a migração

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