Mattermost 워크스페이스 이전

모든 플랜 에서 사용 가능

Cloud 배포판

이 문서는 Mattermost Cloud에서 Mattermost Self-hosted 인스턴스로 이전하는 과정을 설명합니다. 미래에는 Mattermost Self-hosted에서 Mattermost Cloud로의 이전 과정도 여기에 문서화되어 제공될 것입니다.

두 설치 간의 이전은 클라우드나 Self-hosted의 출발지 또는 대상 여부에 관계없이 아래에 문서화된 동일한 과정을 따릅니다. 이러한 단계는 모든 Mattermost 인스턴스에 적용됩니다 .

클라우드에서 Self-hosted로 이전

언제든지 클라우드 워크스페이스 데이터를 Self-hosted 배포로 이전할 수 있습니다.

이 과정은 어떻게 작동합니까?

데이터를 내보내고 이전하기 전에 Mattermost를 실행할 서버에 Mattermost 설치 해야 합니다. 이전은 mmctl CLI 도구를 사용하여 수행되며, 이는 로컬에 설치된 Mattermost API를 사용하는 Mattermost의 원격 CLI 도구입니다. mmctl 은 미리 설치되어 있습니다.

mmctl 사용 노트 에서는 과정 전후에 참고할 추가 컨텍스트 및 정보를 제공합니다.

채널, 메시지, 사용자 등 클라우드 데이터를 내보내기 위해 mmctl export 명령을 사용합니다. 내보내기 파일은 내보내기 명령에서 지정한 위치로 다운로드됩니다. 내보내기가 완료되면 해당 데이터를 Self-hosted 인스턴스로 가져올 수 있습니다.

또는 Mattermost 서버에서 내보내기를 다운로드하는 것이 매우 크고 어려운 경우 Amazon S3 클라우드 저장 위치로 데이터를 내보낼 수도 있습니다. 자세한 내용은 아래의 내보내기 생성 섹션을 참조하십시오.

Note

클라우드에서 데이터를 이전하기 전에, 민감한 정보를 포함할 수 있는 데이터 내보내기를 수행할 적절한 권한이 조직 내에 있는지 확인하십시오. Mattermost는 데이터 내보내기 후에 수행되는 모든 작업에 대해 책임지지 않습니다.

또한 내보내기 과정에는 통합 또는 사용자 지정 데이터가 포함되지 않습니다. 보안 설정 및 요구 사항과 같은 인스턴스의 다른 측면도 포함되지 않습니다. 추가 데이터 및 설정을 이전하는 데 도움이 필요한 경우 지원 옵션을 확인하십시오: https://mattermost.com/support/.

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

인증

인증은 Mattermost 로그인 자격 증명 또는 인증 토큰을 사용하여 수행됩니다. 먼저 mmctl로 관리자 자격 증명을 사용하여 인스턴스에 로그인하여 example-source-domain.com 을(를) 출처 인스턴스의 네트워크 주소로 대체하십시오:

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

사용자 이름 (관리자 사용자를 사용), 비밀번호 및 연결 이름에 대한 프롬프트가 표시됩니다. 연결 이름은 편리를 위해 미래에 이 자격 증명 집합을 식별하는 데 사용되며 원하는 대로 지정할 수 있습니다. 그런 다음 내보내기 프로세스를 시작할 수 있습니다.

내보내기 생성

로그인한 후 다음 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

Tip

• 이 단계의 대체 방안으로 Mattermost Cloud 웹 인스턴스에서는 /exportlink [job-id|zip file|latest] 슬래시 명령을 사용하여 내보내기 파일 다운로드 링크를 검색할 수 있습니다. 사용 가능한 최신 내보내기를 자동으로 가져오려면 latest 옵션을 사용하거나 job-id 또는 zip file 로 다운로드 링크를 지정하십시오.

• 자체 호스팅된 Mattermost 인스턴스에서 mmctl export generate-presigned-url 명령을 사용하려면 Mattermost Enterprise v8.1.0-RC1 이상이 필요합니다. Mattermost Enterprise v8.1.0-RC1 binary 또는 Mattermost Team Edition v8.1.0-RC1 binary 에 액세스하세요.

새 서버로 내보내기 업로드

마지막으로 출발지 서버에서 내보낸 내용을 대상 서버로 가져와서 가져올 시간입니다. 계속하기 전에 해당하는 경우 다음과 같은 Self-hosted 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].

마이그레이션이 완료되고 데이터를 자체 호스팅된 인스턴스로 가져왔으면, 클라우드 인스턴스를 종료하기 전에 데이터를 확인하고 모든 것이 예상대로 작동하는지 몇 일 동안 확인하는 것을 권장합니다.

Note

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

문제가 발생하거나 문제가 있으면 Mattermost 지원팀 을 통해 지원팀에 문의하거나 Mattermost 도움말 센터 를 통해 연락하세요.

자체 호스팅된 서버에서 클라우드로 마이그레이션하기

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

Note

이 마이그레이션 프로세스는 유료 Mattermost 에디션을 사용하는 고객에게만 제공됩니다.

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

사용자 인증

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

플러그인

마켓플레이스에 나열되지 않은 플러그인을 사용하는 경우, 해당 플러그인은 내보내기에 포함되지 않으며 향후 액세스할 수 없습니다. 플러그인 목록은 지원 지식베이스 에서 확인할 수 있습니다.

데이터

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

마이그레이션 프로세스

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

관리자 자격 증명을 사용하여 자체 호스팅된 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 파일 로 다운로드됩니다.

Note

로그 파일에서 파일 이름이 참조되므로 파일 이름을 변경하지 마십시오. 이 로그 파일은 지원 팀이 내보낸 파일을 유효성 검사하는 데 사용됩니다.

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

Mattermost 클라우드에서 새 워크스페이스 만들기

그 동안, Mattermost 자격 증명으로 Mattermost 클라우드에 로그인하여 클라우드 워크스페이스를 만들 수 있습니다.

Note

Mattermost 클라우드 인스턴스에서 사용자를 만들지 마십시오. 마이그레이션 프로세스가 이 작업을 대신 수행합니다.

데이터를 Mattermost 클라우드 인스턴스로 가져오기

제공된 S3 버킷으로의 내보내기 업로드가 완료되고 Mattermost 클라우드 인스턴스 이름/URL을 공유한 후에, 지원팀이 가져오기 단계를 시작할 수 있습니다.

내보내기의 크기에 따라 이 프로세스에는 시간이 걸릴 수 있습니다. 가져오기가 완료되면 지원팀이 가능한 빨리 연락을 드릴 것입니다. 이 기간 동안 Mattermost 클라우드 인스턴스를 사용하지 않는 것이 매우 권장됩니다.

Mattermost 클라우드 인스턴스 사용 시작

내보내기가 완료되면 클라우드 인스턴스에 로그인하여 사용자를 초대할 수 있습니다.

Note

클라우드 인스턴스를 사용하기 시작하고 모든 것이 예상대로 확인될 때까지는 자체 호스팅 Mattermost 서버를 유지하는 것이 좋습니다.