이 페이지에서는 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/v2
Go로 업그레이드할 때의 주요 차이점은 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
명령어를 사용합니다.