Go 1.11에서 최신 Go 런타임으로 마이그레이션

이 페이지에서는 1세대에서 2세대 Go 런타임으로 마이그레이션하는 방법을 안내합니다. 지원되는 최신 Go 버전을 사용하도록 2세대 앱을 업그레이드하는 방법은 기존 애플리케이션 업그레이드를 참조하세요.

Go 1.11은 2024년 1월 30일 지원 종료되었습니다. 기존 Go 1.11 애플리케이션을 계속 실행하고 트래픽을 수신합니다. 그러나 App Engine에서 지원 종료일 이후에 런타임을 사용하는 애플리케이션의 재배포를 차단할 수 있습니다. 이 페이지의 가이드라인을 참고하여 지원되는 최신 Go 런타임으로 마이그레이션하는 것이 좋습니다.

지원되는 2세대 Go 런타임으로 마이그레이션하면 최신 언어 기능을 사용하고 관용적인 코드로 이동성이 향상된 앱을 빌드할 수 있습니다.

2세대 런타임 변경사항

지원되는 2세대 Go 런타임으로 업그레이드할 때 다음과 같은 차이점을 고려하세요.

  • 런타임 마이그레이션 노력과 복잡성이 줄어들도록 App Engine 표준 환경에서는 Memcache와 같은 2세대 런타임의 다양한 기존 번들 서비스와 API에 액세스할 수 있습니다. 2세대 Go 앱은 Go용 App Engine SDK를 통해 번들 서비스 API를 호출하고 Go 1.11 런타임과 동일한 기능 대부분에 액세스할 수 있습니다.

    기존 번들 서비스와 비슷한 기능을 제공하는 Google Cloud 제품을 사용할 수도 있습니다. 이러한 Google Cloud제품은 관용적인 Go용 Cloud 클라이언트 라이브러리를 제공합니다.Google Cloud에서 별도의 제품으로 제공되지 않는 번들 서비스의 경우(예: 이미지 처리, 검색, 메시지) 타사 제공업체 또는 다른 해결 방법을 사용할 수 있습니다.

    번들되지 않은 서비스로 마이그레이션하는 방법에 대한 자세한 내용은 번들 서비스에서 마이그레이션을 참조하세요.

  • app.yaml 구성 파일의 일부 요소 동작이 수정되었습니다. 자세한 내용은 app.yaml 파일 변경사항을 참조하세요.

  • 2세대 런타임에 로깅은 Cloud Logging의 로깅 표준을 따릅니다. 2세대 런타임에서 앱 로그는 더 이상 요청 로그와 번들로 제공되지 않고 다른 레코드로 분리됩니다. 2세대 런타임에서 로그를 읽고 쓰는 방법에 대한 자세한 내용은 로깅 가이드를 참조하세요.

메모리 사용량 차이

2세대 런타임은 1세대 런타임에 비해 메모리 사용량 기준이 더 높습니다. 이는 여러 다른 기본 이미지 버전, 두 세대 간의 메모리 사용량 계산 방법의 차이와 같은 여러 요인 때문에 발생합니다.

2세대 런타임은 애플리케이션 프로세스가 사용하는 항목의 합계 및 메모리에 동적으로 캐시된 애플리케이션 파일 수에 따라 인스턴스 메모리 사용량을 계산합니다. 메모리 사용량이 높은 애플리케이션에서 메모리 한도 초과로 인한 인스턴스 종료가 발생하지 않도록 방지하려면 메모리가 많은 더 큰 인스턴스 클래스로 업그레이드하세요.

CPU 사용량 차이

2세대 런타임은 인스턴스 콜드 스타트 시 CPU 사용량 기준이 더 높을 수 있습니다. 그 결과 애플리케이션의 확장 구성에 따라 애플리케이션이 CPU 사용률을 기준으로 확장되도록 구성된 경우 예상한 것보다 높은 인스턴스 수와 같은 의도치 않은 부작용이 발생할 수 있습니다. 이러한 문제를 방지하기 위해서는 애플리케이션 확장 구성을 검토 및 테스트해서 인스턴스 수를 적정 수준으로 유지해야 합니다.

요청 헤더 차이

1세대 런타임에서는 밑줄이 사용된 요청 헤더(예: X-Test-Foo_bar)를 애플리케이션에 전달할 수 있습니다. 2세대 런타임에는 호스트 아키텍처에 Nginx가 도입되었습니다. 이러한 변경사항으로 인해 2세대 런타임은 밑줄(_)이 있는 헤더를 자동으로 삭제하도록 구성됩니다. 애플리케이션 문제를 방지하기 위해서는 애플리케이션 요청 헤더에 밑줄을 사용하지 않아야 합니다.

app.yaml 파일의 변경사항

app.yaml 구성 파일의 일부 요소 동작이 수정되었습니다.

요소 유형 변경 설명
app_engine_apis 기존 번들 서비스를 사용하는 앱에 필요 2세대 런타임용 기존 번들 서비스에 액세스하려면 true로 설정해야 합니다.
login app_engine_apis가 true인 경우 지원됨 2세대 런타임에 기존 번들 서비스를 사용하지 않는 경우에는 다른 방법으로 사용자를 인증합니다.
runtime 수정됨 runtime 요소를 변경하여 2세대 런타임을 지정합니다.

자세한 내용은 app.yaml 참조를 확인하세요.

main 패키지 만들기

서비스는 최소 한 개 이상의 소스 파일에 package main 문을 포함해야 합니다.

App Engine 기존 번들 서비스

서비스가 2세대 런타임용 기존 번들 서비스를 사용하는 경우:

  • 서비스는 v2(google.golang.org/appengine/v2) 패키지만 사용해야 합니다. 이전 v1(google.golang.org/appengine) 패키지를 사용하면 오류가 발생합니다.

  • main() 함수에서 http.ListenAndServe() 대신 appengine.Main()을 호출합니다. 이렇게 하면 user 및 appengine API가 현재 요청 컨텍스트에 액세스할 수 있습니다.

main 패키지 작성

서비스에 아직 main 패키지가 없으면 package main 문을 추가하고 main() 함수를 작성합니다. 최소한 main() 함수가 다음을 수행해야 합니다.

  • PORT 환경 변수를 읽고 http.ListenAndServe() 함수를 호출합니다.

    port := os.Getenv("PORT")
if port == "" {
	port = "8080"
	log.Printf("Defaulting to port %s", port)
}

log.Printf("Listening on port %s", port)
if err := http.ListenAndServe(":"+port, nil); err != nil {
	log.Fatal(err)
}

HTTP 핸들러 등록

다음 옵션 중 하나를 선택하여 HTTP 핸들러를 등록할 수 있습니다.

  • 모든 http.HandleFunc() 호출을 사용 중인 패키지에서 main 패키지의 main() 함수로 직접 이동하는 것이 좋습니다.

  • 또는 애플리케이션의 패키지를 main 패키지로 가져옵니다. 이때 각 init() 함수(http.HandleFunc() 호출이 포함)가 시작 시 실행되는지 확인합니다.

    다음 bash 스크립트와 함께 http.HandleFunc() 호출을 사용하는 모든 패키지를 찾고 출력을 main 패키지의 import 블록에 복사할 수 있습니다.

    gp=$(go env GOPATH) && p=$(pwd) && pkg=${p#"$gp/src/"} && find . -name "*.go" | xargs grep "http.HandleFunc" --files-with-matches | grep -v vendor/ | grep -v '/main.go' | sed "s#\./\(.*\)/[^/]\+\.go#\t_ \"$pkg/\1\"#" | sort | uniq

파일 구조화

Go에서는 각 패키지마다 고유한 디렉터리가 있어야 합니다. 프로젝트의 app.yaml 파일에서 main:을 사용하여 main 패키지의 위치를 App Engine에 알려줄 수 있습니다. 예를 들어 앱의 파일 구조가 다음과 같습니다.

myapp/
├── app.yaml
├── foo.go
├── bar.go
└── web/
    └── main.go

app.yaml 파일에는 다음이 포함됩니다.

main: ./web # Relative filepath to the directory containing your main package.

main 플래그에 대한 자세한 내용은 app.yaml 참조를 확인하세요.

파일을 GOPATH로 이동

다음 명령어를 사용하여 GOPATH를 찾습니다.

go env GOPATH

모든 관련 파일 및 가져오기를 GOPATH로 이동합니다. import ./guestbook 등 관련 가져오기를 사용하는 경우 전체 경로(import github.com/example/myapp/guestbook)를 사용하도록 가져오기를 업데이트합니다.