환경 변수

요약

GitLab은 기본값을 재정의하는 데 사용할 수 있는 특정 환경 변수를 노출합니다. 일반적으로 GitLab을 다음으로 구성합니다: 다음 환경 변수를 사용하여 특정 값을 재정의할 수 있습니다: 변수를 사용하여 더 많은 설정을 구성 가능하게 만드는 Merge Request을 환영합니다.

GitLab은 기본값을 재정의하는 데 사용할 수 있는 특정 환경 변수를 노출합니다.

일반적으로 GitLab을 다음으로 구성합니다:

Linux 패키지 설치의 경우 /etc/gitlab/gitlab.rb.
소스에서 컴파일한 설치의 경우 gitlab.yml.

다음 환경 변수를 사용하여 특정 값을 재정의할 수 있습니다:

지원되는 환경 변수#

변수	유형	설명
`DATABASE_URL`	string	데이터베이스 URL. 형식은 `postgresql://localhost/blog_development`입니다.
`ENABLE_BOOTSNAP`	string	초기 Rails 부팅 속도를 높이기 위한 Bootsnap을 토글합니다. 비프로덕션 환경에서는 기본적으로 활성화됩니다. 비활성화하려면 `0`으로 설정합니다.
`EXTERNAL_URL`	string	설치 시 외부 URL을 지정합니다.
`EXTERNAL_VALIDATION_SERVICE_TIMEOUT`	integer	외부 CI/CD 파이프라인 유효성 검사 서비스의 타임아웃(초). 기본값은 `5`입니다.
`EXTERNAL_VALIDATION_SERVICE_URL`	string	외부 CI/CD 파이프라인 유효성 검사 서비스의 URL.
`EXTERNAL_VALIDATION_SERVICE_TOKEN`	string	외부 CI/CD 파이프라인 유효성 검사 서비스와 인증하기 위한 `X-Gitlab-Token`.
`GITLAB_CDN_HOST`	string	정적 자산을 제공하는 CDN의 기본 URL을 설정합니다(예: `https://mycdnsubdomain.fictional-cdn.com`).
`GITLAB_EMAIL_DISPLAY_NAME`	string	GitLab에서 보내는 이메일의 From 필드에 사용되는 이름.
`GITLAB_EMAIL_FROM`	string	GitLab에서 보내는 이메일의 From 필드에 사용되는 이메일 주소.
`GITLAB_EMAIL_REPLY_TO`	string	GitLab에서 보내는 이메일의 Reply-To 필드에 사용되는 이메일 주소.
`GITLAB_EMAIL_SUBJECT_PREFIX`	string	GitLab에서 보내는 이메일에 사용되는 이메일 제목 접두사.
`GITLAB_EMAIL_SUBJECT_SUFFIX`	string	GitLab에서 보내는 이메일에 사용되는 이메일 제목 접미사.
`GITLAB_HOST`	string	GitLab 서버의 전체 URL(`http://` 또는 `https://` 포함).
`GITLAB_MARKUP_TIMEOUT`	string	`gitlab-markup` gem에서 실행되는 `rest2html` 및 `pod2html` 명령의 타임아웃(초). 기본값은 `10`입니다.
`GITLAB_ROOT_PASSWORD`	string	설치 시 `root` 사용자의 비밀번호를 설정합니다.
`GITLAB_SHARED_RUNNERS_REGISTRATION_TOKEN`	string	Runner에 사용되는 초기 등록 토큰을 설정합니다. GitLab 16.11에서 더 이상 사용되지 않음.
`RAILS_ENV`	string	Rails 환경. `production`, `development`, `staging`, `test` 중 하나일 수 있습니다.
`GITLAB_RAILS_CACHE_DEFAULT_TTL_SECONDS`	integer	Rails 캐시에 저장된 항목에 사용되는 기본 TTL. 기본값은 `28800`. 15.3에서 도입.
`GITLAB_CI_CONFIG_FETCH_TIMEOUT_SECONDS`	integer	CI 구성에서 원격 포함을 확인하기 위한 타임아웃(초). `0`에서 `60` 사이여야 합니다. 기본값은 `30`. 15.11에서 도입.
`GITLAB_CI_CONFIG_GITALY_TIMEOUT_SECONDS`	integer	CI 구성 파일(로컬, 프로젝트, 컴포넌트 포함)을 가져올 때 Gitaly 호출에 대한 요청별 타임아웃(초). 기본값은 `10`.
`GITLAB_CI_CONFIG_HTTP_OPEN_TIMEOUT_SECONDS`	integer	원격 CI 구성 파일을 가져올 때 HTTP 호출에 대한 요청별 열기(연결) 타임아웃(초). `1`에서 `60` 사이여야 합니다. 기본값은 `10`. `ci_config_http_timeout` 기능 플래그가 필요합니다.
`GITLAB_CI_CONFIG_HTTP_READ_TIMEOUT_SECONDS`	integer	원격 CI 구성 파일을 가져올 때 HTTP 호출에 대한 요청별 읽기 타임아웃(초). `1`에서 `60` 사이여야 합니다. 기본값은 `30`. `ci_config_http_timeout` 기능 플래그가 필요합니다.
`GITLAB_CI_MAX_COMMIT_MESSAGE_SIZE_IN_BYTES`	integer	CI Runner로 전송될 수 있는 최대 커밋 메시지 크기(바이트). `0`에서 `1000000` 사이여야 합니다. 기본값은 `100000`. 18.6에서 도입.
`GITLAB_DISABLE_MARKDOWN_TIMEOUT`	string	`true`, `1`, 또는 `yes`로 설정하면 백엔드의 Markdown 렌더링이 타임아웃되지 않습니다. 기본값은 `false`. 17.4에서 도입.
`GITLAB_LFS_LINK_BATCH_SIZE`	integer	LFS 파일 연결을 위한 배치 크기를 설정합니다. 기본값은 `1000`.
`GITLAB_LFS_MAX_OID_TO_FETCH`	integer	연결할 최대 LFS 객체 수를 설정합니다. 기본값은 `100000`.
`SIDEKIQ_SEMI_RELIABLE_FETCH_TIMEOUT`	integer	Sidekiq 반안정적 가져오기의 타임아웃을 설정합니다. 기본값은 `5`. GitLab 16.7 이전, 기본값은 `3`. GitLab 16.6 이하에서 높은 Redis CPU 소비가 발생하거나 이 변수를 사용자 정의한 경우 이 변수를 `5`로 업데이트해야 합니다.
`SSL_IGNORE_UNEXPECTED_EOF`	string	OpenSSL 3.0은 SSL 연결을 종료하기 전에 서버가 `close_notify` 알림을 보내도록 요구합니다. 기본값은 `false`. 이 변수를 `true`로 설정하면 알림이 비활성화됩니다. 자세한 내용은 OpenSSL 문서를 참조하세요.

더 많은 변수 추가#

변수를 사용하여 더 많은 설정을 구성 가능하게 만드는 Merge Request을 환영합니다. config/initializers/1_settings.rb 파일을 변경하고 GITLAB_#{name in 1_settings.rb in upper case} 명명 체계를 사용합니다.

Linux 패키지 설치 구성#

환경 변수를 설정하려면 다음 지침을 따르세요.

환경 변수 GITLAB_OMNIBUS_CONFIG를 docker run 명령에 추가하여 GitLab Docker 이미지를 미리 구성할 수 있습니다. 자세한 내용은 Docker 컨테이너 미리 구성을 참조하세요.