---

Wiki 설정#

  - 
  Tier: Free, Premium, Ultimate

- Offering: GitLab Self-Managed

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

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

Wiki 페이지에 대한 최대 콘텐츠 크기 제한을 설정할 수 있습니다. 이 제한은 기능 남용을 방지하는 데 도움이 됩니다. 기본값은 5242880 Bytes(5 MB)입니다.

콘텐츠 크기 제한 동작 방식#

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

기존 Wiki 페이지가 제한을 초과하더라도, 해당 페이지를 다시 편집하여 콘텐츠가 변경될 때까지 제한이 적용되지 않습니다.

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

이 설정은 Admin 영역 설정에서는 사용할 수 없습니다. 이 설정을 구성하려면 Rails 콘솔 또는 Application settings API를 사용하세요.

제한 값은 바이트 단위여야 합니다. 최솟값은 1024 bytes입니다.

Rails 콘솔을 통한 구성#

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

Rails 콘솔을 시작합니다:

# For Omnibus installations
sudo gitlab-rails console

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

Wiki 페이지 최대 콘텐츠 크기를 업데이트합니다:

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

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

Gitlab::CurrentSettings.wiki_page_max_content_bytes

API를 통한 구성#

Application Settings API를 통해 Wiki 페이지 크기 제한을 설정하려면, 다른 설정을 업데이트할 때와 같이 명령어를 사용합니다:

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"

Wiki 리포지터리 크기 줄이기#

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

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

AsciiDoc URI 포함 허용#

History

• GitLab 16.1에서 도입됨.

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

Rails 콘솔을 통한 구성#

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

Rails 콘솔을 시작합니다:

# For Omnibus installations
sudo gitlab-rails console

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

AsciiDoc URI 포함을 허용하도록 Wiki를 업데이트합니다:

ApplicationSetting.first.update!(wiki_asciidoc_allow_uri_includes: true)

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

Gitlab::CurrentSettings.wiki_asciidoc_allow_uri_includes

API를 통한 구성#

Application settings API를 통해 AsciiDoc URI 포함을 허용하도록 Wiki를 설정하려면 curl 명령어를 사용합니다:

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

관련 항목#

• Wiki 사용자 문서

• 프로젝트 Wiki API

• 그룹 Wiki API