refactor: 문서 사람처럼 작성하기
This commit is contained in:
+4
-4
@@ -24,7 +24,7 @@ source:
|
||||
|
||||
# 가이드대로 다시 쳐서 이 실험대가 같은 상태로 서는가
|
||||
|
||||
2026-09-21에는 기존 worker 두 대를 실제로 철거한 뒤 cloud-init부터 k3s, Keycloak, observability까지 다시 올리고 power-cycle 뒤 복구 상태까지 확인했다. 따라서 **worker 재생성 이후의 복구 경로는 실제로 재검증됐다.** 다만 물리 호스트와 Edge VM, 인증서 계층을 모두 지운 빈 환경에서 00~06을 처음부터 다시 수행한 것은 아니다. `keycloak-cluster.yaml`, `observability.yaml`, `kc-lab.yaml.example` 원본도 저장소에 아직 없어, "문서만으로 빈 호스트를 완전 재구축할 수 있는가"라는 질문은 아직 확인이 끝나지 않았다.
|
||||
2026-09-21에는 기존 worker 두 대를 실제로 철거한 뒤 cloud-init부터 k3s, Keycloak, observability까지 다시 올리고 power-cycle 뒤 복구 상태까지 확인했다. 따라서 worker 재생성 이후의 복구 경로는 실제로 재검증됐다. 다만 물리 호스트와 Edge VM, 인증서 계층을 모두 지운 빈 환경에서 00~06을 처음부터 다시 수행한 것은 아니다. `keycloak-cluster.yaml`, `observability.yaml`, `kc-lab.yaml.example` 원본도 저장소에 아직 없어, "문서만으로 빈 호스트를 완전 재구축할 수 있는가"라는 질문은 아직 확인이 끝나지 않았다.
|
||||
|
||||
## 2026-09-21에 실제로 재구축한 범위
|
||||
|
||||
@@ -33,7 +33,7 @@ source:
|
||||
- Setup 00은 host 상태를 재확인했고, Setup 01에서는 두 worker의 qcow2·seed ISO를 다시 만든 뒤 SSH, cloud-init `status: done`, 고정 IP를 확인했다. 이어서 k3s server/agent, Keycloak 2노드·PostgreSQL, Prometheus/Grafana를 다시 올렸고 `vendor_cluster_size=2`와 주요 target `up=1`을 확인했다.
|
||||
- 그 뒤 worker power-cycle과 workload 복구도 수행했고 Keycloak cluster size가 다시 2로 돌아오는 것까지 확인했다. 이 범위에서는 "기존 host/edge를 유지한 worker 재구축 경로"가 실제로 동작했다.
|
||||
- 재구축 성공 여부는 일곱 가지 상태로 확인한다: `virsh list`가 동작하는가, 세 게스트에 SSH가 붙는가, `kubectl get nodes`에서 두 노드가 `Ready`인가, 외부 요청이 파드까지 닿는가, HTTPS가 열리고 인증서 체인이 기대한 형태인가, 관리 콘솔 로그인이 되는가, `vendor_cluster_size`가 2인가.
|
||||
- 문서만으로 다시 세울 때 필요한 입력 파일 일부가 이 문서 묶음 안에 완결된 형태로 들어 있지 않다. `keycloak-cluster.yaml`, `observability.yaml`, `kc-lab.yaml.example`의 canonical 파일 자체가 함께 제공되어야 ‘본문을 읽은 기억’ 없이 빈 환경에서 그대로 재구축할 수 있다.
|
||||
- 문서만으로 다시 세울 때 필요한 입력 파일 일부가 이 문서 묶음 안에 완결된 형태로 들어 있지 않다. `keycloak-cluster.yaml`, `observability.yaml`, `kc-lab.yaml.example`의 실제 원본 파일이 함께 있어야 문서 밖의 기억에 의존하지 않고 빈 환경에서 그대로 재구축할 수 있다.
|
||||
- 기존 구축 과정에서는 실행 순서와 실행 위치 때문에 여섯 번 막혔다. 각 실패 자체는 실제로 관측했고, 이 여섯 사례를 ‘순서와 위치를 검증하지 않은 문서’라는 공통 원인으로 묶은 것은 사례를 바탕으로 한 해석이다.
|
||||
- 수정한 가이드의 상당 부분은 2026-09-21 재구축에서 실제 실행 순서로 다시 확인했다. 다만 host 패키지 설치부터 Edge VM·DNS-01 인증서 계층까지 전부 제거한 완전한 빈 환경 재구축은 아직 하지 않았다.
|
||||
|
||||
@@ -81,9 +81,9 @@ source:
|
||||
|
||||
## 다음 검증
|
||||
|
||||
1. `keycloak-cluster.yaml`, `observability.yaml`, `kc-lab.yaml.example`의 canonical source를 저장소에 포함시킨다. 이 셋이 없으면 완전 재구축 검증에 "문서 밖의 기억"이 섞인다.
|
||||
1. `keycloak-cluster.yaml`, `observability.yaml`, `kc-lab.yaml.example`의 실제 원본 파일을 저장소에 포함시킨다. 이 셋이 없으면 완전 재구축 검증에 "문서 밖의 기억"이 섞인다.
|
||||
2. 대상을 정한다. 다른 빈 host에서 검증할지, 현재 lab을 계획적으로 철거한 뒤 같은 host에서 다시 세울지 선택한다.
|
||||
3. 가이드 그대로 00부터 06까지 순서대로 친다. historical command와 현재 따라 할 절차가 함께 있는 곳에서는 현재 절차를 기준으로 실행한다. 각 단계의 통과 조건을 확인하고, 실행한 명령·작업 디렉터리·시각·종료 코드와 원문 출력을 함께 남겨 나중에 같은 실패를 다시 대조할 수 있게 한다.
|
||||
3. 가이드 그대로 00부터 06까지 순서대로 친다. 과거에 사용한 명령과 현재 절차가 함께 적힌 곳에서는 현재 절차를 기준으로 실행한다. 각 단계의 통과 조건을 확인하고, 실행한 명령·작업 디렉터리·시각·종료 코드와 원문 출력을 함께 남겨 나중에 같은 실패를 다시 대조할 수 있게 한다.
|
||||
4. 04 단계는 --dry-run 을 먼저 돌린다. 주당 중복 인증서 5장 한도를 dry-run 은 쓰지 않는다.
|
||||
5. 막힌 단계마다 무엇이 없어서 막혔는지를 「이 구축에서 드러난 문서 결함의 공통 원인」의 두 축으로 분류해 적는다. 그 시점에 리소스가 없었나, 그 셸에서 안 도는 명령이었나. 어느 축에도 안 들어가면 그것을 새 축으로 적는다.
|
||||
6. 끝나면 판 번호 넷을 적어 지금 실험대의 값과 나란히 둔다. 명령이 pin한 k3s는 동일 버전 여부를 판정하고, package manager가 고정하지 않은 nginx/libvirt/QEMU는 관측값 차이와 동작 차이를 분리해서 적는다.
|
||||
|
||||
Reference in New Issue
Block a user