Files

11 KiB

kind, slug, title, topic, topicName, project, status, questionStatus, lastVerifiedOn, evidence, sourceRevision, source
kind slug title topic topicName project status questionStatus lastVerifiedOn evidence sourceRevision source
QUESTION does-the-guide-rebuild-this-lab 가이드대로 다시 쳐서 이 실험대가 같은 상태로 서는가 build-completion-judgment 끝났다는 판정 virtualization 게시 전 OPEN 2026-09-21
../../../final/evidence/raw/2026-09-21-test-server-revalidation/04-worker-teardown.txt
../../../final/evidence/raw/2026-09-21-test-server-revalidation/05-setup00-host-prep-recheck.txt
../../../final/evidence/raw/2026-09-21-test-server-revalidation/09-setup01-worker-verify.txt
../../../final/evidence/raw/2026-09-21-test-server-revalidation/19-certbot-dryrun.txt
../../../final/evidence/raw/2026-09-21-test-server-revalidation/24-setup05-core-verification.txt
../../../final/evidence/raw/2026-09-21-test-server-revalidation/29-setup06-final-queries.txt
../../../final/evidence/raw/2026-09-21-test-server-revalidation/39-setup07-postrecovery-cluster.txt
import-head 9465582b5d1630eb4ae7c4e078021486919bf6b6 · uncommitted-working-tree snapshot
final/document.md#194-이-부에서-파생될-open-question
final/document.md#184-이-부의-출처와-범위

가이드대로 다시 쳐서 이 실험대가 같은 상태로 서는가

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에 실제로 재구축한 범위

  • 「이 부의 출처와 범위」에서는 이 부의 검증 방식을 갈라 적었다. 읽기 전용 확인은 돌아가는 실험대에서 실제로 실행해 출력을 그대로 실었다.
  • 2026-09-21 재검증에서는 kc-lab-1과 kc-lab-2를 destroy → undefine --remove-all-storage로 실제 철거하고 DHCP 예약도 제거한 뒤 다시 만들었다.
  • 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의 실제 원본 파일이 함께 있어야 문서 밖의 기억에 의존하지 않고 빈 환경에서 그대로 재구축할 수 있다.
  • 기존 구축 과정에서는 실행 순서와 실행 위치 때문에 여섯 번 막혔다. 각 실패 자체는 실제로 관측했고, 이 여섯 사례를 ‘순서와 위치를 검증하지 않은 문서’라는 공통 원인으로 묶은 것은 사례를 바탕으로 한 해석이다.
  • 수정한 가이드의 상당 부분은 2026-09-21 재구축에서 실제 실행 순서로 다시 확인했다. 다만 host 패키지 설치부터 Edge VM·DNS-01 인증서 계층까지 전부 제거한 완전한 빈 환경 재구축은 아직 하지 않았다.

완전 재구축에 필요한 조건

  • 검증할 때는 현재 저장소의 가이드를 기준으로 삼는다. 다만 기존 여섯 결함이 모두 현재 판에 반영됐는지는 실행 전에 별도로 대조해야 한다.
  • 외부 입력은 버전 고정 여부를 구분해서 본다. k3s는 INSTALL_K3S_VERSION=v1.36.4+k3s1로 명시적으로 고정한다. 반면 Debian 12 genericcloud 이미지, apt의 nginx/certbot, Arch의 libvirt/QEMU는 현재 절차가 exact package version을 고정하지 않는다. 이들은 재구축 시 실제 판 번호를 기록하되, 숫자가 다르다는 이유만으로 곧바로 재구축 실패로 판정하지 않는다.
  • 도메인과 Cloudflare 토큰과 tailnet 주소는 다시 세울 때도 그대로 쓴다고 본다. 04 단계 전체가 그 셋에 묶여 있다.
  • 새로 세우는 기계의 CPU 가 하드웨어 가상화를 지원한다고 전제한다. 아니면 00 단계부터 다른 이유로 막히고, 그 막힘은 가이드의 결함이 아니다.

아직 빈 호스트에서 모르는 것

  • 물리 호스트와 Edge VM, 인증서 계층까지 모두 제거한 빈 환경에서 00~06을 처음부터 순서대로 실행했을 때 어느 단계에서 멈추는지.
  • 저장소에 원본이 없는 keycloak-cluster.yaml, observability.yaml, kc-lab.yaml.example를 문서 본문만으로 다시 만들 수 있다고 봐도 되는지. 2026-09-21에는 현재 문서와 기존 환경 정보를 이용해 복구했지만, "필요한 입력 파일이 저장소에 완결돼 있다"는 조건은 아직 충족하지 못했다.
  • 다시 선 실험대의 동등성은 통과 조건 일곱과 topology/behavior로 판정한다. 현재 관측값은 libvirt 12.7.0 · QEMU 11.1.1 · nginx 1.22.1이고, k3s는 v1.36.4+k3s1이다. 이 가운데 k3s는 설치 명령에서 버전을 고정하지만 libvirt/QEMU/nginx는 현재 설치 절차가 exact version을 pin하지 않는다. 따라서 후자의 숫자는 provenance로 기록하되 재현 성공의 필수 동일값으로 요구하지 않는다.

보존해야 할 경계

  • 기존 실험대와 사용자 작업을 보존해야 하므로 재검증 범위는 명확한 lab 자원으로 제한한다. 2026-09-21에도 worker 두 대만 철거했고 libvirt default network, host SSH/Tailscale, unrelated service/config, Edge VM은 보존했다.
  • 이 호스트에 동일한 세 게스트를 한 벌 더 병렬로 세우기는 메모리 여유가 부족하다. 완전 재구축을 다시 검증하려면 기존 lab을 계획적으로 철거하거나 별도 host를 준비해야 한다.
  • 04 단계는 공개 인터넷이 아니라 tailnet 과 Cloudflare 계정에 묶여 있다. 다른 기계에서 재려면 그 둘에 닿아야 한다.
  • Let's Encrypt 의 주당 중복 인증서 5장 한도가 있다. 재구축을 여러 번 돌리면 04 단계가 거기 걸린다.
  • 한 번 끝까지 따라가는 것으로 답한다. 여러 번 돌려 분포를 보는 것은 이 물음의 범위 밖이다.

완전 재구축을 확인하는 방법

1. 다른 기계에 빈 호스트를 두고 00 부터 06 까지 순서대로 친다

돌고 있는 실험대를 건드리지 않고 가이드만 시험한다. 하드웨어가 달라도 상관없는 대신, 막힌 단계가 가이드의 결함인지 하드웨어 차이인지를 가르는 일이 따로 붙는다.

결과는 네 줄로 적는다.

멈춘 단계 : 00 부터 06 까지 중 어디인가 멈춘 이유 : 그 시점에 리소스가 없어서인가, 그 셸에서 안 도는 명령이라서인가, 둘 다 아닌가 「이 구축에서 드러난 문서 결함의 공통 원인」의 여섯과 겹치나 : o 또는 x 통과 조건 일곱 : 단계마다 같은 값이 나왔는가

2. 현재 lab을 계획적으로 철거한 뒤 00부터 다시 세운다

같은 하드웨어에서 검증할 수 있어 장비 차이를 제거할 수 있다. 대신 host/edge/certificate까지 포함해 어디까지 철거할지 먼저 정하고, SSH/Tailscale과 사용자 파일처럼 실험대 밖 자원은 보존해야 한다. 2026-09-21 worker 재구축보다 범위가 훨씬 크므로 별도 실험 세션에서 수행한다.

3. 문서만 읽어 빠진 단계를 찾는다 — 제외

「이 구축에서 드러난 문서 결함의 공통 원인」에서는 이미 답을 적었다. 개별 명령은 전부 실제로 돌았던 것이고 틀린 것은 명령이 아니라 그 명령이 놓인 위치라, 각 줄은 참인데 순서대로 따라가면 막힌다. 그런 결함은 문서를 읽어서는 안 나오고 실행해야 나온다.

다음 검증

  1. keycloak-cluster.yaml, observability.yaml, kc-lab.yaml.example의 실제 원본 파일을 저장소에 포함시킨다. 이 셋이 없으면 완전 재구축 검증에 "문서 밖의 기억"이 섞인다.
  2. 대상을 정한다. 다른 빈 host에서 검증할지, 현재 lab을 계획적으로 철거한 뒤 같은 host에서 다시 세울지 선택한다.
  3. 가이드 그대로 00부터 06까지 순서대로 친다. 과거에 사용한 명령과 현재 절차가 함께 적힌 곳에서는 현재 절차를 기준으로 실행한다. 각 단계의 통과 조건을 확인하고, 실행한 명령·작업 디렉터리·시각·종료 코드와 원문 출력을 함께 남겨 나중에 같은 실패를 다시 대조할 수 있게 한다.
  4. 04 단계는 --dry-run 을 먼저 돌린다. 주당 중복 인증서 5장 한도를 dry-run 은 쓰지 않는다.
  5. 막힌 단계마다 무엇이 없어서 막혔는지를 「이 구축에서 드러난 문서 결함의 공통 원인」의 두 축으로 분류해 적는다. 그 시점에 리소스가 없었나, 그 셸에서 안 도는 명령이었나. 어느 축에도 안 들어가면 그것을 새 축으로 적는다.
  6. 끝나면 판 번호 넷을 적어 지금 실험대의 값과 나란히 둔다. 명령이 pin한 k3s는 동일 버전 여부를 판정하고, package manager가 고정하지 않은 nginx/libvirt/QEMU는 관측값 차이와 동작 차이를 분리해서 적는다.

현재까지는 worker 재생성부터 workload·관측 스택·power-cycle 복구까지 실제로 통과했다. 남은 완전 재구축에서도 00부터 06까지 필요한 입력 파일만으로 통과 조건 일곱을 만족하면 그때 "가이드만으로 빈 환경에서 이 실험대가 다시 선다"고 기록한다. 그 결과가 있어야 qcow2를 옮기는 방식과 처음부터 재구축하는 방식의 시간도 같은 기준으로 비교할 수 있다.

어느 단계에서든 막히면 그 시점의 선행 리소스와 실행 위치를 먼저 확인한다. 기존 여섯 실패와 같은 유형이면 수정한 가이드가 아직 충분하지 않은 것이고, 두 범주로 설명되지 않는다면 새 결함 유형으로 기록한다. 이 과정을 끝까지 거쳐야 00~06의 생성 명령을 ‘현재 환경에서 재현 가능한 절차’라고 말할 수 있다.