DNS 설정
도메인 네임 시스템(DNS)은 IP 주소를 도메인 이름과 매칭하는 데 사용되는 네이밍 시스템입니다.
GitLab 인스턴스를 단순히 IP 주소만을 사용하여 실행할 수 있지만, 도메인 이름을 사용하는 것은 다음과 같습니다:
- 기억하기 쉽고 사용하기 쉽습니다.
-
HTTPS를 위해 필요합니다.
참고: Let’s Encrypt 통합을 활용하려면(자동 SSL 인증서), 인스턴스의 도메인 이름은 공용 인터넷에서 해결될 수 있어야 합니다.
이름 등록기 사용
도메인 이름을 인스턴스의 IP 주소와 연결하려면 하나 이상의 DNS 레코드를 지정해야 합니다. 도메인의 DNS 구성에 DNS 레코드를 추가하는 것은 선택한 공급업체에 완전히 의존하며 이 문서의 범위를 벗어납니다.
일반적으로 과정은 다음과 유사합니다:
-
DNS 등록기의 제어판을 방문하여 DNS 레코드를 추가합니다. 이것은 다음 유형 중 하나여야 합니다:
AAAAACNAME
유형은 인스턴스의 기본 아키텍처에 따라 다릅니다. 가장 흔한 것은 A 레코드입니다.
- 구성이 적용되었는지 테스트합니다.
- GitLab이 설치된 서버에 SSH로 연결합니다.
- 선호하는 GitLab 설정으로 구성 파일
(/etc/gitlab/gitlab.rb)을 편집합니다.
DNS 레코드에 대해 자세히 알아보려면 DNS 레코드 개요를 참조하세요.
동적 DNS 서비스 사용
비생산용으로 nip.io와 같은 동적 DNS 서비스를 사용할 수 있습니다.
이러한 서비스는 주로 다음과 같습니다: - 보안이 약함 - Let’s Encrypt에 의해 요청 제한
생산용이나 장기간 사용되는 인스턴스에는 권장하지 않습니다.
DNS를 사용하는 GitLab 설정
다음 GitLab 설정은 DNS 항목에 해당합니다.
| GitLab 설정 | 설명 | 구성 |
|---|---|---|
external_url
| 이 URL은 주요 GitLab 인스턴스와 상호 작용합니다. SSH/HTTP/HTTPS로 복제하거나 웹 UI에 액세스할 때 사용됩니다. GitLab Runner는 인스턴스와 통신하는 데 사용합니다. | external_url 구성
|
registry_external_url
| 이 URL은 컨테이너 레지스트리와 상호 작용하는 데 사용됩니다. Let’s Encrypt 통합에서 사용할 수 있습니다. 이 URL은 external_url과 동일한 DNS 항목을 사용할 수도 있지만 다른 포트에서 사용합니다.
| registry_external_url 구성
|
mattermost_external_url
| 이 URL은 번들 Mattermost 소프트웨어에 사용됩니다. Let’s Encrypt 통합에서 사용할 수 있습니다. | mattermost_external_url 구성
|
pages_external_url
| 기본적으로 GitLab Pages를 사용하는 프로젝트는 이 값의 하위 도메인에 배포됩니다. | pages_external_url 구성
|
| Auto DevOps 도메인 | 프로젝트를 배포하기 위해 Auto DevOps를 사용하는 경우, 이 도메인을 사용하여 소프트웨어를 배포할 수 있습니다. 이 도메인은 인스턴스나 클러스터 수준에서 정의할 수 있습니다. 이것은 /etc/gitlab/gitlab.rb에 정의하는 것이 아니라 GitLab UI를 사용하여 구성됩니다.
| Auto DevOps 도메인 구성 |
문제 해결
특정 구성 요소에 액세스할 때 문제가 있거나 Let’s Encrypt 통합이 실패하는 경우, DNS 문제가 있는 가능성이 있습니다. DNS가 문제의 원인인지 확인하려면 dig 도구를 사용할 수 있습니다.
성공한 DNS 쿼리
이 예제에서는 쿼리가 전 세계적으로 해결됨을 보장하기 위해 Public Cloudflare DNS resolver를 사용합니다. 다른 Google Public DNS resolver와 같은 공용 리졸버들도 사용할 수 있습니다.
$ dig registry.gitlab.com @1.1.1.1
; <<>> DiG 9.18.18-0ubuntu0.22.04.1-Ubuntu <<>> registry.gitlab.com @1.1.1.1
;; global options: +cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 3934
;; flags: qr rd ra; QUERY: 1, ANSWER: 1, AUTHORITY: 0, ADDITIONAL: 1
;; OPT PSEUDOSECTION:
; EDNS: version: 0, flags:; udp: 1232
;; QUESTION SECTION:
;registry.gitlab.com. IN A
;; ANSWER SECTION:
registry.gitlab.com. 58 IN A 35.227.35.254
;; Query time: 8 msec
;; SERVER: 1.1.1.1#53(1.1.1.1) (UDP)
;; WHEN: Wed Jan 31 11:16:51 CET 2024
;; MSG SIZE rcvd: 64
상태가 NOERROR이고 ANSWER SECTION에 실제 결과가 있는지 확인하세요.
실패한 DNS 쿼리
$ dig fake.gitlab.com @1.1.1.1
; <<>> DiG 9.18.18-0ubuntu0.22.04.1-Ubuntu <<>> fake.gitlab.com @1.1.1.1
;; global options: +cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NXDOMAIN, id: 25693
;; flags: qr rd ra; QUERY: 1, ANSWER: 0, AUTHORITY: 1, ADDITIONAL: 1
;; OPT PSEUDOSECTION:
; EDNS: version: 0, flags:; udp: 1232
;; QUESTION SECTION:
;fake.gitlab.com. IN A
;; AUTHORITY SECTION:
gitlab.com. 1800 IN SOA diva.ns.cloudflare.com. dns.cloudflare.com. 2331688399 10000 2400 604800 1800
;; Query time: 12 msec
;; SERVER: 1.1.1.1#53(1.1.1.1) (UDP)
;; WHEN: Wed Jan 31 11:17:46 CET 2024
;; MSG SIZE rcvd: 103
이 예제에서 status가 NXDOMAIN이고 ANSWER SECTION이 없습니다. SERVER 필드는 답변에 대한 쿼리가 된 DNS 서버를 알려줍니다. 이 경우 Public Cloudflare DNS resolver가 됩니다.
와일드카드 DNS 항목 사용
URL attributes에 와일드카드 DNS를 사용하는 것이 가능하지만, 각각에 대해 전체 도메인 이름을 제공해야 합니다.
Let’s Encrypt 통합은 와일드카드 인증서를 가져오지 않습니다. 이 작업은 직접 해야 합니다.
도움말