이 문서는 Jira 혹은 Confluence Server에서 Cloud로 마이그레이션 하는 가이드를 공유하기 위해 작성되었다.

원본 문서 - https://www.atlassian.com/ko/migration/cloud/guide/introduction/overview

마이그레이션 지원 도구

Cloud 마이그레이션 평가판

Atlassian은 자체 관리 라이선스의 남은 기간 및 사용자 티어와 일치하는 무료 Cloud 마이그레이션 최대 12달 동안 제공
유지보수 종료되거나 이미 만료된 경우에도 2달의 Cloud 마이그레이션 평가판 제공
- 평가 기간 중에 Standard 및 Premium Cloud 플랜 제공

Cloud Migration Assistant

Confluence - Cloud Migration Assistant
- 스페이스, 사용자 및 그룹
Jira Software / Core - Cloud Migration Assistant
- 데이터 마이그레이션 지원
Jira Service Management
- Jira site import 방식 사용
- 나중에는 Cloud Migration Assistant 지원 예정

마이그레이션 진행

1단계 - 평가

이 단계에서는 현재 환경을 조사하고 Cloud와 자체 호스팅 사이의 기능, 유지 관리 및 비용 등의 차이를 이해하고 비즈니스에 Cloud가 맞는지 평가

Cloud vs. Server 비교

서버 기능	세부사항
System Administrator permissions	Confluence의 시스템 관리자는 Atlassian Cloud site admin으로 서버 시스템 관리자의 모든 권한과 함께 청구 세부 정보 관리와 같은 추가 사용자 관리 및 사이트 관리자 권한을 가진다.
Server base URL	Atlassian 클라우드 가입자에게 도메인을 제공 ex) example.atlassian.net
External user management	Atlassian 클라우드 제품은 사용자 관리를 위해 다른 클라우드 또는 서버 사이트에 연결할 수 없음
Content indexing	콘텐츠 인덱싱에 대한 일반 액세스는 기본적으로 비활성화되어 있으며 시스템 관리자만 수행할 수 있음.
Daily backup administration	Cloud의 경우 자동으로 백업됨. admin.atlassian.com 에서 Site settings > Storage 에서 각 제품별 저장소 량 및 남은 량을 확인할 수 있음 저장 용량을 늘리는 방법은 plan 업그레이드 하는 방법외엔 없음 Plan 별 Storage Free - 2 GB Standard - 250 GB Premium - Unlimited
Editing improvements	향상된 editor
Apps	몇몇 App은 Cloud를 지원하지 않음
Mail servers	기본적으로 내부 SMTP 서버가 구성되어있으며, 구성이 불가능함.
Mail accounts	Atlassian Cloud에서는 mail to page 기능이 없음
Attachment storage	첨부파일 최대 사이즈는 100MB
Look and feel	커스텀 html, css는 제공되지 않는다. Theme 설치 제공
Backup and restore	Confluence 내보내기는 백업 관리자에서 수동으로 생성할 수 있음
Importing pages from disk	Cloud 고객은 불가능
Spam prevention / CAPTCHA	기본 Captcha는 disable 됨.
PDF export language support	한번의 하나의 폰트만이 지원됨. 새로운 폰트 설치 시, 이전 글꼴을 사용할 수 없음
Custom database configuration	불가능
Linking to anchorsin appmacros	Anchors 매크로는 지원하는 않음
Copy and delete page hierarchies	Cloud는 하위 페이지 전체 삭제 기능을 제공하지 않음
Read-only mode	Data Center만 제공

Bitbucket Server vs. Bitbucket Cloud

https://support.atlassian.com/migration/docs/functional-differences-in-bitbucket-cloud/

배포 및 관리

Cloud 보안 및 규정 준수

Atlassian은 데이터 보안, 개인 정보 보호 및 규정 준수를 매우 중요하게 생각합니다. 전 세계의 최신 규정 및 규정 준수 요구사항을 파악할 책임이 관리자 대신 Atlassian에 있으므로, 어떤 곳에 있든 데이터를 안전하게 보호할 수 있습니다. Atlassian에서 기본적으로 제공하는 보안 및 규정 준수 혜택에는 이동 시 및 미사용 시 암호화, SOC2, ISO 27001/27018, GDPR, CSA, PCI DSS, Privacy Shield, VPAT, FedRAMP 등에 대한 기본 제공형이 보장이 됩니다. 또한 중앙 집중식 허브를 통해 SAML SSO, SCIM 사용자 프로비저닝 및 Active Driectory 동기화를 설정할 수 있습니다.

https://www.atlassian.com/ko/trust

사용자 관리 및 Atlassian Access

Cloud에서 엔터프라이즈급 보안 및 중앙 집중식 관리를 위해, 하나의 구독으로 모든 Atlassian Cloud 제품에서 사용할 수 있는 Atlassian Access를 만들었음

회사에서 Cloud 애플리케이션과 관련된 보안 요구사항이 있나요?
간소화된 액세스 및 인증에 SAML SSO가 필요한가요?
자동화된 사용자 수명 주기 관리를 내부 디렉토리에 연결해야 하나요?

Cloud 플랜 및 가격

Cloud 플랜

Free - 사용자 10명 미만
Standard - 사용자 최대 10000명
Premium - 사용자 최대 10000명
- 무제한 스토리지
Enterprise - 사용자 최대 10000명
- 무제한 인스턴스

Cloud 제품에 포함된 것

Server 또는 호스팅 수수료
Server 지원
소프트웨어 갱신 / 라이선스 (및 초과 라이선싱)
가동 중지 시간, 중단 및 고장 비용
보안, 규정 준수 및 자산 관리
유지 관리에 할당된 관리자 리소스

Cloud 가격 할인

Cloud 교육 기관 - 50%
커뮤니티 가격 - 75%
오픈 소스 구독 - Free
정부 가격

현재 환경 검사

현재 기술 스택을 감사할 때는 어떤 제품을 가지고 있는지를 기록하세요.

전부 자체 관리되나요, 아니면 이미 일부 Cloud 제품이 있나요?
각 제품을 몇명의 직원이 어떤 목적으로 사용하고 있나요?
얼마나 자주 사용하나요?
이전에 알지 못했던 인스턴스가 있나요? 그러한 경우, Cloud 사이트 옆에 계속 보관할 예정인가요, 아니면 보관할 예정인가요?
실행하고 있는 Atlassian 제품의 버전은 무엇인가요?
Atlassian 제품에 사용자 지정 사항을 만들었나요?
고객님이나 팀이 인스턴스에서 워크플로 및 사용자 지정 필드를 얼마나 자주 유지하나요?

앱 및 통합 감사 및 평가

각 앱이 어떻게 사용되는지 고려해 보세요. 전부 의도한 목적대로 사용되고 있나요?
얼마나 많은 사람들이 앱을 활용하고 있나요?
여러 앱이 같은 목적의 서비스를 제공하고 있나요?
Cloud 제품에서 같은 앱 기능이 기본적으로 사용 가능한가요?
Server 및 Cloud 앱의 비용 차이는 어떻게 되나요?
만료된 앱 라이선스가 있나요?

Cloud Migration Assistant 다운로드

Jira 및 Confluence 용 Cloud 마이그레이션 어시스턴트(Jira Cloud Migration Assistnat)를 다운로드하고 탐색하여 앱을 평가 수행

앱 평가 기능은 서버에 설치한 모든 앱, Cloud 해당 앱 버전이 있는지 여부 및 기능 균등성, 그리고 마이그레이션 경로가 존재하는지 여부를 보여줌

https://support.atlassian.com/migration/docs/assess-and-migrate-apps-with-the-cloud-migration-assistant/

수동 마이그레이션 진단

https://support.atlassian.com/migration/docs/audit-apps-for-your-migration-to-cloud/

2단계 - 계획

Cloud에서 준비 마치기

Cloud 마이그레이션 평가판(또는 구매한 새 Cloud 사이트)을 사용할 때는 바로 두 가지, 조직 설정 및 도메인 확인을 수행해야 합니다. 조직 전반에서 보안을 강화하기 위해 Atlassian Access가 필요한지 여부를 결정하기에도 좋습니다.

조직 설정

다시 알리자면, 조직에서는 회사의 모든 Atlassian Cloud 사용자(여러 Atlassian 사이트 및 제품에 걸쳐)를 한곳에서 보고, 사용자의 계정을 관리하고, SAML SSO 등의 보안 기능을 설정할 수 있습니다. 모든 사이트에 대해 조직을 자동으로 만들거나, 사이트를 기존 조직으로 전환할 수 있습니다. 조직에 액세스하려면 admin.atlassian.com으로 이동하여 조직에 제품 및 사이트를 설정, 이름을 변경 및 추가하는 방법에 안내된 단계를 따르세요.

도메인 확인

도메인을 확인하면 회사 도메인의 소유권을 보호하고 해당 도메인의 모든 사용자 계정(관리되는 계정이라고도 함)을 클레임할 수 있습니다. 방법을 선택하고 조직의 도메인을 확인하는 방법에 안내된 단계를 따라보세요. 이 작업은 최대 72시간이 걸릴 수 있으므로, 미리 하는 것이 좋습니다.

Atlassian Access 필요 여부 결정

SAML SSO, 사용자 프로비저닝 등의 추가적인 보안 보호 조치가 필요하거나 외부 디렉토리에서 그룹을 동기화하려는 경우, Atlassian Access에 구독해야 할지 여부를 고려해 봐야 합니다. Cloud ID 공급자도 필요한 경우, Atlassian Access 내에서 바로 무료 Okta 계정에 가입하세요.

데이터의 크기 및 복잡성 평가

평가 단계에서는 현재 환경에 관한 정보를 수집했습니다. 이제 자체 호스팅 인스턴스를 검토하여 Cloud로 마이그레이션하려는 데이터의 양과 사용자의 수를 확인할 차례입니다. 복잡성에 영향을 줄 수 있는 요인은 다음과 같습니다.

크기: 여기에는 데이터의 크기 및 사용자의 수가 포함됩니다.
앱: 여기에는 중요한 앱의 수, 그러한 앱이 Cloud에서 사용 가능한지 여부(또는 대안이 있는지 여부) 및 마이그레이션 경로가 있는지 여부가 포함됩니다.
사용자 지정: 여기에는 사용자 지정 필드, Atlassian 이외의 통합, 사용자 지정 앱 및 비정상적인 데이터 형태가 포함될 수 있습니다.
제품의 수:마이그레이션할 제품이 많을수록 마이그레이션은 복잡해집니다. 예를 들어, Jira Software 및 Jira Service Desk를 모두 마이그레이션하는 것보다 Jira Software만 마이그레이션하는 것이 더 간단합니다.
통합, 페더레이션 또는 하이브리드 호스팅: 단순히 새 사이트로 마이그레이션하는 것이 아니라 여러 사이트를 통합하는 경우에는 데이터, 앱 및 사용자를 조정해야 하므로 프로세스가 더 복잡해집니다. 마찬가지로, Cloud 및 Server 인스턴스에서 사이트를 페더레이션 또는 분할하거나 데이터를 호스팅하도록 선택하는 경우 마이그레이션 프로세스가 더 복잡해질 수 있습니다.
사용자 관리: 여기에는 Atlassian Access의 필요성, 익명 사용자의 수, 비활성 사용자의 수 및 여러 ID 공급자의 사용이 포함됩니다.

마이그레이션 전략 및 방식 선택

사용자는 팀의 마이그레이션 요구 사항에 따라 다른 방식을 선택하게 됩니다. 아래의 섹션을 검토하여 팀을 위한 최고의 전략과 방식을 이해하고 선택하세요.

Server에서 Cloud로의 마이그레이션 전략

마그레이션 방식 선택

실제 마이그레이션 방식에는 몇 가지 선택지가 있습니다. 위에서 선택한 마이그레이션 전략을 고려하고 여기에 설명된 마이그레이션 방식을 검토하여 데이터를 Cloud로 마이그레이션할 방식을 결정하세요. 방식에 영향을 줄 요인으로는 마이그레이션하는 제품, 사용 중인 Server 또는 Data Center 버전, 이동해야 하는 데이터의 양 등이 있습니다.

마이그레이션 계획 개발하기

앱 마이그레이션 경로

마이그레이션 계획의 일부는 앱 마이그레이션 경로를 결정하는 것을 포함합니다.

앱 마이그레이션에 대해 염두에 두어야 할 몇 가지는 다음과 같습니다.

앱 데이터는 Server에서 Cloud로 자동으로 마이그레이션되지 않습니다. 일부 앱은 데이터를 내보내고 가져오는 기능이 있으며, 벤더 파트너와 함께 또는 문서를 검토하여 각 앱에 대한 최고의 마이그레이션 방식을 결정하는 것이 좋습니다.
Atlassian은 현재 앱 마이그레이션을 지원하지 않지만 현재 개발 중입니다. 그 동안 앱 벤더와 함께 최고의 마이그레이션 접근 방식을 결정해야 합니다. 진행 상황을 추적하려면 Cloud 마이그레이션 로드맵을 확인하세요.
마이그레이션 전에 앱을 사용 중지하거나 제거할 필요는 없습니다. 마이그레이션이 실행될 때 앱이 활성화되어 있어도 마이그레이션은 성공합니다.

앱 마이그레이션 경로가 있는 앱의 목록은 여기에서 검토하세요.

사용자 마이그레이션 전략

사용자 마이그레이션은 현재 사용 중인 마이그레이션 도구 및 외부 ID 공급자가 있는지 여부에 따릅니다. 사용자를 마이그레이션하도록 결정하기 전에, 각 제품에 대한 사용자, 그룹 및 권한의 마이그레이션 방식을 검토하세요.

Atlassian Access를 구독할 계획인 경우, 외부 ID 공급자 사용에 대한 Atlassian Access 권장 사항을 검토하세요.

3단계 - 준비

팀 및 사이트 준비

계획과 예상 타임라인이 준비되었으므로 이해관계자 및 영향을 받는 팀에게 마이그레이션의 세부 정보를 공유하여 사용자의 작업에 중단을 최소화하고 원활하게 시작 및 진행할 수 있도록 하세요. 일부 회사의 경우, 이 단계는 마이그레이션하는 제품의 중요도에 따라 더 일찍 실행될 수 있습니다. 또한 팀에서 변화에 대한 정보를 얻고 준비할 수 있도록, 업데이트를 언제, 그리고 얼마나 자주 커뮤니케이션할지에 대해 커뮤니케이션 간격을 정하는 것이 가장 좋습니다.

지원되는 Server 버전을 사용하고 있는지 확인

2단계에서 선택한 마이그레이션 방식에 따라, 마이그레이션을 실행하기 위해 특정 버전의 Server 또는 Data Center 인스턴스를 사용해야 할 수 있습니다. 지원되는 버전은 아래에서 검토하세요.

Clean up your server instance

The more data you migrate, the longer and more complex your migration is likely to be and could affect cloud performance later on. Use your migration as an opportunity to clean up your server instance before running your test migration.

Some things to look out for might be inactive apps or users, old product data such as projects, customizations, or workflows that can be simplified or left behind, and any duplicate data. Refer to our documentation for some guidance.

마이그레이션 전 체크리스트를 완료하세요

테스트 마이그레이션을 실행하기 전에, 자세한 마이그레이션 전 체크리스트를 검토하여 데이터 및 환경이 준비되었는지 확인하세요.

Cloud 앱 설치

테스트의 일부로, Cloud에서 사용하려는 앱의 완전한 기능 및 마이그레이션을 설치 및 테스트해보고 싶을 수 있습니다. 사용자와 이해관계자가 Cloud 기능을 테스트하여 팀의 요구 사항에 적합한지 확인할 수 있도록 하세요. 앱 마이그레이션에서 자세히 알아보세요.

4단계 - 테스트

마이그레이션 테스트

데이터 백업

Jira 백업 - https://confluence.atlassian.com/adminjiraserver/backing-up-data-938847673.html
Confluence 백업 - https://confluence.atlassian.com/doc/site-backup-and-restore-163578.html

사용자 승인 테스트

테스트 마이그레이션의 일부는 UAT(사용자 승인 테스트)를 수행하여 최종 사용자가 일반적인 일상 업무를 복제하고 예상대로 작동하는지 확인하는 것입니다. 이 프로세스를 통해 최종 사용자에게 영향을 주게 될 문제가 있는지 알아보고 팀이 Cloud와 함께 변경되는 사항에 대비하도록 지원할 수 있습니다.

https://support.atlassian.com/migration/docs/test-your-server-to-cloud-migration/

런북 및 타임라인 구축

테스트 마이그레이션 전반에서 어떤 것을 언제 수행해야 할지, 지침이 필요한지, 각 작업의 소유자는 누구인지, 그리고 각 단계의 소요 시간은 얼마나 될지에 대한 런북이나 단계별 체크리스트를 작성하세요. 또한, 어떤 단계가 서로 종속되어 있는지 기록하면 도움이 되며, 완료하지 못한 상태로 진행하는 것을 방지해 줍니다. 런북의 마지막에는 롤백해야 할 경우를 대비하여 소유자와 함께 완화 계획을 포함하세요.

테스트 마이그레이션 및 진행 방법에 익숙해졌다면 계속하여 프로덕션 마이그레이션 기간 및 계획 커뮤니케이션을 다음 단계에서 선택하세요.

https://www.atlassian.com/ko/dam/jcr:5451577b-91c9-4fc8-97f2-765ab8e89114/Cloud%20Migration%20Runbook%20Template%20.xlsx

마이그레이션 프로덕션 기간 선택

타임라인을 결정했다면 Atlassian의 지원 범위를 이해하고 마이그레이션 기간을 알려주세요.

https://support.atlassian.com/migration/docs/support-for-cloud-migrations/

교육 자료 준비

Cloud로 전환하면 몇 가지 변경 사항이 발생합니다. 최종 사용자는 이점을 누릴 수 있습니다. 로그인 방식, 새 URL, 앱 변경 사항 및 UI 차이점 등 사용자가 겪게 될 모든 중요한 변화를 숙지하고 이에 대비하세요. 위 UAT는 사용자가 할 수 있는 질문 및 사용자에게 유용할 수 있는 교육에 대해 알려줍니다. 한곳에 자료를 정리했을 뿐 아니라 Atlassian은 여기에서 유용할 수 있는 추가 리소스를 제공합니다.

Atlassian University - 관리자와 최종 사용자가 제품을 가장 잘 활용하는 방법을 알아보도록 지원하는 무료 및 유료 과정을 모두 제공합니다. 여기에서 몇몇 체인지보딩 튜토리얼을 확인하세요.
Jira 제품 가이드 - Jira 사용 및 사용자 지정, 시작, 그리고 모범 사례에 대해 알아야 할 모든 것을 제공합니다.
Confluence 제품 가이드 - Confluence를 시작하고 실행하기 위한 튜토리얼 및 데모를 제공합니다.
Bitbucket 제품 가이드 - Bitbucket Cloud 구매, 사용 및 Bitbucket Cloud를 통해 성장하는 데 필요한 모든 것을 제공합니다.
마이그레이션 후 Cloud 시작하기 - 이 페이지는 사용자에게 보내는 이메일에 포함할 수 있습니다. 또는 사용자가 액세스할 수 있는 추가 리소스로도 유용합니다.

팀을 성공적으로 전환하려면 근무 시간 또는 채팅방 등을 활용해 Cloud로의 전환에 대한 피드백을 수집하고 최종 사용자 질문에 답변하기 위한 명확한 프로세스를 만드는 것을 염두에 두세요.

계획 커뮤니케이션

타임라인과 소유자가 준비되면 공식적인 계획을 조직에 알리세요. 커뮤니케이션에 포함할 만한 사항은 다음과 같습니다.

마이그레이션 실행 시점
사용자가 예상할 수 있는 가동 중지 시간
최종 사용자에게 전환 중 변경을 피하도록 공지
마이그레이션 후에 기존 사이트에 나타나는 변화, 액세스 가능성 또는 읽기 가능성
마이그레이션에서 사용되는 새 URL
로그인 방법
이슈 발생 또는 로그인 문제 발생 시 연락 담당자
Cloud에 익숙해지기 위해 검토해야 할 온보딩 자료

마이그레이션 중에 이슈가 발생하여 문제를 해결해야 할 수 있다는 점을 염두에 두세요. 최종 사용자에게 조정 기간을 고지하여 사이트가 정리되고 계획대로 작동할 수 있도록 하세요.

5단계 - 마이그레이션

Server를 읽기 전용으로 설정

Confluence - 스페이스에서 읽기 외의 권한 제거
Jira - 찾아보기 권한만 허용 적용

프로덕션 마이그레이션 실행

Migrate any apps

파악한 앱 마이그레이션 경로를 통해, Cloud에서 사용하는 것이 중요하다고 생각되는 앱을 설치하고 마이그레이션 수행.

QA migrated data

데이터 마이그레이션이 예상대로 진행되었는지, 그리고 모든 것이 적절하고 올바르게 작동하는지 확인 수행