위키 설정

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

당신의 GitLab 인스턴스의 위키 설정을 조정하세요.

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

  • GitLab 13.2에서 도입됨.

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

작동 방식

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

기존 위키 페이지를 손상시키지 않기 위해, 제한은 위키 페이지가 다시 편집되고 콘텐츠가 변경될 때까지 적용되지 않습니다.

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

이 설정은 관리자 영역 설정을 통해 사용할 수 없습니다. 이 설정을 구성하려면 Rails 콘솔이나 Application Settings API를 사용하세요.

note
제한 값은 바이트 단위여야 합니다. 최소값은 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 Settings 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 포함 허용

  • GitLab 16.1에서 도입됨.

포함 지시문은 별도의 페이지나 외부 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 Settings 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"

관련 주제