Nakama 업그레이드 #

Nakama를 새 버전으로 업그레이드할 경우, 세 가지 작업을 먼저 수행해야 합니다:

• 버전에서 특정한 업그레이드 요건이 있는 경우 릴리스 정보를 확인합니다.
• 새로운 Nakama 버전에서 지원되는 포맷으로 데이터를 마이그레이션합니다.
• 실행 중인 클라이언트 버전이 배포된 서버와 호환되는지 확인합니다.

Docker #

Nakama 또는 CockroachDB에서 새로운 버전이 출시됨에 따라 업그레이드가 필요할 수도 있습니다. Docker를 사용하면 컨테이너 이미지의 새로운 버전을 적용할 수 있기 때문에 업그레이드를 쉽게 할 수 있습니다. Nakama의 새로운 버전으로 업그레이드하는 경우, docker-compose.yml의 프로세스에서 데이터가 새로운 데이터베이스 스키마로 자동으로 마이그레이션됩니다.

가장 최신의 Nakama 이미지를 사용하여 Docker Compose로 데이터 마이그레이션을 실시할 수 있습니다.

1
2
3

docker-compose down # top and remove both the Nakama and CockroachDB containers
docker pull heroiclabs/nakama # download the latest Nakama image
docker-compose up # start the containers (both Nakama and CockroachDB) as fresh installs

이와 유사하게, CockroachDB 컨테이너를 아래와 같이 업데이트할 수 있습니다.

1

docker pull cockroachdb/cockroach # download the latest CockroachDB image

데이터베이스 스키마 마이그레이션을 명시적으로 실시하려면 다음 명령을 발행합니다:

1

docker run heroiclabs/nakama migrate up

수동 업그레이드 #

아래의 설명에 따라 한 개의 노드 또는 전체 클러스터를 Nakama의 최신 버전으로 업그레이드할 수 있습니다.

클러스터의 각 노드에서 다음을 수행합니다:

Nakama를 정지합니다. Linux 설정에서 systemd을(를) 사용하는 경우, 명령은 다음과 같습니다:

1

sudo systemctl stop nakama

CockroachDB 백업:

1

cockroach dump nakama > mydatabackup.sql --insecure

최신 릴리스를 다운로드하고 nakama 바이너리를 새로 다운로드한 항목으로 대체합니다.

다음 명령을 사용하여 데이터베이스 스키마를 업그레이드합니다:

1

nakama migrate up

같은 절차를 통해 Nakama를 다운그레이드할 수 있지만, 다음을 사용하여 마이그레이션 명령을 대체합니다:

1

nakama migrate down --limit 1

Nakama를 실행하고 업그레이드된 버전이 실행 중인지 확인합니다.

1

sudo systemctl start nakama