Go 라이브러리 사용

App Engine Flexible Environment에서 실행 중인 인스턴스에 모든 linux/amd64 호환 패키지를 사용할 수 있습니다. 이 안내에서는 go get 명령어를 사용하여 지원되는 저장소(예: GitHub, Bitbucket, LaunchPad 등)에서 직접 패키지를 가져온다고 가정합니다.

종속성 선언 및 관리

Go 애플리케이션은 소스 파일의 디렉터리 구조를 미러링한 패키지로 구성됩니다. import 문을 사용하면 가져오기의 상대 경로가 해석됩니다. 유효한 가져오기 경로는 GOPATH에서 지정된 모든 디렉터리의 src 하위 디렉터리를 기준으로 정규화된 경로입니다.

예를 들어 다음과 같이 GOPATH가 정의되어 있습니다.

export GOPATH=/home/fred/go

예시 앱의 디렉터리에 있는 src1-1.go 파일에는 다음 가져오기 문이 포함되어 있습니다.

import "foo/bar"

그런 다음 앱을 실행하거나 배포할 때 gcloud CLI가 다음 위치에서 'foo/bar' 패키지를 찾습니다.

/home/fred/go/src/foo/bar

GOPATH에 패키지 소스를 포함하는 경우 소스 코드를 app.yaml 파일이 위치한 앱 디렉터리 또는 그 아래에 배치하지 않도록 주의해야 합니다. 그렇지 않으면 패키지가 서비스 디렉터리를 기준으로 한 상대 경로에서 1번, 정규화된 경로에서 1번 등 총 2번 로드되어 미묘한 문제가 발생할 수 있습니다. 문제를 방지하기 위해 gcloud CLI는 앱의 디렉터리와 GOPATH를 모두 검사한 후 충돌이 감지되면 오류를 보고합니다.

최상의 결과를 얻으려면 다음 사항을 따르는 것이 좋습니다.

  • 서비스마다 앱 디렉터리에 별도의 디렉터리를 만듭니다.
  • 각 서비스의 디렉토리에는 서비스의 app.yaml 파일 및 하나 이상의 .go 파일이 있어야 합니다.
  • 서비스 디렉터리에 어떠한 하위 디렉터리도 포함하지 않습니다.
  • GOPATH는 앱 디렉터리 외부에 있고 앱이 가져올 모든 종속 항목이 포함된 디렉터리를 지정해야 합니다.

필수 패키지 다운로드

go get 명령어를 사용하여 패키지를 다운로드할 수 있습니다. 예를 들어 GitHub my_repo에서 packagename을 다운로드하려면 다음 명령어를 실행합니다.

go get github.com/my_repo/packagename

App Engine에 배포

애플리케이션을 App Engine에 배포하려면 애플리케이션 코드와 함께 앱에 필요한 라이브러리를 배포해야 합니다. 자세한 내용은 애플리케이션 배포를 참조하세요.