트래픽 마이그레이션

트래픽 이전은 애플리케이션의 서비스 내에서 여러 버전 간에 요청 라우팅을 전환하여 하나 이상의 버전에서 새로운 단일 버전으로 트래픽을 이동하는 기능입니다.

여러 앱 버전 간의 트래픽 분할에 대한 자세한 내용은 트래픽 분할을 참조하세요.

시작하기 전에

특정 버전에 대한 트래픽을 구성하려면 먼저 사용자 계정에 필수 권한이 있는지 확인합니다.

점진적인 트래픽 마이그레이션

표준 환경에서는 대상 버전으로의 라우팅 시점을 즉시 라우팅이나 점진적 라우팅 중 선택할 수 있습니다.

기본적으로 준비 요청은 사용 중지되며 트래픽이 즉시 해당 버전으로 마이그레이션됩니다.

버전으로 트래픽을 점진적으로 마이그레이션하려는 경우 준비 요청을 사용 설정할 수 있습니다. 인스턴스 실행 없이 새 버전으로 바로 트래픽 마이그레이션을 하면 로딩 요청의 지연 시간이 급증합니다. 기존 버전과 동일한 이름으로 새 버전을 배포하면 즉시 트래픽 마이그레이션이 수행됩니다. 이때 기존 버전의 모든 인스턴스는 즉시 종료되며 새 버전을 위한 요청 로드로 인해 지연 시간이 급증합니다.

준비 요청을 사용 설정한 경우에는 트래픽을 즉시 마이그레이션하도록 지정해야 다른 환경에 상주하는 버전 간의 트래픽 마이그레이션이 가능합니다.

애플리케이션에 준비 요청 추가

준비 요청을 사용 설정하면 새 인스턴스에서 사용자 요청 수신이 있기 전에 준비 요청을 해당 인스턴스로 보내서 점진적으로 트래픽이 마이그레이션됩니다. 준비 요청을 사용하면 현재 트래픽을 수신하는 버전에서 해당 요청을 처리할 수 있으므로 사용자 응답 시간이 개선되지만, 새 인스턴스가 생성되는 동안 새 버전으로 트래픽을 마이그레이션하는 데 약간의 시간이 걸릴 수 있습니다.

준비 요청을 사용 설정하지 않으면 새 인스턴스가 생성되기 전에 사용자 요청이 새 인스턴스로 전송됩니다. 새 인스턴스를 만들고 애플리케이션을 로드하는 과정에서 초래되는 지연으로 인해 사용자 응답에 지연 시간이 발생할 수 있습니다.

지연을 방지하고 준비 요청을 사용 설정하려면 애플리케이션을 App Engine에 배포하기 전에 구성 파일에 inbound_services 요소를 포함시킵니다.

예를 들어 app.yaml 파일에 다음 내용을 포함한 후 App Engine에 배포합니다.

inbound_services:
- warmup

준비 요청 사용에 대한 자세한 내용은 준비 요청을 구성하여 성능 개선을 참조하세요.

새 버전으로 트래픽 마이그레이션

콘솔

Console에서 트래픽을 마이그레이션하려면 버전 페이지로 이동합니다.

버전 페이지로 이동

  1. 트래픽을 모두 마이그레이션할 대상 버전을 선택합니다.
  2. 트래픽 마이그레이션을 클릭합니다.
  3. 선택사항: 준비 요청을 사용 설정하면 트래픽이 점진적으로 마이그레이션됩니다. 트래픽을 즉시 마이그레이션하려면 고급 옵션 보기 섹션에 있는 옵션을 선택합니다.

gcloud

Google Cloud CLI를 설치한 후 gcloud app services set-traffic 명령어를 실행하여 모든 트래픽을 단일 버전으로 마이그레이션합니다. 예를 들면 다음과 같습니다.

  • 트래픽을 즉시 마이그레이션하려면 다음을 실행합니다.
    gcloud app services set-traffic [MY_SERVICE] --splits [MY_VERSION]=1
  • 트래픽을 점진적으로 마이그레이션하려면 선택사항인 --migrate 플래그를 포함합니다.
    gcloud app services set-traffic [MY_SERVICE] --splits [MY_VERSION]=1 --migrate

API

트래픽을 프로그래매틱 방식으로 마이그레이션하려면 Admin API를 사용하면 됩니다. 자세한 내용은 트래픽 마이그레이션 및 분할을 참조하세요.