Confluence Cloud Migration Assistant를 사용하여 마이그레이션

Confluence Cloud Migration Assistant(CCMA)

Confluence Server 또는 Data Center의 콘텐츠, 사용자 및 그룹을 Cloud로 쉽게 이동하도록 도움을 주는 응용 프로그램. Atlassian에서 구축 및 유지 관리하는 이 앱은 무료로 설치하고 사용할 수 있습니다.

앱을 사용 하면 Cloud로 이동할 항목을 선택하고, 편리한 시간에 마이그레이션을 시작하고, 마이그레이션 프로세스 전반에 걸쳐 모든 진행 상황을 모니터링할 수 있습니다.

앱을 사용하는 경우:

• Confluence Server 또는 Data Center에서 Confluence Cloud로 사용자 또는 데이터를 이동하려는 경우

• Confluence Server 또는 Data Center에서 Confluence Cloud로 이동하기 전에 앱을 평가하려는 경우

• Confluence Server 또는 Data Center에서 Confluence Cloud로 테스트 마이그레이션을 실행하려는 경우

CCMA를 사용하여 앱 평가

앱 평가를 수행하면 마이그레이션에 필요한 앱을 설정하는 데 도움이 됩니다. 

Open

Cloud 사이트에서 가능한 데이터 충돌 확인

Server 및 Cloud 사이트에서 수동 검사를 수행하면 문제가 발생하거나 마이그레이션이 실패할 위험을 줄일 수 있습니다.

1. 그룹 충돌 확인

의도적으로 병합하려는 경우가 아니라면 Cloud 사이트에 Server 사이트의 그룹과 이름이 같은 그룹이 없는지 확인하십시오.

Server 사이트에서 Cloud 사이트의 그룹과 이름이 같은 그룹을 찾으면 Server 그룹의 사용자를 Cloud 그룹으로 병합합니다. Server 그룹 사용자는 Cloud 그룹의 권한을 상속합니다. 이는 마이그레이션하려는 Confluence 그룹과 동일한 이름을 가진 Jira 제품 액세스 권한이 있는 그룹에도 적용됩니다. 이는 모든 사용자와 그룹이 Cloud 사이트의 중앙 위치에서 관리되기 때문입니다.

이런 일이 발생하지 않도록 하려면  마이그레이션을 실행하기 전에 서버와 클라우드의 모든 그룹에 고유한 이름이 있는지 확인해야 합니다.

2. 공간 키 충돌 확인

마이그레이션하기 전에 서버와 클라우드 사이트 사이에 동일한 공간키를 사용하는 공간이 없는지 확인해야 합니다.

서버 사이트의 공간에 클라우드 사이트의 공간과 동일한 공간 키가 있는 경우 마이그레이션이 실패합니다. Confluence Cloud의 모든 공간에는 고유한 공간 키가 있어야 하기 때문입니다. 충돌을 발견하면 다음을 수행할 수 있습니다.

• 서버 또는 클라우드 사이트에서 중복 공간 삭제 

• 클라우드 사이트 재설정

• 이 공간을 마이그레이션하지 않도록 선택 

앱을 사용하여 마이그레이션 설정 및 실행

앱이 설치되면 서버 또는 데이터 센터에서 클라우드로 마이그레이션을 설정하고 실행하는 5가지 주요 단계가 있습니다.

1. 클라우드에 연결

2. 마이그레이션할 대상 선택

3. 오류 확인

4. 마이그레이션 검토

5. 마이그레이션

Open

테스트 마이그레이션 실행

최종 마이그레이션을 실행하기 전에 테스트 또는 스테이징 사이트로 마이그레이션을 시험 실행하는 것이 좋습니다. 

1. 대상 Confluence Cloud 사이트에 연결

마이그레이션 이름을 추가하고 마이그레이션할 클라우드 사이트를 선택하라는 메시지가 표시됩니다. 

서버와 대상 클라우드 사이트 모두에서 관리자여야 합니다.

클라우드 사이트를 이미 연결했다면 드롭다운에 해당 사이트가 표시되어야 합니다. 아무것도 없으면 새 클라우드 사이트를 연결하거나 새 클라우드 라이선스에 가입해야 합니다.

준비가 되면 Atlassian이 서버 사이트에서 클라우드 사이트로 데이터를 이동할 수 있도록 확인란을 선택합니다. 

Atlassian에 액세스 권한을 부여할 수 없는 경우 CCMA를 사용하여 마이그레이션 할 수 없으며 공간 가져오기를 수행해야 합니다.

Confluence Server 사이트가 방화벽 뒤에 있는 경우 atlassian.com 도메인에 대한 액세스를 허용해야 합니다.

2. 마이그레이션 할 대상 선택

한번에 마이그레이션하거나 여러 단계로 나눌 수 있습니다.

다음을 선택할 수 있습니다.

• 전체 또는 일부 사용자 및 그룹

• 마이그레이션하려는 개별 공간(및 해당 첨부 파일)

사용자 및 그룹

전체 또는 일부 사용자를 마이그레이션하도록 선택할 수 있습니다.

사용자 마이그레이션을 선택하면 처음으로 마이그레이션할 때 모든 사용자가 클라우드 사이트에 추가됩니다. 모든 마이그레이션은 첫 번째 이후에 클라우드에 이미 존재하는 사용자에게 데이터를 연결하기만 하면 됩니다.

사용자를 마이그레이션하면 클라우드 그룹에 추가됩니다. 마이그레이션 후 그룹 권한을 검토하고 승인해야 합니다. 그룹 권한을 승인하면 사용자에게 Confluence 액세스 권한이 부여되고 청구서에 추가됩니다.

사용자에게 초대장을 보내지 않습니다. 사용자를 초대하려면 마이그레이션한 후 관리 공간에서 초대를 보내거나 직접 로그인할 수 있는 링크를 보내도록 선택할 수 있습니다.

사용자 및 그룹을 마이그레이션할 때 알아야 할 기타 사항:

• 사용자는 이메일 주소를 출처로 사용하여 마이그레이션됩니다. 후속 마이그레이션에서 마이그레이션 지원은 사용자를 다시 마이그레이션하지 않고 이메일 주소로 연결합니다. 

• 클라우드로 마이그레이션하기 전에 모든 사용자 계정(이메일 주소)을 확인해야 합니다. 알 수 없는 사용자 계정을 마이그레이션하면 잠재적으로 클라우드 사이트에 대한 무단 액세스가 허용될 수 있습니다. 예를 들어, "email@example.com"과 같이 소유하지 않은 이메일을 가진 사용자가 서버 인스턴스에 있는 경우 "@example.com"을 소유한 사람을 클라우드의 사이트에 초대할 수 있습니다.

• Confluence Cloud는 구독 기반이며 사용자 기준으로 청구됩니다. 사용자를 마이그레이션할 계획이라면 사용 가능한 라이선스 옵션을 확인하십시오. 

• 외부 사용자 관리 시스템을 사용하는 경우 마이그레이션하기 전에 로컬 디렉터리와 동기화하는 것이 좋습니다. 이는 데이터를 전송하기 전에 사용자와 그룹이 최신 상태인지 확인하기 위한 것입니다.

• 서버 사이트에서 비활성화 상태인 사용자는 활성 상태로 마이그레이션되지만 제품 액세스 권한은 없습니다. 이는 청구 목적으로 활성 Confluence 사용자로 계산되지 않음을 의미 합니다.

• 서버 사이트 에서 클라우드 사이트의 그룹과 이름이 같은 그룹을 찾으면 서버 그룹의 사용자를 클라우드 그룹으로 병합합니다.

• 전역 설정 및 전역 사이트 권한은 이 도구로 마이그레이션되지 않습니다. 마이그레이션 후에 수동으로 설정해야 합니다.

• 대상 클라우드 사이트에 이미 존재하는 사용자가 있고 이 앱으로 사용자를 마이그레이션하도록 선택 하면 다음이 발생합니다.

  • 사용자가 클라우드에서 제품 액세스 권한이 있지만 서버 사이트에서 비활성화 상태인 경우 마이그레이션 후에도 클라우드에서 제품 액세스 권한이 계속 유지됩니다.

  • 사용자가 클라우드에서 제품 액세스 권한이 없지만 서버 사이트에서 활성화된 경우 마이그레이션 프로세스를 통해 제품 액세스 권한이 부여됩니다.

공간

공간 전체 또는 일부를 마이그레이션 하려면 옵션에서 마이그레이션할 공간을 선택할 수 있습니다. 공간을 마이그레이션하지 않는 경우 오류를 확인하기 위해 다음으로 바로 이동합니다.

마이그레이션에 추가할 공간을 선택합니다. 목록을 필터링하거나 특정 공간을 검색할 수 있고 모든 공간으 마이그레이션하려면 모두 선택을 클릭합니다. Confluence Cloud 대상 사이트에 이미 존재하는 공간 키로 공간을 마이그레이션할 수 없습니다 .

마이그레이션 됨 상태의 공간이 있다면, 이 공간을 동일한 클라우드 사이트로 이미 마이그레이션된 것을 감지한 것입니다.

대기 중 상태의 공간이 있다면, 마이그레이션에 이미 추가되어 실행 대기중인 공간이 있습니다.

모든 공간을 선택했으면 마이그레이션에 추가를 선택합니다. 

3. 오류 확인

이 단계에서는 마이그레이션을 검토하고 일반적인 오류를 확인합니다.

• 앱이 최신 버전인지

• 사용자는 유효하고 고유한 이메일 주소를 가지고 있는지

• 그룹이 마이그레이션 프로세스를 통해 병합되는지

• 클라우드 사이트에 공간이 이미 있는지

• 공간이 공개적으로 사용 가능하고 온라인에서 검색 가능한지

마이그레이션 프로세스 중에 다른 문제가 발생할 수도 있습니다 . 이 단계에서는 여기에 언급된 문제만 확인합니다.

녹색 체크 표시가 있으면  확인이 완료된 것입니다. 경고 표시가 나타나면  계속 진행할 수 있지만 잠재적인 문제를 포함하고 있는 것입니다.

확인에 빨간색 오류가 표시  되면 마이그레이션을 실행하기 전에 오류를 해결해야 합니다.

계속하고 나중에 수정하기로 결정한 경우 마이그레이션을 저장한 후 다시 돌아와 오류를 볼 수 있습니다.

앱 업데이트

CCMA 버전이 오래되었을 수 있습니다. 이 오류가 발생하면 마이그레이션을 실행하기 전에 앱을 업데이트해야 합니다.

사용자 및 그룹 오류

모든 사용자는 유효하고 고유한 이메일 주소를 가지고 있어야 합니다. 잘못된 이메일이나 동일한 이메일을 사용하는 여러 사용자를 감지하면 오류가 발생합니다.

모든 사용자를 마이그레이션하도록 선택한 경우 클라우드 사이트에 이미 동일한 이름을 가진 그룹이 있는지 확인합니다. 같은 이름의 그룹을 찾으면 서버 그룹의 사용자를 같은 이름의 클라우드 그룹으로 병합합니다. 이 문제를 수정하지 않고 마이그레이션을 계속할 수 있지만 이로 인해 권한 에스컬레이션이 발생하지 않는지 확인하는 것이 중요합니다.

공간 오류

공간을 마이그레이션하는 경우 공간 키 충돌이 있는지 확인합니다. 오류가 발생하면 다음을 수행할 수 있습니다.

• 클라우드 또는 서버 사이트에서 중복 공간 삭제

• 클라우드 사이트 재설정

• 마이그레이션에서 제거하여 이러한 공간을 마이그레이션하지 않도록 선택

마이그레이션을 실행하기 전에 공간 키 충돌을 해결해야 합니다.

4. 마이그레이션 검토

마이그레이션 설정의 마지막 단계입니다.

모든 확인이 완료된 후 마이그레이션을 시작하려면 실행을 클릭합니다. 나중에 마이그레이션을 시작하고 싶거나 여전히 수정할 오류가 있는 경우 저장을 클릭합니다. 마이그레이션을 실행하도록 선택하면 내용이 대시보드에 저장됩니다. 여기에서 모든 마이그레이션의 진행 상황과 세부 정보를 볼 수 있습니다.

5. 마이그레이션 관리

저장된 마이그레이션은 세부 정보를 보거나 실행할 수 있는 마이그레이션 대시보드에 나열됩니다. 마이그레이션 상태를 확인하고 진행 상황을 모니터링하거나 현재 실행 중인 마이그레이션을 중지하거나 새 마이그레이션을 생성할 수도 있습니다.

필요한 만큼 마이그레이션을 생성할 수 있습니다. 현재 마이그레이션은 수정하거나 삭제할 수 없으므로 사용할 수 없는 마이그레이션을 만들 경우 새로 생성하면 됩니다.

상태 정의

saved 마이그레이션이 저장되고 실행할 준비가 되었습니다.

running 현재 마이그레이션이 진행 중입니다.

finished 마이그레이션의 모든 작업이 완료되었습니다.

stoped 마이그레이션이 수동으로 중지되었습니다. 한 번 중지되면 재개할 수 없습니다. 이미 진행 중인 모든 단계는 마이그레이션이 완전히 중지된 것으로 표시되기 전에 먼저 완료해야 합니다. 일부 사용자, 그룹 및 공간은 이미 Confluence Cloud 사이트로 마이그레이션 되었을 수 있습니다.

failed 마이그레이션을 완료할 수 없습니다. 대상 사이트에 공간 키가 이미 존재하거나 마이그레이션에서 예기치 않은 오류가 발생했기 때문일 수 있습니다. 일부 사용자, 그룹 및 공간은 이미 Confluence Cloud 사이트로 마이그레이션되었을 수 있습니다.

마이그레이션 이후

공간을 마이그레이션한 후 공간 디렉토리에 표시되는 데 시간이 걸릴 수 있습니다. 그러나 직접 링크를 통해 계속 액세스할 수 있습니다.

마이그레이션 유형에 따라 마이그레이션이 완료된 후 수행해야 할 몇 가지 작업이 있을 수 있습니다.

사용자 및 그룹

사용자와 그룹이 올바르게 설정되었는지 확인하려면:

• 가져온 그룹 검토로 이동하여 그룹 구성원을 검토하고 권한을 승인합니다. (무료 플랜에서는 권한을 수정할 수 없습니다. 사용자 및 그룹은 원래 사이트에서와 동일한 권한을 유지합니다.)

• 필요한 경우 일반 그룹에 사용자를 추가합니다. 일반 그룹은 "site-admins", "system-administrators", "atlassian-addons", "atlassian-addons-admin" 입니다.

• 외부 사용자 관리 시스템을 사용하는 경우 사용자가 올바르게 동기화되었는지 확인하십시오.

• 준비가 되면 사용자를 초대합니다. 관리 > 사용자 > 세부 정보 표시로 이동한 다음 초대를 다시 보냅니다. 처음 로그인 할 때 새 암호를 설정하고 개인 정보를 추가하라는 메시지가 표시될 수 있습니다.

• 새로운 클라우드 작업 공간에 익숙해지도록 지원하기 위해 몇 가지 교육을 제공하거나 사용자에게 온보딩 이메일을 보내는 것이 좋습니다.

공간

공간이 성공적으로 마이그레이션되었는지 확인하려면:

• 콘텐츠 및 공간을 검토하거나 사용자에게 자신의 콘텐츠를 검토하도록 요청하세요.

• 이전 사용자의 인스턴스가 있는지 확인합니다. 이는 콘텐츠를 사용자와 일치시킬 수 없음을 의미합니다.

• 설정 > 애플리케이션 링크로 이동하여 다른 Atlassian 제품을 연결합니다.

• Jira 매크로 복구를 사용하여 Jira에 대한 모든 링크를 업데이트합니다. 클라우드 사이트에서 설정 > Jira 매크로 복구로 이동 하고 단계를 따릅니다.