릴리스·복구·운영 피드백
버전·저장 구조·검증 결과를 묶어 전달을 준비하고 로컬 가상 자료로 백업 복원과 호환성 거절을 실행합니다.
이전 코드로 되돌렸는데 새 저장 파일을 읽지 못합니다. 릴리스는 사용할 구성을 식별해 전달하는 일이고 배포는 실제 실행 환경에 그 구성을 적용하는 일입니다. 로컬 실험의 성공과 운영 배포 성공은 다릅니다.
전달 전에 묶을 근거
버전·변경 요약·지원 환경·수락 및 회귀 결과·저장 구조의 호환성·되돌릴 자료와 조건을 확인합니다. 사용자가 관찰할 정책 변화와 내부 개선을 구분해 설명합니다. 테스트를 실행하지 않았거나 실제 환경을 검증하지 않았다면 그 범위를 그대로 기록합니다.
롤백은 이전 구성으로 되돌리는 대응이고 복구는 필요한 상태와 서비스를 다시 사용 가능하게 만드는 활동입니다. 데이터 구조가 바뀌면 코드만 롤백해도 충분하지 않을 수 있습니다. 되돌릴 수 있는 데이터·호환성·손실 허용 조건을 함께 정합니다.
전달 구성과 복구 자료를 함께 검증한다
min이 참가한 스키마 1 자료와 백업을 만든다. 호환 백업에서 실제 참가 상태를 복원한다. 각 단계의 값과 전환 이유를 비교합니다.
SOFTWARE ENGINEERING · READING CLUB
전달 구성과 복구 자료를 함께 검증한다
코드를 이전 버전으로 되돌릴 수 있어도 저장 자료가 호환되지 않을 수 있습니다.
예제는 가상 자료의 로컬 복원 실험입니다. 실제 서비스 배포·동시성·권한·장애 내구성은 별도 환경에서 검증합니다.
이 예의 조건
- 본문과 전체 도표의 예를 따라 호환 자료 준비부터 백업 복원까지 진행합니다.
| 관찰·상황 | 값·보충 정보 | 변화·이유 |
|---|---|---|
| 호환 자료 준비 min이 참가한 스키마 1 자료와 백업을 만든다. |
|
|
| 후보 확인 읽어서 스키마와 상태를 검사한 뒤 이름을 바꾼다. |
|
|
| 백업 복원 호환 백업에서 실제 참가 상태를 복원한다. |
|
|
전달 구성과 복구 자료를 함께 검증한다
min이 참가한 스키마 1 자료와 백업을 만든다. 호환 백업에서 실제 참가 상태를 복원한다. 각 단계의 값과 전환 이유를 비교합니다.
SOFTWARE ENGINEERING · READING CLUB
전달 구성과 복구 자료를 함께 검증한다
코드를 이전 버전으로 되돌릴 수 있어도 저장 자료가 호환되지 않을 수 있습니다.
예제는 가상 자료의 로컬 복원 실험입니다. 실제 서비스 배포·동시성·권한·장애 내구성은 별도 환경에서 검증합니다.
이 예의 조건
- 본문과 전체 도표의 예를 따라 호환 자료 준비부터 백업 복원까지 진행합니다.
| 관찰·상황 | 값·보충 정보 | 변화·이유 |
|---|---|---|
| 호환 자료 준비 min이 참가한 스키마 1 자료와 백업을 만든다. |
|
|
| 후보 확인 읽어서 스키마와 상태를 검사한 뒤 이름을 바꾼다. |
|
|
| 백업 복원 호환 백업에서 실제 참가 상태를 복원한다. |
|
|
안전한 로컬 복원 실험
examples/ch10.mjs는 새 임시 폴더에 가상 모임 자료만 만들고 종료할 때 그 폴더만 제거합니다. 원래 프로젝트·PDF·사용자 자료를 읽거나 바꾸지 않습니다. 실행 전에 코드를 읽어 임시 경로의 생성과 제거 범위를 확인합니다.
import assert from "node:assert/strict";
import { createHash } from "node:crypto";
import { mkdtemp, readFile, writeFile, rename, rm } from "node:fs/promises";
import { tmpdir } from "node:os";
import path from "node:path";
import { createSession, register, restoreSession } from "../core.mjs";
function decodeSnapshot(encoded) {
const snapshot = JSON.parse(encoded);
if (snapshot.schemaVersion !== 1) throw new Error("unsupported schema version");
return restoreSession(snapshot.session);
}
const initial = createSession({ id: "book-1", title: "첫 책", capacity: 2 });
const registered = register(initial, "min").state;
const encoded = JSON.stringify({ schemaVersion: 1, session: registered });
const sha256 = createHash("sha256").update(encoded).digest("hex");
assert.equal(sha256.length, 64);
assert.throws(() => decodeSnapshot('{"schemaVersion":2}'), /unsupported/);
// All created files stay in our newly created temporary directory.
const directory = await mkdtemp(path.join(tmpdir(), "reading-lab-release-"));
try {
const backup = path.join(directory, "backup.json");
const temporary = path.join(directory, "candidate.json");
const current = path.join(directory, "current.json");
await writeFile(backup, encoded, "utf8");
await writeFile(temporary, encoded, "utf8");
decodeSnapshot(await readFile(temporary, "utf8"));
await rename(temporary, current);
const restored = decodeSnapshot(await readFile(backup, "utf8"));
assert.deepEqual(restored.participants, ["min"]);
assert.equal(register(restored, "min").code, "ALREADY_REGISTERED");
console.log("snapshot v1, checksum length", sha256.length);
console.log("local backup restore PASS");
} finally {
await rm(directory, { recursive: true, force: true });
}node examples/ch10.mjs출력은 해시 길이 64와 local backup restore PASS입니다. 가상 저장 스키마 버전 1만 받으며 버전 2는 명시적으로 거절합니다. 알 수 없는 버전을 무조건 v1으로 해석하면 누락된 필드를 조용히 잃을 수 있습니다.
후보 파일을 읽어 유효성을 확인한 뒤 같은 임시 디렉터리 안에서 이름을 바꿉니다. 이는 단순한 로컬 실험입니다. 실제 파일 시스템의 장애 내구성, 동시에 읽고 쓰는 프로세스, 권한과 디스크 실패를 모두 검증한 트랜잭션 저장 시스템이 아닙니다. 실제 쓰기 동작의 API 범위는 Node.js 파일 시스템 문서에서 확인합니다.
운영 피드백의 연결
오류가 생기면 시각·환경·버전·재현 입력·관찰 결과를 기록하되 실사용자 ID·비밀 값은 그대로 보고하지 않습니다. “저장 실패 뒤 성공으로 안내했다”는 관찰은 다음 수락 사례와 오류 처리 개선의 입력이 됩니다. 원인을 모른 채 배포 횟수만 늘리면 비교할 근거가 사라집니다.
독립 문제: 호환성 없는 롤백
새 버전은 참가자 ID 대신 내부 숫자 ID를 저장합니다. 이전 버전은 문자열만 받습니다. 새 파일을 그대로 두고 코드만 되돌릴 때의 위험과 릴리스 전에 준비할 자료를 제시하세요.
힌트
변환을 되돌릴 수 있는지와 이전 데이터의 의미를 보존하는지 확인합니다.
해설
이전 코드가 파일을 거절하거나 잘못 해석할 수 있습니다. 스키마 버전·변환 규칙·호환성 테스트·변환 전 백업·되돌리는 절차와 데이터 손실 조건을 준비합니다. 숫자 ID에서 원래 문자열을 복원할 매핑이 없으면 단순 역변환이 불가능합니다. 코드 롤백 성공과 명단 복구 성공을 따로 확인합니다.
마지막 문서는 문서가 부족한 기존 시스템의 구조와 의도를 어떻게 확인해 개선할지 다룹니다.