macOS에 Nakama 바이너리 설치하기 #
이번 튜토리얼은 macOS에서 Nakama 바이너리와 필수 요건을 설정하고 실행하는 방법에 대해서 설명합니다.
바이너리 설정을 통해 Docker 없이도 Nakama를 설치하고 관리할 수 있지만, 설정과 관리에 추가적인 단계가 필요합니다:
- CockroachDB 또는 PostgreSQL 설치하기
- 데이터베이스 마이그레이션 수동으로 적용하기
- Nakama와 데이터베이스를 새 버전으로 수동 업그레이드
- 서비스 구성 또는 Nakama와 데이터베이스 수동으로 시작하기
필수 조건 #
운영 체제 #
진행하기 전에 X86_64(64비트) 프로세서 아키텍처가 포함된 macOS 10.9(Mavericks) 이상인지 확인합니다
다음으로, 지원되는 데이터베이스 엔진을 설치합니다.
CockroachDB #
Nakama는 저장소 엔진에 최적화된 쿼리를 포함하는 CockroachDB v20.0 이상을 공식적으로 지원합니다.
공식적으로 지원되는 메서드를 통해 CockroachDB를 설치합니다:
- Homebrew
- 바이너리
- 소스에서 빌드
PostgreSQL #
Nakama는 개발 환경을 위해서 PostgreSQL 9.6 이상을 비공식적으로 지원합니다.
다음을 통해서 PostgreSQL을 설치합니다:
Nakama 다운로드 #
MacOS용 Nakama 서버 최신 바이너리 얻기:
- Nakama GitHub 리포지토리 출시 페이지에서 다운로드합니다.
- 아카이브를 추출하고 이름을 지정한 후에 적절한 위치로 폴더를 이동합니다.
Nakama 실행 #
Nakama 서버를 시작하기 전에 다음을 실행해야 합니다:
- 선택한 데이터베이스, CockroachDB 또는 PostgreSQL을 실행합니다.
- Nakama를 처음 실행하거나 버전을 업그레이드한 경우, Nakama 데이터베이스 마이그레이션을 실행합니다.
Nakama 마이그레이션 #
Nakama를 처음 실행하거나 버전을 업그레이드한 경우, Nakama 데이터베이스 마이그레이션을 실행해야 할 수도 있습니다. 확실하지 않으면 마이그레이션을 다시 실행하는 것이 안전합니다.
기본 구성으로 CockroachDB를 실행하는 경우, 마이그레이션을 추가 옵션 없이 간단하게 실행할 수 있습니다.
PosgreSQL을 사용하는 경우, 데이터베이스 서버 주소, 사용자, 비밀번호를 입력해야 합니다.
Nakama 마이그레이션을 실행하려면 Nakama 디렉터리로 이동해서 다음을 실행합니다:
CockroachDB
|
|
PostgreSQL
|
|
Nakama 서버 #
CockroachDB 또는 PostgreSQL을 통해 Nakama 서버를 시작하려면 Nakama 디렉터리로 이동하여 다음을 실행합니다:
CockroachDB
|
|
PostgreSQL
|
|
Nakama PostgreSQL 데이터베이스 마이그레이션을 실행할 때 사용했던 동일한 database.address
값을 입력해야 합니다.
Nakama Console #
브라우저에서 127.0.0.1:7351
로 이동하여 Nakama Console에 액세스할 수 있습니다:
로그인 알림이 표시되면 기본 자격 증명은 admin:password
입니다. 구성 파일 또는 명령 라인 플래그를 통해 변경할 수 있습니다.
구성 파일 #
Nakama 서버를 사용자 지정으로 설정하기 위해서 여러 구성 옵션을 사용할 수 있습니다.
다음 단계 #
Nakama 서버가 원하는 구성으로 실행중인 경우, 원하는 클라이언트 SDK로 시작할 수 있습니다.