GS2-Freeze API 레퍼런스

GS2 마이크로서비스의 버전을 고정하기 위한 인터페이스를 제공하는 마이크로서비스

GS2는 매일 업데이트되며, 이러한 업데이트로 인한 영향을 최소화하기 위해 코드베이스를 고정하는 기능을 제공합니다.
본 마이크로서비스를 통해 버전을 고정하는 기능을 제공하지만, 결함 수정이나 취약점 대응과 같은 지원은 최신 코드베이스와의 차이(diff)로만 제공됩니다.
따라서 본 기능을 이용하더라도 최소 한 달에 한 번(매주 권장)은 최신 코드베이스를 따라가시기 바랍니다.

GS2-Freeze 의 핵심이 되는 개념이 “스테이지 (Stage)” 입니다.
스테이지는 “특정 시점에 고정된 GS2 마이크로서비스 버전의 집합” 을 나타냅니다.

게임의 클라이언트·서버는 이용하고자 하는 스테이지를 지정하여 GS2 의 API 를 호출함으로써, 해당 스테이지에 고정된 버전의 마이크로서비스를 이용할 수 있습니다.

스테이지의 버전을 업데이트하는 조작을 “프로모트 (Promote)” 라고 부릅니다.
프로모트를 실행하면 소스 스테이지에 고정되어 있는 버전이 대상 스테이지로 복사됩니다.
예를 들어 “staging 스테이지의 버전을 production 스테이지로 프로모트한다” 와 같은 방식으로 검증이 완료된 버전을 본번에 반영할 수 있습니다.

프로모트 후에 문제가 발견된 경우에는 “롤백 (Rollback)” 을 실행하여 직전 버전으로 되돌릴 수 있습니다.

sortNumber 를 이용함으로써, 여러 스테이지를 “개발”, “스테이징”, “본번” 과 같은 계층으로 나열할 수 있습니다.
정렬 순서는 매니지먼트 콘솔 상의 표시 순서나, 프로모트 대상을 선택할 때의 참고 정보로 사용됩니다.