refactor: 문서 개선 중

This commit is contained in:
donghyeon-ka
2026-09-21 14:30:55 +09:00
parent c93cdea150
commit 805a18f486
1497 changed files with 525837 additions and 59152 deletions
@@ -7,7 +7,7 @@ topicName: 실험대 환경 구성
project: virtualization
status: 게시 전
decisionStatus: ADOPTED
sourceRevision: 9465582b5d1630eb4ae7c4e078021486919bf6b6
sourceRevision: import-head 9465582b5d1630eb4ae7c4e078021486919bf6b6 · uncommitted-working-tree snapshot
source:
- final/document.md#190-단계-04-let's-encrypt-와-인증서-갱신
- final/document.md#184-이-부의-출처와-범위
@@ -67,6 +67,6 @@ DNS 공급자 의존 : 인증서를 받는 일이 Cloudflare 계정에 묶인다
발급 자체에도 순서가 붙는다. --dry-run 을 먼저 돌리는 것은 Let's Encrypt 의 주당 중복 인증서 5장 한도를 dry-run 이 쓰지 않기 때문이다. dry-run 은 인증서를 저장하지 않으므로 그 직후 certbot certificates 가 No certificates found 를 내는 것이 정상이다.
이 결정이 남긴 이름 규칙이 하나 있다. live/hyeonworks.com/ 은 certbot 이 이 묶음을 관리하려고 첫 번째 -d 에서 따온 라벨이고 서빙과 무관하다. 브라우저가 보는 유효 호스트명은 -d 로 준 이름 전부이므로 auth.hyeonworks.com 으로 다시 받을 필요가 없다. 대신 nginx 설정에는 그 디렉터리 경로를 한 글자도 다르지 않게 적어야 한다. live/auth.hyeonworks.com/ 이라고 적으면 cannot load certificate 로 막고, §182 가 이것을 가이드 결함 여섯 중 하나로 셌다. 와일드카드는 한 단계만 덮는다. a.b.hyeonworks.com 도, apex hyeonworks.com 자신도 와일드카드에 들어가지 않아 -d 를 둘 준다.
이 결정 뒤에 lineage 이름을 추측하는 규칙을 두지 않는다. 2026-09-17 현재 실험대에서 `sudo ls /etc/letsencrypt/live/``certbot certificates` 로 확인한 실제 경로는 `live/auth.hyeonworks.com/` 이다(observed). 브라우저가 보는 유효 호스트명은 SAN 목록이고 lineage 디렉터리 이름과 별개다. 원본 가이드 04 에 남아 있던 `live/hyeonworks.com/` 을 nginx 에 쓰면 `cannot load certificate` 로 막고, §182 가 이것을 가이드 결함으로 셌다. 그래서 nginx 에는 이름을 추측해 적지 않고 `certbot certificates` 가 찍은 경로를 그대로 쓴다. 와일드카드는 한 단계만 덮으므로 `a.b.hyeonworks.com` apex `hyeonworks.com` 은 별도 조건으로 본다.
이 결정이 끝내지 못한 것이 하나 있다. 받은 인증서가 갱신 뒤에 실제로 서빙되는지는 발급 방식과 별개이고, 근거로 건 첫 기록이 그것을 받는다.
@@ -7,7 +7,7 @@ topicName: 실험대 환경 구성
project: virtualization
status: 게시 전
decisionStatus: ADOPTED
sourceRevision: 9465582b5d1630eb4ae7c4e078021486919bf6b6
sourceRevision: import-head 9465582b5d1630eb4ae7c4e078021486919bf6b6 · uncommitted-working-tree snapshot
source:
- final/document.md#179-엣지를-물리-호스트에서-vm-으로-옮기면-무엇이-새로-필요해지나
- final/document.md#178-이-부의-출처와-범위
@@ -13,7 +13,7 @@ source:
- final/document.md#245-libvirt-default-네트워크와-virbr0
- final/document.md#246-dnsmasq-libvirt-내장-dhcp-dns
- final/document.md#248---live---config
sourceRevision: 9465582b5d1630eb4ae7c4e078021486919bf6b6
sourceRevision: import-head 9465582b5d1630eb4ae7c4e078021486919bf6b6 · uncommitted-working-tree snapshot
---
# 게스트 주소는 libvirt DHCP 예약으로 고정한다 — 바꿀 수 없어서가 아니라 되돌리기가 가장 비싸서
@@ -11,7 +11,7 @@ source:
- final/document.md#281-docker를-lab-host에-설치하면-안-되는-이유
- final/document.md#282-그러면-이미지는-어떻게-넣는가
- final/document.md#280-무엇을-어디에-설치하는가
sourceRevision: 9465582b5d1630eb4ae7c4e078021486919bf6b6
sourceRevision: import-head 9465582b5d1630eb4ae7c4e078021486919bf6b6 · uncommitted-working-tree snapshot
---
# lab host 에는 Docker 를 깔지 않는다 — 이미지 저장소가 갈리고, 그 위에 네트워크 변수가 하나 더 붙는다
@@ -11,7 +11,7 @@ source:
- final/document.md#213-왜-호스트에-직접-깔지-않고-vm-2대인가
- final/document.md#313-k3s-server와-agent-죽였을-때가-다르다
- final/document.md#218-실험대-전체-배치-2026-09-03-구축-완료-실측값
sourceRevision: 9465582b5d1630eb4ae7c4e078021486919bf6b6
sourceRevision: import-head 9465582b5d1630eb4ae7c4e078021486919bf6b6 · uncommitted-working-tree snapshot
---
# 호스트에 직접 깔지 않고 게스트 VM 두 대로 간다 — 관측자가 실험 대상과 함께 죽으면 안 된다