Mattermost 서버를 Ubuntu에 설치하기

최소 시스템 요구 사항:

  • 운영 체제: 18.04 LTS, 20.04 LTS, 22.04 LTS
  • 하드웨어: 1 vCPU/core 및 2GB RAM (최대 1,000명의 사용자 지원)
  • 데이터베이스: PostgreSQL v11+
  • 네트워크:
    • 응용 프로그램 80/443, TLS, TCP Inbound
    • 관리자 콘솔 8065, TLS, TCP Inbound
    • SMTP 포트 10025, TCP/UDP Outbound

Mattermost 서버는 .deb 서명된 패키지를 사용하여 Mattermost PPA (Personal Package Archive)를 통해 설치할 수 있습니다. Mattermost Personal Package Archive (PPA)를 사용하면 Mattermost 서버를 가장 빠르게 설치할 뿐만 아니라 자동 업데이트도 제공합니다. 이 설치 방법은 단일 및 클러스터 설치에 모두 사용됩니다.

Tip

Mattermost 서버와 데이터베이스를 동일 시스템에서 실행 중이라면, Mattermost Omnibus 설치 방법 을 권장합니다. 이는 설정 및 지속적인 유지 및 보수를 크게 줄입니다.

Note

PostgreSQL 데이터베이스가 필요합니다. 이 전제 조건에 대한 자세한 내용은 데이터베이스 준비 문서를 참조하십시오.

Mattermost 배포에는 4단계가 포함되어 있습니다: PPA 저장소 추가 , 설치 , 설정 , 그리고 업데이트 .

Mattermost Server PPA 저장소 추가

터미널 창에서 다음 명령을 실행하여 Mattermost 서버 저장소를 추가합니다:

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

설치

Mattermost 서버를 설치하기 전에, 다음 명령을 실행하여 모든 저장소를 업데이트하고 필요한 경우 기존 패키지를 업데이트하는 것이 좋습니다:

  sudo apt update

모든 업데이트 및 시스템 재부팅이 완료된 후에, Mattermost 서버를 설치하려면 이제 단일 명령만 실행하면 됩니다:

sudo apt install mattermost -y Copied to clipboard

이제 시스템에 최신 Mattermost 서버 버전이 설치되었습니다.

설치 경로는 /opt/mattermost 입니다. 패키지는 mattermost 라는 사용자와 그룹을 추가했습니다. 필요한 systemd unit 파일도 생성되었지만 활성화되지는 않았습니다.

Note

Mattermost 저장소에서 서명된 패키지가 여러 설치 유형에 사용되므로 systemd unit 파일에 의존성을 추가하지 않습니다. Mattermost 서버를 데이터베이스와 동일한 시스템에 설치하는 경우, systemd unit 파일의 [Unit] 섹션에 After=postgresql.serviceBindsTo=postgresql.service 를 추가하는 것이 좋습니다.

설정

Mattermost 서버를 시작하기 전에 구성 파일을 편집해야 합니다. 샘플 구성 파일은 /opt/mattermost/config/config.defaults.json 에 있습니다.

이 구성 파일에 올바른 권한으로 이름을 변경하십시오:

sudo install -C -m 600 -o mattermost -g mattermost /opt/mattermost/config/config.defaults.json /opt/mattermost/config/config.json

이 파일에서 다음 속성을 구성하십시오:

  • DriverName"postgres" 로 설정하십시오. 이것은 모든 Mattermost 설치에 대한 기본 및 권장 데이터베이스입니다.

  • DataSource"postgres://mmuser: <mmuser-password>@ <host-name-or-IP>:5432/mattermost?sslmode=disable&connect_timeout=10" 로 설정하십시오. 여기서 mmuser , <mmuser-password> , <host-name-or-IP>mattermost 를 사용자의 데이터베이스 이름으로 대체하십시오.

  • "SiteURL" 설정: Mattermost 애플리케이션의 도메인 이름 (예: https://mattermost.example.com )을 입력합니다.

config.json 설정 파일을 수정한 후, 이제 Mattermost 서버를 시작할 수 있습니다:

sudo systemctl start mattermost

Mattermost가 실행 중인지 확인하세요: curl http://localhost:8065 . Mattermost 서버가 반환한 HTML을 보아야 합니다.

최종 단계는 필요에 따라 sudo systemctl enable mattermost.service 를 실행하여 Mattermost를 시스템 부팅 시 시작하도록 하는 것입니다.

업데이트

새로운 Mattermost 버전이 출시되면, sudo apt update && sudo apt upgrade 를 실행하여 Mattermost 인스턴스를 다운로드하고 업데이트하세요.

Note

sudo apt upgrade 명령을 실행할 때, mattermost-server 와 다른 패키지도 업데이트됩니다. apt 명령을 실행하기 전, sudo systemctl stop mattermost-server 를 사용하여 Mattermost 서버를 중단하는 것을 강력히 권장합니다.

Mattermost 제거

어떠한 이유로든 Mattermost 서버를 제거하고 싶다면, 다음 명령을 실행할 수 있습니다:

sudo apt remove --purge mattermost

자주 묻는 질문

Mattermost가 시스템 부팅 시 시작되지 않는 이유는 무엇인가요?

Mattermost 서버를 시스템 부팅 시 시작하려면, systemd 유닛 파일을 활성화해야 합니다. 다음 명령을 실행하세요:

  sudo systemctl enable mattermost.service

Mattermost가 시스템 부팅 시 시작하지 못하는 이유는 무엇인가요?

만약 데이터베이스가 Mattermost 서버와 동일한 시스템에 있다면, /lib/systemd/system/mattermost.service systemd 유닛 파일을 편집하여 [Unit] 섹션에 After=postgresql.serviceBindsTo=postgresql.service 를 추가하는 것을 권장합니다.

프록시 없이 Mattermost를 실행할 수 있나요?

네. Mattermost는 8065 대신 443에 바인딩됩니다. 이를 위해 올바른 권한이있는 Mattermost 이진 파일이 필요합니다. 다음 명령을 실행하여 포트가 1024보다 낮은 값에 바인딩하도록 CAP_NET_BIND_SERVICE 기능을 활성화해야 합니다:

  sudo setcap cap_net_bind_service=+ep ./mattermost/bin/mattermost

Note

  • 200명 이하의 동시 사용자에 대해서는 Mattermost 서버 앞에 프록시를 사용하는 것을 강력히 권장합니다. 200명 이하의 동시 사용자가 있는 경우, TLS 설정 을 할 수 있습니다. 200명을 초과하는 동시 사용자가 있는 경우, 트래픽을 관리하기 위해 NGINX와 같은 프록시 가 필요합니다.