이 설정은 GitLab.com에서 사용되며, GitLab.com 고객이 이용할 수 있습니다.

이러한 설정 중 일부는 GitLab.com 인스턴스 구성 페이지에서 확인할 수 있습니다.

계정 및 제한 설정#

GitLab.com은 다음 계정 제한을 사용합니다. 목록에 없는 설정은 기본값이 GitLab Self-Managed 인스턴스와 동일합니다.

리포지터리 크기 제한에 가까워지거나 제한을 초과한 경우 다음을 할 수 있습니다.

• Git으로 리포지터리 크기 줄이기.
• 추가 스토리지 구매.

백업#

GitLab.com에서 전체 프로젝트를 백업하려면 다음 방법으로 내보낼 수 있습니다.

• UI를 통해.
• API를 통해. API를 사용하면 Amazon S3 같은 스토리지 플랫폼에 내보내기 파일을 프로그래밍 방식으로 업로드할 수도 있습니다.

내보내기를 사용할 때는 프로젝트 내보내기에 포함되는 항목과 포함되지 않는 항목을 확인합니다.

프로젝트나 위키의 Git 리포지터리를 백업하려면 다른 컴퓨터로 클론합니다. 2020년 8월 22일 이후 위키에 업로드된 모든 파일은 리포지터리를 클론할 때 포함됩니다.

CI/CD#

GitLab.com은 다음 GitLab CI/CD 설정을 사용합니다. 여기에 나열하지 않은 설정이나 기능 제한은 관련 문서에 나열된 기본값을 사용합니다.

컨테이너 레지스트리#

GitLab 컨테이너 레지스트리를 사용하려면 Docker 클라이언트가 다음에 액세스할 수 있어야 합니다.

• 인가를 위한 레지스트리 엔드포인트와 GitLab.com.
• 이미지를 다운로드하기 위한 Google Cloud Storage(Google이 인터넷에서 사용자에게 제공하는 IP 범위 참고) 또는 Google Cloud Content Delivery Network.

GitLab.com은 Cloudflare를 앞단에 둡니다. GitLab.com으로 들어오는 연결에는 Cloudflare의 CIDR 블록 (IPv4 및 IPv6)을 허용해야 합니다.

Diff 표시 제한#

diff 파일의 표시 설정은 GitLab.com에서 변경할 수 없습니다. 이 제한은 GitLab UI와 API 엔드포인트에 모두 적용됩니다.

GitLab Self-Managed에서는 diff 제한을 변경할 수 있습니다.

이메일#

이메일 구성 설정, IP 주소, 별칭입니다.

확인 설정#

GitLab.com은 다음 이메일 확인 설정을 사용합니다.

• email_confirmation_setting은 Hard로 설정됩니다.
• unconfirmed_users_delete_after_days는 3일로 설정됩니다.

IP 주소#

GitLab.com은 Mailgun을 사용해 mg.gitlab.com 도메인에서 이메일을 보내며, 전용 IP 주소를 보유하고 있습니다.

• 23.253.183.236
• 69.72.35.190
• 69.72.44.107
• 159.135.226.146
• 161.38.202.219
• 192.237.158.143
• 192.237.159.239
• 198.61.254.136
• 198.61.254.160
• 209.61.151.122

mg.gitlab.com의 IP 주소는 언제든지 변경될 수 있습니다.

Service Desk 별칭#

GitLab.com에는 Service Desk용 메일박스가 다음 이메일 주소로 구성되어 있습니다. contact-project+%{key}@incoming.gitlab.com. 이 메일박스를 사용하려면 프로젝트 설정에서 사용자 지정 접미사를 구성합니다.

GitLab.com의 Gitaly RPC 동시성 제한#

리포지터리별 Gitaly RPC 동시성 및 큐 제한은 git clone 같은 여러 종류의 Git 작업에 대해 구성됩니다. 이 제한을 초과하면 fatal: remote error: GitLab is currently unable to handle this request due to load 메시지가 클라이언트에 반환됩니다.

가져오기나 클론 작업이 이전 작업이 끝나기 전에 시작되면 동시 작업입니다.

관리자 문서는 RPC 동시성 제한을 참고합니다.

GitLab Pages#

GitLab Pages의 일부 설정은 GitLab Self-Managed 기본값과 다릅니다.

Pages 사이트의 최대 크기는 최대 아티팩트 크기에 따라 달라지며, 이는 GitLab CI/CD 설정의 일부입니다.

GitLab Pages에도 속도 제한이 적용됩니다.

GitLab.com의 규모 확장#

GitLab.com은 GitLab Enterprise Edition Linux 패키지 설치 외에도 규모를 확장하기 위해 다음 애플리케이션과 설정을 사용합니다. 모든 설정은 Kubernetes 구성 또는 Chef 쿡북 형태로 공개되어 있습니다.

Consul#

서비스 디스커버리입니다.

• gitlab-cookbooks / gitlab_consul · GitLab

Fluentd#

GitLab 로그를 통합하기 위해 Fluentd를 사용합니다.

• gitlab-cookbooks / gitlab_fluentd · GitLab

Grafana#

모니터링 데이터를 시각화합니다.

• gitlab-cookbooks / gitlab-grafana · GitLab

HAProxy#

고성능 TCP/HTTP 로드 밸런서입니다.

• gitlab-cookbooks / gitlab-haproxy · GitLab

Prometheus#

Prometheus는 모니터링 스택을 완성합니다.

• gitlab-cookbooks / gitlab-prometheus · GitLab

Sentry#

오픈 소스 오류 추적입니다.

• gitlab-cookbooks / gitlab-sentry · GitLab

GitLab 호스팅 러너#

GitLab 호스팅 러너를 사용하면 GitLab.com과 GitLab Dedicated에서 CI/CD job을 실행해 여러 환경에서 애플리케이션을 매끄럽게 빌드, 테스트, 배포할 수 있습니다.

자세한 내용은 GitLab 호스팅 러너를 참고합니다.

호스트 이름 목록#

로컬 HTTP(S) 프록시나 최종 사용자 컴퓨터를 관리하는 웹 차단 소프트웨어에서 허용 목록을 구성할 때 다음 호스트 이름을 추가합니다. GitLab.com의 페이지는 다음 호스트 이름에서 콘텐츠를 로드합니다.

• gitlab.com
• *.gitlab.com
• *.gitlab-static.net
• *.gitlab.io
• *.gitlab.net

docs.gitlab.com과 about.gitlab.com에서 제공하는 문서 및 GitLab 회사 페이지는 일부 페이지 콘텐츠를 일반 공용 CDN 호스트 이름에서 직접 로드합니다.

컨테이너 레지스트리 호스트 이름 목록#

registry.gitlab.com에서 이미지를 가져오는 경우 허용 목록에 다음 호스트 이름을 추가로 등록합니다.

• *.storage.googleapis.com
• *.cdn.registry.gitlab-static.net

가져오기#

GitLab.com은 GitLab으로 데이터를 가져오는 작업을 제한하는 설정을 사용합니다.

기본 가져오기 소스#

기본적으로 사용할 수 있는 가져오기 소스(마이그레이션 도구)는 사용하는 GitLab 종류에 따라 다릅니다.

• GitLab.com: 사용 가능한 모든 가져오기 소스가 기본적으로 활성화되어 있습니다.
• GitLab Self-Managed: 기본적으로 활성화된 가져오기 소스가 없으므로 활성화해야 합니다.

가져오기 플레이스홀더 사용자 제한#

GitLab.com으로 가져올 때는 최상위 네임스페이스마다 플레이스홀더 사용자 수가 제한됩니다. 제한은 플랜과 시트 수에 따라 다릅니다. 자세한 내용은 GitLab.com의 플레이스홀더 사용자 제한 표를 참고합니다.

IP 범위#

GitLab.com은 Web/API 플릿에서 나가는 트래픽에 IP 범위 34.74.90.64/28과 34.74.226.0/24를 사용합니다. 이 범위 전체는 GitLab에만 할당되어 있습니다. 웹훅이나 리포지터리 미러링에서 오는 연결은 이 IP 주소에서 시작됩니다. 이러한 연결은 허용하는 것이 좋습니다.

• 들어오는 연결 - GitLab.com은 Cloudflare를 앞단에 둡니다. GitLab.com으로 들어오는 연결에는 Cloudflare의 CIDR 블록(IPv4 및 IPv6)을 허용합니다.

• CI/CD 러너에서 나가는 연결 - CI/CD 러너에서 나가는 연결에는 고정 IP 주소를 제공하지 않습니다. 다만 다음 지침이 도움이 됩니다.

  • Linux GPU 지원 러너와 Linux Arm64 러너는 Google Cloud의 us-central1에 배포됩니다.
  • 그 외 GitLab.com 인스턴스 러너는 Google Cloud의 us-east1에 배포됩니다.
  • macOS 러너는 AWS의 us-east-1 리전에서 호스팅되고, 러너 매니저는 Google Cloud에서 호스팅됩니다.

IP 기반 방화벽을 구성하려면 AWS IP 주소 범위와 Google Cloud IP 주소 범위를 모두 허용해야 합니다.

GCP의 IP 주소 범위 또는 CIDR 블록을 조회하는 방법을 참고합니다.

최대 검토자 및 담당자 수#

머지 리퀘스트에는 다음 최대값이 적용됩니다.

• 최대 담당자 수: 200
• 최대 검토자 수: 200

머지 리퀘스트 제한#

히스토리

• GitLab 17.10에서 merge_requests_diffs_limit이라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
• GitLab 17.10에서 GitLab.com에 활성화되었습니다.
• GitLab 19.0에서 일반 제공되었습니다. 기능 플래그 merge_requests_diffs_limit이 제거되었습니다.

GitLab은 각 머지 리퀘스트를 1000개의 diff 버전으로 제한합니다. 이 제한에 도달한 머지 리퀘스트는 더 이상 업데이트할 수 없습니다. 대신 영향을 받은 머지 리퀘스트를 닫고 새 머지 리퀘스트를 만듭니다.

Diff 커밋 제한#

히스토리

• GitLab 17.11에서 merge_requests_diff_commits_limit이라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
• GitLab 19.0에서 일반 제공되었습니다. 기능 플래그 merge_requests_diff_commits_limit이 제거되었습니다.

GitLab은 각 머지 리퀘스트를 1,000,000개(백만 개)의 diff 커밋으로 제한합니다. 이 제한에 도달한 머지 리퀘스트는 더 이상 업데이트할 수 없습니다. 대신 영향을 받은 머지 리퀘스트를 닫고 새 머지 리퀘스트를 만듭니다.

비밀번호 요구 사항#

GitLab.com은 새 계정의 비밀번호와 비밀번호 변경에 다음 요구 사항을 적용합니다.

• 최소 문자 길이는 8자입니다.
• 최대 문자 길이는 128자입니다.
• 모든 문자를 사용할 수 있습니다. 예를 들어 ~, !, @, #, $, %, ^, &, *, (), [], _, +, =, -입니다.

그룹 생성#

히스토리

• GitLab 18.0에서 도입되었습니다
• GitLab 18.5에서 GitLab SAAS 관리자 예외가 도입되었습니다

GitLab.com에서는 최상위 그룹 생성이 UI에서만 허용됩니다. 관리자만 API로 최상위 그룹을 만들 수 있습니다.

프로젝트 및 그룹 삭제#

프로젝트와 그룹 삭제에 관련된 설정입니다.

지연된 그룹 삭제#

히스토리

• 18.0에서 GitLab Premium에서 GitLab Free로 이동되었습니다.
• 18.0.2에서 삭제 기간이 7일에서 30일로 늘어났습니다.

그룹은 30일의 지연 기간이 지난 후 영구적으로 삭제됩니다.

삭제 표시된 그룹을 조회하고 복원하는 방법을 참고합니다.

지연된 프로젝트 삭제#

히스토리

• 18.0에서 GitLab Premium에서 GitLab Free로 이동되었습니다.
• 18.0.2에서 삭제 기간이 7일에서 30일로 늘어났습니다.

프로젝트는 30일의 지연 기간이 지난 후 영구적으로 삭제됩니다.

삭제 표시된 프로젝트를 조회하고 복원하는 방법을 참고합니다.

휴면 프로젝트 삭제#

휴면 프로젝트 삭제는 GitLab.com에서 비활성화되어 있습니다.

패키지 레지스트리 제한#

GitLab 패키지 레지스트리에 업로드하는 패키지의 최대 파일 크기는 형식에 따라 다릅니다.

Puma#

GitLab.com은 Puma 요청 타임아웃에 기본값 60초를 사용합니다.

GitLab.com의 속도 제한#

GitLab.com의 속도 제한은 구독 플랜에 따라 다르며 사용자별로, 그리고 최상위 그룹별로 모두 적용됩니다. 각 플랜에는 사용량을 좌우하는 시간당 제한과 분당 버스트 제한이 있으며, 시간당 제한이 우선합니다. 인증된 요청은 플랜의 전체 허용량을 받습니다.

플랜별 제한, 적용 시점, 429 Too Many Requests 응답을 처리하는 방법은 GitLab.com 속도 제한을 참고합니다.

Sidekiq#

GitLab.com은 Ruby job 스케줄링을 위해 Sidekiq를 외부 프로세스로 실행합니다.

현재 설정은 GitLab.com Kubernetes Pod 구성에 있습니다.

SSH 키 및 인증#

SSH 인증과 관련된 설정입니다. 최대 연결 수에 관한 정보는 SSH 최대 연결 수를 참고합니다.

대체 SSH 포트#

GitLab.com은 git+ssh에 대해 다른 SSH 포트로도 접속할 수 있습니다.

~/.ssh/config 예시는 다음과 같습니다.

Host gitlab.com
  Hostname altssh.gitlab.com
  User git
  Port 443
  PreferredAuthentications publickey
  IdentityFile ~/.ssh/gitlab

SSH 호스트 키 지문#

GitLab.com의 SSH 호스트 키 지문을 확인하려면 현재 인스턴스 구성으로 이동합니다.

1. GitLab에 로그인합니다.
2. 왼쪽 사이드바에서 Help([question-o]) > Help를 선택합니다.
3. Help 페이지에서 Check the current instance configuration을 선택합니다.

인스턴스 구성에서 SSH host key fingerprints를 확인할 수 있습니다.

GitLab.com 리포지터리에 처음 연결할 때 이 키 중 하나가 출력에 표시됩니다.

SSH 키 제한#

GitLab.com은 기본 SSH 키 제한을 사용합니다.

SSH known_hosts 항목#

SSH에서 수동 지문 확인을 건너뛰려면 .ssh/known_hosts에 다음을 추가합니다.

gitlab.com ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIAfuCHKVTjquxvt6CM6tdG4SLp1Btn/nOeHHE5UOzRdf
gitlab.com ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQCsj2bNKTBSpIYDEGk9KxsGh3mySTRgMtXL583qmBpzeQ+jqCMRgBqB98u3z++J1sKlXHWfM9dyhSevkMwSbhoR8XIq/U0tCNyokEi/ueaBMCvbcTHhO7FcwzY92WK4Yt0aGROY5qX2UKSeOvuP4D6TPqKF1onrSzH9bx9XUf2lEdWT/ia1NEKjunUqu1xOB/StKDHMoX4/OKyIzuS0q/T1zOATthvasJFoPrAjkohTyaDUz2LN5JoH839hViyEG82yB+MjcFV5MU3N1l1QL3cVUCh93xSaua1N85qivl+siMkPGbO5xR/En4iEY6K2XPASUEMaieWVNTRCtJ4S8H+9
gitlab.com ecdsa-sha2-nistp256 AAAAE2VjZHNhLXNoYTItbmlzdHAyNTYAAAAIbmlzdHAyNTYAAABBBFSMqzJeV9rUzU4kWitGjeR4PWSa29SPqJ1fVkhtj3Hw9xjLVXVYrU9QlYWrOLXBpQ6KWjbjTDTdDkoohFzgbEY=

가시성 설정#

프로젝트, 그룹, 스니펫에서 Internal 가시성 설정은 GitLab.com에서 비활성화되어 있습니다.

웹훅#

웹훅에는 다음 제한이 적용됩니다.

속도 제한#

최상위 네임스페이스의 웹훅이 분당 호출될 수 있는 횟수입니다. 네임스페이스의 모든 프로젝트 웹훅과 그룹 웹훅이 이 제한을 공유합니다. 제한은 플랜과 구독의 시트 수에 따라 다릅니다.

속도 제한에 도달하면 네임스페이스의 모든 웹훅이 일시적으로 비활성화되고 다음 1분 안에 자동으로 다시 활성화됩니다.

속도 제한이 적용되면 웹훅 목록의 해당 웹훅 옆에 배지가 표시됩니다. 웹훅 편집 페이지에는 네임스페이스 제한이 분당 몇 번 초과되었는지와 웹훅이 다시 활성화되는 시점을 알리는 메시지가 표시됩니다.

보안 정책 제한#

보안 정책 프로젝트에 추가할 수 있는 최대 정책 수입니다. 이 제한은 각 정책 유형에 개별적으로 적용됩니다. 예를 들어 같은 보안 정책 프로젝트에 머지 리퀘스트 승인 정책 5개와 스캔 실행 정책 5개를 둘 수 있습니다.

기타 제한#

GitLab Self-Managed 인스턴스 제한은 다음을 참고합니다.

• 웹훅 속도 제한.
• 웹훅 수.
• 웹훅 타임아웃.
• 병렬 Pages 배포.