GitLab 인스턴스의 위키 설정을 조정합니다.

Wiki 페이지 콘텐츠 크기 제한#

위키 페이지의 최대 콘텐츠 크기 제한을 설정할 수 있습니다. 이 제한으로 기능 남용을 방지할 수 있습니다. 기본값은 5242880 Bytes(5 MB)입니다.

작동 방식#

콘텐츠 크기 제한은 GitLab UI 또는 API를 통해 위키 페이지를 생성하거나 업데이트할 때 적용됩니다. Git으로 푸시한 로컬 변경 사항은 검증되지 않습니다.

기존 위키 페이지를 중단하지 않도록, 위키 페이지가 다시 편집되어 콘텐츠가 변경될 때까지 제한이 적용되지 않습니다.

Wiki 페이지 콘텐츠 크기 제한 구성#

이 설정은 Admin 영역 설정을 통해 사용할 수 없습니다. 이 설정을 구성하려면 Rails 콘솔 또는 애플리케이션 설정 API를 사용합니다.

Rails 콘솔을 통해#

Rails 콘솔을 통해 이 설정을 구성하려면:

1. Rails 콘솔을 시작합니다:

   # For Omnibus installations
   sudo gitlab-rails console
   
   # For installations from source
   sudo -u git -H bundle exec rails console -e production
   

2. 위키 페이지 최대 콘텐츠 크기를 업데이트합니다:

   ApplicationSetting.first.update!(wiki_page_max_content_bytes: 5.megabytes)
   

현재 값을 검색하려면 Rails 콘솔을 시작하고 다음을 실행합니다:

Gitlab::CurrentSettings.wiki_page_max_content_bytes

API를 통해#

애플리케이션 설정 API를 통해 위키 페이지 크기 제한을 설정하려면 다른 설정을 업데이트하는 것처럼 명령을 사용합니다:

curl --request PUT --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/application/settings?wiki_page_max_content_bytes=5242880"

API를 사용하여 현재 값을 검색할 수도 있습니다:

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/application/settings"

위키 리포지터리 크기 줄이기#

위키는 네임스페이스 스토리지 크기의 일부로 계산되므로 위키 리포지터리를 가능한 한 컴팩트하게 유지해야 합니다.

리포지터리를 컴팩트하게 하는 도구에 대한 자세한 내용은 리포지터리 크기 줄이기 문서를 참조하세요.

AsciiDoc에 URI 포함 허용#

포함 지시자는 별도의 페이지나 외부 URL에서 콘텐츠를 가져와 현재 문서의 콘텐츠 일부로 표시합니다. AsciiDoc 포함을 활성화하려면 Rails 콘솔이나 API를 통해 기능을 활성화합니다.

Rails 콘솔을 통해#

Rails 콘솔을 통해 이 설정을 구성하려면:

1. Rails 콘솔을 시작합니다:

   # For Omnibus installations
   sudo gitlab-rails console
   
   # For installations from source
   sudo -u git -H bundle exec rails console -e production
   

2. AsciiDoc에 URI 포함을 허용하도록 위키를 업데이트합니다:

   ApplicationSetting.first.update!(wiki_asciidoc_allow_uri_includes: true)
   

포함이 활성화되어 있는지 확인하려면 Rails 콘솔을 시작하고 다음을 실행합니다:

Gitlab::CurrentSettings.wiki_asciidoc_allow_uri_includes

API를 통해#

애플리케이션 설정 API를 통해 AsciiDoc에 URI 포함을 허용하도록 위키를 설정하려면 curl 명령을 사용합니다:

curl --request PUT --header "PRIVATE-TOKEN: <your_access_token>" \
  "https://gitlab.example.com/api/v4/application/settings?wiki_asciidoc_allow_uri_includes=true"

관련 주제#

• 위키 사용자 문서
• 프로젝트 위키 API
• 그룹 위키 API