GitLab Pages Let's Encrypt 인증서

GitLab Pages를 위한 자동 Let's Encrypt SSL 인증서를 설정합니다.

Let's Encrypt(LE)와 GitLab Pages의 통합을 사용하면 사용자 정의 도메인을 쓰는 Pages 웹사이트에 LE 인증서를 적용하면서도 직접 발급하고 갱신하는 번거로움을 겪지 않아도 됩니다. GitLab이 기본 제공 기능으로 대신 처리합니다. Let's Encrypt 는 무료이며 자동화된 오픈 소스 인증 기관입니다. Warning 이 기능은 사용자 정의 도메인에 대한 인증서만 적용하며, Pages 데몬 실행에 필요한 와일드카드 인증서에는 적용되지 않습니다(GitLab Self-Managed, Free, Premium, Ultimate 전용). 와일드카드 인증서 생성은 이 이슈 에서 추적됩니다. 사전 요구 사항 # 도메인에 대한 SSL 인증서 자동 프로비저닝을 켜기 전에 다음을 확인합니다: 웹사이트 소스 코드가 담긴 GitLab 프로젝트 를 생성했습니다. 도메인( example.com )을 취득하고 Pages 웹사이트를 가리키는 DNS 항목 을 추가했습니다. 최상위 도메인( .com )은 공개 접미사 여야 합니다. Pages 프로젝트에 도메인을 추가 하고 소유권을 확인했습니다. 웹사이트가 실행 중이며 사용자 정의 도메인으로 접근할 수 있는지 확인했습니다. Let's Encrypt와 GitLab의 통합은 GitLab.com에서 켜져 있습니다. GitLab Self-Managed 인스턴스의 경우 관리자가 켰는지 확인합니다. 사용자 정의 도메인에 대한 Let's Encrypt 통합 활성화 # 요구 사항을 충족한 후 Let's Encrypt 통합을 켭니다: 상단 바에서 Search or go to 를 선택하고 프로젝트를 찾습니다. 왼쪽 사이드바에서 Deploy > Pages 를 선택합니다. 도메인 이름 옆에서 Edit (✏️)을 선택합니다. Automatic certificate management using Let's Encrypt 토글을 켭니다. Save changes 를 선택합니다. 켜면 GitLab이 Let's Encrypt 인증서를 받아 연결된 Pages 도메인에 추가합니다. GitLab은 인증서를 자동으로 갱신하기도 합니다. Note 인증서를 발급하고 Pages 구성을 업데이트하는 데 최대 한 시간이 걸릴 수 있습니다. 도메인 설정에 이미 SSL 인증서가 있으면 Let's Encrypt 인증서로 교체될 때까지 계속 작동합니다. 문제 해결 # Let's Encrypt 인증서를 받는 중에 문제가 발생했습니다 # Something went wrong while obtaining the Let's Encrypt certificate 오류가 표시될 수 있습니다. 이 문제는 Let's Encrypt가 도메인에 도달하거나 검증할 수 없을 때 발생합니다. 이 문제를 해결하려면: 상단 바에서 Search or go to 를 선택하고 프로젝트를 찾습니다. 왼쪽 사이드바에서 Settings > General 을 선택합니다. Visibility, project features, permissions 를 확장합니다. Pages 아래 드롭다운 목