여러 프로젝트를 관리하기 위해 GitLab 그룹을 사용하는 경우 일부 문서가 여러 그룹에 걸쳐 있을 수 있습니다. 프로젝트 위키 대신 그룹 위키를 만들면 모든 그룹 구성원이 기여에 필요한 올바른 액세스 권한을 갖도록 할 수 있습니다. 그룹 위키는 프로젝트 위키와 유사하지만 몇 가지 제한 사항이 있습니다.

• Git LFS는 지원되지 않습니다.
• 그룹 위키의 변경 사항은 그룹의 활동 피드에 표시되지 않습니다.

업데이트 현황은 프로젝트 위키와의 기능 동등성을 추적하는 에픽에서 확인합니다.

프로젝트 위키와 마찬가지로 Developer, Maintainer 또는 Owner 권한을 가진 그룹 구성원이 그룹 위키를 편집할 수 있습니다. 그룹 위키 리포지터리는 그룹 리포지터리 스토리지 이동 API를 사용하여 이동할 수 있습니다.

그룹 위키 보기#

그룹 위키에 액세스하려면 다음을 수행합니다.

1. 상단 표시줄에서 Search or go to를 선택하고 그룹을 찾습니다.
2. 왼쪽 사이드바에서 Plan > Wiki를 선택합니다.

그룹 위키 내보내기#

그룹에서 Owner 권한을 가진 사용자는 그룹을 가져오거나 내보낼 때 그룹 위키를 가져오거나 내보낼 수 있습니다.

그룹 위키에서 만든 콘텐츠는 계정이 다운그레이드되거나 GitLab 평가판이 종료되어도 삭제되지 않습니다. 그룹 위키 데이터는 해당 위키의 그룹 소유자를 내보낼 때마다 함께 내보내집니다.

기능을 더 이상 사용할 수 없는 상태에서 내보내기 파일의 그룹 위키 데이터에 액세스하려면 다음을 수행해야 합니다.

1. 다음 명령으로 내보내기 파일 tarball을 추출합니다. FILENAME은 파일 이름으로 바꿉니다. tar -xvzf FILENAME.tar.gz
2. repositories 디렉터리로 이동합니다. 이 디렉터리에는 확장자가 .wiki.bundle인 Git 번들이 들어 있습니다.
3. Git 번들을 새 리포지터리로 클론합니다. FILENAME은 번들 이름으로 바꿉니다. git clone FILENAME.wiki.bundle

위키의 모든 파일은 이 Git 리포지터리에서 사용할 수 있습니다.

그룹 위키 가시성 구성#

위키는 GitLab에서 기본적으로 활성화되어 있습니다. 그룹 관리자는 그룹 설정에서 그룹 위키를 활성화하거나 비활성화할 수 있습니다.

그룹 설정을 열려면 다음을 수행합니다.

1. 상단 표시줄에서 Search or go to를 선택하고 그룹을 찾습니다.
2. 왼쪽 사이드바에서 Settings > General을 선택합니다.
3. Permissions and group features를 펼칩니다.
4. Wiki로 스크롤하여 다음 옵션 중 하나를 선택합니다.
   • Enabled: 공개 그룹의 경우 누구나 위키에 액세스할 수 있습니다. 내부 그룹의 경우 인증된 사용자만 위키에 액세스할 수 있습니다.
   • Private: 그룹 구성원만 위키에 액세스할 수 있습니다.
   • Disabled: 위키에 액세스할 수 없으며 다운로드할 수도 없습니다.
5. Save changes를 선택합니다.

그룹 위키 내용 삭제#

Rails 콘솔을 사용하여 그룹 위키의 내용을 삭제할 수 있습니다. 그런 다음 새 콘텐츠로 위키를 채울 수 있습니다.

사전 요건:

• 관리자여야 합니다.

그룹 위키에서 모든 데이터를 삭제하고 빈 상태로 다시 만들려면 다음을 수행합니다.

1. Rails 콘솔 세션을 시작합니다.

2. 다음 명령을 실행합니다.

   # Enter your group's path
   g = Group.find_by_full_path('<group-name>')
   
   # This command deletes the wiki group from the filesystem.
   g.wiki.repository.remove
   
   # Refresh the wiki repository state.
   g.wiki.repository.expire_exists_cache
   

위키의 모든 데이터가 지워졌으며 위키를 사용할 준비가 되었습니다.

관련 주제#

• 관리자를 위한 위키 설정
• 프로젝트 위키 API
• 그룹 리포지터리 스토리지 이동 API
• 그룹 위키 API
• 위키 키보드 단축키
• 에픽: 프로젝트 위키와의 기능 동등성