Linux에 대한 Nakama 바이너리 #

이번 튜토리얼은 Linux에서 Nakama 바이너리와 필수 요건을 설정하고 실행하는 방법에 대해서 설명합니다.

바이너리 설정을 통해 Docker 없이도 Nakama를 설치하고 관리할 수 있지만, 설정과 관리에 추가적인 단계가 필요합니다.

  • CockroachDB 또는 PostgreSQL 설치하기
  • 데이터베이스 마이그레이션 수동으로 적용하기
  • Nakama와 데이터베이스를 새 버전으로 수동 업그레이드
  • 서비스 구성 또는 Nakama와 데이터베이스 수동으로 시작하기

필수 조건 #

운영 체제 #

진행하기 전에 X86_64 (64bit) Linux 배포가 실행되고 있는지 확인합니다.

다음으로, 지원되는 데이터베이스 엔진을 설치합니다.

CockroachDB #

Nakama는 저장소 엔진에 최적화된 쿼리를 포함하는 CockroachDB v20.0 이상을 공식적으로 지원합니다.

공식적으로 지원되는 메서드를 통해 CockroachDB를 설치합니다:

  • 바이너리
  • 소스에서 빌드

PostgreSQL #

Nakama는 개발 환경을 위해서 PostgreSQL 9.6 이상을 비공식적으로 지원합니다.

다음을 통해서 PostgreSQL을 설치합니다:

  • Debian, Red Hat/CentOS, Suse 및 Ubuntu에 대한 공식 패키지
  • 소스에서 빌드

Nakama 다운로드 #

Nakama 서버 최신 바이너리 얻기:

  1. Nakama GitHub 리포지토리 출시 페이지에서 다운로드합니다.
  2. 아카이브를 추출하고 이름을 지정한 후에 적절한 위치로 폴더를 이동합니다.

Nakama 실행 #

Nakama 서버를 시작하기 전에 다음을 실행해야 합니다:

  1. 선택한 데이터베이스, CockroachDB 또는 PostgreSQL을 실행합니다.
  2. Nakama를 처음 실행하거나 버전을 업그레이드한 경우, Nakama 데이터베이스 마이그레이션을 실행합니다.

Nakama 마이그레이션 #

Nakama를 처음 실행하거나 버전을 업그레이드한 경우, Nakama 데이터베이스 마이그레이션을 실행해야 할 수도 있습니다. 확실하지 않으면 마이그레이션을 다시 실행하는 것이 안전합니다.

기본 구성으로 CockroachDB를 실행하는 경우, 마이그레이션을 추가 옵션 없이 간단하게 실행할 수 있습니다.

PosgreSQL을 사용하는 경우, 데이터베이스 서버 주소, 사용자, 비밀번호를 입력해야 합니다.

Nakama 마이그레이션을 실행하려면 Nakama 디렉터리로 이동해서 다음을 실행합니다:

CockroachDB

1

./nakama migrate up

PostgreSQL

1

./nakama migrate up --database.address postgres:password@127.0.0.1:5432

Nakama 서버 #

CockroachDB 또는 PostgreSQL을 통해 Nakama 서버를 시작하려면 Nakama 디렉터리로 이동하여 다음을 실행합니다:

CockroachDB

1

./nakama

PostgreSQL

1

./nakama --database.address postgres:password@127.0.0.1:5432

Nakama PostgreSQL 데이터베이스 마이그레이션을 실행할 때 사용했던 동일한 database.address 값을 입력해야 합니다:

systemd #

Nakama를 서비스로 실행하기를 원하고 systemd를 사용하는 distro를 실행하려면, 다음 스크립트를 사용할 수 있습니다. systemd 구성 내에서 Nakama 경로를 사용해야 합니다.

다음 컨텐츠로 서비스 파일 /usr/lib/systemd/system/nakama.service을 생성합니다:

nakama.service

1
2
3
4
5
6
7
8
9

[Unit]
Description=Nakama server

[Service]
ExecStart=/path/to/nakama --config /path/to/nakama/config.yml
KillMode=process

[Install]
WantedBy=multi-user.target

systemd daemon 프로세스에서 읽을 수 있도록 파일 권한을 업데이트합니다:

1

sudo chmod 644 /usr/lib/systemd/system/nakama.service

Enable and run the service:

1
2

sudo systemctl enable nakama
sudo systemctl start nakama

Nakama Console #

브라우저에서 127.0.0.1:7351로 이동하여 Nakama Console에 액세스할 수 있습니다.

Nakama console
Nakama console

로그인 알림이 표시되면 기본 자격 증명은 admin:password입니다. 구성 파일 또는 명령 라인 플래그를 통해 변경할 수 있습니다.

구성 파일 #

Nakama 서버를 사용자 지정으로 설정하기 위해서 여러 구성 옵션을 사용할 수 있습니다.

다음 단계 #

Nakama 서버가 원하는 구성으로 실행중인 경우, 원하는 클라이언트 SDK로 시작할 수 있습니다.

Related Pages