환경 변수
요약
환경 변수를 사용하여 구성을 관리할 수 있습니다. 모든 설정의 환경 변수 이름은 config.json의 설정 이름에서 도출할 수 있습니다. 환경 변수를 사용하여 해당 라이선스를 교체하지 않고도 데이터베이스 또는 파일 구성의 라이선스를 재정의할 수 있습니다.
환경 변수를 사용하여 구성을 관리할 수 있습니다. 환경 변수는 config.json의 설정을 재정의합니다. config.json의 설정 변경이 적용되려면 재시작이 필요한 경우, 해당 환경 변수의 변경도 서버 재시작이 필요합니다.
모든 설정의 환경 변수 이름은 config.json의 설정 이름에서 도출할 수 있습니다. 예를 들어, 사이트 URL 설정의 이름을 도출하려면:
config.json에서 설정을 찾으세요. 이 경우, ServiceSettings.SiteURL입니다.- 시작 부분에
MM_을 추가하고 모든 문자를 대문자로 변환하며.을_로 바꾸세요. 예: MM_SERVICESETTINGS_SITEURL. - 설정은
export MM_SERVICESETTINGS_SITEURL="http://example.com"이 됩니다.
Note
- Mattermost가 초기화 파일에서 실행되는 경우, 환경 변수는
Environment=<>또는EnvironmentFile=<path/to/file>을 통해 설정할 수 있습니다. 두 번째 경우, 지정된 파일에는 설정할 환경 변수 목록이 포함되어 있습니다. - Mattermost v7.5부터 환경 구성 파싱은
MM_PLUGINSETTINGS_PLUGINS및MM_PLUGINSETTINGS_PLUGINSTATES에 대해 JSON을 지원합니다. 이는 모든 플러그인이 동시에 구성되는 경우 Helm 구성 파일에 특히 유용합니다. 예:MM_PLUGINSETTINGS_PLUGINSTATES="{\"com.mattermost.calls\":{\"Enable\":true},\"com.mattermost.nps\":{\"Enable\":true}}". - 환경 변수를 통해 설정이 구성된 경우, 시스템 관리자는 시스템 콘솔에서 해당 설정을 수정할 수 없습니다. 환경 변수를 통해 설정이 구성된 경우, 시스템 콘솔에서 다른 변경이 이루어지면 환경 변수의 저장된 값이 해당 설정의 값으로
config.json에 다시 기록됩니다. config.json이나 환경 변수에서 설정되지 않은 모든 설정에 대해 Mattermost 서버는 아래 이 페이지의 섹션에 설명된 설정의 기본값을 사용합니다.
Warning
- 활성 셸 내에서 설정된 Mattermost 설정의 환경 변수는 구성을 마이그레이션할 때 적용됩니다. 자세한 내용은 데이터베이스의 구성 문서를 참조하세요.
- 데이터베이스 읽기 및 검색 복제본의 데이터베이스 연결 문자열은 URL 인코딩을 사용하여 형식화해야 합니다. 잘못 형식화된 문자열은 일부 문자가 문자열을 조기에 종료하게 하여 연결 문자열이 파싱될 때 문제가 발생할 수 있습니다.
Mattermost 라이선스 파일 재정의#
환경 변수를 사용하여 해당 라이선스를 교체하지 않고도 데이터베이스 또는 파일 구성의 라이선스를 재정의할 수 있습니다. 서버를 시작할 때 라이선스 파일의 내용을 MM_LICENSE로 지정합니다.
Note
MM_LICENSE가 비어 있지 않은 문자열로 설정되어 있지만 지정된 라이선스가 유효하지 않은 경우, Mattermost 서버는 라이선스 없이 시작됩니다.
고가용성(HA) 배포에서 환경 변수를 사용하여 서버 라이선스를 재정의하면 개별 앱 서버에만 영향을 미치며 클러스터의 다른 서버에는 전파되지 않습니다.
커스텀 구성 기본값 로드#
이 커스텀 구성은 현재 서버 구성에 해당 값이 아직 없는 경우에만 적용됩니다.
- 커스텀 구성 기본값이 포함된 JSON 파일을 만드세요. 예:
custom.json. - 서버를 시작할 때 커스텀 기본값 환경 변수를 기본값 파일로 지정하세요:
MM_CUSTOM_DEFAULTS_PATH=custom.json.