Go 1.12+용 기존 번들 서비스 액세스

이 페이지에서는 App Engine 표준 환경용 Go 1.12 이상 런타임에서 번들 서비스를 설치하고 사용하는 방법을 설명합니다. 앱은 Go 1.12+용 App Engine 서비스 SDK를 통해 번들 서비스에 액세스할 수 있습니다.

시작하기 전에

Go 1.12 이상 런타임에서 호출할 수 있는 기존 번들 서비스 API 목록을 참조하세요.
Go 1.12 이상으로 마이그레이션 프로젝트를 시작하기 전에 기존 번들 서비스를 사용할 때 런타임 마이그레이션 개요 및 마이그레이션 고려사항을 참조하세요.

Go 1.12 이상에서 기존 번들 서비스 API를 호출하려면 최신 SDK를 사용해야 합니다. 다음 단계를 따르세요.

다음 줄을 포함하도록 app.yaml 파일을 업데이트합니다.
```
app_engine_apis: true
```
다음과 같이 터미널에서 go get을 실행하여 go.mod 파일의 최신 SDK에 대한 참조를 추가합니다.
```
go get google.golang.org/appengine/v2
```
Go 1.12+로 업그레이드할 때의 주요 차이점은 App Engine 서비스 SDK v2를 사용한다는 것입니다.
앱에서 이전 패키지 이름에 /v2/를 삽입하여 가져오기 문을 수정합니다. 예를 들어 Memcache를 사용하는 경우 다음을 수행합니다.
```
import (
  "google.golang.org/appengine/v2"
  "google.golang.org/appengine/v2/memcache"
)
```
사용 가능한 전체 패키지 이름 목록은 기존 번들 서비스 API 참조 문서를 확인하세요.
go mod tidy를 실행하여 go.mod 파일의 참조를 정리합니다.
```
go mod tidy
```

Go 1.12 이상 런타임으로 마이그레이션하고 앱에서 기존 번들 서비스를 사용하는 경우 다음 사항을 고려해야 합니다.

Go 1.12 이상 앱에서 기존 번들 서비스 기능을 테스트하려면 자주 사용하는 개발 도구(예: go run)를 사용하여 로컬 환경에서 애플리케이션을 실행합니다.
앱을 배포하려면 gcloud app deploy 명령어를 사용합니다.