이 페이지에서는 App Engine 표준 환경용 Go 런타임에서 번들 서비스를 설치하고 사용하는 방법을 설명합니다. 앱은 Go용 App Engine 서비스 SDK를 통해 번들 서비스에 액세스할 수 있습니다.
시작하기 전에
- Go 런타임에서 호출할 수 있는 기존 번들 서비스 API 목록을 참조하세요.
- 프로젝트를 Go로 마이그레이션하기 전에 기존 번들 서비스를 사용할 때 런타임 마이그레이션 개요 및 마이그레이션 고려사항을 참조하세요.
App Engine 서비스 SDK 설치
Go에서 기존 번들 서비스 API를 호출하려면 최신 SDK를 사용해야 합니다. 다음 단계를 따르세요.
다음 줄을 포함하도록
app.yaml파일을 업데이트합니다.app_engine_apis: true다음과 같이 터미널에서
go get을 실행하여go.mod파일의 최신 SDK에 대한 참조를 추가합니다.go get google.golang.org/appengine/v2Go로 업그레이드할 때의 주요 차이점은 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 런타임으로 마이그레이션하고 앱에서 기존 번들 서비스를 사용하는 경우 다음 사항을 고려해야 합니다.
- Go 앱에서 기존 번들 서비스 기능을 테스트하려면 자주 사용하는 개발 도구(예:
go run)를 사용하여 로컬 환경에서 애플리케이션을 실행합니다. - 앱을 배포하려면
gcloud app deploy명령어를 사용합니다.