소개

Confluence 의 페이지는 자동으로 버전 관리 및 동시 편집이 되므로 실수해도 쉽게 예전 상태로 복구할 수 있습니다.

하지만 MS Office 나 Photoshop 같은 외부 저작 도구에서 만든 파일을 Confluence 에 올리고 편집할 경우 동시성 제어가 안 되므로 내가 작업한 버전을 다른 이가 덮어 써 버릴 위험이 있습니다.


Cenote Lockpoint 는 Confluence plugin 으로 page 에 첨부된 파일을 버전 관리 시스템처럼 check-out, check-in 방식으로 관리할 수 있는 제품입니다.


이 플러그인을 설치하면 첨부 파일을 수정할 경우 배타적 락(exclusive lock)을 걸수 있으므로 내가 수정한 첨부 파일을 다른 이가 덮어쓸 위험을 방지할 수 있습니다.

만약 Confluence 와 함께 Office 등 외부 저작 도구를 사용한다면 권장하는 플러그인으로 "Balsamiq mock" 이나 gliffy diagram같이 별도의 첨부 파일을 생성하는 confluence 플러그인을 사용한다면 작업자간의 충돌을 방지하기 위해 반드시 사용하는 것이 좋습니다.

주의 사항

첨부 파일을 변경할 경우 문서-2021-06-08-#3.xlsx 처럼 이름을 바꿔서 업로드하지 마세요.

  1. 같은 이름일 경우 versioning 이 자동으로 되지만 이름이 달라질 경우 versioning 이 되지 않습니다.
  2. Confluence 는 MS Office나 PDF 의 경우 본문내 text 를 추출해서 인덱싱합니다. 바뀐 파일을 다른 이름으로 올릴 경우 동일한 내용이 너무 많아져 검색 품질이 형편없어 집니다.


첨부 파일 락킹

아래처럼 페이지에 첨부 파일이 있을 경우 클립아이콘(1) 이나 더보기 → Attachments(2) 를 통해서 페이지 첨부파일 보기로 들어갑니다.


첨부 파일 목록 화면에서 생성일, 생성자, Lock 여부등을 확인할 수 있으며 아래는 lock 이 걸리지 않았을 때 화면입니다.


첨부 파일인 "통합 문서1.xlsx" 를 수정하려면 우측의 "Lock to Edit"를 클릭하면 배타적 락을 걸수 있습니다.


락이 걸리면 아래 그림처럼 자물쇠 아이콘이 표시되며 마우스를 갖다대면 lock 을 건 작업자가 누구인지와 lock 시간이 표시됩니다.


만약 lock 을 걸었는데 다른 이가 첨부 파일을 갱신하려면 아래 화면같은 에러가 발생하며 덮어쓰기가 예방됩니다.

Unlock

첨부 파일 좌측의 화살표(모든 버전 보기)를 누르면 첨부파일의 변경 이력을 볼수 있으며 아래 예제는 첨부파일이 변경된 적이 없어서 하나의 버전만 표시됩니다.


이제 작업을 마친후에 첨부 파일을 다시 업로드하고 첨부파일 버전 보기를 클릭하면 새로운 버전이 추가된 것을 알수 있습니다.



lock 을 건 작업자는 이제 작업이 끝났으면 Unlock  을 눌러서 명시적으로 작업이 끝났음을 선언해야 후임 작업자가 첨부 파일을 업데이트할 수 있습니다.


Unlock 알림 받기

만약 여럿이 Remote 로 각자 작업해야 하는데 이전 작업자의 작업이 언제 끝날지 모른다고 가정해 봅시다.

이런 상황은 일반적일테지만 후임 작업자는 작업이 끝났는지 여부를 polling 방식으로 계속 페이지를 모니터링하는 것은 비효율적입니다.


lock point 플러그인은 비동기 방식의 알림 기능을 제공하므로 작업자가 Unlock 을 하면 알림을 받을 수 있습니다.


알림 등록을 하려면 첨부 파일 목록에 들어간 후에 "Notify Me" 를 클릭해 주면 됩니다.


그러면 "Cancel Notification" 으로 버튼이 바뀌고 이전 작업자가 Unlock 할 경우 이메일로 알림을 받을 수 있습니다.


자동 Unlocking

파일을 잠그고 깜빡한 경우 lockpoint 는 잠김 시간이 일정 기간을 지난 첨부 파일을 자동으로 락을 해제하고 잠금자에게 알림 메일을 통보합니다.



자동 잠금 해제 시간을 변경하려면 Confluence admin 으로 로그인한 후에 관리 메뉴에 들어가서 "Cenote Lockpoint""Unlock timeouts" 항목을 수정해 주면 됩니다.





WebDAV Locking

LockPoint 는 WebDAV Clients 와 호환되므로 WebDAV 방식으로 작업할 경우 자동으로 lock 을 걸수 있으며 저장하면 자동으로 Unlock 이 되므로 매우 편리합니다.


예로 confluence page내 첨부 파일을 바로 편집 - goEdit plugin 를 같이 쓰면 첨부 파일을 다운로드 → 수정 → Lock → 업로드 → Unlock 과정없이 편리하게 첨부 파일을 다룰 수 있습니다.


같이 보기