Docker 배포 문제 해결

M1 Mac에서의 권한 문제

M1 Mac에서 Docker로 Mattermost 서버를 배포하는 중 Docker 컨테이너에서 권한 문제가 발생하면, 필요한 디렉터리를 다시 만들고 권한을 설정한 다음 아래 명령은 건너뛰세요. 이 명령을 실행하면 배포가 동작하지 않게 됩니다.

sudo chown -R 2000:2000 ./volumes/app/mattermost

Docker 배포 전반에서 문제가 발생한다면 docker 데몬이 활성화되어 실행 중인지 확인하세요.

sudo systemctl enable --now docker

Mattermost 배포의 모든 데이터와 설정을 삭제하려면 다음을 실행합니다.

sudo rm -rf ./volumes

TLS 및 NGINX 문제

NGINX용 TLS 인증서와 키를 구성하는 자세한 가이드는 저장소의 이 문서를 참고하세요.

다른 버전의 Mattermost 설치

1. 배포를 종료합니다.
2. git pull을 실행해 저장소의 최근 변경 사항을 가져옵니다. 이때 env.example의 변경 사항이 있는지 주의 깊게 확인하세요.
3. .env 파일의 MATTERMOST_IMAGE_TAG를 원하는 enterprise 또는 team 이미지 버전을 가리키도록 수정합니다.
   중요

   프로덕션 환경에서는 MATTERMOST_IMAGE_TAG=release-10 같은 일반 태그 대신 MATTERMOST_IMAGE_TAG=release-10.5처럼 특정 버전 태그를 사용하는 것을 권장합니다. 일반 release-x 태그는 개발 용도로만 제공되며, 해당 메이저 버전 내의 새 패치 릴리스를 자동으로 반영하지 않습니다. 특정 버전 태그를 사용하면 프로덕션 배포 환경을 더 재현 가능하고 결정적으로 유지할 수 있습니다.

4. Mattermost를 다시 배포합니다.

의도하지 않은 버전 다운그레이드

일반 MATTERMOST_IMAGE_TAG=release-x 태그를 사용하다가 의도하지 않은 다운그레이드를 겪는다면, 이는 해당 태그가 개발 용도로 설계되어 그 메이저 버전 내 최신 패치 릴리스를 가리키지 않을 수 있기 때문입니다.

해결 방법: MATTERMOST_IMAGE_TAG=release-10.5처럼 더 구체적인 버전 태그를 Docker 이미지에 사용해 예기치 않은 버전 변경을 방지하고 일관된 배포를 유지하세요.

mattermost-docker에서 업그레이드

더 이상 사용되지 않는 mattermost-docker 저장소에서 업그레이드하는 자세한 가이드는 이 문서를 참고하세요. 추가 도움이 필요하면 이 이슈를 참고하세요.