애플리케이션 설정 API

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

이 API 호출을 통해 GitLab 인스턴스의
애플리케이션 설정
읽고 수정할 수 있습니다. 이 설정은 /admin/application_settings/general에 나타납니다.
이 작업을 수행하려면 관리자여야 합니다.

애플리케이션 설정은 캐싱의 영향을 받을 수 있으며, 즉시 효과가 나타나지 않을 수 있습니다.
기본적으로 GitLab은 애플리케이션 설정을 60초 동안 캐시합니다.
인스턴스의 애플리케이션 설정 캐시를 제어하는 방법에 대한 정보는
애플리케이션 캐시 간격을 참조하세요.

현재 애플리케이션 설정 가져오기

History
  • always_perform_delayed_deletion 기능 플래그가 GitLab 15.11에서 활성화되었습니다.
  • delayed_project_deletiondelayed_group_deletion 속성이 GitLab 16.0에서 제거되었습니다.
  • in_product_marketing_emails_enabled 속성이 GitLab 16.6에서 제거되었습니다.
  • repository_storages 속성이 GitLab 16.6에서 제거되었습니다.
  • user_email_lookup_limit 속성이 GitLab 16.7에서 제거되었습니다.

현재 GitLab 인스턴스의 애플리케이션 설정을 나열합니다.

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

예시 응답:

{  
  "default_projects_limit" : 100000,  
  "signup_enabled" : true,  
  "id" : 1,  
  "default_branch_protection" : 2,  
  "default_branch_protection_defaults": {  
        "allowed_to_push": [  
            {  
                "access_level": 40  
            }  
        ],  
        "allow_force_push": false,  
        "allowed_to_merge": [  
            {  
                "access_level": 40  
            }  
        ]  
    },  
  "default_preferred_language" : "en",  
  "failed_login_attempts_unlock_period_in_minutes": 30,  
  "restricted_visibility_levels" : [],  
  "password_authentication_enabled_for_web" : true,  
  "after_sign_out_path" : null,  
  "max_attachment_size" : 10,  
  "max_decompressed_archive_size": 25600,  
  "max_export_size": 50,  
  "max_import_size": 50,  
  "max_import_remote_file_size": 10240,  
  "max_login_attempts": 3,  
  "user_oauth_applications" : true,  
  "updated_at" : "2016-01-04T15:44:55.176Z",  
  "session_expire_delay" : 10080,  
  "home_page_url" : null,  
  "default_snippet_visibility" : "private",  
  "outbound_local_requests_whitelist": [],  
  "domain_allowlist" : [],  
  "domain_denylist_enabled" : false,  
  "domain_denylist" : [],  
  "created_at" : "2016-01-04T15:44:55.176Z",  
  "default_ci_config_path" : null,  
  "default_project_visibility" : "private",  
  "default_group_visibility" : "private",  
  "gravatar_enabled" : true,  
  "container_expiration_policies_enable_historic_entries": true,  
  "container_registry_cleanup_tags_service_max_list_size": 200,  
  "container_registry_delete_tags_service_timeout": 250,  
  "container_registry_expiration_policies_caching": true,  
  "container_registry_expiration_policies_worker_capacity": 4,  
  "container_registry_token_expire_delay": 5,  
  "decompress_archive_file_timeout": 210,  
  "repository_storages_weighted": {"default": 100},  
  "plantuml_enabled": false,  
  "plantuml_url": null,  
  "diagramsnet_enabled": true,  
  "diagramsnet_url": "https://embed.diagrams.net",  
  "kroki_enabled": false,  
  "kroki_url": null,  
  "terminal_max_session_time": 0,  
  "polling_interval_multiplier": 1.0,  
  "rsa_key_restriction": 0,  
  "dsa_key_restriction": 0,  
  "ecdsa_key_restriction": 0,  
  "ed25519_key_restriction": 0,  
  "ecdsa_sk_key_restriction": 0,  
  "ed25519_sk_key_restriction": 0,  
  "first_day_of_week": 0,  
  "enforce_terms": true,  
  "terms": "Hello world!",  
  "performance_bar_allowed_group_id": 42,  
  "user_show_add_ssh_key_message": true,  
  "allow_account_deletion": true,  
  "updating_name_disabled_for_users": false,  
  "local_markdown_version": 0,  
  "allow_local_requests_from_hooks_and_services": true,  
  "allow_local_requests_from_web_hooks_and_services": true,  
  "allow_local_requests_from_system_hooks": false,  
  "asset_proxy_enabled": true,  
  "asset_proxy_url": "https://assets.example.com",  
  "asset_proxy_whitelist": ["example.com", "*.example.com", "your-instance.com"],  
  "asset_proxy_allowlist": ["example.com", "*.example.com", "your-instance.com"],  
  "maven_package_requests_forwarding": true,  
  "npm_package_requests_forwarding": true,  
  "pypi_package_requests_forwarding": true,  
  "snippet_size_limit": 52428800,  
  "issues_create_limit": 300,  
  "raw_blob_request_limit": 300,  
  "wiki_page_max_content_bytes": 52428800,  
  "require_admin_approval_after_user_signup": false,  
  "require_personal_access_token_expiry": true,  
  "personal_access_token_prefix": "glpat-",  
  "rate_limiting_response_text": null,  
  "keep_latest_artifact": true,  
  "admin_mode": false,  
  "floc_enabled": false,  
  "external_pipeline_validation_service_timeout": null,  
  "external_pipeline_validation_service_token": null,  
  "external_pipeline_validation_service_url": null,  
  "jira_connect_application_key": null,  
  "jira_connect_public_key_storage_enabled": false,  
  "jira_connect_proxy_url": null,  
  "silent_mode_enabled": false,  
  "package_registry_allow_anyone_to_pull_option": true,  
  "bulk_import_max_download_file_size": 5120,  
  "project_jobs_api_rate_limit": 600,  
  "security_txt_content": null,  
  "bulk_import_concurrent_pipeline_batch_limit": 25,  
  "concurrent_github_import_jobs_limit": 1000,  
  "concurrent_bitbucket_import_jobs_limit": 100,  
  "concurrent_bitbucket_server_import_jobs_limit": 100,  
  "silent_admin_exports_enabled": false  
}  

GitLab Premium 또는 Ultimate를 사용하는 사용자도 다음과 같은 매개변수를 볼 수 있습니다:

  • group_owners_can_manage_default_branch_protection
  • file_template_project_id
  • geo_node_allowed_ips
  • geo_status_timeout
  • default_project_deletion_protection
  • deletion_adjourned_period
  • disable_personal_access_tokens
  • security_policy_global_group_approvers_enabled
  • security_approval_policies_limit
  • delete_unconfirmed_users
  • unconfirmed_users_delete_after_days
  • duo_features_enabled
  • lock_duo_features_enabled
  • use_clickhouse_for_analytics
  • pre_receive_secret_detection_enabled
{  
  "id": 1,  
  "signup_enabled": true,  
  "group_owners_can_manage_default_branch_protection": true,  
  "file_template_project_id": 1,  
  "geo_node_allowed_ips": "0.0.0.0/0, ::/0",  
  "default_project_deletion_protection": false,  
  "deletion_adjourned_period": 7,  
  "disable_personal_access_tokens": false,  
  "duo_features_enabled": true,  
  "lock_duo_features_enabled": false  
  ...  
}  

애플리케이션 설정 변경

  • always_perform_delayed_deletion 기능 플래그가 활성화되었습니다. GitLab 15.11에서.
  • delayed_project_deletiondelayed_group_deletion 속성이 GitLab 16.0에서 제거되었습니다.
  • user_email_lookup_limit 속성이 GitLab 16.7에서 제거되었습니다.
  • default_branch_protection이 GitLab 17.0에서 사용 중단되었습니다. 대신 default_branch_protection_defaults를 사용하세요.

API 호출을 사용하여 GitLab 인스턴스의 애플리케이션 설정을 수정하세요.

PUT /application/settings
curl --request PUT --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/application/settings?signup_enabled=false&default_project_visibility=internal"

예시 응답:

{
  "id": 1,
  "default_projects_limit": 100000,
  "default_preferred_language": "en",
  "failed_login_attempts_unlock_period_in_minutes": 30,
  "signup_enabled": false,
  "password_authentication_enabled_for_web": true,
  "gravatar_enabled": true,
  "created_at": "2015-06-12T15:51:55.432Z",
  "updated_at": "2015-06-30T13:22:42.210Z",
  "home_page_url": "",
  "default_branch_protection": 2,
  "default_branch_protection_defaults": {
    "allowed_to_push": [
        {
            "access_level": 40
        }
    ],
    "allow_force_push": false,
    "allowed_to_merge": [
        {
            "access_level": 40
        }
    ]
  },
  "restricted_visibility_levels": [],
  "max_attachment_size": 10,
  "max_decompressed_archive_size": 25600,
  "max_export_size": 50,
  "max_import_size": 50,
  "max_import_remote_file_size": 10240,
  "max_login_attempts": 3,
  "session_expire_delay": 10080,
  "default_ci_config_path" : null,
  "default_project_visibility": "internal",
  "default_snippet_visibility": "private",
  "default_group_visibility": "private",
  "outbound_local_requests_whitelist": [],
  "domain_allowlist": [],
  "domain_denylist_enabled" : false,
  "domain_denylist" : [],
  "external_authorization_service_enabled": true,
  "external_authorization_service_url": "https://authorize.me",
  "external_authorization_service_default_label": "default",
  "external_authorization_service_timeout": 0.5,
  "user_oauth_applications": true,
  "after_sign_out_path": "",
  "container_expiration_policies_enable_historic_entries": true,
  "container_registry_cleanup_tags_service_max_list_size": 200,
  "container_registry_delete_tags_service_timeout": 250,
  "container_registry_expiration_policies_caching": true,
  "container_registry_expiration_policies_worker_capacity": 4,
  "container_registry_token_expire_delay": 5,
  "decompress_archive_file_timeout": 210,
  "package_registry_cleanup_policies_worker_capacity": 2,
  "plantuml_enabled": false,
  "plantuml_url": null,
  "diagramsnet_enabled": true,
  "diagramsnet_url": "https://embed.diagrams.net",
  "terminal_max_session_time": 0,
  "polling_interval_multiplier": 1.0,
  "rsa_key_restriction": 0,
  "dsa_key_restriction": 0,
  "ecdsa_key_restriction": 0,
  "ed25519_key_restriction": 0,
  "ecdsa_sk_key_restriction": 0,
  "ed25519_sk_key_restriction": 0,
  "first_day_of_week": 0,
  "enforce_terms": true,
  "terms": "Hello world!",
  "performance_bar_allowed_group_id": 42,
  "user_show_add_ssh_key_message": true,
  "file_template_project_id": 1,
  "local_markdown_version": 0,
  "asset_proxy_enabled": true,
  "asset_proxy_url": "https://assets.example.com",
  "asset_proxy_allowlist": ["example.com", "*.example.com", "your-instance.com"],
  "globally_allowed_ips": "",
  "geo_node_allowed_ips": "0.0.0.0/0, ::/0",
  "allow_local_requests_from_hooks_and_services": true,
  "allow_local_requests_from_web_hooks_and_services": true,
  "allow_local_requests_from_system_hooks": false,
  "maven_package_requests_forwarding": true,
  "npm_package_requests_forwarding": true,
  "pypi_package_requests_forwarding": true,
  "snippet_size_limit": 52428800,
  "issues_create_limit": 300,
  "raw_blob_request_limit": 300,
  "wiki_page_max_content_bytes": 52428800,
  "require_admin_approval_after_user_signup": false,
  "require_personal_access_token_expiry": true,
  "personal_access_token_prefix": "glpat-",
  "rate_limiting_response_text": null,
  "keep_latest_artifact": true,
  "admin_mode": false,
  "external_pipeline_validation_service_timeout": null,
  "external_pipeline_validation_service_token": null,
  "external_pipeline_validation_service_url": null,
  "can_create_group": false,
  "jira_connect_application_key": "123",
  "jira_connect_public_key_storage_enabled": true,
  "jira_connect_proxy_url": "http://gitlab.example.com",
  "user_defaults_to_private_profile": true,
  "projects_api_rate_limit_unauthenticated": 400,
  "silent_mode_enabled": false,
  "security_policy_global_group_approvers_enabled": true,
  "security_approval_policies_limit": 5,
  "package_registry_allow_anyone_to_pull_option": true,
  "bulk_import_max_download_file_size": 5120,
  "project_jobs_api_rate_limit": 600,
  "security_txt_content": null,
  "bulk_import_concurrent_pipeline_batch_limit": 25,
  "downstream_pipeline_trigger_limit_per_project_user_sha": 0,
  "concurrent_github_import_jobs_limit": 1000,
  "concurrent_bitbucket_import_jobs_limit": 100,
  "concurrent_bitbucket_server_import_jobs_limit": 100,
  "silent_admin_exports_enabled": false
}

GitLab Premium or Ultimate 사용자는 다음 매개 변수를 볼 수 있습니다:

  • group_owners_can_manage_default_branch_protection
  • file_template_project_id
  • geo_node_allowed_ips
  • geo_status_timeout
  • default_project_deletion_protection
  • deletion_adjourned_period
  • disable_personal_access_tokens
  • security_policy_global_group_approvers_enabled
  • security_approval_policies_limit
  • delete_unconfirmed_users
  • unconfirmed_users_delete_after_days
  • duo_features_enabled
  • lock_duo_features_enabled
  • use_clickhouse_for_analytics

예시 응답:

  "file_template_project_id": 1,
  "geo_node_allowed_ips": "0.0.0.0/0, ::/0",
  "duo_features_enabled": true,
  "lock_duo_features_enabled": false,

API 호출을 통해 접근할 수 있는 설정 목록

History
  • housekeeping_full_repack_period, housekeeping_gc_period, 그리고 housekeeping_incremental_repack_period는 GitLab 15.8에서 중단됨. 대신 housekeeping_optimize_repository_period를 사용하세요.
  • allow_account_deletion는 GitLab 16.1에서 도입됨.
  • allow_project_creation_for_guest_and_below는 GitLab 16.8에서 도입됨.
  • silent_admin_exports_enabled는 GitLab 17.0에서 도입됨.
  • require_personal_access_token_expiry는 GitLab 17.3에서 도입됨.
  • receptive_cluster_agents_enabled는 GitLab 17.4에서 도입됨.

일반적으로 모든 설정은 선택사항입니다. 그러나 특정 설정을 활성화하면, 제대로 작동하기 위해 다른 설정이 필요할 수 있습니다. 이러한 요구 사항은 관련 설정의 설명에 나열되어 있습니다.

속성 타입 필요 여부 설명
admin_mode boolean 아니오 관리 작업을 위해 관리자가 Admin Mode를 활성화하려면 다시 인증해야 합니다.
admin_notification_email string 아니오 중단됨: 대신 abuse_notification_email를 사용하세요. 설정 시, 불법 사용 보고서는 이 주소로 발송됩니다. 불법 사용 보고서는 항상 Admin 영역에서 확인할 수 있습니다.
abuse_notification_email string 아니오 설정 시, 불법 사용 보고서는 이 주소로 발송됩니다. 불법 사용 보고서는 항상 Admin 영역에서 확인할 수 있습니다.
notify_on_unknown_sign_in boolean 아니오 미지의 IP 주소에서 로그인 발생 시 알림 전송을 활성화합니다.
after_sign_out_path string 아니오 로그아웃 후 사용자를 리다이렉션할 곳입니다.
email_restrictions_enabled boolean 아니오 이메일을 통한 가입 제한 활성화합니다.
email_restrictions string email_restrictions_enabled에 의해 필요 등록 시 사용된 이메일에 대해 확인되는 정규 표현식입니다.
after_sign_up_text string 아니오 가입 후 사용자에게 표시되는 텍스트입니다.
akismet_api_key string akismet_enabled에 의해 필요 Akismet 스팸 방지를 위한 API 키입니다.
akismet_enabled boolean 아니오 (활성화 시 필요: akismet_api_key) Akismet 스팸 방지를 활성화하거나 비활성화합니다.
allow_account_deletion boolean 아니오 사용자가 자신의 계정을 삭제할 수 있도록 true로 설정합니다. 프리미엄 및 얼티밋 전용입니다.
allow_group_owners_to_manage_ldap boolean 아니오 그룹 소유자가 LDAP를 관리할 수 있도록 true로 설정합니다. 프리미엄 및 얼티밋 전용입니다.
allow_local_requests_from_hooks_and_services boolean 아니오 (중단됨: 대신 allow_local_requests_from_web_hooks_and_services를 사용하세요) 웹후크와 통합에서 로컬 네트워크에 대한 요청을 허용합니다.
allow_local_requests_from_system_hooks boolean 아니오 시스템 훅에서 로컬 네트워크에 대한 요청을 허용합니다.
allow_local_requests_from_web_hooks_and_services boolean 아니오 웹후크와 통합에서 로컬 네트워크에 대한 요청을 허용합니다.
allow_project_creation_for_guest_and_below boolean 아니오 게스트 역할까지 부여된 사용자가 그룹 및 개인 프로젝트를 만들 수 있는지 여부를 나타냅니다. 기본값은 true입니다.
allow_runner_registration_token boolean 아니오 등록 토큰을 사용하여 러너를 생성할 수 있도록 허용합니다. 기본값은 true입니다.
archive_builds_in_human_readable string 아니오 작업이 오래되고 만료된 것으로 간주되는 기간을 설정합니다. 그 시간을 지나면 작업이 아카이브되며 재시도할 수 없습니다. 비워두면 작업이 만료되지 않습니다. 최소 1일 이상이어야 하며, 예: 15 days, 1 month, 2 years.
asset_proxy_enabled boolean 아니오 (활성화 시 필요: asset_proxy_url) 자산의 프록시화를 활성화합니다. 변경 사항을 적용하려면 GitLab을 다시 시작해야 합니다.
asset_proxy_secret_key string 아니오 자산 프록시 서버와의 공유 비밀입니다. GitLab을 다시 시작해야 변경 사항이 적용됩니다.
asset_proxy_url string 아니오 자산 프록시 서버의 URL입니다. GitLab을 다시 시작해야 변경 사항이 적용됩니다.
asset_proxy_whitelist string or array of strings 아니오 (중단됨: 대신 asset_proxy_allowlist를 사용하세요) 이러한 도메인과 일치하는 자산은 프록시되지 않습니다. 와일드카드 허용됩니다. 귀하의 GitLab 설치 URL은 자동으로 허용 목록에 추가됩니다. GitLab을 다시 시작해야 변경 사항이 적용됩니다.
asset_proxy_allowlist string or array of strings 아니오 이러한 도메인과 일치하는 자산은 프록시되지 않습니다. 와일드카드 허용됩니다. 귀하의 GitLab 설치 URL은 자동으로 허용 목록에 추가됩니다. GitLab을 다시 시작해야 변경 사항이 적용됩니다.
authorized_keys_enabled boolean 아니오 기본적으로 Git over SSH를 지원하기 위해 authorized_keys 파일에 기록합니다. GitLab은 데이터베이스 파일을 통해 SSH 키를 인증하도록 최적화할 수 있습니다. OpenSSH 서버를 AuthorizedKeysCommand를 사용하도록 구성한 경우에만 비활성화하세요.
auto_devops_domain string 아니오 모든 프로젝트의 자동 리뷰 앱 및 자동 배포 단계에서 기본적으로 사용할 도메인을 지정합니다.
auto_devops_enabled boolean 아니오 기본적으로 프로젝트를 위해 자동 DevOps를 활성화합니다. 미리 정의된 CI/CD 구성을 기반으로 애플리케이션을 자동으로 빌드하고 테스트 및 배포합니다.
automatic_purchased_storage_allocation boolean 아니오 이를 활성화하면 네임스페이스에서 구매한 저장소의 자동 할당이 허용됩니다. EE 배포판에만 해당됩니다.
bulk_import_enabled boolean 아니오 직접 전송을 통해 GitLab 그룹을 마이그레이션할 수 있도록 활성화합니다. GitLab 15.8에서 도입됨. 이 설정은 Admin 영역에서도 사용할 수 있습니다.
bulk_import_max_download_file_size integer 아니오 직접 전송을 통한 원본 GitLab 인스턴스에서 가져올 때의 최대 다운로드 파일 크기입니다. GitLab 16.3에서 도입됨.
can_create_group boolean 아니오 사용자가 최상위 그룹을 생성할 수 있는지 나타냅니다. GitLab 15.5에서 도입됨. 기본값은 true입니다.
check_namespace_plan boolean 아니오 이를 활성화하면 프로젝트의 네임스페이스 계획에 기능이 포함되어 있거나 프로젝트가 공개된 경우에만 라이센스가 있는 EE 기능이 사용 가능합니다. 프리미엄 및 얼티밋 전용입니다.
ci_max_total_yaml_size_bytes integer 아니오 파이프라인 구성에 할당될 수 있는 최대 메모리 양(바이트)으로, 모든 포함된 YAML 구성 파일이 포함됩니다.
ci_max_includes integer 아니오 파이프라인당 최대 포함 개수. 기본값은 150입니다.
concurrent_github_import_jobs_limit integer 아니오 GitHub 가져오기에 대한 최대 동시 가져오기 작업 수. 기본값은 1000입니다. GitLab 16.11에서 도입됨.
concurrent_bitbucket_import_jobs_limit integer 아니오 Bitbucket Cloud 가져오기에 대한 최대 동시 가져오기 작업 수. 기본값은 100입니다. GitLab 16.11에서 도입됨.
concurrent_bitbucket_server_import_jobs_limit integer 아니오 Bitbucket Server 가져오기에 대한 최대 동시 가져오기 작업 수. 기본값은 100입니다. GitLab 16.11에서 도입됨.
commit_email_hostname string 아니오 커스텀 호스트 이름(비공식 커밋 이메일용).
container_expiration_policies_enable_historic_entries boolean 아니오 모든 프로젝트에 대한 정리 정책을 활성화합니다.
container_registry_cleanup_tags_service_max_list_size integer 아니오 정리 정책의 단일 실행에서 삭제할 수 있는 최대 태그 수입니다.
container_registry_delete_tags_service_timeout integer 아니오 정리 정책에서 태그 배치를 삭제하는 데 소요될 수 있는 최대 시간(초)입니다.
container_registry_expiration_policies_caching boolean 아니오 정리 정책 실행 중 캐싱합니다.
container_registry_expiration_policies_worker_capacity integer 아니오 정리 정책에 대한 작업자 수입니다.
container_registry_token_expire_delay integer 아니오 컨테이너 레지스트리 토큰의 지속 시간(분)입니다.
package_registry_cleanup_policies_worker_capacity integer 아니오 패키지 정리 정책에 할당된 작업자 수입니다.
updating_name_disabled_for_users boolean 아니오 사용자 프로필 이름 변경 비활성화.
allow_account_deletion boolean 아니오 사용자가 자신의 계정을 삭제할 수 있도록 활성화합니다.
deactivate_dormant_users boolean 아니오 비활성 사용자의 자동 비활성화 활성화.
deactivate_dormant_users_period integer 아니오 사용자가 비활성으로 간주되는 기간(일)입니다. GitLab 15.3에서 도입됨.
decompress_archive_file_timeout integer 아니오 압축된 파일을 해제할 때의 기본 제한 시간(초)입니다. 제한 시간을 비활성화하려면 0으로 설정하세요. GitLab 16.4에서 도입됨.
default_artifacts_expire_in string 아니오 각 작업의 아티팩트 기본 만료 시간을 설정합니다.
default_branch_name string 아니오 인스턴스 수준 사용자 정의 초기 브랜치 이름.
default_branch_protection integer 아니오 GitLab 17.0에서 중단됨. 대신 default_branch_protection_defaults를 사용하세요.
default_branch_protection_defaults hash 아니오 GitLab 17.0에서 도입됨. 사용 가능한 옵션의 경우 default_branch_protection_defaults에 대한 옵션을 참조하세요.
default_ci_config_path string 아니오 새 프로젝트의 기본 CI/CD 구성 파일 및 경로(.gitlab-ci.yml이 설정되지 않은 경우).
default_group_visibility string 아니오 새 그룹이 받는 가시성 수준입니다. private, internal, public 중 하나를 매개변수로 가질 수 있습니다. 기본값은 private입니다. GitLab 16.4에서 변경됨: restricted_visibility_levels에서 어떤 수준도 설정할 수 없습니다.
default_preferred_language string 아니오 로그인하지 않은 사용자의 기본 선호 언어입니다.
default_project_creation integer 아니오 기본적으로 프로젝트 생성 보호를 설정합니다. 다음을 선택할 수 있습니다: 0 (아무도 없음), 1 (유지 관리자) 또는 2 (개발자 + 유지 관리자)
default_project_visibility string 아니오 새 프로젝트가 받는 가시성 수준입니다. private, internal, public 중 하나를 매개변수로 가질 수 있습니다. 기본값은 private입니다. GitLab 16.4에서 변경됨: restricted_visibility_levels에서 어떤 수준도 설정할 수 없습니다.
default_projects_limit integer 아니오 사용자당 프로젝트 한도입니다. 기본값은 100000입니다.
default_snippet_visibility string 아니오 새 스니펫이 받는 가시성 수준입니다. private, internal, public 중 하나를 매개변수로 가질 수 있습니다. 기본값은 private입니다.
default_syntax_highlighting_theme integer 아니오 새 사용자 및 로그인하지 않은 사용자를 위한 기본 구문 강조 테마입니다. 활용 가능한 테마의 ID를 참조하세요.
default_project_deletion_protection boolean 아니오 기본 프로젝트 삭제 보호를 활성화하므로 관리자만 프로젝트를 삭제할 수 있습니다. 기본값은 false입니다. 자가 호스팅, 프리미엄 및 얼티밋 전용입니다.
delete_unconfirmed_users boolean 아니오 사용자 이메일을 확인하지 않은 사용자를 삭제할지 여부를 지정합니다. 기본값은 false입니다. true로 설정하면, 확인되지 않은 사용자가 unconfirmed_users_delete_after_days일 후에 삭제됩니다. GitLab 16.1에서 도입됨. 자가 호스팅, 프리미엄 및 얼티밋 전용입니다.
deletion_adjourned_period integer 아니오 삭제로 표시된 프로젝트 또는 그룹을 삭제하기 전에 기다릴 일수입니다. 값은 1에서 90 사이여야 합니다. 기본값은 7입니다. 자가 호스팅, 프리미엄 및 얼티밋 전용입니다.
diagramsnet_enabled boolean 아니오 (활성화 시 필요: diagramsnet_url) Diagrams.net 통합을 활성화합니다. 기본값은 true입니다.
diagramsnet_url string diagramsnet_enabled에 의해 필요 통합을 위한 Diagrams.net 인스턴스 URL입니다.
diff_max_patch_bytes integer 아니오 최대 diff 패치 크기, 바이트 단위입니다.
diff_max_files integer 아니오 diff의 최대 파일 수.
diff_max_lines integer 아니오 diff의 최대 라인 수.
disable_admin_oauth_scopes boolean 아니오 관리자들이 api, read_api, read_repository, write_repository, read_registry, write_registry, 또는 sudo 스콥을 가진 비신뢰 OAuth 2.0 애플리케이션에 연결하지 못하도록 합니다. GitLab 15.6에서 도입됨.
disable_feed_token boolean 아니오 RSS/Atom 및 캘린더 피드 토큰의 표시를 비활성화합니다.
disable_personal_access_tokens boolean 아니오 개인 액세스 토큰을 비활성화합니다. GitLab 15.7에서 도입됨. 자가 호스팅, 프리미엄 및 얼티밋 전용입니다. API를 통해 비활성화된 개인 액세스 토큰을 다시 활성화할 수 있는 방법이 없습니다. 이는 잘 알려진 문제입니다. 사용 가능한 우회 방법에 대한 자세한 내용은 을 참조하세요.
disabled_oauth_sign_in_sources array of strings 아니오 비활성화된 OAuth 로그인 소스입니다.
dns_rebinding_protection_enabled boolean 아니오 DNS-재바인딩 공격 보호를 시행합니다.
domain_denylist_enabled boolean 아니오 (활성화 시 필요: domain_denylist) 특정 도메인에서 이메일 가입을 차단할 수 있습니다.
domain_denylist array of strings 아니오 이러한 도메인과 일치하는 이메일 주소를 가진 사용자는 가입할 수 없습니다. 와일드카드 허용됩니다. 여러 항목을 별도로 줄에 입력하세요. 예: domain.com, *.domain.com.
domain_allowlist array of strings 아니오 사람들이 가입을 위해 기업 이메일만 사용하도록 강제합니다. 기본값은 null, 즉 제한이 없음을 의미합니다.
downstream_pipeline_trigger_limit_per_project_user_sha integer 아니오 최대 다운스트림 파이프라인 트리거 비율. 기본값: 0 (제한 없음). GitLab 16.10에서 도입됨.
dsa_key_restriction integer 아니오 업로드된 DSA 키의 최소 허용 비트 길이입니다. 기본값은 0 (제한 없음)입니다. -1은 DSA 키를 비활성화합니다.
ecdsa_key_restriction integer 아니오 업로드된 ECDSA 키의 최소 허용 곡선 크기(비트 단위)입니다. 기본값은 0 (제한 없음)입니다. -1은 ECDSA 키를 비활성화합니다.
ecdsa_sk_key_restriction integer 아니오 업로드된 ECDSA_SK 키의 최소 허용 곡선 크기(비트 단위)입니다. 기본값은 0 (제한 없음)입니다. -1은 ECDSA_SK 키를 비활성화합니다.
ed25519_key_restriction integer 아니오 업로드된 ED25519 키의 최소 허용 곡선 크기(비트 단위)입니다. 기본값은 0 (제한 없음)입니다. -1은 ED25519 키를 비활성화합니다.
ed25519_sk_key_restriction integer 아니오 업로드된 ED25519_SK 키의 최소 허용 곡선 크기(비트 단위)입니다. 기본값은 0 (제한 없음)입니다. -1은 ED25519_SK 키를 비활성화합니다.
eks_access_key_id string 아니오 AWS IAM 액세스 키 ID입니다.
eks_account_id string 아니오 Amazon 계정 ID입니다.
eks_integration_enabled boolean 아니오 Amazon EKS와의 통합을 활성화합니다.
eks_secret_access_key string 아니오 AWS IAM 비밀 액세스 키입니다.
elasticsearch_aws_access_key string 아니오 AWS IAM 액세스 키. 프리미엄 및 얼티밋 전용입니다.
elasticsearch_aws_region string 아니오 Elasticsearch 도메인이 구성된 AWS 리전입니다. 프리미엄 및 얼티밋 전용입니다.
elasticsearch_aws_secret_access_key string 아니오 AWS IAM 비밀 액세스 키입니다. 프리미엄 및 얼티밋 전용입니다.
elasticsearch_aws boolean 아니오 AWS에서 호스팅된 Elasticsearch 사용을 활성화합니다. 프리미엄 및 얼티밋 전용입니다.
elasticsearch_indexed_field_length_limit integer 아니오 Elasticsearch에 의해 색인되는 텍스트 필드의 최대 크기입니다. 0 값은 제한이 없음을 의미합니다. 이 제한은 리포지토리 및 위키 색인화에는 적용되지 않습니다. 프리미엄 및 얼티밋 전용입니다.
elasticsearch_indexed_file_size_limit_kb integer 아니오 Elasticsearch에 의해 색인되는 리포지토리 및 위키 파일의 최대 크기입니다. 프리미엄 및 얼티밋 전용입니다.
elasticsearch_indexing boolean 아니오 Elasticsearch 색인을 활성화합니다. 프리미엄 및 얼티밋 전용입니다.
elasticsearch_requeue_workers boolean 아니오 색인 작업자의 자동 재큐를 활성화합니다. 이는 모든 문서가 처리될 때까지 Sidekiq 작업을 큐에 추가하여 비코드 색인 처리량을 개선합니다. 프리미엄 및 얼티밋 전용입니다.
elasticsearch_limit_indexing boolean 아니오 특정 네임스페이스 및 프로젝트를 색인할 수 있는 Elasticsearch를 제한합니다. 프리미엄 및 얼티밋 전용입니다.
elasticsearch_max_bulk_concurrency integer 아니오 색인 작업당 Elasticsearch의 최대 동시 대량 요청 수입니다. 이 규칙은 리포지토리 색인 작업에만 적용됩니다. 프리미엄 및 얼티밋 전용입니다.
elasticsearch_max_code_indexing_concurrency integer 아니오 Elasticsearch 코드 색인 배경 작업의 최대 동시 수입니다. 이 규칙은 리포지토리 색인 작업에만 적용됩니다. 프리미엄 및 얼티밋 전용입니다.
elasticsearch_worker_number_of_shards integer 아니오 색인 작업자 샤드 수입니다. 이는 Sidekiq 작업을 더 병렬적으로 추가하여 비코드 색인 처리량을 개선합니다. 기본값은 2입니다. 프리미엄 및 얼티밋 전용입니다.
elasticsearch_max_bulk_size_mb integer 아니오 MB 단위로 Elasticsearch 대량 색인 요청의 최대 크기입니다. 이 규칙은 리포지토리 색인 작업에만 적용됩니다. 프리미엄 및 얼티밋 전용입니다.
elasticsearch_namespace_ids array of integers 아니오 elasticsearch_limit_indexing가 활성화된 경우 Elasticsearch를 통해 색인할 네임스페이스입니다. 프리미엄 및 얼티밋 전용입니다.
elasticsearch_project_ids array of integers 아니오 elasticsearch_limit_indexing가 활성화된 경우 Elasticsearch를 통해 색인할 프로젝트입니다. 프리미엄 및 얼티밋 전용입니다.
elasticsearch_search boolean 아니오 Elasticsearch 검색을 활성화합니다. 프리미엄 및 얼티밋 전용입니다.
elasticsearch_url string 아니오 Elasticsearch에 연결하는 데 사용할 URL입니다. 클러스터를 지원하기 위해 쉼표로 구분된 목록을 사용하세요(예: http://localhost:9200, http://localhost:9201"). 프리미엄 및 얼티밋 전용입니다.
elasticsearch_username string 아니오 Elasticsearch 인스턴스의 username입니다. 프리미엄 및 얼티밋 전용입니다.
elasticsearch_password string 아니오 Elasticsearch 인스턴스의 비밀번호입니다. 프리미엄 및 얼티밋 전용입니다.
email_additional_text string 아니오 법적/감사/규정 준수 이유로 모든 이메일 하단에 추가되는 텍스트입니다. 프리미엄 및 얼티밋 전용입니다.
email_author_in_body boolean 아니오 일부 이메일 서버는 이메일 발신자 이름을 재정의하는 것을 지원하지 않습니다. 이 옵션을 활성화하면 이메일 본문에 이슈, 병합 요청 또는 코멘트의 작성자 이름을 포함합니다.
email_confirmation_setting string 아니오 사용자가 로그인하기 전에 이메일 확인을 해야 하는지 여부를 지정합니다. 가능한 값은 off, soft, hard입니다.
custom_http_clone_url_root string 아니오 HTTP(S)용 사용자 정의 Git 클론 URL을 설정합니다.
enabled_git_access_protocol string 아니오 Git 액세스를 위한 활성 프로토кол입니다. 허용된 값은 ssh, http, 그리고 두 프로토콜을 허용하기 위한 all입니다. all 값은 GitLab 16.9에서 도입됨.
enforce_namespace_storage_limit boolean 아니오 이를 활성화하면 네임스페이스 저장소 한도의 적용을 허용합니다.
enforce_terms boolean 아니오 (활성화 시 필요: terms) 모든 사용자에게 애플리케이션 ToS를 강제 적용합니다.
external_auth_client_cert string 아니오 (활성화 시 필요: external_auth_client_key) 외부 인증 서비스와 인증하는 데 사용할 인증서입니다.
external_auth_client_key_pass string 아니오 외부 서비스와 인증할 때 개인 키에 사용할 비밀번호입니다. 저장 시 암호화됩니다.
external_auth_client_key string external_auth_client_cert에 의해 필요 외부 인증 서비스에 대한 인증이 필요한 경우 인증서의 개인 키입니다. 저장 시 암호화됩니다.
external_authorization_service_default_label string external_authorization_service_enabled에 의해 필요 승인 요청 시 분류 레이블이 지정되지 않은 경우 사용할 기본 분류 레이블입니다.
external_authorization_service_enabled boolean 아니오 (활성화 시 필요: external_authorization_service_default_label, external_authorization_service_timeoutexternal_authorization_service_url) 프로젝트에 접근하기 위해 외부 인증 서비스를 사용하도록 활성화합니다.
external_authorization_service_timeout float external_authorization_service_enabled에 의해 필요 인증 요청이 중단되는 시간(초)입니다. 요청이 타임아웃되면 사용자의 접근이 거부됩니다. (최소: 0.001, 최대: 10, 스텝: 0.001).
external_authorization_service_url string external_authorization_service_enabled에 의해 필요 인증 요청이 전송되는 URL입니다.
external_pipeline_validation_service_url string 아니오 파이프라인 유효성 검사 요청에 사용할 URL입니다.
external_pipeline_validation_service_token string 아니오 선택 사항. external_pipeline_validation_service_url의 요청에 X-Gitlab-Token 헤더로 포함할 토큰입니다.
external_pipeline_validation_service_timeout integer 아니오 파이프라인 유효성 검사 서비스의 응답을 기다리는 시간입니다. 타임아웃이 발생하면 OK로 가정합니다.
static_objects_external_storage_url string 아니오 리포지토리 정적 객체를 위한 외부 저장소의 URL입니다.
static_objects_external_storage_auth_token string static_objects_external_storage_url에 의해 필요 static_objects_external_storage_url에서 연결된 외부 저장소에 대한 인증 토큰입니다.
failed_login_attempts_unlock_period_in_minutes integer 아니오 최대 로그인 시도 횟수를 초과한 후 사용자가 잠금 해제되는 기간(분)입니다.
file_template_project_id integer 아니오 사용자 정의 파일 템플릿을 로드할 프로젝트의 ID입니다. 프리미엄 및 얼티밋 전용입니다.
first_day_of_week integer 아니오 달력 뷰 및 날짜 선택기의 주 시작일입니다. 유효한 값은 0 (기본값) 일요일, 1 월요일 및 6 토요일입니다.
globally_allowed_ips string 아니오 항상 허용되는 IP 주소 및 CIDR의 쉼표로 구분된 목록입니다. 예: 1.1.1.1, 2.2.2.0/24.
geo_node_allowed_ips string 허용된 보조 노드의 IP 및 CIDR의 쉼표로 구분된 목록입니다. 예: 1.1.1.1, 2.2.2.0/24. 자가 호스팅, 프리미엄 및 얼티밋 전용입니다.
geo_status_timeout integer 아니오 보조 노드 상태를 가져오는 요청이 타임아웃되는 시간(초)입니다. 자가 호스팅, 프리미엄 및 얼티밋 전용입니다.
git_two_factor_session_expiry integer 아니오 2FA가 활성화된 경우 Git 작업의 세션 최대 지속 시간(분)입니다. 프리미엄 및 얼티밋 전용입니다.
gitaly_timeout_default integer 아니오 기본 Gitaly 제한 시간, 초 단위입니다. 이 제한 시간은 Git 패치/푸시 작업이나 Sidekiq 작업에 적용되지 않습니다. 제한 시간을 비활성화하려면 0으로 설정하십시오.
gitaly_timeout_fast integer 아니오 Gitaly 빠른 작업 제한 시간, 초 단위입니다. 일부 Gitaly 작업은 빠르다고 예상됩니다. 이 한도를 초과할 경우 스토리지 샤드에 문제가 있을 수 있으며 ‘빠른 실패’가 GitLab 인스턴스의 안정성을 유지하는 데 도움이 될 수 있습니다. 제한 시간을 비활성화하려면 0으로 설정하십시오.
gitaly_timeout_medium integer 아니오 중간 Gitaly 제한 시간, 초 단위입니다. 이는 Fast와 Default 제한 시간 사이의 값이어야 합니다. 제한 시간을 비활성화하려면 0으로 설정하십시오.
gitlab_dedicated_instance boolean 아니오 인스턴스가 GitLab 전용으로 프로비저닝되었는지 여부를 나타냅니다.
gitlab_environment_toolkit_instance boolean 아니오 인스턴스가 서비스 핑 보고를 위해 GitLab 환경 툴킷으로 프로비저닝되었는지 여부를 나타냅니다.
gitlab_shell_operation_limit integer 아니오 사용자가 수행할 수 있는 Git 작업의 최대 수입니다. 기본값: 600. GitLab 16.2에서 도입됨.
grafana_enabled boolean 아니오 Grafana를 활성화합니다.
grafana_url string 아니오 Grafana URL입니다.
gravatar_enabled boolean 아니오 Gravatar를 활성화합니다.
group_owners_can_manage_default_branch_protection boolean 아니오 기본 브랜치 보호를 오버라이드하지 않도록 방지합니다. 자가 호스팅, 프리미엄 및 얼티밋 전용입니다.
hashed_storage_enabled boolean 아니오 해시 저장 경로를 사용하여 새 프로젝트를 생성합니다: 불변 해시 기반 경로와 리포지토리 이름을 사용하여 디스크에 리포지토리를 저장합니다. 이는 프로젝트 URL이 변경될 때 리포지토리를 이동하거나 이름을 바꿀 필요가 없도록 하며 디스크 I/O 성능을 개선할 수 있습니다. (GitLab 버전 13.0 이상에서는 항상 활성화되며, 14.0에서는 구성 삭제가 예정되어 있습니다.)
help_page_hide_commercial_content boolean 아니오 도움말에서 마케팅 관련 항목을 숨깁니다.
help_page_support_url string 아니오 도움말 페이지 및 도움말 드롭다운 목록의 대체 지원 URL입니다.
help_page_text string 아니오 도움말 페이지에 표시될 사용자 지정 텍스트입니다.
hide_third_party_offers boolean 아니오 GitLab에서 제3자 제공 내용을 표시하지 않습니다.
home_page_url string 아니오 로그인하지 않은 경우 이 URL로 리다이렉션합니다.
housekeeping_bitmaps_enabled boolean 아니오 중단됨. Git packfile 비트맵 생성은 항상 활성화되며 API 및 UI를 통해 변경할 수 없습니다. 항상 true를 반환합니다.
housekeeping_enabled boolean 아니오 Git housekeeping을 활성화하거나 비활성화합니다. 추가 필드를 설정해야 합니다. 더 많은 정보는 Housekeeping fields를 참조하세요.
housekeeping_full_repack_period integer 아니오 중단됨. 증분 git repack가 실행되는 Git 푸시 횟수입니다. 대신 housekeeping_optimize_repository_period를 사용하세요. 자세한 내용은 Housekeeping fields를 참조하세요.
housekeeping_gc_period integer 아니오 중단됨. git gc가 실행되는 Git 푸시 횟수입니다. 대신 housekeeping_optimize_repository_period를 사용하세요. 자세한 내용은 Housekeeping fields를 참조하세요.
housekeeping_incremental_repack_period integer 아니오 중단됨. 증분 git repack가 실행되는 Git 푸시 횟수입니다. 대신 housekeeping_optimize_repository_period를 사용하세요. 자세한 내용은 Housekeeping fields를 참조하세요.
housekeeping_optimize_repository_period integer 아니오 증분 git repack가 실행되는 Git 푸시 횟수입니다.
html_emails_enabled boolean 아니오 HTML 이메일을 활성화합니다.
import_sources array of strings 아니오 프로젝트 가져오기를 허용할 출처, 가능한 값: github, bitbucket, bitbucket_server, fogbugz, git, gitlab_project, gitea, 및 manifest.
invisible_captcha_enabled boolean 아니오 가입 시 Invisible CAPTCHA 스팸 감지를 활성화합니다. 기본값은 비활성화입니다.
issues_create_limit integer 아니오 사용자당 분당 최대 이슈 생성 요청 수입니다. 기본적으로 비활성화되어 있습니다.
jira_connect_application_key string 아니오 GitLab for Jira Cloud 앱과의 인증에 사용되는 OAuth 애플리케이션 ID입니다.
jira_connect_public_key_storage_enabled boolean 아니오 GitLab for Jira Cloud 앱에 대해 공개 키 저장을 활성화합니다.
jira_connect_proxy_url string 아니오 GitLab for Jira Cloud 앱의 프록시로 사용되는 GitLab 인스턴스의 URL입니다.
keep_latest_artifact boolean 아니오 최근에 성공한 작업의 아티팩트를 삭제하지 않도록 방지합니다. 기본적으로 활성화되어 있습니다.
local_markdown_version integer 아니오 캐시된 Markdown을 무효화해야 할 때 이 값을 증가시킵니다.
mailgun_signing_key string 아니오 웹후크에서 이벤트를 수신하기 위한 Mailgun HTTP 웹후크 서명 키입니다.
mailgun_events_enabled boolean 아니오 Mailgun 이벤트 수신기를 활성화합니다.
maintenance_mode_message string 아니오 인스턴스가 유지 관리 모드일 때 표시되는 메시지입니다. 프리미엄 및 얼티밋 전용입니다.
maintenance_mode boolean 아니오 인스턴스가 유지 관리 모드인 경우 관리자의 비관리 사용자는 읽기 전용 액세스 및 읽기 전용 API 요청을 수행할 수 있습니다. 프리미엄 및 얼티밋 전용입니다.
max_artifacts_size integer 아니오 최대 아티팩트 크기(MB)입니다.
max_attachment_size integer 아니오 첨부 파일 크기 제한(MB).
max_decompressed_archive_size integer 아니오 가져온 아카이브의 최대 압축 해제 파일 크기(MB). 무제한을 원하면 0으로 설정하세요. 기본값은 25600입니다.
max_export_size integer 아니오 최대 내보내기 크기(MB). 0은 무제한입니다. 기본값 = 0 (무제한).
max_import_size integer 아니오 최대 가져오기 크기(MB). 0은 무제한입니다. 기본값 = 0 (무제한).
max_import_remote_file_size integer 아니오 외부 오브젝트 저장소에서 가져올 때의 최대 원격 파일 크기입니다. GitLab 16.3에서 도입됨.
max_login_attempts integer 아니오 사용자 잠금을 해제하기 전에 최대 로그인 시도 횟수입니다.
max_pages_size integer 아니오 페이지 리포지토리의 최대 크기(MB).
max_personal_access_token_lifetime integer 아니오 액세스 토큰의 최대 허용 수명(일)입니다. 비워 두면 기본값 365가 적용됩니다. 설정 시 값은 365 이하 여야 합니다. 변경 시, 최대 허용 수명보다 유효 기간이 긴 기존 액세스 토큰이 취소됩니다. 자가 호스팅, 얼티밋 전용입니다.
max_ssh_key_lifetime integer 아니오 SSH 키에 대한 최대 허용 수명(일). 자가 호스팅, 얼티밋 전용입니다.
max_terraform_state_size_bytes integer 아니오 Terraform 상태 파일의 최대 크기(바이트). 무제한 파일 크기를 위해 이를 0으로 설정하세요.
metrics_method_call_threshold integer 아니오 메서드 호출이 주어진 밀리초보다 오래 걸릴 경우에만 추적됩니다.
max_number_of_repository_downloads integer 아니오 사용자가 지정된 기간 내에 다운로드할 수 있는 고유 리포지토리의 최대 수입니다. 기본값: 0, 최대: 10,000 리포지토리. GitLab 15.1에서 도입됨. 자가 호스팅, 얼티밋 전용입니다.
max_number_of_repository_downloads_within_time_period integer 아니오 보고 기간(초). 기본값: 0, 최대: 864000초(10일). GitLab 15.1에서 도입됨. 자가 호스팅, 얼티밋 전용입니다.
max_yaml_depth integer 아니오 include 키워드를 사용하여 추가된 CI/CD 구성의 최대 중첩 깊이입니다. 기본값: 100.
max_yaml_size_bytes integer 아니오 단일 CI/CD 구성 파일의 최대 크기(바이트)입니다. 기본값: 2097152.
git_rate_limit_users_allowlist array of strings 아니오 Git 남용 비율 제한에서 제외된 사용자 이름 목록입니다. 기본값: [], 최대: 100 사용자 이름. GitLab 15.2에서 도입됨. 자가 호스팅, 얼티밋 전용입니다.
git_rate_limit_users_alertlist array of integers 아니오 Git 남용 비율 제한이 초과될 때 이메일을 받을 사용자 ID 목록입니다. 기본값: [], 최대: 100 사용자 ID. GitLab 15.9에서 도입됨. 자가 호스팅, 얼티밋 전용입니다.
auto_ban_user_on_excessive_projects_download boolean 아니오 활성화하면 사용자가 max_number_of_repository_downloadsmax_number_of_repository_downloads_within_time_period 각각에서 설정된 고유 프로젝트 수를 초과하여 다운로드할 경우 자동으로 애플리케이션에서 차단됩니다. GitLab 15.4에서 도입됨. 자가 호스팅, 얼티밋 전용입니다.
mirror_available boolean 아니오 리포지토리 미러링이 프로젝트 유지 관리자가 구성할 수 있도록 허용합니다. 비활성화하면 관리자만 리포지토리 미러링을 구성할 수 있습니다.
mirror_capacity_threshold integer 아니오 미러를 사전 예방적으로 스케줄링하기 전에 필요로 하는 최소 용량입니다. 프리미엄 및 얼티밋 전용입니다.
mirror_max_capacity integer 아니오 동시에 동기화할 수 있는 최대 미러 수입니다. 프리미엄 및 얼티밋 전용입니다.
mirror_max_delay integer 아니오 스케줄링된 동기화 중 미러가 가질 수 있는 최대 시간(분)입니다. 프리미엄 및 얼티밋 전용입니다.
maven_package_requests_forwarding boolean 아니오 패키지가 GitLab 패키지 레지스트리에서 발견되지 않을 때 repo.maven.apache.org를 기본 원격 리포지토리로 사용합니다. 프리미엄 및 얼티밋 전용입니다.
npm_package_requests_forwarding boolean 아니오 패키지가 GitLab 패키지 레지스트리에서 발견되지 않을 때 npmjs.org를 기본 원격 리포지토리로 사용합니다. 프리미엄 및 얼티밋 전용입니다.
pypi_package_requests_forwarding boolean 아니오 패키지가 GitLab 패키지 레지스트리에서 발견되지 않을 때 pypi.org를 기본 원격 리포지토리로 사용합니다. 프리미엄 및 얼티밋 전용입니다.
outbound_local_requests_whitelist array of strings 아니오 로컬 요청에 대한 웹후크와 통합이 비활성화된 경우 허용된 도메인 또는 IP 주소 목록을 정의합니다.
package_registry_allow_anyone_to_pull_option boolean 아니오 패키지 레지스트리에서 누구나 풀할 수 있도록 허용합니다 표시 및 변경 가능하도록 활성화합니다.
package_metadata_purl_types array of integers 아니오 패키지 레지스트리 메타데이터 동기화의 목록입니다. 사용 가능한 값의 목록을 참조하세요. 자가 호스팅, 얼티밋 전용입니다.
pages_domain_verification_enabled boolean 아니오 사용자가 사용자 정의 도메인의 소유권을 입증하도록 요구합니다. 도메인 확인은 공개 GitLab 사이트에 대한 필수 보안 조치입니다. 사용자는 도메인이 사용 가능하도록 활성화되기 전에 도메인을 제어하고 있음을 입증해야 합니다.
password_authentication_enabled_for_git boolean 아니오 Git을 통해 HTTP(S) 요청에 대해 GitLab 계정 비밀번호를 사용한 인증을 활성화합니다. 기본값은 true입니다.
password_authentication_enabled_for_web boolean 아니오 웹 인터페이스에서 GitLab 계정 비밀번호를 사용한 인증을 활성화합니다. 기본값은 true입니다.
minimum_password_length integer 아니오 비밀번호에 최소 길이가 필요한지 여부를 나타냅니다. GitLab 15.1에서 도입됨. 프리미엄 및 얼티밋 전용입니다.
password_number_required boolean 아니오 비밀번호에 숫자 하나 이상이 필요한지 여부를 나타냅니다. GitLab 15.1에서 도입됨. 프리미엄 및 얼티밋 전용입니다.
password_symbol_required boolean 아니오 비밀번호에 기호 문자가 하나 이상이 필요한지 여부를 나타냅니다. GitLab 15.1에서 도입됨. 프리미엄 및 얼티밋 전용입니다.
password_uppercase_required boolean 아니오 비밀번호에 대문자 하나 이상이 필요한지 여부를 나타냅니다. GitLab 15.1에서 도입됨. 프리미엄 및 얼티밋 전용입니다.
password_lowercase_required boolean 아니오 비밀번호에 소문자 하나 이상이 필요한지 여부를 나타냅니다. GitLab 15.1에서 도입됨. 프리미엄 및 얼티밋 전용입니다.
performance_bar_allowed_group_id string 아니오 (중단됨: 대신 performance_bar_allowed_group_path를 사용하세요) 성능 바를 전환할 수 있는 그룹의 경로입니다.
performance_bar_allowed_group_path string 아니오 성능 바를 전환할 수 있는 그룹의 경로입니다.
performance_bar_enabled boolean 아니오 (중단됨: performance_bar_allowed_group_path: nil을 전달하세요) 성능 바를 활성화할 수 있도록 허용합니다.
personal_access_token_prefix string 아니오 생성된 모든 개인 액세스 토큰의 접두사입니다.
pipeline_limit_per_project_user_sha integer 아니오 사용자 및 커밋당 분당 파이프라인 생성 요청 수의 최대값입니다. 기본적으로 비활성화되어 있습니다.
gitpod_enabled boolean 아니오 (활성화 시 필요: gitpod_url) Gitpod 통합을 활성화합니다. 기본값은 false입니다.
gitpod_url string gitpod_enabled에 의해 필요 통합을 위한 Gitpod 인스턴스 URL입니다.
kroki_enabled boolean 아니오 (활성화 시 필요: kroki_url) Kroki 통합을 활성화합니다. 기본값은 false입니다.
kroki_url string kroki_enabled에 의해 필요 통합을 위한 Kroki 인스턴스 URL입니다.
kroki_formats object 아니오 Kroki 인스턴스에서 지원하는 추가 형식입니다. 가능 값은 true 또는 false의 형식으로 bpmn, blockdiag, 및 excalidraw입니다. 형식 <format>: true 또는 <format>: false로 지정합니다.
plantuml_enabled boolean 아니오 (활성화 시 필요: plantuml_url) PlantUML 통합을 활성화합니다. 기본값은 false입니다.
plantuml_url string plantuml_enabled에 의해 필요 통합을 위한 PlantUML 인스턴스 URL입니다.
polling_interval_multiplier float 아니오 폴링을 수행하는 엔드포인트에서 사용하는 간격 승수입니다. 폴링을 비활성화하려면 0으로 설정하십시오.
project_export_enabled boolean 아니오 프로젝트 내보내기를 활성화합니다.
project_jobs_api_rate_limit integer 아니오 분당 /project/:id/jobs에 대한 최대 인증 요청 수입니다. GitLab 16.5에서 도입됨. 기본값: 600.
projects_api_rate_limit_unauthenticated integer 아니오 GitLab 15.10에서 도입됨. 모든 프로젝트 목록 API에 대한 비인증 요청의 경우 10분당 최대 요청 수입니다. 기본값: 400. 제한 해제를 비활성화하려면 0으로 설정하세요.
prometheus_metrics_enabled boolean 아니오 Prometheus 메트릭을 활성화합니다.
protected_ci_variables boolean 아니오 CI/CD 변수는 기본적으로 보호됩니다.
disable_overriding_approvers_per_merge_request boolean 아니오 프로젝트와 머지 요청에서 승인 규칙 수정 방지
prevent_merge_requests_author_approval boolean 아니오 작성자의 승인을 방지합니다.
prevent_merge_requests_committers_approval boolean 아니오 병합 요청에 대한 기여자의 승인을 방지합니다.
push_event_activities_limit integer 아니오 대량 푸시 이벤트가 생성되는 최대 변경 사항 수입니다. 0으로 설정하면 스로틀을 비활성화하지 않습니다.
push_event_hooks_limit integer 아니오 단일 푸시에서 웹후크와 통합이 트리거되지 않는 최대 변경 사항 수입니다. 0으로 설정하면 스로틀을 비활성화하지 않습니다.
rate_limiting_response_text string 아니오 throttle_* 설정을 통해 속도 제한이 활성화되어 있을 때, 속도 제한이 초과되었을 때 이 일반 텍스트 응답을 보냅니다. 비워두면 ‘나중에 다시 시도하세요’가 전송됩니다.
raw_blob_request_limit integer 아니오 각 원시 경로에 대한 분당 최대 요청 수(기본값 300). 0으로 설정하면 스로틀을 비활성화합니다.
search_rate_limit integer 아니오 인증된 상태에서 검색을 수행하기 위한 분당 최대 요청 수입니다. 기본값: 30. 스로틀을 비활성화하려면 0으로 설정합니다.
search_rate_limit_unauthenticated integer 아니오 비인증 상태에서 검색을 수행하기 위한 분당 최대 요청 수입니다. 기본값: 10. 스로틀을 비활성화하려면 0으로 설정합니다.
recaptcha_enabled boolean 아니오 (활성화 시 필요: recaptcha_private_keyrecaptcha_site_key) reCAPTCHA를 활성화합니다.
login_recaptcha_protection_enabled boolean 아니오 로그인에 대해 reCAPTCHA를 활성화합니다.
recaptcha_private_key string recaptcha_enabled에 의해 필요 reCAPTCHA에 대한 개인 키입니다.
recaptcha_site_key string recaptcha_enabled에 의해 필요 reCAPTCHA의 사이트 키입니다.
receptive_cluster_agents_enabled boolean 아니오 Kubernetes용 GitLab Agents에 대해 수신 모드를 활성화합니다.
receive_max_input_size integer 아니오 최대 푸시 크기(MB).
remember_me_enabled boolean 아니오 기억하기 설정을 활성화합니다. GitLab 16.0에서 도입됨.
repository_checks_enabled boolean 아니오 GitLab은 모든 프로젝트 및 위키 리포지토리에서 git fsck를 주기적으로 실행하여 조용한 디스크 손상 문제를 찾습니다.
repository_size_limit integer 아니오 리포지토리당 크기 제한(MB). 프리미엄 및 얼티밋 전용입니다.
repository_storages_weighted hash of strings to integers 아니오 gitlab.yml에서 가져온 이름의 해시를 사용하여 새로운 프로젝트를 생성할 저장소를 무게를 기반으로 무작위 선택할 때 사용됩니다.
require_admin_approval_after_user_signup boolean 아니오 활성화하면 등록 양식을 사용하여 계정을 생성하는 모든 사용자가 대기 승인 상태로 배치되며, 관리자가 명시적으로 승인해야 합니다.
require_personal_access_token_expiry boolean 아니오 활성화되면 사용자는 그룹 또는 프로젝트 액세스 토큰을 생성할 때 또는 서비스 계정이 소유한 개인 액세스 토큰을 생성할 때 만료 날짜를 설정해야 합니다.
require_two_factor_authentication boolean 아니오 (활성화 시 필요: two_factor_grace_period) 모든 사용자에게 2FA 설정을 요구합니다.
restricted_visibility_levels array of strings 아니오 선택된 수준은 비관리자 사용자가 그룹, 프로젝트 또는 스니펫에 대해 사용할 수 없습니다. private, internal, public 중 하나를 매개변수로 가질 수 있습니다. 기본값은 null, 이는 제한이 없음을 의미합니다. GitLab 16.4에서 변경됨: default_project_visibilitydefault_group_visibility로 설정된 수준을 선택할 수 없습니다.
rsa_key_restriction integer 아니오 업로드된 RSA 키의 최소 허용 비트 길이입니다. 기본값은 0 (제한 없음)입니다. -1은 RSA 키를 비활성화합니다.
session_expire_delay integer 아니오 세션 지속 시간(분)입니다. GitLab을 재시작해야 변경 사항이 적용됩니다.
security_policy_global_group_approvers_enabled boolean 아니오 병합 요청 승인 정책 승인 그룹을 전역적으로 검색하거나 프로젝트 계층 내에서 검색할지 여부입니다.
security_approval_policies_limit integer 아니오 보안 정책 프로젝트당 활성 병합 요청 승인 정책의 최대 수입니다. 기본값: 5. 최대: 20
security_txt_content string 아니오 공개 보안 연락처 정보. GitLab 16.7에서 도입됨.
service_access_tokens_expiration_enforced boolean 아니오 서비스 계정 사용자의 토큰 만료 날짜가 선택적일 수 있는지 여부를 나타냅니다.
shared_runners_enabled boolean 아니오 (활성화 시 필요: shared_runners_textshared_runners_minutes) 새 프로젝트에 대한 공유 러너를 활성화합니다.
shared_runners_minutes integer shared_runners_enabled에 의해 필요 그룹이 공유 러너에서 사용할 수 있는 최대 컴퓨팅 분 수를 설정합니다. 프리미엄 및 얼티밋 전용입니다.
shared_runners_text string shared_runners_enabled에 의해 필요 공유 러너 텍스트입니다.
runner_token_expiration_interval integer 아니오 새로 등록된 인스턴스 러너의 인증 토큰의 만료 시간을(초 단위) 설정합니다. 최소값은 7200초입니다. 더 많은 정보는 러너 인증 토큰 자동 회전을 참조하세요.
group_runner_token_expiration_interval integer 아니오 새로 등록된 그룹 러너의 인증 토큰의 만료 시간을(초 단위) 설정합니다. 최소값은 7200초입니다. 더 많은 정보는 러너 인증 토큰 자동 회전을 참조하세요.
project_runner_token_expiration_interval integer 아니오 새로 등록된 프로젝트 러너의 인증 토큰의 만료 시간을(초 단위) 설정합니다. 최소값은 7200초입니다. 더 많은 정보는 러너 인증 토큰 자동 회전을 참조하세요.
sidekiq_job_limiter_mode string 아니오 track 또는 compress. Sidekiq 작업 크기 제한의 동작을 설정합니다. 기본값: ‘compress’.
sidekiq_job_limiter_compression_threshold_bytes integer 아니오 Sidekiq 작업이 Redis에 저장되기 전에 압축되는 임계값(바이트)입니다. 기본값: 100,000 바이트(100 KB).
sidekiq_job_limiter_limit_bytes integer 아니오 Sidekiq 작업이 거부되는 임계값(바이트)입니다. 기본값: 0 바이트(작업을 거부하지 않음).
signin_enabled string 아니오 (중단됨: 대신 password_authentication_enabled_for_web를 사용하세요) 웹 인터페이스에 대한 비밀번호 인증이 활성화되어 있는지 표시하는 플래그입니다.
signup_enabled boolean 아니오 등록을 활성화합니다. 기본값은 true입니다.
silent_admin_exports_enabled boolean 아니오 조용한 관리자 내보내기 활성화. 기본값은 false입니다.
silent_mode_enabled boolean 아니오 조용한 모드 활성화. 기본값은 false입니다.
slack_app_enabled boolean 아니오 (활성화 시 필요: slack_app_id, slack_app_secret, slack_app_signing_secret, 및 slack_app_verification_token) GitLab for Slack 앱을 활성화합니다.
slack_app_id string slack_app_enabled에 의해 필요 GitLab for Slack 앱의 클라이언트 ID입니다.
slack_app_secret string slack_app_enabled에 의해 필요 GitLab for Slack 앱의 클라이언트 비밀입니다. 앱에서 OAuth 요청을 인증하는 데 사용됩니다.
slack_app_signing_secret string slack_app_enabled에 의해 필요 GitLab for Slack 앱의 서명 비밀입니다. API 요청을 인증하는 데 사용됩니다.
slack_app_verification_token string slack_app_enabled에 의해 필요 GitLab for Slack 앱의 검증 토큰입니다. 이 인증 방법은 Slack에 의해 중단되었으며 앱에서 슬래시 명령을 인증하는 데만 사용됩니다.
snippet_size_limit integer 아니오 최대 스니펫 콘텐츠 크기(바이트)입니다. 기본값: 52428800 바이트(50 MB).
snowplow_app_id string 아니오 Snowplow 사이트 이름 / 애플리케이션 ID입니다. (예: gitlab)
snowplow_collector_hostname string snowplow_enabled에 의해 필요 Snowplow 수집기 호스트 이름입니다. (예: snowplow.trx.gitlab.net)
snowplow_database_collector_hostname string 아니오 Snowplow 데이터베이스 이벤트 수집기 호스트 이름입니다. (예: db-snowplow.trx.gitlab.net)
snowplow_cookie_domain string 아니오 Snowplow 쿠키 도메인입니다. (예: .gitlab.com)
snowplow_enabled boolean 아니오 Snowplow 추적을 활성화합니다.
sourcegraph_enabled boolean 아니오 Sourcegraph 통합을 활성화합니다. 기본값은 false입니다. 활성화 시 필요 sourcegraph_url.
sourcegraph_public_only boolean 아니오 Sourcegraph가 비공개 및 내부 프로젝트에서 로드되지 않도록 차단합니다. 기본값은 true입니다.
sourcegraph_url string sourcegraph_enabled에 의해 필요 통합을 위한 Sourcegraph 인스턴스 URL입니다.
spam_check_endpoint_enabled boolean 아니오 외부 스팸 검사 API 끝점 사용을 활성화합니다. 기본값은 false입니다.
spam_check_endpoint_url string 아니오 외부 Spamcheck 서비스 끝점의 URL입니다. 유효한 URI 스킴은 grpc 또는 tls입니다. tls를 지정하면 통신이 암호화됩니다.
spam_check_api_key string 아니오 GitLab이 Spam Check 서비스 끝점에 액세스하는 데 사용하는 API 키입니다.
suggest_pipeline_enabled boolean 아니오 파이프라인 제안 배너를 활성화합니다.
enable_artifact_external_redirect_warning_page boolean 아니오 GitLab Pages의 사용자 생성 콘텐츠에 대한 경고를 제공하는 외부 리다이렉트 페이지를 표시합니다.
terminal_max_session_time integer 아니오 웹 터미널 웹소켓 연결의 최대 시간(초)입니다. 0으로 설정하여 무제한 시간을 설정할 수 있습니다.
terms text enforce_terms에 의해 필요 (필수: enforce_terms) ToS에 대한 Markdown 콘텐츠입니다.
throttle_authenticated_api_enabled boolean 아니오 (활성화 시 필요: throttle_authenticated_api_period_in_secondsthrottle_authenticated_api_requests_per_period) 인증된 API 요청 속도 제한을 활성화합니다. 요청량을 줄이는 데 도움이 됩니다 (예: 크롤러나 악의적인 봇으로부터).
throttle_authenticated_api_period_in_seconds integer throttle_authenticated_api_enabled에 의해 필요 속도 제한 기간(초).
throttle_authenticated_api_requests_per_period integer throttle_authenticated_api_enabled에 의해 필요 사용자당 기간당 최대 요청 수.
throttle_authenticated_packages_api_enabled boolean 아니오 (활성화 시 필요: throttle_authenticated_packages_api_period_in_secondsthrottle_authenticated_packages_api_requests_per_period) 인증된 API 요청 속도 제한을 활성화합니다. 요청량을 줄이는 데 도움이 됩니다 (예: 크롤러나 악의적인 봇으로부터). 패키지 레지스트리 속도 제한에 대한 자세한 내용은 Package Registry rate limits를 참조하세요.
throttle_authenticated_packages_api_period_in_seconds integer throttle_authenticated_packages_api_enabled에 의해 필요 속도 제한 기간(초). 패키지 레지스트리 속도 제한에 대한 자세한 내용은 Package Registry rate limits를 참조하세요.
throttle_authenticated_packages_api_requests_per_period integer throttle_authenticated_packages_api_enabled에 의해 필요 기간당 최대 요청 수. 패키지 레지스트리 속도 제한에 대한 자세한 내용은 Package Registry rate limits를 참조하세요.
throttle_authenticated_web_enabled boolean 아니오 (활성화 시 필요: throttle_authenticated_web_period_in_secondsthrottle_authenticated_web_requests_per_period) 인증된 웹 요청 속도 제한을 활성화합니다. 요청량을 줄이는 데 도움이 됩니다 (예: 크롤러나 악의적인 봇으로부터).
throttle_authenticated_web_period_in_seconds integer throttle_authenticated_web_enabled에 의해 필요 속도 제한 기간(초).
throttle_authenticated_web_requests_per_period integer throttle_authenticated_web_enabled에 의해 필요 기간당 최대 요청 수.
throttle_unauthenticated_enabled boolean 아니오 (중단됨: GitLab 14.3에서 중단됨. throttle_unauthenticated_web_enabled 또는 throttle_unauthenticated_api_enabled로 대체하십시오.) (활성화 시 필요: throttle_unauthenticated_period_in_secondsthrottle_unauthenticated_requests_per_period) 비인증 웹 요청 속도 제한을 활성화합니다. 요청량을 줄이는 데 도움이 됩니다 (예: 크롤러나 악의적인 봇으로부터).
throttle_unauthenticated_period_in_seconds      

비활성 프로젝트 삭제 구성

비활성 프로젝트 삭제를 구성하거나 비활성화할 수 있습니다.

속성 유형 필수 설명
delete_inactive_projects boolean 아니오 비활성 프로젝트 삭제를 활성화합니다. 기본값은 false입니다. 기능 플래그 없이 작동 가능 (GitLab 15.4).
inactive_projects_delete_after_months integer 아니오 delete_inactive_projectstrue이면 비활성 프로젝트를 삭제하기 전에 기다릴 시간(개월 기준). 기본값은 2입니다. 작동 가능 (GitLab 15.0).
inactive_projects_min_size_mb integer 아니오 delete_inactive_projectstrue이면 비활성 상태를 확인할 프로젝트의 최소 리포지토리 크기. 기본값은 0입니다. 작동 가능 (GitLab 15.0).
inactive_projects_send_warning_email_after_months integer 아니오 delete_inactive_projectstrue이면 비활성 프로젝트로 인해 삭제 예정인 프로젝트에 대해 유지 관리에게 경고 이메일을 보내기 전에 기다릴 시간(개월 기준). 기본값은 1입니다. 작동 가능 (GitLab 15.0).

정리 필드

15.8 및 이후

housekeeping_optimize_repository_period 필드가 정수로 설정되어 있으면, 지정한 Git 푸시 수 이후 정리 작업이 수행됩니다.

15.7 및 이전

housekeeping_enabled 필드는 Git 정리를 활성화 또는 비활성화합니다. 제대로 작동하려면 이 필드는 housekeeping_optimize_repository_period가 설정되어 있거나 다음 모든 값이 설정되어 있어야 합니다:

  • housekeeping_bitmaps_enabled
  • housekeeping_full_repack_period
  • housekeeping_gc_period

패키지 레지스트리: 패키지 파일 크기 제한

패키지 파일 크기 제한은 애플리케이션 설정 API의 일부가 아닙니다. 대신, 이러한 설정은 요금제 제한 API를 사용하여 액세스할 수 있습니다.

관련 주제