19강 / 20강

【실습】 새 서비스 하나를 세상에 내놓는다

빈 서버에서 https 주소가 열리기까지 아홉 걸음

이제 실제로 하나 띄워 봅니다. 조건은 이 서버와 같습니다 — 공인 IP 없음, 열린 포트 없음, 도메인은 클라우드플레어에.

목표: lab.example.com 을 치면 서버 안 localhost:8080 의 앱이 https 로 열린다.

고등학생빈 서버에서 https 주소까지

걸음	하는 일	강
1	도메인 확보	4강
2	클라우드플레어에 추가 · 네임서버 변경	7강
3	서버에 앱 배포	—
4	nginx 설정	16·17강
5	오리진 인증서 발급·설치	12강
6	A 레코드 생성 (프록시 켬)	8·9강
7	SSL 모드를 Full (strict)로	11강
8	접속 확인	18강
9	TTL 정리 · 모니터링	6강

① 앱이 안에서 도는지 먼저 본다

$ curl -sI localhost:8080
HTTP/1.1 200 OK

여기서 안 되면 뒤의 여덟 걸음은 전부 의미가 없습니다. 가장 안쪽부터 확인하는 것이 순서예요.

② nginx 블록을 만든다

server {
    listen 443 ssl;
    server_name lab.example.com;

    ssl_certificate     /etc/ssl/certs/example.com.pem;
    ssl_certificate_key /etc/ssl/private/example.com.key;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host              $host;
        proxy_set_header X-Real-IP         $remote_addr;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

$ sudo nginx -t && sudo systemctl reload nginx

고등학생순서가 중요한 이유

순서를 바꾸면	일어나는 일
인증서 전에 SSL 모드를 strict로	연결 실패
앱 전에 DNS를 만듦	방문자가 오류 페이지를 봄
nginx 전에 프록시를 켬	—

"뒤쪽부터 준비하고 마지막에 문을 연다" — 이것이 원칙입니다.

③ 오리진 인증서가 이 이름을 덮는지 본다

12강에서 example.com 과 *.example.com 을 넣었다면 lab.example.com 은 덮입니다. a.lab.example.com 이었다면 인증서를 새로 만들어야 했고요(17강).

④ 터널 설정에 줄을 더한다

ingress:
  - hostname: lab.example.com
    service: https://127.0.0.1:443
    originRequest:
      originServerName: lab.example.com
  …
  - service: http_status:404

터널을 nginx 의 443 으로 보냅니다. 그러면 nginx 가 이름으로 방을 고를 수 있어요(17강). originServerName 은 SNI 로 이 이름을 말해 달라는 뜻입니다.

$ sudo systemctl restart cloudflared
$ systemctl status cloudflared --no-pager

고등학생인증서에 넣을 이름

12강에서 example.com과 *.example.com을 넣었다면 이런 이름들이 커버됩니다.

이름	커버되나
example.com	예
www.example.com	예 (와일드카드)
api.example.com	예
a.b.example.com	아니오 — 두 단계

두 단계 서브도메인을 쓰려면 *.b.example.com도 넣어야 합니다.

⑤ DNS 레코드를 만든다

$ cloudflared tunnel route dns mytunnel lab.example.com

이 한 줄이 CNAME 레코드를 대신 만들어 줍니다 — lab → <UUID>.cfargotunnel.com. 대시보드에서 손으로 만들어도 같습니다. 구름은 주황이어야 하고요.

⑥ SSL 모드를 확인한다

Full (strict). 오리진 인증서를 깔았으니 여기까지 갈 수 있습니다(11·12강).

⑦ 확인한다 — 바깥에서 안쪽 순서로

$ dig +short lab.example.com
104.21.x.x

$ curl -sI https://lab.example.com | head -3
HTTP/2 200
server: cloudflare

값을 False 로 바꿔 보세요. 실제 장애 대응이 이 표를 위에서부터 훑는 일입니다.

Python 브라우저에서 실행

# 아홉 걸음 점검표 — 하나라도 False 면 거기서 막힌다
걸음 = [
    ("① 앱이 localhost 에서 200 을 낸다",     True),
    ("② nginx 블록을 만들고 reload 했다",     True),
    ("③ 인증서가 이 이름을 덮는다",           True),
    ("④ ingress 에 줄을 더하고 재시작했다",    True),
    ("⑤ DNS 레코드가 있고 구름이 주황이다",    True),
    ("⑥ SSL 모드가 Full (strict) 다",        True),
    ("⑦ dig 로 이름이 풀린다",               True),
    ("⑧ curl 이 200 을 받는다",              True),
    ("⑨ 브라우저에 자물쇠가 보인다",           True),
]
막힌곳 = None
for 이름, ok in 걸음:
    print(("  OK  " if ok else "  ✗   ") + 이름)
    if not ok and 막힌곳 is None:
        막힌곳 = 이름

print()
if 막힌곳:
    print("여기서 막혔다:", 막힌곳)
else:
    print("전부 통과 — https://lab.example.com 이 열려 있다.")

고등학생배포 후 확인 목록

확인	방법
http로 오면 https로 가나	브라우저에서 http:// 입력
www 있고 없고 둘 다 되나	—
인증서 만료일	브라우저 자물쇠 클릭
다른 네트워크에서	휴대폰 데이터로
서버 재시작 후에도	서비스 자동 시작 설정

마지막 줄을 자주 놓칩니다 — 재부팅하면 앱이 안 올라오는 경우가 많아요.

🤔 확인 문제

아홉 걸음 가운데 가장 먼저 확인해야 할 것은?

🤔 확인 문제

터널의 service 를 https://127.0.0.1:443 으로 두고 nginx 에 맡기는 이유는?