Mattermost 워크스페이스 마이그레이션#

모든 플랜 에서 사용 가능

이 문서는 기존 Mattermost 인스턴스를 자체 호스팅에서 Cloud로 마이그레이션하고 Cloud에서 자체 호스팅으로 마이그레이션하는 과정을 설명합니다.

참고

동일한 배포 방법을 사용하여 기존 Mattermost 인스턴스를 다른 인스턴스로 마이그레이션하는 것은 아래에 문서화된 것과 동일한 프로세스를 따릅니다. 마이그레이션의 소스나 대상이 Cloud인지 자체 호스팅인지에 관계없이 동일합니다. 이 단계는 Cloud와 자체 호스팅 Mattermost 인스턴스 모두에서 작동합니다.

자체 호스팅에서 Cloud로 마이그레이션#

자체 호스팅에서 Cloud로 마이그레이션할 때는 Mattermost 지원팀에 티켓을 열어 프로세스를 지원받아야 합니다. 아래 정보는 마이그레이션 프로세스를 설명합니다. 시작하기 전에 지원 사이트 에서 티켓을 열어주세요.

중요

이 마이그레이션 프로세스는 유료 Mattermost 버전을 사용하는 고객만 이용할 수 있습니다.
마이그레이션을 시작하기 전에 주요 고려사항, 필수 사전 요구사항, 내보내기 테스트에 대한 가이드를 숙지하기 위해 자체 호스팅에서 Cloud로 마이그레이션 에 대한 지식 베이스 문서를 검토하는 것을 권장합니다.

마이그레이션을 시작하기 전에 다음 정보를 참고하세요:

사용자 인증

이메일 로그인 방식을 사용하는 경우, 마이그레이션이 완료된 후 사용자가 비밀번호를 재설정해야 합니다. LDAP 및 GitLab SSO와 같은 다른 인증 방식은 Mattermost 클라우드에서 특정 인증 방식이 작동할 수 있도록 인프라 변경이 필요합니다.

플러그인

Marketplace에 나열되지 않은 플러그인을 사용하는 경우, 해당 플러그인은 내보내기에 포함되지 않으며 앞으로도 사용할 수 없습니다. 지원되는 플러그인 목록은 통합 개요 문서를 참조하세요.

데이터

마이그레이션에는 채널의 데이터만 포함됩니다. Playbooks 데이터는 내보내지지 않습니다.

마이그레이션 프로세스#

자체 호스팅 인스턴스에서 내보내기

관리자 자격 증명을 사용하여 자체 호스팅 Mattermost 서버에 로그인하세요. 로그인한 후 다음을 실행하세요:

mmctl export create --attachments

이렇게 하면 서버의 전체 내보내기가 생성되며 첨부 파일이 포함됩니다. 첨부 파일을 내보내지 않으려면 --attachments 를 제외하세요.

이 프로세스는 시간이 걸릴 수 있으므로 mmctl 은 즉시 반환되고 작업은 내보내기가 완전히 생성될 때까지 백그라운드에서 실행됩니다. 성공하면 명령은 다음과 같이 작업 ID를 즉시 출력합니다:

Export process job successfully created, ID: yfrr9ku5i7fjubeshs1ksrknzc

작업이 실행되는 동안 생성 시 제공된 ID를 사용하여 상태를 확인할 수 있으며, 완료되면 출력은 다음과 유사하게 표시됩니다:

mmctl export job show yfrr9ku5i7fjubeshs1ksrknzc
ID: yfrr9ku5i7fjubeshs1ksrknzc
Status: success
Created: 2021-11-03 10:44:13 -0500 CDT
Started: 2021-11-03 10:44:23 -0500 CDT

완료된 파일은 .zip 파일로 데스크톱에 다운로드됩니다.

참고

파일 이름은 로그 파일에서 참조되며 Support 팀이 내보낸 파일을 검증하는 데 사용하므로 파일 이름을 변경하지 마세요.

Support 팀은 내보낸 파일을 업로드할 수 있도록 S3 자격 증명을 제공합니다. 파일을 업로드한 후 Support 팀에 연락하여 알려주세요.

Mattermost Cloud에서 새 워크스페이스 생성#

그동안 Mattermost 자격 증명으로 Mattermost Cloud에 로그인하여 Cloud 워크스페이스를 생성할 수 있습니다.

참고

마이그레이션 프로세스가 이 작업을 수행하므로 Mattermost Cloud 인스턴스에 사용자를 생성하지 마세요.

Mattermost Cloud 인스턴스로 데이터 가져오기#

제공된 S3 버킷에 내보내기 업로드가 완료되고 Mattermost Cloud 인스턴스 이름/URL을 공유하면 Support가 가져오기 단계를 시작할 수 있습니다.

내보내기 크기에 따라 이 프로세스는 시간이 걸릴 수 있습니다. 가져오기가 완료되면 Support가 즉시 연락할 것입니다. 이 시간 동안 Mattermost Cloud 인스턴스를 사용하지 않는 것이 좋습니다.

Mattermost Cloud 인스턴스 사용 시작#

내보내기가 완료되면 Cloud 인스턴스에 로그인하고 사용자에게 로그인을 초대할 수 있습니다.

참고

Cloud 인스턴스를 잠시 사용하고 모든 것이 예상대로 검증될 때까지 자체 호스팅 Mattermost 서버를 유지하는 것을 권장합니다.

Cloud에서 자체 호스팅으로 마이그레이션#

언제든지 Cloud 워크스페이스 데이터를 자체 호스팅 배포로 마이그레이션할 수 있습니다.

프로세스는 어떻게 작동하나요?#

데이터를 내보내고 마이그레이션하기 전에 Mattermost를 실행할 서버에 Mattermost 설치 가 필요합니다. 마이그레이션은 로컬에 설치되고 Mattermost API를 사용하는 Mattermost용 원격 CLI 도구인 mmctl CLI 도구를 사용하여 수행됩니다. mmctl 은 사전 설치되어 있습니다.

mmctl 사용 참고 사항 은 프로세스 전후에 참조할 수 있는 추가 컨텍스트와 정보를 제공합니다.

mmctl export 명령을 사용하여 채널, 메시지, 사용자 등의 Cloud 데이터를 내보냅니다. 내보내기 파일은 내보내기 명령에 지정된 위치에 다운로드됩니다. 내보내기가 완료되면 데이터를 자체 호스팅 인스턴스로 가져옵니다.

내보내기가 매우 크고 Mattermost 서버에서 다운로드하기 어려운 경우 Amazon S3 클라우드 스토리지 위치로 데이터를 내보낼 수도 있습니다. 자세한 내용은 아래 create the export 섹션을 참조하세요.

참고

Cloud에서 데이터를 마이그레이션하기 전에 민감한 정보가 포함될 수 있는 데이터 내보내기를 수행할 수 있는 적절한 권한이 조직 내에 있는지 확인하세요. Mattermost는 데이터 내보내기 이후 취해진 조치에 대해 책임을 지지 않습니다.

또한 내보내기 프로세스에는 통합 또는 사용자 정의 데이터가 포함되지 않습니다. 특정 보안 설정 및 요구 사항과 같은 인스턴스의 다른 측면도 포함되지 않습니다. 추가 데이터 및 설정 마이그레이션에 대한 도움이 필요하면 지원 옵션을 참조하세요: https://mattermost.com/support/.

mmctl 이 인증되면 소스 인스턴스에서 내보내기를 생성할 수 있습니다.

인증#

인증은 Mattermost 로그인 자격 증명 또는 인증 토큰으로 수행됩니다. 먼저 관리자 자격 증명을 사용하여 mmctl로 인스턴스에 로그인하세요. example-source-domain.com 을 소스 인스턴스의 네트워크 주소로 바꾸세요:

mmctl auth login https://yourdomain.cloud.mattermost.com

사용자 이름(관리자 사용자 사용), 비밀번호 및 연결 이름을 입력하라는 메시지가 표시됩니다. 연결 이름은 원하는 대로 지정할 수 있으며, 향후 이 자격 증명 세트를 식별하는 데 사용됩니다. 그런 다음 내보내기 프로세스를 시작할 수 있습니다.

내보내기 생성#

중요

Mattermost Cloud 배포에 Cloud Marketplace에 나열되지 않은 플러그인이 포함된 경우, 해당 플러그인은 내보내기에 포함되지 않으며 앞으로도 해당 플러그인에 액세스할 수 없습니다. Cloud 지원 통합 목록은 integrations 문서를 참조하세요.

로그인한 후 다음 mmctl 명령을 실행하세요:

mmctl export create

이 명령을 실행하면 첨부 파일을 포함한 서버의 전체 내보내기가 생성됩니다. 인스턴스에서 첨부 파일을 내보내지 않으려면 --no-attachments 를 추가하고, 내보내기 파일에 보관된 채널을 포함하려면 --with-archived-channels 를 추가하세요. 이 프로세스는 시간이 걸릴 수 있으므로 mmctl 은 즉시 반환되고 작업은 내보내기가 완전히 생성될 때까지 Mattermost 인스턴스에서 백그라운드로 실행됩니다. 성공하면 명령은 다음과 같은 작업 ID를 즉시 출력합니다:

Export process job successfully created, ID: yfrr9ku5i7fjubeshs1ksrknzc

작업이 실행되는 동안 생성 시 제공된 ID를 사용하여 상태를 확인할 수 있으며, 완료되면 출력은 다음과 유사하게 표시됩니다:

mmctl export job show yfrr9ku5i7fjubeshs1ksrknzc
ID: yfrr9ku5i7fjubeshs1ksrknzc
Status: success
Created: 2021-11-03 10:44:13 -0500 CDT
Started: 2021-11-03 10:44:23 -0500 CDT

상태가 success 가 되면 내보내기를 로컬 컴퓨터에 다운로드하세요. 먼저 mmctl export list 로 완료된 내보내기 파일의 이름을 확인하세요:

mmctl export list
r3kcj8yuwbramdt714doafi3oo_export.zip

이렇게 하면 서버의 모든 내보내기가 표시되므로 최신 내보내기를 다운로드하고 저장 공간을 절약하기 위해 완료 후 삭제하세요. 다음과 같은 명령으로 파일 다운로드 링크를 생성하되, 서버의 내보내기 파일 이름을 사용하세요:

mmctl export generate-presigned-url r3kcj8yuwbramdt714doafi3oo_export.zip

팁

마지막 단계의 대안으로, Mattermost Cloud 웹 인스턴스에서 Mattermost 슬래시 명령 /exportlink [job-id|zip file|latest] 를 사용하여 내보내기 파일 다운로드 링크를 검색할 수 있습니다. latest 옵션을 사용하여 사용 가능한 최신 내보내기를 자동으로 가져오거나 job-id 또는 zip file 로 다운로드 링크를 지정하세요.
자체 호스팅 Mattermost 인스턴스에서 mmctl export generate-presigned-url 명령을 사용하려면 Mattermost v8.1.0-RC1이 필요합니다. Mattermost Enterprise v8.1.0-RC1 바이너리 또는 Mattermost Team Edition v8.1.0-RC1 바이너리 에 접근하세요.

내보내기를 새 서버에 업로드#

마지막으로, 소스 서버에서 내보내기를 가져와 대상 서버로 가져오기로 사용할 차례입니다. 진행하기 전에 원활하고 성공적인 가져오기를 위해 해당되는 경우 다음 자체 호스팅 Mattermost 구성 설정을 검토하고 수정하세요.

Mattermost 구성 설정	대용량 파일 가져오기 권장사항
팀당 최대 사용자 수	이 값을 가져오기 파일의 팀당 최대 사용자 수를 초과하는 숫자로 증가시키세요.
최대 파일 크기	이 값을 가져오기 파일의 크기보다 크게 일시적으로 증가시키세요. 성공적인 가져오기 후에는 일상적인 사용에 대한 합리적인 제한으로 이 값을 되돌리는 것을 강력히 권장합니다.
쓰기 시간 초과	파일이 시간 초과 없이 업로드될 수 있도록 가져오기 파일 속도와 네트워크 경로에 따라 이 값을 일시적으로 조정하세요. 3600 값으로 시작하고 필요한 경우 조정하세요. 성공적인 가져오기 후에는 이 설정을 초기 또는 이전 값으로 되돌리는 것을 강력히 권장합니다.
읽기 시간 초과	파일이 시간 초과 없이 업로드될 수 있도록 가져오기 파일 속도와 네트워크 경로에 따라 이 값을 일시적으로 조정하세요. 3600 값으로 시작하고 필요한 경우 조정하세요. 성공적인 가져오기 후에는 이 설정을 초기 또는 이전 값으로 되돌리는 것을 강력히 권장합니다.
Amazon S3 요청 시간 초과	클라우드 기반 파일 스토리지를 사용하는 경우, 스토리지 요청이 너무 빨리 시간 초과되지 않도록 이 값을 조정하세요.

다음으로, 소스 서버에 로그인한 것과 동일한 방식으로 mmctl 을 사용하여 대상 서버에 로그인하세요:

mmctl auth login https://localinstance.company.com

다음 명령을 사용하여 내보내기를 대상 서버에 업로드하세요. 업로드 속도는 연결 속도에 따라 달라질 수 있습니다. 업로드가 완료되면 명령이 가져오기 ID와 함께 반환됩니다:

mmctl import upload r3kcj8yuwbramdt714doafi3oo_export.zip
Upload session successfully created, ID: cfuq6q9kkjrqfgnph1pew3db4e
Import file successfully uploaded, name: xrzs9wrzufntbfcxpy39mdq9hy

새 서버로 가져오기 완료#

mmctl import list available
cfuq6q9kkjrqfgnph1pew3db4e_r3kcj8yuwbramdt714doafi3oo_export.zip

내보내기 파일을 서버로 가져오기 위해 가져오기 작업을 실행하세요. 이 프로세스의 속도는 연결 속도에 따라 달라질 수 있습니다. 먼저 가져오기 프로세스를 시작하세요:

mmctl import process cfuq6q9kkjrqfgnph1pew3db4e_r3kcj8yuwbramdt714doafi3oo_export.zip

파일을 처리하도록 표시한 후 mmctl import job list 를 사용하여 작업 상태를 확인할 수 있습니다:

mmctl --local import job list
ID: f93jxu1hzty79enwa1xy6f1tbr
Status: pending
Created: 2021-10-28 13:32:55 +0200 CEST

작업이 완료되면 success 상태가 표시됩니다:

mmctl --local import job list
ID: f93jxu1hzty79enwa1xy6f1tbr
Status: success
Created: 2021-10-28 13:32:55 +0200 CEST
Started: 2021-10-28 13:33:05 +0200 CEST

그런 다음 다음 mmctl 명령을 실행하여 내보내기 파일을 추출하여 사용하세요:

mmctl extract run [flags].

마이그레이션이 완료되고 데이터를 자체 호스팅 인스턴스로 가져온 후에는 클라우드 인스턴스를 종료하기 전에 데이터를 검증하고 모든 것이 예상대로 작동하는지 확인하기 위해 며칠 정도 시간을 두는 것이 좋습니다.

참고

이메일/비밀번호 인증을 사용하는 경우 사용자는 비밀번호를 재설정해야 합니다.

문제가 발생하면 지원팀에 문의 하거나 Mattermost 도움말 센터 를 방문하세요.

자체 호스팅에서 Cloud로 마이그레이션#

참고

이 마이그레이션 프로세스는 유료 Mattermost 버전을 사용하는 고객만 이용할 수 있습니다.

마이그레이션을 시작하기 전에 다음 정보를 참고하세요:

사용자 인증

플러그인

Marketplace에 나열되지 않은 플러그인을 사용 중인 경우, 해당 플러그인은 내보내기에 포함되지 않으며 앞으로도 사용할 수 없습니다. 플러그인 목록은 지원 지식베이스 에서 확인할 수 있습니다.

데이터

마이그레이션에는 채널 데이터만 포함됩니다. 협업 플레이북 데이터는 내보내지 않습니다.

마이그레이션 프로세스#

자체 호스팅 인스턴스에서 내보내기

관리자 자격 증명을 사용하여 자체 호스팅 Mattermost 서버에 로그인하세요. 로그인한 후 다음을 실행하세요:

mmctl export create --attachments

이렇게 하면 서버의 전체 내보내기가 생성되며 첨부 파일이 포함됩니다. 첨부 파일을 내보내지 않으려면 --attachments 를 제외하세요.

Export process job successfully created, ID: yfrr9ku5i7fjubeshs1ksrknzc

작업이 실행되는 동안 생성 시 제공된 ID를 사용하여 상태를 확인할 수 있으며, 완료되면 출력은 다음과 유사하게 표시됩니다:

mmctl export job show yfrr9ku5i7fjubeshs1ksrknzc
ID: yfrr9ku5i7fjubeshs1ksrknzc
Status: success
Created: 2021-11-03 10:44:13 -0500 CDT
Started: 2021-11-03 10:44:23 -0500 CDT

완료된 파일은 .zip 파일로 데스크톱에 다운로드됩니다.

참고

파일 이름은 로그 파일에서 참조되며 Support 팀이 내보낸 파일을 검증하는 데 사용하므로 파일 이름을 변경하지 마세요.

지원팀에서 내보낸 파일을 업로드할 수 있도록 S3 자격 증명을 제공합니다. 파일을 업로드한 후에는 지원팀에 문의 하여 알려주세요.

Mattermost Cloud에서 새 워크스페이스 생성#

그동안 Mattermost 자격 증명으로 Mattermost Cloud에 로그인하여 Cloud 워크스페이스를 생성할 수 있습니다.

참고

마이그레이션 프로세스가 이 작업을 수행하므로 Mattermost Cloud 인스턴스에 사용자를 생성하지 마세요.

Mattermost Cloud 인스턴스로 데이터 가져오기#

제공된 S3 버킷에 내보내기 업로드가 완료되고 Mattermost Cloud 인스턴스 이름/URL을 공유하면 Support가 가져오기 단계를 시작할 수 있습니다.

Mattermost Cloud 인스턴스 사용 시작#

내보내기가 완료되면 Cloud 인스턴스에 로그인하고 사용자에게 로그인을 초대할 수 있습니다.

참고

Cloud 인스턴스를 잠시 사용하고 모든 것이 예상대로 검증될 때까지 자체 호스팅 Mattermost 서버를 유지하는 것을 권장합니다.