이 가이드는 Mattermost 배포를 위한 최소 소프트웨어 및 하드웨어 요구 사항을 설명합니다. 요구 사항은 사용량에 따라 달라질 수 있으며, 확장 전에 파일럿 프로젝트의 성능을 관찰하는 것을 권장합니다.

배포 개요#

이 문서에서 설명하는 소프트웨어 시스템 및 구성 요소의 요약은 애플리케이션 아키텍처 문서를 참조하세요.

소프트웨어 요구 사항#

클라이언트 소프트웨어#

데스크톱 앱#

공식적으로는 지원되지 않지만 Linux 데스크톱 앱은 RHEL/CentOS 7+에서도 실행됩니다.

Flatpak 패키지 요구 사항(Linux)

Mattermost Desktop v6.1부터 Flatpak 패키지가 Linux에서 사용 가능합니다(현재 베타). Flatpak 버전에는 다음이 필요합니다:

• 시스템에 Flatpak 런타임 설치
• Freedesktop Platform/SDK 25.08
• Electron BaseApp 25.08
• 의존성을 위한 Flathub 또는 호환 Flatpak 리포지터리 접근

Flatpak 패키지는 x86_64(Intel/AMD) 및 aarch64(ARM) 아키텍처에서 사용 가능합니다. Flatpak 버전에는 기본적으로 Wayland 디스플레이 서버 지원이 활성화되어 있습니다.

PC 웹#

*` Internet Explorer(IE11)는 더 이상 지원되지 않습니다. `Mattermost 데스크톱 앱 또는 지원되는 다른 브라우저를 사용하는 것을 권장합니다. 자세한 내용은 이 포럼 게시물 을 참조하세요.

모바일 앱#

모바일 웹#

이메일 클라이언트#

• 데스크톱 클라이언트: Outlook 2010+, Apple Mail 버전 7+, Thunderbird 38.2+
• 웹 기반 클라이언트: Entra ID, Outlook, Gmail, Yahoo, AOL
• 모바일 클라이언트: iOS Mail 앱(iOS 7+), Gmail 모바일 앱(Android, iOS)

서버 소프트웨어#

Mattermost 서버 운영 체제#

• Ubuntu, Debian Buster, CentOS 6+, CentOS 7+, RedHat Enterprise Linux 7+, Oracle Linux 6+, Oracle Linux 7+.
• Docker 호환 운영 체제(Linux 기반 OS)에서 Mattermost Docker 배포 를 사용하는 것이 여전히 권장됩니다.

Fedora, FreeBSD, Arch Linux에 대한 커뮤니티 지원이 존재하지만, Mattermost는 현재 이러한 플랫폼에 대한 프로덕션 지원을 포함하지 않습니다.

데이터베이스 소프트웨어#

• PostgreSQL 14.0+

PostgreSQL의 Amazon Aurora 동등 제품도 지원됩니다. 마이그레이션 가이드 에서 MySQL에서 PostgreSQL로 마이그레이션하는 단계, 도구 및 지원에 대해 설명합니다.

최소 PostgreSQL 데이터베이스 지원 정책

Mattermost 배포가 빠르고 안전하게 유지될 수 있도록 지원되는 PostgreSQL 최소 버전 업데이트에 관한 정책을 도입합니다. Mattermost가 지원하는 가장 오래된 PostgreSQL 버전은 PostgreSQL 커뮤니티에서 지원하는 가장 오래된 버전과 일치합니다. 이를 통해 최신 기능과 보안 업데이트의 혜택을 받을 수 있습니다.

이 정책 변경은 Mattermost v10.6부터 적용되며, 필요한 최소 PostgreSQL 버전은 PostgreSQL 13이 됩니다. 이는 각 메이저 버전에 5년간의 지원을 제공하는 PostgreSQL 커뮤니티 지원 정책과 일치합니다.

PostgreSQL 버전이 수명 종료(EOL)에 도달하면 Mattermost는 다음 예정된 ESR 릴리즈부터 더 새로운 버전을 요구합니다. 이는 다음과 같이 향후 PostgreSQL 최소 버전이 증가함을 의미합니다:

고객은 새 요구 사항이 적용되기 전에 PostgreSQL 버전을 계획, 테스트 및 업그레이드하는 데 9개월이 있습니다. 이 정책은 데이터베이스 업그레이드를 Mattermost 릴리즈 일정에 맞출 수 있도록 명확성과 투명성을 제공하는 것을 목표로 합니다. 옵션에 대해 논의하려면 Mattermost 전문가 에게 문의하세요.

데이터베이스 검색 제한 사항

일반적인 제한 사항:

• 훨씬 더 큰 파일을 업로드할 수 있더라도 파일 콘텐츠의 처음 1MB만 검색에 사용할 수 있습니다.

PostgreSQL 검색 제한 사항:

• 이메일 주소는 결과를 반환하지 않습니다.
• 대시가 포함된 사용자 이름의 해시태그 또는 최근 멘션은 검색 결과를 반환하지 않습니다.
• 대시가 포함된 용어는 검색 쿼리에서 대시가 무시되어 잘못된 결과를 반환합니다.
• PostgreSQL 자체의 제한 사항:
• 그 중 하나는: tsvector(어휘소 + 위치)의 길이는 1MB 미만이어야 합니다로, 파일 콘텐츠에 따라 1MB 미만의 콘텐츠를 가진 파일도 tsvector 제한인 1MB에 도달하면 검색 가능하지 않습니다.
• 위의 사항이 문제인 경우 엔터프라이즈 검색을 설정하고 활성화할 수 있습니다.

MySQL 지원

MySQL 데이터베이스 지원은 Mattermost v11부터 지원 중단될 예정입니다. MySQL에서 PostgreSQL로 마이그레이션하는 방법은 PostgreSQL 마이그레이션 문서를 참조하세요.

• MySQL 검색 제한 사항: 점이 포함된 사용자 이름의 해시태그 또는 최근 멘션은 검색 결과를 반환하지 않습니다.
• 마이그레이션 시스템은 스키마 마이그레이션 실행을 위해 MySQL 데이터베이스 사용자에게 추가 EXECUTE, CREATE ROUTINE, ALTER ROUTINE 및 REFERENCES 권한이 필요합니다.
• MariaDB v10+는 MySQL 5.7.12 요구 사항으로 인해 더 이상 MySQL 드롭인 대체 제품으로 작동하지 않으며, Mattermost에서 지원되지 않습니다. 이전 버전의 MariaDB는 공식적으로 지원되지 않았지만 이전 Mattermost 릴리즈에서는 작동했을 수 있습니다. 현재 MariaDB를 실행 중인 경우 MariaDB에서 MySQL 동등 제품으로 마이그레이션하는 것을 권장합니다.
• 중국어, 일본어, 한국어로 검색이 필요한 배포에는 MySQL 5.7.6+ 및 ngram 전체 텍스트 파서 구성이 필요합니다. 두 자 검색을 위해서는 ft_min_word_len 및 innodb_ft_min_token_size를 2로 설정하고 MySQL을 재시작해야 합니다. 자세한 내용은 CJK 토론 을 참조하세요.

MySQL 8.0.4에서 기본 인증 플러그인이 mysql_native_password에서 caching_sha2_password로 변경되었습니다. 따라서 MySQL 구성 파일에 다음 항목을 추가하여 mysql_native_password를 활성화해야 합니다:

[mysqld]
default-authentication-plugin=mysql_native_password

MySQL 8에서는 기본 콜레이션이 utf8mb4_0900_ai_ci로 변경되었습니다(https://dev.mysql.com/doc/mysqld-version-reference/en/optvar-changes-8-0.html). 따라서 MySQL 설치를 버전 8로 업데이트하면 새 기본 콜레이션을 사용하도록 데이터베이스 테이블을 변환해야 합니다:

ALTER TABLE table_name CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci;

이 변경 사항을 적용하지 않으면 데이터베이스의 테이블에 서로 다른 콜레이션이 생겨 쿼리 실행 시 오류가 발생할 수 있습니다.

MySQL 버전 8.0.0 - 8.0.11에서 ADMIN은 예약 키워드이므로 MySQL 요구 사항이 버전 8.0.12인 이유입니다.

MySQL 8.0.22에는 문자열 값을 정수로 변경하는 JSON 칼럼 유형의 문제 가 있어 Mattermost가 제대로 작동하지 않습니다. 이 데이터베이스 버전은 사용하지 않는 것을 권장합니다.

하드웨어 요구 사항#

CPU, RAM 및 스토리지 공간 사용량은 사용자 행동에 따라 크게 달라질 수 있습니다. 이 하드웨어 권장 사항은 전통적인 배포를 기반으로 하며, 사용자 활동 수준에 따라 늘거나 줄어들 수 있습니다.

또한 메모리 요구 사항은 최대 파일 공유 활동에 의해 결정될 수 있습니다. 권장 사항은 기본 최대 파일 크기 50MB를 기반으로 하며, 시스템 콘솔에서 조정할 수 있습니다. 이 숫자를 변경하면 메모리 요구 사항이 변경될 수 있습니다.

2,000명 이상의 사용자를 위한 배포의 경우 Mattermost 오픈 소스 부하 테스트 프레임워크를 사용하여 전체 규모로 시스템 사용량을 시뮬레이션하는 것을 권장합니다: https://github.com/mattermost/mattermost-load-test-ng.

Mattermost는 모든 64비트 x86 프로세서 아키텍처를 지원합니다.

팀 배포를 위한 하드웨어 요구 사항#

대부분의 소규모 및 중규모 Mattermost 팀 배포는 등록된 사용자 수에 따라 다음 사양의 단일 서버에서 지원될 수 있습니다:

• 1 - 1,000명 사용자 - vCPU/코어 1개, RAM 2GB
• 1,000 - 2,000명 사용자 - vCPU/코어 2개, RAM 4GB

엔터프라이즈 배포(다중 서버)를 위한 하드웨어 요구 사항#

확장 요구 사항#

다중 서버 설정을 갖춘 Enterprise Edition 배포의 경우 확장 가이드를 참조하세요.

전체 규모 사용량을 추정하기 위해 조직의 특정 요구 사항을 기반으로 한 파일럿 실행이 엔터프라이즈 전체 배포 전에 강력히 권장됩니다. Mattermost 오픈 소스 부하 테스트 프레임워크를 사용하여 시스템 사용량을 시뮬레이션할 수 있습니다: https://github.com/mattermost/mattermost-load-test-ng.

Mattermost의 성능 모니터링 도구는 상세한 성능 측정과 크기 조정 및 설치가 올바른지 확인하기 위해 실행 중인 시스템 검사에 사용될 수 있습니다.

시스템 요구 사항#

다중 서버 설정을 갖춘 Enterprise Edition 배포의 경우 Mattermost 배포를 지원하기 위해 다음 시스템을 강력히 권장합니다:

• Mattermost Enterprise에서 사용 가능한 성능 모니터링 기능을 통해 Mattermost 배포의 시스템 상태를 추적하는 Prometheus.
• 성능 모니터링 기능으로 Prometheus가 수집한 시스템 상태 메트릭을 시각화하는 Grafana. Grafana 5.0.0 이상을 권장합니다.
• 클러스터 환경에서 매우 효율적인 데이터베이스 검색을 지원하는 Elasticsearch. Elasticsearch v7.17+가 지원되며, Mattermost v9.11부터 Elasticsearch v8.x 또는 AWS OpenSearch를 권장합니다. 자세히 알아보기.
• AWS S3 또는 모든 S3 호환 서비스. Mattermost는 S3 API를 구현하는 객체 스토리지 시스템과 호환됩니다. 또한 NFS를 사용하는 로컬 스토리지나 네트워크 드라이브를 사용할 수 있습니다. 문서에서 파일 스토리지 구성 옵션에 대해 자세히 알아보세요.