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 ou versões mais recentes, é necessário usar o SDK mais recente. Siga estas etapas:

Atualize o arquivo app.yaml para incluir esta linha:
```
app_engine_apis: true
```
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.
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.
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 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.