Mattermost Omnibus 설치

Available on all plans

Self-hosted deployments

Minimum system requirements:

  • Hardware: 1 vCPU/core with 2GB RAM (support for up to 1,000 users)
  • Operating System: Ubuntu 18.04 or greater
  • Database: PostgreSQL v11+
  • Network ports required:
    • Application ports 80/443, TLS, TCP Inbound
    • Administrator Console port 8065, TLS, TCP Inbound
    • SMTP port 10025, TCP/UDP Outbound

Note

Omnibus는 Ubuntu 배포만 지원합니다.

Mattermost Omnibus는 무료이며 라이선스가 없는 Mattermost Enterprise 버전, PostgreSQL 데이터베이스, 필요에 따라 NGINX를 애플리케이션 프록시로 사용합니다. 사용자 지정 CLI( mmomni )와 ansible 레시피는 구성 요소를 연결하고 구성합니다. Mattermost Omnibus는 Ubuntu 배포에서만 지원됩니다.

Mattermost PPA 저장소 추가

터미널 창에서 다음 명령을 실행합니다.

curl -o- https://deb.packages.mattermost.com/repo-setup.sh | sudo bash 클립보드에 복사함

이 명령은 PostgreSQL 데이터베이스에 필요한 저장소를 구성하고, NGINX 웹 서버를 프록시로 사용하도록 구성하며, SSL 인증서를 발급하고 갱신할 수 있도록 certbot을 구성하고, 설치 명령을 실행할 수 있도록 Mattermost Omnibus 저장소를 구성합니다.

Mattermost Omnibus 설치

터미널 창에서 다음 명령을 실행하여 Omnibus를 설치합니다.

sudo apt install mattermost-omnibus -y 클립보드에 복사함

Note

SSL을 활성화하여 Omnibus를 설치하고 구성하는 것을 권장하지만, 다음 명령을 실행하여 SSL을 비활성화할 수 있습니다: sudo MMO_HTTPS=false apt install mattermost-omnibus .

SSL 인증서를 발급하고 관련 통신을 처리하기 위해 도메인 이름과 이메일 주소를 지정하도록 요청됩니다. 설치된 모든 패키지 이후에 Omnibus는 모든 플랫폼 구성 요소를 구성하고 서버를 시작하는 ansible 스크립트를 실행합니다.

다음 단계:

  1. 브라우저를 열고 Mattermost 도메인으로 이동합니다 (예: 도메인 이름 mymattermostserver.com 또는 도메인 이름을 사용하지 않을 경우 서버 IP 주소).

  2. 첫 번째 Mattermost 사용자를 생성하고 더 많은 사용자를 초대하며 Mattermost 플랫폼을 탐색합니다.

Mattermost Omnibus 구성

Note

플러그인 업로드, 로컬 모드 및 HTTPS가 기본적으로 활성화됩니다. 이러한 설정은 아래에서 설명된대로 yaml 파일에서 수정됩니다.

Mattermost Omnibus를 사용하면 Mattermost config.json 파일은 사용되지 않습니다. Omnibus는 구성을 데이터베이스에 저장합니다. Omnibus 플랫폼 자체에는 /etc/mattermost/mmomni.yml 에 저장된 자체 구성이 필요합니다. 이 파일에는 Omnibus가 플랫폼을 구성하고 모든 서비스를 연결하는 데 필요한 데이터가 포함되어 있습니다.

Mattermost 서버 구성을 변경하려면 mmctl --local config edit 를 사용하여 Mattermost 서버 구성을 변경해야 합니다. 추가 명령 세부 정보는 mmctl 문서를 참조하십시오.

Omnibus가 올바르게 작동하려면 Mattermost의 실행에 사용하는 포트와 같이 일부 구성 매개변수를 변경하지 말아야 합니다.

다음 매개변수는 직접 mmomni.yml 파일을 사용하여 구성해야 합니다:

  • db_user : PostgreSQL 데이터베이스 사용자. 이 값은 Omnibus 설치 중에 생성되며 변경해서는 안 됩니다.

  • db_password : PostgreSQL 데이터베이스 암호. 이 값은 Omnibus 설치 중에 생성되며 변경해서는 안 됩니다.

  • fqdn : Mattermost 애플리케이션의 도메인 이름. 이 값은 설치 프로세스 중에 요청되며 ServiceSettings.SiteURL Mattermost 구성 속성을 채우는 데 사용되며 서버의 SSL 인증서를 검색하고 구성하는 데 사용됩니다.

  • email : 인증서 통신에 사용되는 이메일 주소입니다. 이 값은 설치 프로세스 중에 프롬프트로 나타나며, HTTPS가 비활성화된 경우에는 사용되지 않습니다.

  • https : 플랫폼을 HTTPS 또는 HTTP로 구성해야 하는지 여부를 나타냅니다. true 또는 false 의 값을 갖습니다. Mattermost를 설치하는 권장 방법은 HTTPS를 사용하는 것이지만 필요한 경우 비활성화할 수 있습니다.

  • data_directory : Mattermost가 데이터를 저장하는 디렉터리입니다.

  • enable_plugin_uploads : 이 설정은 PluginSettings.EnableUploads Mattermost 구성 속성을 구성하는 데 사용되며, true 또는 false 가 될 수 있습니다.

  • enable_local_mode : 이 설정은 ServiceSettings.EnableLocalMode Mattermost 구성 속성을 구성하는 데 사용되며, true 또는 false 가 될 수 있습니다.

  • nginx_template : 사용자 정의 NGINX 템플릿의 경로입니다.

mmomni.yml 구성 파일을 수정한 후에는 변경 사항을 적용하기 위해 Omnibus를 실행해야 하며, 그런 다음 Mattermost 서버를 다시 시작해야 합니다.

Mattermost Omnibus 업데이트

Mattermost Omnibus는 apt 패키지 관리자와 통합되어 있습니다. 새로운 Mattermost 버전이 출시되면 다음 명령을 실행하여 Mattermost 인스턴스를 다운로드하고 업데이트합니다:

sudo apt update && sudo apt upgrade 클립보드로 복사됨

Note

sudo apt upgrade 명령을 실행하면 mattermost-server가 다른 패키지와 함께 업데이트됩니다. apt 명령을 실행하기 전에, Mattermost 서버를 중지하는 것을 강력히 권장합니다. 이를 위해 sudo systemctl stop mattermost-server 명령을 실행하면 됩니다.

백업 및 복원

Mattermost Omnibus CLI 도구인 mmomni 을 사용하여 백업 및 복원을 수행합니다. 서버 및 도메인 이전뿐만 아니라 백업 및 복원도 훨씬 쉬워졌습니다. Mattermost 서버의 모든 콘텐츠, 사용자, 플러그인, 구성 및 데이터베이스를 스냅샷으로 저장할 수 있습니다. 동일한 서버에 복원하거나 필요할 때 다른 서버로 이동할 수 있습니다.

Mattermost 서버의 내용을 백업하려면 다음 명령을 실행합니다:

mmomni backup -o /tmp/mm_backup_datetime.tgz

Mattermost 서버의 내용을 복원하려면 다음 두 개의 명령을 실행합니다:

mmomni ore /tmp/mm_backup_datetime.tgz
mmomni reconfigure

Mattermost Omnibus 제거

어떠한 이유로든 Mattermost와 Mattermost Omnibus를 완전히 제거하고 싶다면 다음 명령을 실행할 수 있습니다:

sudo apt remove --purge mattermost mattermost-omnibus

자주 묻는 질문

Omnibus에서 라이선스를 사용할 수 있나요?

네. Mattermost Omnibus는 무료 라이선스가 적용된 Mattermost Enterprise Edition을 번들로 제공하며, 라이선스를 구매하고 업로드하면 엔터프라이즈 기능이 활성화됩니다.

클러스터의 일부로서 Omnibus 서버를 사용할 수 있나요?

아닙니다. Omnibus는 자체 포함형 단일 서버 Mattermost 플랫폼으로 설계되었습니다. 필요한 모든 구성 요소가 동일한 서버에 있을 것으로 예상합니다.

SSL 인증서는 자동으로 갱신되나요?

네. SSL 인증서는 자동으로 갱신됩니다. Omnibus는 인증서를 관리하기 위해 certbot 패키지를 설치하며, /etc/cron.d/certbot에 위치한 cron 작업으로 갱신 프로세스가 자동적으로 실행됩니다.

업그레이드에서 EXPKEYSIG 오류를 어떻게 수정하나요?

드물게 EXPKEYSIG 오류가 발생하는 경우, 이는 인증서가 만료되었음을 나타냅니다. 새 인증서를 획득하려면 다음 명령을 실행하세요:

sudo apt-key remove 44774B28
sudo curl -o- https://deb.packages.mattermost.com/pubkey.gpg | sudo apt-key add -
sudo apt update

사용자 정의 NGINX 템플릿을 사용할 수 있나요?

네. Mattermost Omnibus는 사용자 정의 NGINX 템플릿을 사용할 수 있습니다. 이 기능을 사용하려면 기존 템플릿을 복사하고 수정한 후 새 위치에 저장해야 합니다. 그런 다음 템플릿에 번들된 변수와 내부 로직을 수정하거나 필요한 부분을 완전히 정적인 구성으로 사용할 수 있습니다.

템플릿을 사용자 정의한 후에는 /etc/mattermost/mmomni.yml 구성 파일에 nginx_template 속성을 추가한 다음 mmomni reconfigure 를 실행하세요. 재구성 프로세스는 새 템플릿을 사용하여 최종 NGINX 구성을 생성합니다. 변경 사항이 성공적으로 적용되었는지 확인하려면 /etc/nginx/conf.d/mattermost.conf 파일의 내용을 확인할 수 있습니다.

Note

이 기능을 사용할 때는 주의하시기 바랍니다. 사용자 정의 템플릿을 변경하면 재구성 프로세스가 실패하거나 생성된 NGINX 구성이 유효하지 않을 수 있습니다.

사용 가능한 mmomni 명령어는 무엇인가요?

  • mmomni backup : Mattermost 서버의 완전한 스냅샷을 가져와 백업 파일을 지정된 파일 위치에 배치합니다.

  • mmomni ore : 지정된 백업 파일을 Mattermost 서버에 복원합니다.

  • mmomni reconfigure : 도메인, SSL 또는 Omnibus 지정 제약 사항 변경을 다시 실행하며, mmomni.yml 구성 파일에 적용된 모든 변경 사항을 적용합니다.

  • mmomni status : 모든 Omnibus 구성 요소의 현재 상태를 표시합니다.

  • mmomni tail : 모든 Omnibus 구성 요소의 로그를 실행합니다.

도움이 필요한 경우 어디서 도움을 받을 수 있나요?

Mattermost Omnibus를 설치하는 데 문제가 발생하면 일반 오류 메시지에 대한 문제 해결 가이드 또는 Mattermost 사용자 커뮤니티에 참여하십시오.