App Engine 가변형 환경에서 실행 중인 인스턴스에 모든 linux/amd64 호환 패키지를 사용할 수 있습니다. 이 안내에서는 go get 명령어를 사용하여 지원되는 저장소(예: GitHub, Bitbucket, LaunchPad 등)에서 직접 패키지를 가져온다고 가정합니다.
Go 버전 1.22 이상부터 다음과 같은 사항이 적용됩니다.
기존
GOPATH모드(GO111MODULE=off)의 모듈 외부에서go get을 사용할 수 없습니다. 자세한 내용은 도구를 참조하세요.Go에서는 종속 항목 관리에
go.mod파일을 사용하는 것이 좋습니다. 배포 중에 종속 항목을 설치하려면go.mod파일을app.yaml파일과 동일한 폴더에 포함합니다. Go 버전 및 공급업체 디렉터리의 종속 항목 관리에 대한 자세한 내용은 GOPATH 및 모듈을 참조하세요.
종속 항목 선언 및 관리
Go 애플리케이션은 소스 파일의 디렉터리 구조를 그대로 반영한 패키지로 구성됩니다. import 문을 사용하면 가져오기의 상대 경로가 해석됩니다. 유효한 가져오기 경로는 GOPATH에서 지정된 모든 디렉터리의 src 하위 디렉터리를 기준으로 정규화된 경로입니다.
예를 들어 다음을 정의하는 예시 앱을 살펴보겠습니다.
GOPATH모듈:export GOPATH=/home/fred/go.src1-1.go파일:import "foo/bar"gcloud CLI는 앱을 실행하거나 배포할 때
/home/fred/go/src/foo/bar위치에서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에 배포하려면 애플리케이션 코드와 함께 앱에 필요한 라이브러리를 배포해야 합니다. 자세한 내용은 애플리케이션 테스트 및 배포를 참고하세요.