위키 설정

Tier: Free, Premium, Ultimate Offering: Self-Managed

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

위키 페이지 콘텐츠 크기 제한

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

작동 방식

콘텐츠 크기 제한은 GitLab UI나 API를 통해 위키 페이지가 생성되거나 업데이트될 때 적용됩니다. Git을 통해 푸시된 로컬 변경은 유효성이 검사되지 않습니다.

기존 위키 페이지를 깨트리지 않으려면, 제한은 해당 위키 페이지가 다시 편집되고 콘텐츠가 변경될 때까지 적용되지 않습니다.

위키 페이지 콘텐츠 크기 제한 구성

이 설정은 관리자 영역 설정을 통해 제공되지 않습니다. 이 설정을 구성하려면 Rails 콘솔이나 Application 설정 API를 사용하십시오.

참고: 제한 값은 바이트 단위여야 합니다. 최소 값은 1024바이트입니다.

Rails 콘솔을 통해

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

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

    # Omnibus 설치의 경우
sudo gitlab-rails console

# 소스에서 설치한 경우
sudo -u git -H bundle exec rails console -e production

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

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

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

  Gitlab::CurrentSettings.wiki_page_max_content_bytes

API를 통해

Application 설정 API를 통해 위키 페이지 크기 제한을 설정하려면, 다른 설정을 업데이트하는 것처럼 명령을 사용하십시오: 

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

현재 값을 검색하려면, 다음을 사용하여 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 콘솔을 시작합니다: 

    # Omnibus 설치의 경우
sudo gitlab-rails console

# 소스에서 설치한 경우
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를 통해

AsciiDoc에 대한 URI 포함을 위해 Application 설정 API를 사용하려면, curl 명령을 사용하십시오: 

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

관련 주제