InfoGrab Docs

1단계: PostgreSQL 데이터베이스 설치 또는 데이터베이스 연결 자격증명 확보

요약

Mattermost PPA(Personal Package Archive)를 사용하여 서명된 .deb 패키지로 Mattermost 서버를 배포할 수 있습니다. 이 Mattermost 배포에는 다음 단계가 포함됩니다: PostgreSQL 데이터베이스 설치, 데이터베이스 준비, PPA 저장소 추가, Mattermost 서버 설치, 서버 구성, 서버 업데이트.

Minimum system requirements:

    • Operating System: 20.04 LTS, 22.04 LTS, 24.04 LTS
    • Hardware: 1 vCPU/core with 2GB RAM (support for up to 1,000 users)
    • Database: PostgreSQL v14+
  • Network:
      • Application 80/443, TLS, TCP Inbound
      • Administrator Console 8065, TLS, TCP Inbound
      • SMTP port 10025, TCP/UDP Outbound

Mattermost PPA(Personal Package Archive)를 사용하여 서명된 .deb 패키지로 Mattermost 서버를 배포할 수 있습니다. 이 방법은 자동 업데이트를 제공하는 Mattermost 서버를 설치하는 가장 빠른 방법입니다. 이 설치 방법은 단일 설치 및 클러스터 설치 모두에 사용되며, 클러스터 배포에는 Packer와 같은 도구를 사용할 수 있습니다.

이 Mattermost 배포에는 다음 단계가 포함됩니다: PostgreSQL 데이터베이스 설치, 데이터베이스 준비, PPA 저장소 추가, Mattermost 서버 설치, 서버 구성, 서버 업데이트.

1단계: PostgreSQL 데이터베이스 설치 또는 데이터베이스 연결 자격증명 확보#

Mattermost는 PostgreSQL 데이터베이스가 필요합니다. 다음 중 하나를 선택할 수 있습니다:

  • PostgreSQL 설치 문서에 따라 동일한 서버에 로컬로 PostgreSQL을 설치합니다.
  • 외부 PostgreSQL 데이터베이스 서버를 사용합니다. 호스트명, 포트, 데이터베이스 이름, 사용자명, 비밀번호를 포함한 연결 자격증명이 있는지 확인하세요.
  • 관리형 데이터베이스 서비스를 사용합니다.

2단계: 데이터베이스 준비#

Mattermost를 위한 PostgreSQL 데이터베이스를 설정하려면 데이터베이스 준비 문서를 따르세요.

3단계: Mattermost 서버 PPA 저장소 추가#

Important

GPG 공개 키가 변경되었습니다. 새 공개 키를 가져오거나 아래에서 제공하는 자동 Mattermost PPA 저장소 설정 스크립트를 실행할 수 있습니다. 설정에 따라 추가 단계가 필요할 수 있으며, 특히 저장소 설정 스크립트에 의존하지 않은 설치의 경우에 해당합니다. apt 저장소를 추가하기 전에 /etc/apt/trusted.gpg.d에서 이전 키를 삭제하는 것을 권장합니다.

    • Ubuntu Jammy - 22.04 LTS 및 Ubuntu Noble - 24.04 LTS의 경우:

sudo rm /usr/share/keyrings/mattermost-archive-keyring.gpg

curl -sL -o- https://deb.packages.mattermost.com/pubkey.gpg | gpg --dearmor | sudo tee /usr/share/keyrings/mattermost-archive-keyring.gpg > /dev/null

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

curl -o- https://deb.packages.mattermost.com/repo-setup.sh | sudo bash -s mattermost

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

4단계: Mattermost 서버 설치#

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

sudo apt update

업데이트와 시스템 재부팅이 완료되면 다음 명령으로 Mattermost 서버를 설치할 수 있습니다:

sudo apt install mattermost -y

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

설치 경로는 /opt/mattermost입니다. 패키지는 mattermost라는 이름의 사용자와 그룹을 추가합니다. 필요한 systemd 유닛 파일도 생성되지만 활성 상태로 설정되지는 않습니다.

Note

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

5단계: 서버 구성#

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

이 파일에서 다음 속성을 구성합니다:

* SqlSettings 아래에서 DriverName을 "postgres"로 설정합니다. 이는 모든 Mattermost 설치에 권장되는 기본 데이터베이스입니다.

* SqlSettings 아래에서 DataSource를 "postgres://mmuser:<mmuser-password>@<host-name-or-IP>:5432/mattermost?sslmode=disable&connect_timeout=10"으로 설정하고, mmuser, <mmuser-password>, <host-name-or-IP> 및 mattermost를 데이터베이스 이름으로 교체합니다.

* ServiceSettings 아래에서 "SiteURL" 설정: Mattermost 애플리케이션의 도메인 이름 (예: https://mattermost.example.com).

SupportSettings 아래 "SupportEmail"로 지원 이메일 구성을 권장합니다. 이는 사용자가 도움이 필요할 때 연락하는 이메일 주소입니다.

config.json 구성 파일을 수정한 후 Mattermost 서버를 시작할 수 있습니다:

sudo systemctl start mattermost

Mattermost가 실행 중인지 확인합니다: curl http://localhost:8065. Mattermost 서버가 반환하는 HTML이 표시되어야 합니다.

요구 사항에 따라 마지막 단계로 sudo systemctl enable mattermost.service를 실행하여 Mattermost가 시스템 부팅 시 시작되도록 설정합니다.

Note

DataSource 구성의 sslmode 속성 값은 네이티브 환경에 따라 완전히 달라집니다. 해당 값에 대한 지침은 네이티브 환경 설정 문서를 참조하세요. sslmode에 사용 가능한 옵션은 disable 또는 require입니다. 예를 들어, 데이터 소스로 Amazon Lightsail을 사용하는 경우 데이터베이스에 성공적으로 연결하려면 sslmode를 require로 설정해야 합니다.

6단계: 서버 업데이트#

새 Mattermost 버전이 릴리즈되면 sudo apt update && sudo apt upgrade를 실행하여 Mattermost 인스턴스를 다운로드하고 업데이트합니다.

Note

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

Mattermost 제거#

다음 명령으로 Mattermost 서버를 제거합니다:

sudo apt remove --purge mattermost

1단계: PostgreSQL 데이터베이스 설치 또는 데이터베이스 연결 자격증명 확보

원문 보기
요약

Mattermost PPA(Personal Package Archive)를 사용하여 서명된 .deb 패키지로 Mattermost 서버를 배포할 수 있습니다. 이 Mattermost 배포에는 다음 단계가 포함됩니다: PostgreSQL 데이터베이스 설치, 데이터베이스 준비, PPA 저장소 추가, Mattermost 서버 설치, 서버 구성, 서버 업데이트.

Minimum system requirements:

    • Operating System: 20.04 LTS, 22.04 LTS, 24.04 LTS
    • Hardware: 1 vCPU/core with 2GB RAM (support for up to 1,000 users)
    • Database: PostgreSQL v14+
  • Network:
      • Application 80/443, TLS, TCP Inbound
      • Administrator Console 8065, TLS, TCP Inbound
      • SMTP port 10025, TCP/UDP Outbound

Mattermost PPA(Personal Package Archive)를 사용하여 서명된 .deb 패키지로 Mattermost 서버를 배포할 수 있습니다. 이 방법은 자동 업데이트를 제공하는 Mattermost 서버를 설치하는 가장 빠른 방법입니다. 이 설치 방법은 단일 설치 및 클러스터 설치 모두에 사용되며, 클러스터 배포에는 Packer와 같은 도구를 사용할 수 있습니다.

이 Mattermost 배포에는 다음 단계가 포함됩니다: PostgreSQL 데이터베이스 설치, 데이터베이스 준비, PPA 저장소 추가, Mattermost 서버 설치, 서버 구성, 서버 업데이트.

1단계: PostgreSQL 데이터베이스 설치 또는 데이터베이스 연결 자격증명 확보#

Mattermost는 PostgreSQL 데이터베이스가 필요합니다. 다음 중 하나를 선택할 수 있습니다:

  • PostgreSQL 설치 문서에 따라 동일한 서버에 로컬로 PostgreSQL을 설치합니다.
  • 외부 PostgreSQL 데이터베이스 서버를 사용합니다. 호스트명, 포트, 데이터베이스 이름, 사용자명, 비밀번호를 포함한 연결 자격증명이 있는지 확인하세요.
  • 관리형 데이터베이스 서비스를 사용합니다.

2단계: 데이터베이스 준비#

Mattermost를 위한 PostgreSQL 데이터베이스를 설정하려면 데이터베이스 준비 문서를 따르세요.

3단계: Mattermost 서버 PPA 저장소 추가#

Important

GPG 공개 키가 변경되었습니다. 새 공개 키를 가져오거나 아래에서 제공하는 자동 Mattermost PPA 저장소 설정 스크립트를 실행할 수 있습니다. 설정에 따라 추가 단계가 필요할 수 있으며, 특히 저장소 설정 스크립트에 의존하지 않은 설치의 경우에 해당합니다. apt 저장소를 추가하기 전에 /etc/apt/trusted.gpg.d에서 이전 키를 삭제하는 것을 권장합니다.

    • Ubuntu Jammy - 22.04 LTS 및 Ubuntu Noble - 24.04 LTS의 경우:

sudo rm /usr/share/keyrings/mattermost-archive-keyring.gpg

curl -sL -o- https://deb.packages.mattermost.com/pubkey.gpg | gpg --dearmor | sudo tee /usr/share/keyrings/mattermost-archive-keyring.gpg > /dev/null

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

curl -o- https://deb.packages.mattermost.com/repo-setup.sh | sudo bash -s mattermost

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

4단계: Mattermost 서버 설치#

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

sudo apt update

업데이트와 시스템 재부팅이 완료되면 다음 명령으로 Mattermost 서버를 설치할 수 있습니다:

sudo apt install mattermost -y

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

설치 경로는 /opt/mattermost입니다. 패키지는 mattermost라는 이름의 사용자와 그룹을 추가합니다. 필요한 systemd 유닛 파일도 생성되지만 활성 상태로 설정되지는 않습니다.

Note

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

5단계: 서버 구성#

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

이 파일에서 다음 속성을 구성합니다:

* SqlSettings 아래에서 DriverName을 "postgres"로 설정합니다. 이는 모든 Mattermost 설치에 권장되는 기본 데이터베이스입니다.

* SqlSettings 아래에서 DataSource를 "postgres://mmuser:<mmuser-password>@<host-name-or-IP>:5432/mattermost?sslmode=disable&connect_timeout=10"으로 설정하고, mmuser, <mmuser-password>, <host-name-or-IP> 및 mattermost를 데이터베이스 이름으로 교체합니다.

* ServiceSettings 아래에서 "SiteURL" 설정: Mattermost 애플리케이션의 도메인 이름 (예: https://mattermost.example.com).

SupportSettings 아래 "SupportEmail"로 지원 이메일 구성을 권장합니다. 이는 사용자가 도움이 필요할 때 연락하는 이메일 주소입니다.

config.json 구성 파일을 수정한 후 Mattermost 서버를 시작할 수 있습니다:

sudo systemctl start mattermost

Mattermost가 실행 중인지 확인합니다: curl http://localhost:8065. Mattermost 서버가 반환하는 HTML이 표시되어야 합니다.

요구 사항에 따라 마지막 단계로 sudo systemctl enable mattermost.service를 실행하여 Mattermost가 시스템 부팅 시 시작되도록 설정합니다.

Note

DataSource 구성의 sslmode 속성 값은 네이티브 환경에 따라 완전히 달라집니다. 해당 값에 대한 지침은 네이티브 환경 설정 문서를 참조하세요. sslmode에 사용 가능한 옵션은 disable 또는 require입니다. 예를 들어, 데이터 소스로 Amazon Lightsail을 사용하는 경우 데이터베이스에 성공적으로 연결하려면 sslmode를 require로 설정해야 합니다.

6단계: 서버 업데이트#

새 Mattermost 버전이 릴리즈되면 sudo apt update && sudo apt upgrade를 실행하여 Mattermost 인스턴스를 다운로드하고 업데이트합니다.

Note

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

Mattermost 제거#

다음 명령으로 Mattermost 서버를 제거합니다:

sudo apt remove --purge mattermost