brunch

You can make anything
by writing

C.S.Lewis

by 이듬 Aug 21. 2020

GitHub Pages 한글 도메인 연결하기

GitHub 페이지에 한글 도메인 연결하며 겪은 우여곡절 에피소드.

Google 도메인에서 구매한 한글 도메인을 GitHub 페이지에 연결하며 겪은 이야기를 풀어봅니다.



쉽고 간결한 도메인이 필요해!


GitHub Pages를 통해 연결된 웹 사이트의 기본 주소는 쉽고 간단하지 않았습니다. 도메인에 "github.io"와 "저장소(repository) 이름"이 조합되기 때문이죠. 기억하기 어렵고, 웹 브라우저 주소 창에 직접 입력하기도 번거롭습니다. 그래서 간결하고 기억하기 좋은 도메인 이름이 필요해졌습니다.


https://yamoo9.github.io/EUID



도메인 어디서 구매해야 할까?


도메인을 구매하기로 마음먹었으니 어디서 구매해야 할까? 검색해 보았습니다. 그런데... 광고만 좌르륵 뜨더군요. 검색 첫 페이지에 노출된 광고들은 GoDaddy, 가비아, 후이즈, 카페 24, 닷네임, 호스팅어 등등 여러 업체가 있었습니다. 그렇게 "탐색의 시간"을 가졌고.. 시간은 덧없이 흘러갔습니다.



결국. Google 너로 정했다! 


여기저기 둘러보다 결국은 구글 도메인(Google Domains)에서 구매하기로 결정했습니다. 오랫동안 Google 서비스를 안정적으로 잘 사용해서 인지 믿음이 가졌던 것일지도 모릅니다. 아직 한글로 서비스되고 있지 않지만, 어려운 영 단어가 보이지는 않으니 큰 문제는 되지 않았습니다.


페이지 상단 오른쪽에 위치한 Find a domain 파란색 버튼을 클릭하거나, 페이지 중앙에 위치한 Search for your domain 검색 입력 필드에 원하는 도메인 이름을 입력하고 Get it 파란색 버튼을 누르면 도메인 구매 페이지로 이동합니다. 쉽게 기억할 수 있는 한글이 좋을 듯하여 한글을 입력해봤습니다. 구매가 가능할까요?



응? 우리나라에서는 구매 불가능? 알고 보니...


구매 가능한 한글 도메인 이름 목록 보다, 먼저 눈에 들어온 것은 "Google Domains isn't available in your country/region yet." 경고 메시지였습니다. 우리나라에서는 아직 서비스 전인가? 싶어 불안감이 밀려왔지만 구매에는 아무런 문제가 없는 것으로 확인되었습니다. 확인 결과... 저 메시지는 국가 코드 최상위 도메인(kr, uk, jp 등)을 구매할 수 없음을 경고한 것이더군요.



구매 가능한 한글 도메인 이름은 매우 많았습니다. 목록에는 구매가 가능한 경우 체크 마크 아이콘 ✔︎ 이 표시되고, 구매가 가능하지 않은 경우 서클 디비전 슬래시 아이콘 ⊘ 이 표시됩니다. 그리고 연간 사용료로 달러($) 통화로 구매 금액을 안내하고 있습니다. 


적절한 가격과 이름을 살펴보고 결정했다면 쇼핑 카트 아이콘 버튼을 눌러 장바구니에 추가하거나, 다시 눌러 제거할 수 있습니다. 관련 분야에 적합한 도메인 이름과 금액을 비교해 결정하는 데도 많은 시간이 걸렸습니다.



체크할 것과 체크하지 말아야 할 것


쇼핑 카트에 포함된 구매 항목을 선택한 후, 아래 화면과 같이 Registration 항목은 모두 체크하고, Custom email with G Suite Basic 부분을 체크하지 말고 하단의 Check out 버튼을 눌러 구매합니다.



한글로 서비스되는 페이지를 보면 "등록" 항목과 "G Suite Basic 맞춤 이메일" 항목의 문구를 통해 각각의 활성이 어떻게 작동하는지 확인할 수 있을 겁니다. 앞서 체크를 권하지 않았던 "G Suite Basic 맞춤 이메일" 항목이 필요하다면 체크한 후 결제해도 되지만 매달 $6(약 7,000원) 사용료를 지불해야 함을 기억하세요! 



만약 아래 이미지에서 보이는 것처럼 다시 한번 우리나라에서 Google Domains 구매가 가능하지 않음을 경고한다면? 결제 지역을 미국(United States)으로 선택하고 I have a billing address in this country 버튼을 누릅니다.




어려운 상황과 마주하다.


구매를 위해서는 구매자의 정보를 입력해야 하는데 여기서 어려운 상황에 맞이하게 됩니다. 필요한 정보를 모두 입력하고 저장하고 계속 버튼을 눌렀을 때 도시(City) 항목이 "잘못됨"이라고 표시되면서 다음 단계로 넘어갈 수 없었던 것입니다. "도시"라고 레이블(label)이 있어서 도시 이름을 입력했건만...


잘못됨? 그래서 뭐가 잘못된 건지? 알려줘야 하지 않아?



한글 "서울" 그리고 영문 이름 "Seoul"도 넣어보고, 혹시 시(Si)를 넣어야 하나 해서 Seoul-Si 도 넣어봤으나.. 그저 "잘못됨" 이라고만 표시하니 분통이 터질 것 같더군요. 정말... 너무나 알고 싶었습니다. 뭘 잘못한 걸까요?



어이없는 문제 해결. 
그리고 나쁜 서비스에 관한 고찰.


여러 시행착오 끝에 찾아낸 방법은... "도시" 레이블에 도시 이름을 넣으면 안 되고, 살고 있는 구역인 구이름을 넣어야 하더군요. 이번 경험을 통해 잘못된 레이블, 불 친절한 오류 또는 경고 메시지가 얼마나 사용자를 힘들게 하는지 체험할 수 있었습니다. 제발!! 이렇게 만들지 말아 주세요. 너무 힘들어요!



힘겨움 뒤에 남은 일은 결제 카드 정보를 입력하는 것입니다. 해외 결제가 가능한 카드 정보를 등록하고, 우편 번호는 임의의 값을 넣고 구매 버튼을 눌러 구매를 요청합니다.



구매 완료 후 도착한 메일.


구매 후에는 영수증이 이메일로 보내져요. 주문 번호, 도메인 이름, 날짜, 결제 수단 등을 확인할 수 있습니다.



그리고 구매자가 정상적인 사용자인지 인증(Verify) 하기 위한 메일도 함께 보내집니다. 해당 메일의 Verify email now 버튼을 눌러야만 정상적인 사용자로 인증되어 서비스를 이용할 수 있으니 필히 행하셔야 합니다!



이메일 인증 후, 다시 Google 도메인(Domains)에 접속하면 "내 도메인" 항목을 통해 성공적으로 등록된 도메인 이름을 확인할 수 있습니다. 이어서 진행할 내용은 GitHub Pages에 한글 도메인을 연결하는 것입니다.




Google 도메인 DNS 설정.


Google 도메인 → DNS → 맞춤 리소스 레코드 설정 항목의 DNS 레코드 타입에 A를 선택 후, GitHub Pages의 IP 값을 데이터로 입력해야 합니다. 그리고 CNAME을 선택한 후, www 이름값으로 연결할 GitHub 페이지 주소를 추가합니다. (참고: Managing a custom domain for your GitHub Pages site)



도메인 네임 서버(DNS)  → A 레코드 설정


맞춤 리소스 레코드에 GitHub Pages 서비스의 IP 값을 데이터로 입력할 때 아래 이미지를 참고하여 + 버튼을 눌러 새로운 항목을 아래 방향에 추가할 수 있습니다. 모든 값을 입력한 후에는 추가 버튼을 눌러 등록합니다.


185.199.108.153

185.199.109.153

185.199.110.153

185.199.111.153



도메인 네임 서버(DNS) → CNAME 레코드 설정


CNAME으로 유형을 변경한 후 www 이름으로 연결할 GitHub Pages 주소를 입력하고 추가 버튼을 누릅니다.


사용자계정.github.io.



정상 처리됨을 확인하려면? (생략 가능)


DNS 레코드가 정상적으로 등록되었는지 확인하려면? 터미널(Terminal)에 다음 명령어를 입력 실행해 등록된 도메인에 대한 IP 포인트를 확인할 수 있습니다.


dig +noall +answer 구매_등록한_도메인_주소


등록된 한글 도메인 이름이 아닌, 영문 도메인 이름으로 주소를 설정 입력해야 함에 주의하세요! 영문 주소는 Google 도메인 페이지 주소 창에서 확인할 수 있습니다.


도메인 연결은 다소 시간이 필요합니다. 도메인 연결이 바로 안 된다고 조급해하지 말고, 잠시 기다림의 시간을 가져보세요.



명령을 터미널에 입력하고 실행하면 아래와 같이 도메인에 연결된 IP 주소가 출력되어야 합니다.




GitHub 저장소의 커스텀 도메인 설정.


이 단계까지 도달했다면 힘든 일은 대부분 끝났습니다. 조금 더 힘내서 한글 도메인을 GitHub Pages에 연결해봅시다. GitHub Pages 호스팅 서비스를 하는 저장소(Repository)의 설정(Settings) 항목을 눌러 설정 페이지로 이동합니다.



설정 페이지의 GitHub Pages 설정 항목에서 Custom domain 값을 한글 도메인의 영문 이름값을 넣고 Save 버튼을 누릅니다. 영문 도메인 주소 값을 모른다면? 아래 작성한 영문 도메인 이름 내용을 참고합니다.



등록된 한글 도메인 이름이 아닌, 영문 도메인 이름으로 주소를 설정 입력해야 함에 주의하세요! 영문 주소는 Google 도메인 페이지 주소 창에서 확인할 수 있습니다.



CNAME 파일 생성과 퍼블리싱 성공 메시지!


한글 도메인(영문 이름)과 GitHub Pages 커스텀 도메인 연결이 성공적으로 퍼블리싱되면 다음 메시지가 설정 페이지 GitHub Pages에 표시됩니다. 그리고 저장소의 호스팅 소스(Source)로 지정된 위치에 CNAME 파일이 생성되고 파일 안에는 커스텀 도메인 URL 값이 저장되어 있는 것을 확인할 수 있습니다.


Your site is published at "한글 도메인 영문 이름"




남은 일은 그저 기다림 뿐.


GitHub Pages 커스텀 도메인 연결에 성공했어도, 브라우저에서 바로 안 보일 수 있습니다. 한글 도메인 이름과 GitHub 커스텀 도메인 연결 설정에 시간이 필요하기 때문이죠. 그러니 도메인 연결이 바로 안 된다고 조급해하지 마세요. 잠시 기다림의 시간을 가져봅시다.




이듬.run  ←


잠시... 기다림이 지나면_ 고대하던 한글 도메인 연결이 마무리돼요. 그리고 문제없이 등록된 한글 도메인 이름으로 웹사이트에 접속할 수 있게 된답니다. 기다림이 긴 만큼 기쁨도 크죠. 날아갈 듯한 그 기분을 즐기세요.


치명적으로 길었던 도메인이여. 안녕~
간단해서 기억하기 쉬운 새로운 한글 도메인. 안녕!



글을 마무리하며.


미처 다 표현하지 못했던 우여곡절스러운 이야기가 참 많았었는데요. 하나하나 다 풀어내자면 글이 더 길어질 테고, 읽기 싫어지는 글이 될까 우려되니 여기서 마무리합니다. 한글 도메인과 GitHub Pages 연결에 저처럼 애먹는 분들이 없기를 바라며 경험했던 이야기를 풀어봤습니다. 읽어주셔서 감사합니다.





브런치는 최신 브라우저에 최적화 되어있습니다. IE chrome safari