CLI 명령어를 실행하려면 Mattermost 루트 디렉토리에 있어야 합니다. Mattermost 기본 설치의 경우 루트 디렉토리는 /opt/mattermost 입니다. 표준 설치 프로세스 를 따른 경우 mattermost 사용자로 명령어를 실행해야 합니다. 실행 파일 이름은 mattermost 이며 /opt/mattermost/bin 디렉토리에 있습니다.
예를 들어, Mattermost 기본 설치에서 버전을 확인하려면:
cd /opt/mattermost/
sudo -u mattermost bin/mattermost version
Note
- Mattermost 바이너리는 반드시 ``mattermost`` 사용자로 실행해야 합니다. ``root`` 사용자로 실행하면(예시) 바이너리가 CLI 명령 실행 시 플러그인을 초기화하고 다양한 파일에 접근하므로 권한 관련 문제가 발생할 수 있습니다. ``root`` 로 서버를 실행하면 플러그인 및 파일의 소유권이 변경되거나 기타 권한 오류가 발생할 수 있습니다.
- 데이터베이스에 구성이 저장된 Mattermost 설치에서 CLI 명령어를 실행할 경우 다음과 같이 데이터베이스 연결 문자열을 전달해야 할 수 있습니다:
GitLab Omnibus에서는 CLI 명령어 실행 시 다음 디렉토리에 있어야 합니다: /opt/gitlab/embedded/service/mattermost. 또한 mattermost 사용자로 명령어를 실행하고 구성 파일 위치를 지정해야 합니다. 실행 파일은 /opt/gitlab/embedded/bin/mattermost 입니다.
예를 들어, GitLab Omnibus에서 Mattermost 버전을 확인하려면:
cd /opt/gitlab/embedded/service/mattermost
sudo /opt/gitlab/embedded/bin/chpst -e /opt/gitlab/etc/mattermost/env -P -U mattermost:mattermost -u mattermost:mattermost /opt/gitlab/embedded/bin/mattermost version
Note
이 문서의 예제 명령어는 Mattermost 기본 설치 기준입니다. GitLab Omnibus에서 동작하도록 명령어를 수정해야 합니다.
Docker 설치에서는 /mattermost/bin 디렉토리가 PATH 에 추가되어 있어 docker exec 명령어로 CLI를 직접 사용할 수 있습니다. docker-compose.yml 로 Mattermost를 설치한 경우 컨테이너 이름이 mattermostdocker_app_1 일 수 있습니다.
예를 들어, Docker 설치에서 Mattermost 버전을 확인하려면:
docker exec -it <your-mattermost-container-name> mattermost version
-c, --config {string} 사용할 구성 파일 (기본값 "config.json")
--disableconfigwatch {boolean} true인 경우 다른 프로세스가 변경해도 config.json 파일이 자동으로 다시 로드되지 않음 (기본값 "false")
주어진 데이터 소스 이름(DSN)에 대한 데이터베이스를 초기화하고, 마이그레이션을 실행하며, 지정된 경우 사용자 정의 기본값을 로드합니다.
형식
mattermost db init
예시
config 플래그를 사용해 DSN을 전달합니다:
mattermost db init --config postgres://localhost/mattermost
``MM_CONFIG`` 환경 변수를 사용하려면 이 명령어를 실행합니다:
MM_CONFIG=postgres://localhost/mattermost mattermost db init
데이터베이스에 로드할 사용자 정의 기본값 파일을 설정하려면 이 명령어를 실행합니다:
MM_CUSTOM_DEFAULTS_PATH=custom.json MM_CONFIG=postgres://localhost/mattermost mattermost db init</code></pre>
<h3 id="mattermost-db-migrate">mattermost db migrate</h3>
<p>설명
적용되지 않은 마이그레이션이 있는 경우 데이터베이스 스키마를 마이그레이션합니다.
하위 명령어
mattermost db downgrade - 데이터베이스 마이그레이션 롤백.
형식
mattermost db migrate
예시
mattermost db migrate
옵션
--auto-recover bool 마이그레이션 계획이 마이그레이션 중에 오류를 수신하면 이 명령어가 계획 내에서 이미 적용된 마이그레이션을 롤백하려 시도합니다. --save-plan 및 --dry-run 옵션을 결합해 마이그레이션 계획을 검토하지 않는 한 권장하지 않습니다.
--save-plan bool 향후 계획 검토나 다운그레이드에 사용할 수 있도록 마이그레이션 계획을 파일 스토어에 저장합니다.
--dry-run bool 마이그레이션을 적용하지 않지만 주어진 조건에 따라 마이그레이션이 어떻게 실행될지 유효성을 검사합니다.
CLI 명령어를 실행하려면 Mattermost 루트 디렉토리에 있어야 합니다. Mattermost 기본 설치의 경우 루트 디렉토리는 /opt/mattermost 입니다. 표준 설치 프로세스 를 따른 경우 mattermost 사용자로 명령어를 실행해야 합니다. 실행 파일 이름은 mattermost 이며 /opt/mattermost/bin 디렉토리에 있습니다.
예를 들어, Mattermost 기본 설치에서 버전을 확인하려면:
cd /opt/mattermost/
sudo -u mattermost bin/mattermost version
Note
- Mattermost 바이너리는 반드시 ``mattermost`` 사용자로 실행해야 합니다. ``root`` 사용자로 실행하면(예시) 바이너리가 CLI 명령 실행 시 플러그인을 초기화하고 다양한 파일에 접근하므로 권한 관련 문제가 발생할 수 있습니다. ``root`` 로 서버를 실행하면 플러그인 및 파일의 소유권이 변경되거나 기타 권한 오류가 발생할 수 있습니다.
- 데이터베이스에 구성이 저장된 Mattermost 설치에서 CLI 명령어를 실행할 경우 다음과 같이 데이터베이스 연결 문자열을 전달해야 할 수 있습니다:
GitLab Omnibus에서는 CLI 명령어 실행 시 다음 디렉토리에 있어야 합니다: /opt/gitlab/embedded/service/mattermost. 또한 mattermost 사용자로 명령어를 실행하고 구성 파일 위치를 지정해야 합니다. 실행 파일은 /opt/gitlab/embedded/bin/mattermost 입니다.
예를 들어, GitLab Omnibus에서 Mattermost 버전을 확인하려면:
cd /opt/gitlab/embedded/service/mattermost
sudo /opt/gitlab/embedded/bin/chpst -e /opt/gitlab/etc/mattermost/env -P -U mattermost:mattermost -u mattermost:mattermost /opt/gitlab/embedded/bin/mattermost version
Note
이 문서의 예제 명령어는 Mattermost 기본 설치 기준입니다. GitLab Omnibus에서 동작하도록 명령어를 수정해야 합니다.
Docker 설치에서는 /mattermost/bin 디렉토리가 PATH 에 추가되어 있어 docker exec 명령어로 CLI를 직접 사용할 수 있습니다. docker-compose.yml 로 Mattermost를 설치한 경우 컨테이너 이름이 mattermostdocker_app_1 일 수 있습니다.
예를 들어, Docker 설치에서 Mattermost 버전을 확인하려면:
docker exec -it <your-mattermost-container-name> mattermost version
-c, --config {string} 사용할 구성 파일 (기본값 "config.json")
--disableconfigwatch {boolean} true인 경우 다른 프로세스가 변경해도 config.json 파일이 자동으로 다시 로드되지 않음 (기본값 "false")
주어진 데이터 소스 이름(DSN)에 대한 데이터베이스를 초기화하고, 마이그레이션을 실행하며, 지정된 경우 사용자 정의 기본값을 로드합니다.
형식
mattermost db init
예시
config 플래그를 사용해 DSN을 전달합니다:
mattermost db init --config postgres://localhost/mattermost
``MM_CONFIG`` 환경 변수를 사용하려면 이 명령어를 실행합니다:
MM_CONFIG=postgres://localhost/mattermost mattermost db init
데이터베이스에 로드할 사용자 정의 기본값 파일을 설정하려면 이 명령어를 실행합니다:
MM_CUSTOM_DEFAULTS_PATH=custom.json MM_CONFIG=postgres://localhost/mattermost mattermost db init</code></pre>
<h3 id="mattermost-db-migrate">mattermost db migrate</h3>
<p>설명
적용되지 않은 마이그레이션이 있는 경우 데이터베이스 스키마를 마이그레이션합니다.
하위 명령어
mattermost db downgrade - 데이터베이스 마이그레이션 롤백.
형식
mattermost db migrate
예시
mattermost db migrate
옵션
--auto-recover bool 마이그레이션 계획이 마이그레이션 중에 오류를 수신하면 이 명령어가 계획 내에서 이미 적용된 마이그레이션을 롤백하려 시도합니다. --save-plan 및 --dry-run 옵션을 결합해 마이그레이션 계획을 검토하지 않는 한 권장하지 않습니다.
--save-plan bool 향후 계획 검토나 다운그레이드에 사용할 수 있도록 마이그레이션 계획을 파일 스토어에 저장합니다.
--dry-run bool 마이그레이션을 적용하지 않지만 주어진 조건에 따라 마이그레이션이 어떻게 실행될지 유효성을 검사합니다.
