chore: 이전 세션이 남긴 변경을 커밋한다
이번 파이프라인 작업과 무관하게 작업 트리에 남아 있던 것을 그대로 올린다. 사용자가 「전부 커밋」으로 정했고, 이번 작업과 섞이지 않게 커밋만 나눴다. 대부분은 clean-architecture-backend-template 의 그림 정본 재배치다 — final/assets/diagrams/<이름>/ 에 있던 것이 CLAUDE.md 가 적은 배치인 final/assets/<이름>/ 로 옮겨졌고 .techviz/<이름>/ 이 함께 들어왔다. 삽입 줄의 대부분(3.15M)이 그 .techviz context.json 이다. 그 밖에 ca-tmpl·document-haness 의 정리, .claude/agents/ 열한 개, writing-practitioner-guides 스킬, .playwright-mcp 세션 산출물, scripts/check-ssot-facts.py 와 그 시험이 들어 있다. 이 커밋의 내용은 내가 만든 것이 아니라 이전 세션이 남긴 것이고 검증하지 않았다. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
DongHyeonka
co-authored by
Claude Opus 5
Claude Opus 5
parent
2109f726fe
commit
ab59130196
@@ -0,0 +1,52 @@
|
||||
# 데이터 저장소 — what to reach for first
|
||||
|
||||
## PostgreSQL
|
||||
```bash
|
||||
psql -U <user> -d <db>
|
||||
```
|
||||
```
|
||||
\conninfo 지금 어디에 붙어 있나
|
||||
\dt 테이블 목록
|
||||
\d <table> 구조 · 인덱스 · 제약
|
||||
\du 롤
|
||||
\l 데이터베이스 목록
|
||||
\x 세로 출력 토글 (넓은 행을 볼 때)
|
||||
```
|
||||
|
||||
```sql
|
||||
SHOW <setting>; -- 전역값
|
||||
SELECT * FROM pg_stat_activity; -- 지금 도는 쿼리
|
||||
EXPLAIN <query>; -- 계획만
|
||||
EXPLAIN (ANALYZE, BUFFERS) <query>; -- 실제 실행. 변경 쿼리에 쓰면 실제로 바뀐다
|
||||
```
|
||||
|
||||
한 줄로 값만 뽑을 때.
|
||||
```bash
|
||||
kubectl exec deploy/postgres -- psql -U <user> -d <db> -tAc 'select count(*) from <t>'
|
||||
```
|
||||
|
||||
문장 로깅 — 애플리케이션을 고치지 않고 「무엇이 DB 를 어떻게 쓰는지」 본다.
|
||||
```sql
|
||||
ALTER SYSTEM SET log_statement = 'all';
|
||||
SELECT pg_reload_conf();
|
||||
-- 끝나면 되돌린다
|
||||
ALTER SYSTEM RESET log_statement;
|
||||
```
|
||||
|
||||
## Redis
|
||||
```bash
|
||||
redis-cli ping
|
||||
redis-cli info server | head
|
||||
redis-cli dbsize
|
||||
redis-cli --scan --pattern '<prefix>*' # KEYS 대신. 블로킹하지 않는다
|
||||
redis-cli type <key>
|
||||
redis-cli ttl <key>
|
||||
redis-cli --no-raw get <key> # 바이너리를 이스케이프해 보여 준다
|
||||
redis-cli config get appendonly
|
||||
```
|
||||
`\xac\xed` 로 시작하면 Java 네이티브 직렬화라 사람이 읽을 수 없다.
|
||||
|
||||
`/data` 가 볼륨이 아니면 영속화 설정은 컨테이너와 함께 사라진다.
|
||||
```bash
|
||||
kubectl get pod -l app=redis -o jsonpath='{.items[0].spec.volumes}'
|
||||
```
|
||||
@@ -0,0 +1,72 @@
|
||||
# Kubernetes — what to reach for first
|
||||
|
||||
Order matters. Widen first, then narrow.
|
||||
|
||||
## 무엇이 있나
|
||||
```bash
|
||||
kubectl get pods # 이름 · 상태 · 재시작 횟수
|
||||
kubectl get pods -o wide # + 노드 · 파드 IP
|
||||
kubectl get all # 워크로드 계열만. Secret·PVC·Ingress 는 안 나온다
|
||||
kubectl get secret,configmap,pvc,ingress
|
||||
```
|
||||
|
||||
## 왜 이 파드가 이런가
|
||||
```bash
|
||||
kubectl describe pod <pod> # 이벤트가 여기 붙는다 — 로그보다 먼저 본다
|
||||
kubectl logs <pod>
|
||||
kubectl logs <pod> --previous # CrashLoop 이면 죽은 이유는 여기 있다
|
||||
kubectl logs <pod> -c <container> # 컨테이너가 여럿일 때
|
||||
kubectl events --for pod/<pod>
|
||||
kubectl get events --sort-by=.lastTimestamp | tail -20
|
||||
```
|
||||
|
||||
## 사슬을 따라간다
|
||||
```bash
|
||||
kubectl get deploy,rs,pod -l app=<label>
|
||||
```
|
||||
Deployment 는 파드를 직접 만들지 않는다. ReplicaSet 을 만들고 그것이 파드를
|
||||
만든다. RS 가 여러 개 남아 있는 것은 정상이며(배포 이력) 활성인 것만 0 이 아니다.
|
||||
|
||||
StatefulSet 은 RS 를 쓰지 않고 파드를 직접 만든다 — 이름이 고정이라
|
||||
`Terminating` 이 안 풀리면 대체 파드가 생기지 않는다.
|
||||
|
||||
## Service 가 파드를 잡고 있나
|
||||
```bash
|
||||
kubectl describe svc <svc> | grep -i endpoints
|
||||
kubectl get endpointslice -l kubernetes.io/service-name=<svc>
|
||||
```
|
||||
`kubectl get endpoints` 는 v1.33+ 에서 deprecated 다.
|
||||
|
||||
비어 있으면 셀렉터와 라벨이 안 맞거나 readiness 미통과다.
|
||||
```bash
|
||||
kubectl get svc <svc> -o jsonpath='{.spec.selector}'
|
||||
kubectl get pods --show-labels
|
||||
```
|
||||
|
||||
## Secret 이 실제로 들어갔나 — 값은 찍지 않는다
|
||||
```bash
|
||||
kubectl get secret <s> -o jsonpath='{.data}' | tr ',' '\n' | grep -o '"[A-Z_]*"' # 키 이름만
|
||||
kubectl get secret <s> -o jsonpath='{.data.<KEY>}' | base64 -d | wc -c # 길이만
|
||||
kubectl exec <pod> -- sh -c 'echo ${#MY_ENV}' # 파드 안 주입 확인
|
||||
```
|
||||
|
||||
## 적용과 대기
|
||||
```bash
|
||||
kubectl apply -f <file>
|
||||
kubectl rollout status deploy/<name> --timeout=180s # 끝날 때까지 블록한다
|
||||
kubectl rollout undo deploy/<name>
|
||||
```
|
||||
|
||||
## 안에서 볼 때
|
||||
```bash
|
||||
kubectl exec -it <pod> -- sh
|
||||
kubectl port-forward svc/<svc> 8080:80
|
||||
kubectl debug -it <pod> --image=busybox --target=<container> # 최소 이미지에 도구가 없을 때
|
||||
```
|
||||
|
||||
**최소 이미지에는 `curl` 도 `wget` 도 없다.** Keycloak 공식 이미지가 그렇다
|
||||
(`exit 127`). 밖에서 물어보거나 임시 파드를 띄운다.
|
||||
```bash
|
||||
kubectl run tmp --rm -it --restart=Never --image=curlimages/curl:8.11.1 -- \
|
||||
curl -s http://<podIP>:9000/metrics
|
||||
```
|
||||
@@ -0,0 +1,51 @@
|
||||
# Linux · systemd — what to reach for first
|
||||
|
||||
## 서비스 상태
|
||||
```bash
|
||||
systemctl status <unit> # 상태 · Main PID · CGroup · 최근 로그
|
||||
systemctl is-active <unit> # 한 단어. 스크립트용
|
||||
systemctl cat <unit> # 유닛 파일에 적힌 것
|
||||
systemctl show <unit> # 기본값까지 합쳐 실제 적용되는 것
|
||||
```
|
||||
`cat` 과 `show` 는 다르다. `Restart=on-failure` 만 적혀 있어도 `show` 는
|
||||
`RestartUSec`·`StartLimitBurst` 같은 기본값을 함께 보여 준다.
|
||||
|
||||
## 로그
|
||||
```bash
|
||||
journalctl -u <unit> -n 50 # 최근 50줄
|
||||
journalctl -u <unit> -e # 끝으로 (페이저)
|
||||
journalctl -u <unit> -f # 실시간
|
||||
journalctl -u <unit> -p err # 에러만
|
||||
journalctl -u <unit> --since '1 hour ago'
|
||||
journalctl -u <unit> -o json # 메타데이터까지
|
||||
```
|
||||
긴 줄이 접히면 `less -S` 로 좌우 스크롤한다.
|
||||
|
||||
**nginx 에러 로그는 2048바이트에서 잘린다**(`NGX_MAX_ERROR_STR`). 저널
|
||||
포맷을 바꿔도 안 늘어난다 — 기록 자체가 잘렸기 때문이다. access 로그에는
|
||||
제한이 없으므로 그쪽을 본다.
|
||||
|
||||
## 프로세스 · 포트 · 자원
|
||||
```bash
|
||||
ps aux | grep <name>
|
||||
ps -eo pid,ppid,etimes,lstart,args | grep <name> # 얼마나 오래 떠 있나
|
||||
ss -lntp # 듣고 있는 TCP 포트 + 프로세스
|
||||
lsof -i :8080
|
||||
free -m
|
||||
top / htop
|
||||
```
|
||||
|
||||
## cgroup
|
||||
```bash
|
||||
systemd-cgls /system.slice/<unit>.service
|
||||
cat /sys/fs/cgroup/system.slice/<unit>.service/memory.current
|
||||
cat /sys/fs/cgroup/system.slice/<unit>.service/pids.current
|
||||
```
|
||||
`systemctl status` 의 `Memory:` `Tasks:` `CPU:` 가 여기서 읽은 값이다.
|
||||
|
||||
## nginx
|
||||
```bash
|
||||
nginx -t && systemctl reload nginx # -t 를 통과할 때만 reload
|
||||
ps -eo pid,lstart,args | grep 'nginx: worker' # reload 판정은 워커 PID 로
|
||||
```
|
||||
reload 하면 마스터는 유지되고 워커만 새로 뜬다. 로그 문구가 아니라 이걸 본다.
|
||||
@@ -0,0 +1,61 @@
|
||||
# 네트워크 · TLS — what to reach for first
|
||||
|
||||
## HTTP
|
||||
```bash
|
||||
curl -I <url> # 한 번 볼 때
|
||||
curl -v <url> # 헤더 · TLS 협상까지
|
||||
curl -s -o /dev/null -w '%{http_code}\n' <url> # 여러 번 재서 비교할 때만
|
||||
```
|
||||
`-w` 형태는 측정용이다. 눈으로 한 번 볼 때는 `-I` 나 `-v` 로 충분하다.
|
||||
|
||||
## 이름 해석
|
||||
```bash
|
||||
dig +short <name>
|
||||
getent hosts <name> # /etc/hosts 와 NSS 순서까지 반영된 결과
|
||||
```
|
||||
|
||||
## TLS
|
||||
```bash
|
||||
echo | openssl s_client -connect <host>:443 -servername <host> 2>/dev/null \
|
||||
| openssl x509 -noout -subject -issuer -dates -ext subjectAltName
|
||||
|
||||
echo | openssl s_client -connect <host>:443 -servername <host> 2>/dev/null \
|
||||
| grep -E '^ *[0-9]+ s:|^ *i:|Verify return code'
|
||||
```
|
||||
체인 단계가 1개면 `cert.pem` 을 쓴 것이다. `fullchain.pem` 이어야 한다.
|
||||
|
||||
발급 시각의 외부 기준이 필요하면 SCT 를 본다.
|
||||
```bash
|
||||
… | openssl x509 -noout -ext ct_precert_scts
|
||||
```
|
||||
|
||||
## 연결 추적
|
||||
```bash
|
||||
sudo conntrack -L | grep <port>
|
||||
sudo conntrack -C
|
||||
cat /proc/sys/net/netfilter/nf_conntrack_tcp_timeout_established # 보통 86400
|
||||
```
|
||||
`ESTABLISHED` 는 대부분의 방화벽 규칙 평가를 건너뛴다. 규칙을 넣었는데
|
||||
아무 일도 없으면 여기를 먼저 본다.
|
||||
|
||||
## 방화벽 규칙
|
||||
```bash
|
||||
sudo iptables -S FORWARD # 순서가 중요하다 — 내 규칙이 몇 번째인가
|
||||
sudo iptables -L FORWARD -v -n # 카운터가 0 이면 도달하지 않았다
|
||||
sudo iptables -t raw -S PREROUTING # conntrack 보다 먼저 잡는 자리
|
||||
```
|
||||
|
||||
## 패킷
|
||||
```bash
|
||||
sudo tcpdump -i <iface> -n port <p> -c 20
|
||||
```
|
||||
오버레이 네트워크(flannel VXLAN 등)에서는 물리 인터페이스에 안쪽 IP 가 안
|
||||
보인다. `flannel.1` 같은 터널 인터페이스에서 잡는다.
|
||||
|
||||
## 시계
|
||||
```bash
|
||||
timedatectl show -p NTP -p NTPSynchronized
|
||||
A=$(date -u +%s.%N); B=$(ssh <host> 'date -u +%s.%N'); C=$(date -u +%s.%N)
|
||||
curl -sI https://www.google.com | grep -i '^date:' # 어느 쪽이 맞는지 외부 기준
|
||||
```
|
||||
두 기계의 로그를 나란히 놓기 전에 확인한다.
|
||||
Reference in New Issue
Block a user