[Confluence Server/Data Center Add-On] Comala Publishing Guide
문제
Git hub의 pull request, merge 프로세스와 유사한 기능을 제공하는 Add-on으로, Confluence의 공간(space) 간에 페이지를 복사하거나 이동하는 기능을 제공하여, 문서의 작성, 검토 및 출판 과정을 관리하고 자동화하는 데 도움을 줍니다.
해당 Add-on을 통해 Confluence 내에서 여러 문서에대한 자동화된 버전 관리가 가능합니다. 주요 기능은 하기와 같습니다.
주요 기능:
작업 공간과 공개 공간의 분리:
사용자는 "작업 공간"에서 문서를 편집하고 검토할 수 있습니다.
검토 및 승인 과정을 거친 문서는 게시하고자하는 Space에 발행할 수 있습니다.
이를 통해 문서의 작업 중인 버전과 최종 승인된 버전을 분리하여 관리할 수 있습니다.
문서의 안전한 검토 및 게시:
팀이 안전하게 문서를 편집하고 검토할 수 있습니다.
준비가 완료되면 넓은 대상에게 문서를 공개할 수 있습니다.
버전 관리:
문서의 여러 버전을 관리하고, 특정 버전을 공개하거나 숨길 수 있습니다.
본 내용은 Data center 제품을 기준으로 작성된 가이드로, 제품마다 설정과 사용 방법에 있어 다소 차이점이 존재할 수 있습니다.
해결책
Space에 동기화 전략 설정하는 방법
"Publish to Another Space"와 "Publish from Another Space"중 선택하여 Confluence 공간 간에
배포하고 동기화 전략 방식을 설정합니다하기의 방법은 Admin space → User space로 배포하는 Case입니다.
Space내의 Space tools > Space Publishing에서 Set up Space Publishing 클릭
Publish to Another Space (다른 공간으로 배포하기): 현재 Confluence 공간에서 작성한 콘텐츠를 다른 Confluence 공간으로 배포하는 것을 의미합니다. 즉, 원본 콘텐츠가 있는 공간에서 변경된 사항을 선택한 대상 공간으로 전송하고 배포합니다. 이 방식을 사용하면 원본 공간의 콘텐츠가 변경될 때마다 대상 공간에도 해당 변경 사항이 반영되어 유지됩니다.
Publish from Another Space (다른 공간에서 가져오기): 다른 Confluence 공간에서 가져온 콘텐츠를 현재 공간으로 배포하는 것을 의미합니다. 즉, 다른 공간에서 작성한 콘텐츠를 현재 공간으로 가져오고 배포할 수 있습니다. 이 방식을 사용하면 외부 공간의 콘텐츠를 현재 공간으로 통합하거나 활용할 수 있습니다.
두 옵션의 차이점은 콘텐츠의 이동 방향과 목적에 있습니다.
"Publish to Another Space"는 현재 공간에서 다른 공간으로 콘텐츠를 배포하고 유지 관리할 때 사용되며, "Publish from Another Space"는 다른 공간에서 가져온 콘텐츠를 현재 공간으로 가져와 활용할 때 사용됩니다.
‘Admin space’에서 ‘User space’로 배포하는 프로세스로 설정할 경우, ‘Admin space’에서 Publish to Another Space를 선택한 후 Select Published Space의 Published Space에서 ‘User space’를 선택 후 Link.
Link가 완료되면 Finish → Publish 클릭
Space 동기화 환경 구성 방법
해당 Add-on을 통해 Sync label에서 sync시킬 label을 설정한 후, 해당 라벨이 부여된 페이지만 동기화 대상으로 설정할 수 있습니다.상단 메뉴의 설정 → General Configuration 클릭
왼쪽 메뉴에 위치한 Publishing → Space Publishing 클릭
Publishing Configuration에 위치한 Sync Label의 Edit을 클릭하여 Sync시킬 label을 설정
Sync label 설정 후, Admin space의 Space Publishing에서 Configure 클릭
Content options의 Use sync-label과 Publish content with the sync label의 체크 박스 활성화 (필요에 따라 Include child pages 체크박스 활성화) 이외의 CONTENT OPTIONS의 옵션에 대한 설명은 해당 Add-on의 개발사 공식 문서를 참고 부탁드립니다.
동기화 대상 페이지의 label에 전역에서 설정한 Sync label 추가
배포시킬 Space(Admin Space)의 Space tools > Space publishing > View Changes 클릭 후 Changes 내역 확인 후 Publish 클릭
Comala Publishing 권한 설정
Space-level Permissions (공간 수준 권한)
Comala Publishing은 Confluence 공간 수준에서 권한을 설정할 수 있습니다.
공간 관리자는 워크플로우를 추가, 수정, 삭제할 수 있는 권한을 가질 수 있습니다.
이 권한 설정은 Confluence의 공간 설정에서 관리됩니다.
Page-level Permissions (페이지 수준 권한)
Comala Publishing은 Confluence의 기본 페이지 권한과 함께 작동합니다.
페이지 작성자나 관리자는 해당 페이지에 대한 워크플로우 상태를 변경할 수 있습니다.
Approval Permissions (승인 권한)
워크플로우 내에서 승인 단계를 설정할 때, 특정 사용자나 그룹만이 승인을 할 수 있도록 권한을 제한할 수 있습니다.
Notifications (알림)
워크플로우의 특정 단계나 상태 변경 시, 알림을 받을 사용자나 그룹을 설정할 수 있습니다.
관련 문서
https://wiki.comalatech.com/display/AHP/Welcome+to+Comala+Publishing
https://wiki.comalatech.com/display/AHP/Content+options+-+Settings