HAL 0.4.1 hal.local.test(WS1) 배포 기록: VERSION_HISTORY 0.4.1 배포 절에 사설 CA 환경 배포·hal-host-agent 부트스트랩 완료·실제 TLS 경로 검증(핀 없는 curl 60 → 핀 명령·hal-ca.pem·--cacert·Node fetch ok), RUNBOOK §11.3 실행 기록

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-11-06 09:19:25 +00:00
parent 3250502caa
commit ed059d4884
2 changed files with 3 additions and 1 deletions
@@ -163,4 +163,5 @@ cd /srv/ariweb/hal/current && bash deploy/hal-host-agent.sh --name hal21.ariweb.
 1. HAL 서버에서 상태 확인: `node hal/index.mjs tls-probe` → `trusted:false, reason:…, pin:"sha256//…", caCount:1`. `caCount:0` 이면(루트를 체인에 싣지 않는 사설 CA) `/srv/ariweb/hal/data/tls/hal-ca.pem` 에 루트 CA PEM 을 두고 HAL 을 재시작하거나 10분 기다린다(`GET /agent/v1/tls?refresh=1`).
 2. 운영자 콘솔 › 서버 › 등록 토큰: 핀이 붙은 명령이 나온다. 대상 서버에서 그대로 실행한다(`-k --pinnedpubkey` 로 스크립트를 받고 `--hal-pin` 으로 CA 를 받는다). CA 는 `/srv/ariweb/agent/data/hal-ca.pem`, 유닛에 `NODE_EXTRA_CA_CERTS`, `agent.json` 에 `caFile`.
 3. 이미 등록된 서버에서 같은 명령을 다시 실행하면 "이미 등록된 서버 … 코드·유닛만 갱신" 으로 끝난다. 새 Agent 로 바꾸려면 토큰 발급 때 "재등록 허용" 을 선택한다(재인증).
+- 실행 기록(2026-11-06 09:17 UTC, hal.local.test = WS1 192.168.20.31, `ssh master@ws1`): HAL 0.4.0 → 0.4.1(`ws-apply-0.4.1.sh`), `hal-host-agent.sh` 로 서버 `srv_01a1b0268c70986dc77d7f8e76`·Agent `ag_01a1b0268e2ef4aba63f88cae4`, 부트스트랩 완료. 핀 `sha256//ANF6p+gy9SXw0D3TEJGBBDA3HQHRgp078yEuZJrj8uc=`(루트 CA 가 체인에 있어 `hal-ca.pem` 제공). WS2 등록은 운영자 콘솔 › 서버 ws2 › 등록 토큰(핀 명령) 또는 `node hal/index.mjs server-token --server srv_01a19f297b62971d5fc4d1edcc --by <who>`.
 4. 0.4.0 Agent 가 이미 설치된 서버(인증서가 사설 CA 로 바뀐 경우): `curl -k --pinnedpubkey '<핀>' https://<HAL>/agent/v1/hal-ca.pem -o /srv/ariweb/agent/data/hal-ca.pem` 후 유닛에 `Environment=NODE_EXTRA_CA_CERTS=/srv/ariweb/agent/data/hal-ca.pem` 을 더하고 재시작, 또는 HAL 작업으로 agent 0.4.1 배포 뒤 설치 명령을 다시 실행(`--hal-pin`)해 `caFile` 을 보완한다.