chore: 실행 환경 구성 문서 추가 및 수정

This commit is contained in:
DongHyeonka
2026-09-10 15:55:36 +09:00
parent 6f6ab86345
commit 9465582b5d
17 changed files with 1489 additions and 142 deletions
+9 -4
View File
@@ -301,12 +301,17 @@ git checkout feature/keycloak-multinode-cluster-jdbc-ping
생긴다 — nginx 설정에서 실제로 겪었다
([`two-hop-proxy-header-contract.md`](two-hop-proxy-header-contract.md) 9절).
### 호스트 nginx
### 엣지 nginx (`kc-lab-edge`)
**lab host 가 아니라 엣지 게스트에서 돈다.** 2026-09-10 에 엣지 계층을
물리 호스트에서 `kc-lab-edge`(192.168.122.10) 로 옮겼다 —
[03](guides/03-nginx/) 의 「왜 엣지가 물리 호스트가 아니라 VM 인가」.
```bash
sudo cp deploy/lab/host/nginx-keycloak-lab.conf /etc/nginx/sites-available/keycloak-lab
sudo nginx -t && sudo systemctl reload nginx
sudo nginx -T | grep -n 'upstream\|server_name' # 최종 병합 설정
cat deploy/lab/edge/nginx-keycloak-lab.conf \
| ssh kc-lab-edge 'sudo tee /etc/nginx/sites-available/keycloak-lab >/dev/null'
ssh kc-lab-edge "sudo nginx -t && sudo systemctl reload nginx"
ssh kc-lab-edge "sudo nginx -T | grep -n 'upstream\|server_name'" # 최종 병합 설정
```
**`nginx -t`를 통과한 뒤에만 reload한다.** 깨진 설정으로 reload하면 서비스가