# CLI 명령

**URL:** https://heroiclabs.com/docs/kr/nakama/getting-started/commands/
**Summary:** Overview of the available command-line commands available for running and administration of Nakama, including upgrade and migration.

---


# Nakama 명령

Nakama의 일상적인 운영은 최소한의 개입만 필요로 하며 간단합니다. 사용할 수 있는 Nakama 명령은 서너개며 중요한 명령은 3개입니다:

- [nakama](#nakama)
- [마이그레이션](#migrate)
- [구성 재정의](#config)

## nakama

`nakama` 명령을 단독으로 실행하면 기본 구성으로 서버가 시작됩니다. 명령줄 플래그를 사용하여 [구성 기본값(및 구성 파일 매개변수)을 재정의](#config)할 수 있습니다.

## 마이그레이션

Nakama 바이너리에는 스키마와, 기존 데이터베이스 스키마를 업그레이드하는 방법이 포함되어 있습니다. Nakama를 처음 실행하는 경우 Nakama가 상호 작용하는 데이터베이스 스키마를 설정해야 합니다. 마찬가지로 새로운 Nakama 버전이 출시되면 데이터 스키마를 새 버전의 스키마로 마이그레이션해야 합니다.

| 명령          | 설명                                                                                                                                               |
|------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------|
| `migrate up`     | Nakama에 필요한 최신 버전으로 데이터베이스 스키마를 생성하고 업데이트합니다. 기본적으로 스키마는 사용 가능한 최신 정보로 순차적으로 업데이트됩니다. |
| `migrate down`   | 데이터베이스 스키마를 요청된 버전으로 다운그레이드합니다. 기본적으로 한 번에 하나의 스키마 변경 사항을 다운그레이드합니다.                                           |
| `migrate redo`   | 하나의 스키마 변경 사항을 다운그레이드한 후 변경 사항을 다시 적용합니다.                                                                                                  |
| `migrate status` | 현재 데이터베이스에 적용된 스키마에 대한 정보와, 적용되지 않은 스키마가 있는 경우 이에 대한 정보를 제공합니다.                                            |

| 플래그              | 설명                                                                                                                                                                                           |
|--------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `database.address` | 연결할 데이터베이스 노드. `username:password@address:port/dbname`(`postgres://` 프로토콜이 경로 끝에 자동으로 추가됨) 형식을 따라야 합니다. 기본값은 `root@localhost:26257`입니다. |
| `--limit`          | `up`, `down` 또는 `redo`을(를) 실행할 때 사용할 마이그레이션 수입니다.                                                                                                                              |

<!--
## doctor

Nakama ships with a built-in diagnostic tool which is particularly useful when you need support or otherwise are looking to diagnose an issue.

Running `nakama doctor` generates a report that details the server's configuration and environment. By default, the diagnostic tool looks for a Nakama node to connect to on the local machine, but this can be changed:

| Flags   | description                                                                              |
|---------|------------------------------------------------------------------------------------------|
| `host`  | The host running the Nakama instance you want to diagnose. Default value is `127.0.0.1`. |
| `limit` | Dashboard port used by nakama. Default value is 7351.                                    |
-->

## 구성

Nakama는 [YML 구성](../configuration/) 파일을 사용하거나, 아래와 같은 명령줄 플래그를 전달하여 재정의할 수 있는 기본 구성으로 제공됩니다:

```sh
nakama --config path/to/config.yml --database.address root@localhost:26257 --database.address root@machine-2:26257
```

명령줄 플래그에 의해 구성 파일에 설정된 옵션이 재정의됩니다. 구성 파일에 의해 기본 구성 옵션이 재정의됩니다.

구성 플래그의 전체 목록은 [구성 문서](../configuration/#server-configuration)를 참조하세요.

## 버전

`version` 명령을 사용하여 Nakama 서버 인스턴스의 의미 체계 버전을 확인합니다. 예:

```sh
nakama --version
3.3.0+83fc6fbc
```

## 확인

`check` 명령은 모든 명령줄 인수를 구문 분석하여 서버가 Lua 및 Go 라이브러리 파일을 검색할 런타임 경로를 찾습니다.

## 도움말

`help` 명령을 사용하여 사용 가능한 모든 구성 플래그를 표시합니다. [구성](../configuration/) 페이지에서도 사용할 수 있습니다.

```sh
nakama --help
```