스터디 자료

▸ 0. 시작하기 전에 8

1. 3이 덱이 하려는 것
2. 4대상 독자
3. 5덱의 구성 — 커리큘럼 도메인에 맞춰 정렬했다
4. 6이 덱 전체를 관통하는 한 문장
5. 7표기 약속
6. 8실습 환경은 따로 준비하자
7. 9이 덱의 정보 기준 시점
8. 100장 요약

▸ 1. CKA 시험 해부 13

1. 12CKA는 어떤 시험인가
2. 13도메인과 배점
3. 14도메인별 실제 출제 항목 (커리큘럼 원문 정리)
4. 15커리큘럼에서 읽어야 할 신호
5. 16시험 환경에 이미 준비된 것들
6. 17터미널에서 알아둘 조작
7. 18vim 최소 세트
8. 19열어놓을 수 있는 문서
9. 20공식 문서에서 자주 퍼오는 페이지
10. 21채점은 결과만 본다
11. 22시간 배분이 진짜 시험이다
12. 23준비 로드맵
13. 241장 요약

▸ 2. 클러스터 아키텍처 21

1. 26클러스터는 두 층으로 되어 있다
2. 27전체 그림
3. 28kube-apiserver — 유일한 관문
4. 29etcd — 유일한 저장소
5. 30kube-scheduler — 자리를 정할 뿐이다
6. 31kube-controller-manager — 루프들의 모음
7. 32kubelet — 노드의 대리인
8. 33kube-proxy — Service를 노드의 규칙으로 번역한다
9. 34컨테이너 런타임 (CRI)
10. 35컨트롤 플레인은 어떻게 떠 있나 — 스태틱 Pod
11. 36스태틱 Pod의 특징
12. 37요청 하나가 지나가는 길
13. 38저장된 다음 — 컨트롤러들의 릴레이
14. 39오브젝트의 공통 구조
15. 40API 그룹과 리소스 탐색
16. 41네임스페이스
17. 42라벨과 셀렉터 — 연결의 접착제
18. 43필드 셀렉터와 소유 관계
19. 44노드 살펴보기
20. 45파일이 어디 있는지 — 트러블슈팅의 지도
21. 462장 요약

▸ 3. kubectl — 손 속도가 점수다 16

1. 48kubectl은 무엇인가
2. 49kubeconfig 구조 — 세 덩어리 + 조합
3. 50컨텍스트 다루기
4. 51출력을 다루는 법
5. 52정렬과 필드 추출
6. 53describe vs get -o yaml
7. 54명령형 vs 선언형
8. 55생성기(generator) — 시험의 핵심 무기
9. 56dry-run — 명령형으로 YAML을 뽑는다
10. 57수정하는 네 가지 방법
11. 58apply가 하는 일 — 3-way merge
12. 59삭제
13. 60로그 — 커리큘럼의 "컨테이너 출력 스트림"
14. 61exec · cp · port-forward
15. 62이벤트 — 시간순으로 보는 클러스터의 일기
16. 633장 요약

▸ 4. Pod — 배포의 최소 단위 22

1. 65Pod이란 무엇인가
2. 66Pod 안에서 공유되는 것
3. 67pause 컨테이너 — 보이지 않는 세 번째 컨테이너
4. 68Pod 매니페스트
5. 69command와 args — Dockerfile과의 대응
6. 70멀티 컨테이너 패턴
7. 71initContainers — 앱보다 먼저 끝나야 하는 일
8. 72네이티브 사이드카 (Kubernetes v1.33 GA)
9. 73Pod의 phase
10. 74컨테이너 상태 — 진짜 정보는 여기 있다
11. 75restartPolicy
12. 76CrashLoopBackOff의 정체
13. 77프로브(probe) — kubelet이 던지는 질문
14. 78프로브의 네 가지 방식
15. 79프로브 파라미터 읽는 법
16. 80종료 흐름 — Pod이 죽을 때 벌어지는 일
17. 81lifecycle 훅
18. 82환경변수 — 값을 넣는 여러 경로
19. 83securityContext
20. 84스태틱 Pod 만들기 — 시험 단골
21. 85리소스 in-place 변경 (Kubernetes v1.35 GA)
22. 864장 요약

▸ 5. 워크로드 컨트롤러 23

1. 88컨트롤러가 필요한 이유
2. 89어떤 컨트롤러를 쓸 것인가
3. 90ReplicaSet — 개수를 맞추는 루프
4. 91ReplicaSet의 무서운 성질
5. 92Deployment — ReplicaSet 위의 롤아웃 관리자
6. 93Deployment 만들기
7. 94롤링 업데이트의 두 손잡이
8. 95롤아웃 다루기
9. 96리비전과 change-cause
10. 97스케일링
11. 98DaemonSet — 노드마다 하나씩
12. 99DaemonSet의 배치 제어
13. 100StatefulSet — 신원이 있는 Pod
14. 101StatefulSet이 주는 세 가지 보장
15. 102headless Service와 안정적인 DNS
16. 103StatefulSet 업데이트와 스케일
17. 104Job — 끝나는 작업
18. 105Job 파라미터가 실제로 뜻하는 것
19. 106CronJob — 일정에 따라 Job을 만든다
20. 107CronJob에서 헷갈리는 것들
21. 108PodDisruptionBudget — 자발적 중단으로부터 보호
22. 109자가치유는 어디까지 되나
23. 1105장 요약

▸ 6. 설정과 리소스 16

1. 112설정을 이미지에서 분리하는 이유
2. 113ConfigMap 만들기
3. 114ConfigMap 매니페스트
4. 115주입 방식 1 — 개별 환경변수
5. 116주입 방식 2 — 전부 환경변수로
6. 117주입 방식 3 — 볼륨으로 마운트
7. 118subPath — 파일 하나만 얹기
8. 119Secret — ConfigMap과 무엇이 다른가
9. 120base64는 암호화가 아니다
10. 121imagePullSecrets
11. 122requests와 limits
12. 123CPU와 메모리의 단위
13. 124QoS 클래스 — 누가 먼저 쫓겨나는가
14. 125LimitRange — 네임스페이스의 기본값과 상한
15. 126ResourceQuota — 네임스페이스 총량 제한
16. 1276장 요약

▸ 7. 스케줄링 17

1. 129스케줄러가 하는 일 — 다시
2. 130배치를 제어하는 도구들
3. 131nodeName — 스케줄러 건너뛰기
4. 132nodeSelector — 가장 단순한 방법
5. 133nodeAffinity — 표현력 있는 버전
6. 134긴 이름 읽는 법과 연산자
7. 135podAffinity / podAntiAffinity
8. 136taint — 노드가 Pod을 밀어낸다
9. 137toleration
10. 138시스템이 자동으로 붙이는 taint
11. 139cordon · drain · uncordon
12. 140topologySpreadConstraints — 균등 분산
13. 141PriorityClass와 선점(preemption)
14. 142여러 스케줄러 쓰기
15. 143Pod admission — Pod Security Admission
16. 144스케줄링 실패 진단 순서
17. 1457장 요약

▸ 8. 오토스케일링 11

1. 147세 가지 오토스케일링
2. 148metrics-server가 먼저다
3. 149메트릭은 어디서 오는가
4. 150HPA 만들기
5. 151HPA가 개수를 정하는 방식
6. 152HPA 상태 읽기
7. 153여러 메트릭 쓰기
8. 154behavior — 확장·축소 속도 제어
9. 155VPA와 Cluster Autoscaler
10. 156HPA에서 자주 걸리는 것들
11. 1578장 요약

▸ 9. Service 17

1. 159Service가 필요한 이유
2. 160Service의 정체 — 가상 IP와 커널 규칙
3. 161Service 타입 네 가지
4. 162ClusterIP
5. 163targetPort는 이름으로도 쓸 수 있다
6. 164셀렉터와 엔드포인트 — 실제 연결의 실체
7. 165EndpointSlice — Endpoints의 후계자
8. 166NodePort
9. 167LoadBalancer와 ExternalName
10. 168셀렉터 없는 Service — 외부를 클러스터 이름으로
11. 169headless Service
12. 170kube-proxy 모드
13. 171sessionAffinity와 externalTrafficPolicy
14. 172여러 포트를 가진 Service
15. 173Service 진단 절차
16. 174어디서 끊겼는지 판별하기
17. 1759장 요약

▸ 10. 클러스터 DNS 9

1. 177CoreDNS는 어디에 있나
2. 178이름 규칙
3. 179Pod 안의 resolv.conf
4. 180dnsPolicy와 dnsConfig
5. 181Corefile — CoreDNS 설정
6. 182특정 도메인을 다른 곳으로 보내기
7. 183DNS 진단
8. 184DNS 증상별 원인
9. 18510장 요약

▸ 11. Ingress와 Gateway API 17

1. 187Service만으로는 부족한 이유
2. 188Ingress = 리소스 + 컨트롤러
3. 189Ingress 리소스
4. 190pathType — 세 가지
5. 191IngressClass — 어느 컨트롤러가 처리하나
6. 192Ingress TLS
7. 193기본 백엔드와 애노테이션
8. 194Gateway API — Ingress의 후속
9. 195세 개의 리소스와 세 개의 역할
10. 196Gateway
11. 197HTTPRoute
12. 198가중치 분배와 필터 — 애노테이션 없이
13. 199네임스페이스를 넘을 때 — ReferenceGrant
14. 200Route 종류들
15. 201Ingress에서 Gateway API로
16. 202진단
17. 20311장 요약

▸ 12. NetworkPolicy와 CNI 12

1. 205기본값은 "전부 허용"이다
2. 206CNI — 누가 네트워크를 만드는가
3. 207NetworkPolicy 구조
4. 208세 가지 규칙을 먼저 외우자
5. 209전부 차단하기
6. 210출발지를 지정하는 세 가지
7. 211가장 많이 틀리는 것 — AND와 OR
8. 212egress와 DNS
9. 213포트 지정과 주의점
10. 214실전 예제 — 3계층 앱
11. 215진단
12. 21612장 요약

▸ 13. 스토리지 20

1. 218볼륨이 필요한 이유
2. 219emptyDir — Pod과 함께 사는 임시 공간
3. 220hostPath — 노드의 디렉터리
4. 221PV와 PVC — 왜 나눴나
5. 222PersistentVolume
6. 223PersistentVolumeClaim
7. 224바인딩 규칙
8. 225accessModes
9. 226reclaimPolicy — PVC를 지우면 데이터는?
10. 227PV의 상태
11. 228StorageClass — 동적 프로비저닝
12. 229volumeBindingMode — 언제 묶을 것인가
13. 230볼륨 확장
14. 231StatefulSet과 volumeClaimTemplates
15. 232CSI — 스토리지 확장 인터페이스
16. 233설정을 담는 볼륨들
17. 234진단 절차
18. 235RWO 볼륨 + Deployment의 함정
19. 236정적 프로비저닝 실습 흐름
20. 23713장 요약

▸ 14. 인증 · 인가 · RBAC 20

1. 239요청이 통과해야 하는 세 관문
2. 240인증 방식들
3. 241사용자 인증서 만들기 (CSR API)
4. 242kubeconfig에 등록하기
5. 243ServiceAccount — Pod의 신원
6. 244SA 토큰의 현재 방식
7. 245RBAC의 네 리소스
8. 246Role
9. 247verbs와 apiGroups
10. 248하위 리소스를 잊지 말 것
11. 249RoleBinding
12. 250ClusterRole과 ClusterRoleBinding
13. 251조합 — 이 표가 전부다
14. 252내장 ClusterRole
15. 253집계 ClusterRole
16. 254권한 확인하기
17. 255실제로 실행해보기
18. 256admission 컨트롤러
19. 257RBAC 진단 순서
20. 25814장 요약

▸ 15. 클러스터 라이프사이클 22

1. 260이 장이 시험의 승부처다
2. 261노드 준비 — kubeadm 이전에 해야 할 것
3. 262컨테이너 런타임과 kubeadm 설치
4. 263kubeadm init
5. 264CNI 설치 — 이걸 안 하면 노드가 NotReady
6. 265워커 노드 조인
7. 266버전 스큐 규칙 — 업그레이드 순서의 근거
8. 267업그레이드 — 첫 컨트롤 플레인 노드
9. 268업그레이드 — kubelet과 kubectl
10. 269업그레이드 — 나머지 노드
11. 270업그레이드 순서 요약 — 이것만 외우면 된다
12. 271인증서 관리
13. 272etcd 접근 준비
14. 273etcd 백업
15. 274etcd 복구
16. 275복구에서 자주 틀리는 지점
17. 276HA 컨트롤 플레인 — 두 가지 토폴로지
18. 277etcd 멤버 관리
19. 278노드 추가와 제거
20. 279kubelet 설정 바꾸기
21. 280클러스터 건강 점검 루틴
22. 28115장 요약

▸ 16. Helm과 Kustomize 12

1. 283왜 커리큘럼에 있나
2. 284Helm의 구성 요소
3. 285Helm 기본 명령
4. 286값 오버라이드 — 실무의 핵심
5. 287업그레이드와 롤백
6. 288Kustomize — 템플릿 없는 커스터마이징
7. 289오버레이 — 이름·네임스페이스·이미지 바꾸기
8. 290오버레이 — generator와 patch
9. 291Kustomize 실행
10. 292generator의 해시 접미사
11. 293언제 무엇을 쓰나
12. 29416장 요약

▸ 17. 확장 인터페이스와 오퍼레이터 11

1. 296Kubernetes는 껍데기다
2. 297CRI — 컨테이너 런타임
3. 298CNI — Pod 네트워크
4. 299CSI — 스토리지
5. 300CRD — 새로운 리소스 만들기
6. 301CRD를 만들면 무슨 일이 생기나
7. 302오퍼레이터 — CRD + 컨트롤러
8. 303오퍼레이터 설치와 확인
9. 304CRD 다룰 때 주의점
10. 305그 밖의 확장 지점
11. 30617장 요약

▸ 18. 트러블슈팅 26

1. 308진단의 원칙
2. 309층을 가르는 세 가지 질문
3. 310도구 지도
4. 311Pod 상태별 진단 — 전체 지도
5. 312Pending
6. 313ImagePullBackOff
7. 314CrashLoopBackOff
8. 315OOMKilled
9. 316ContainerCreating에서 멈춤
10. 317Running인데 Ready가 아니다 (0/1)
11. 318Terminating이 끝나지 않는다
12. 319로그 다루기 — 커리큘럼의 "컨테이너 출력 스트림"
13. 320리소스 사용량 모니터링
14. 321노드가 NotReady
15. 322kubelet이 안 뜬다 — 체크리스트
16. 323kubectl이 아예 안 된다
17. 324API 서버가 안 뜨는 전형적 원인
18. 325스케줄러 · 컨트롤러 매니저가 죽었을 때
19. 326etcd 문제
20. 327네트워킹 진단 — 안에서 밖으로
21. 328네트워킹 증상 → 원인 표
22. 329인증서 문제
23. 330노드 압박(pressure)과 축출
24. 331종합 시나리오 — 자주 나오는 유형
25. 332고치고 나서 반드시 확인할 것
26. 33318장 요약

▸ 19. 시험 전략과 치트시트 17

1. 335시험 시작 30초 루틴
2. 336문제마다 반복하는 3단계
3. 337생성 치트시트 — 워크로드
4. 338생성 치트시트 — 네트워크 · 설정
5. 339생성 치트시트 — RBAC
6. 340조회 치트시트
7. 341진단 치트시트
8. 342클러스터 운영 치트시트
9. 343etcd 백업·복구 — 통째로 외울 것
10. 344YAML을 빠르게 만들고 고치는 법
11. 345자주 나오는 문제 유형
12. 346시간 관리
13. 347가장 비싼 실수들
14. 348검산 습관
15. 349공식 문서에서 바로 가져올 것들
16. 350시험 전 2주 계획
17. 35119장 요약

▸ 20. 마무리 6

1. 353전체 지도
2. 354장별로 남길 한 줄
3. 355반복해야 하는 것 — 딱 다섯 가지
4. 356자주 되돌아올 슬라이드
5. 357시험 이후 — 실무로 가는 길
6. 358마지막으로

▸ 0. 오리엔테이션 8

1. 3이 덱은 누구를 위한 것인가
2. 4이 덱의 한 가지 약속
3. 5다루는 것과 다루지 않는 것
4. 6전체 로드맵
5. 7미리 잡아두면 좋은 멘탈 모델 3가지
6. 8실습 환경 준비물
7. 92026년 8월 기준 — 바뀐 것들
8. 10자주 나올 용어 미리보기

▸ 1. 지형도 12

1. 12먼저: 이 셋은 경쟁하지 않는다
2. 13한 문장씩
3. 14각각이 없던 시절의 고통 (1) — Next.js 이전
4. 15각각이 없던 시절의 고통 (2) — Tailwind 이전
5. 16각각이 없던 시절의 고통 (3) — shadcn/ui 이전
6. 17왜 하필 이 조합인가
7. 18이 조합이 정답이 아닌 경우
8. 19대안 지도
9. 20실행 위치라는 축
10. 21완성된 화면 미리보기
11. 22같은 화면, 다른 디자인 시스템
12. 231장 요약

▸ 2. Next.js의 실체 14

1. 25Next.js를 한 문장으로
2. 26기존 React 앱에서 벌어지던 일
3. 27서버 컴포넌트가 바꾸는 것
4. 28서버 컴포넌트 = 기본값
5. 29클라이언트 컴포넌트는 명시적으로
6. 30use client는 "경계"지 "스위치"가 아니다
7. 31번들에 미치는 영향
8. 32규칙: 경계를 잎사귀로 밀어라
9. 33서버 컴포넌트가 클라이언트 컴포넌트를 감쌀 수 있다
10. 34서버에서 클라이언트로 넘길 수 있는 것
11. 35서버에서 클라이언트로 가는 것의 정체 — RSC 페이로드
12. 36하이드레이션이란 무엇인가
13. 37서버 컴포넌트에서 못 하는 것
14. 382장 요약

▸ 3. App Router 13

1. 40파일 규약이라는 아이디어
2. 41특수 파일 전체 목록
3. 42layout은 리렌더되지 않는다
4. 43동적 세그먼트
5. 44searchParams도 Promise다
6. 45라우트 그룹 — 괄호 폴더
7. 46병렬 라우트와 인터셉트
8. 47Route Handler — 진짜 API가 필요할 때
9. 48링크와 내비게이션
10. 49로딩과 에러 — 파일만 두면 된다
11. 50proxy.ts — 예전의 middleware.ts
12. 51proxy를 인증 게이트로 믿지 말 것
13. 523장 요약

▸ 4. 경계 설계 12

1. 54이 장에서 답할 질문
2. 55상황 1: Provider가 필요하다
3. 56도넛 패턴
4. 57상황 2: 서드파티 라이브러리에 use client가 없다
5. 58상황 3: 클라이언트 컴포넌트에 데이터가 필요하다
6. 59상황 4: Context를 쓰고 싶다
7. 60상태를 URL로 올리기
8. 61상황 5: 서버 전용 코드를 지키고 싶다
9. 62결정 트리
10. 63자주 하는 실수 모음
11. 64파일 구조 관례
12. 654장 요약

▸ 5. 데이터 가져오기 12

1. 67가장 단순한 형태
2. 68어디서 조회할 것인가
3. 69순차 vs 병렬 — 실제로 얼마나 차이 나는가
4. 70중복 조회는 React.cache()로
5. 71fetch도 자동으로 중복 제거된다
6. 72Suspense로 스트리밍
7. 73스트리밍의 실제 모습
8. 74어디에 Suspense를 걸 것인가
9. 75스켈레톤은 진짜 레이아웃을 흉내내야 한다
10. 76외부 API를 쓸 때
11. 77클라이언트에서 조회해야 하는 경우
12. 785장 요약

▸ 6. 캐싱 17

1. 80왜 이 장이 필요한가
2. 81켜기
3. 82use cache — 두 가지 층위
4. 83cacheLife — 수명을 정한다
5. 84cacheTag + revalidateTag — 온디맨드 무효화
6. 85캐시하지 않는 데이터는 Suspense로
7. 86런타임 API도 마찬가지다
8. 87정적 껍데기를 최대한 키우기
9. 88세 가지가 한 페이지에 공존한다
10. 89use cache: private — 사용자별 캐시
11. 90use cache: remote — 인스턴스 간 공유 캐시
12. 91저장 위치 정리
13. 92무작위 값과 현재 시각
14. 93런타임 프리페칭
15. 94봇과 크롤러는 다르게 처리된다
16. 95예전 모델과의 대응표
17. 966장 요약

▸ 7. 데이터 바꾸기 13

1. 98읽기가 서버로 갔다면, 쓰기는?
2. 99가장 단순한 형태
3. 100여기서 무슨 일이 일어나는가
4. 101점진적 향상 (progressive enhancement)
5. 102로딩·에러 상태: useActionState
6. 103실제로 보이는 모습
7. 104낙관적 업데이트: useOptimistic
8. 105Server Function은 공개 엔드포인트다
9. 106안전한 Server Function 템플릿
10. 107반복을 줄이는 방법
11. 108변경 후 화면 갱신하는 네 가지 방법
12. 109Server Function vs Route Handler
13. 1107장 요약

▸ 8. 성능 11

1. 112사용자가 실제로 느끼는 세 가지
2. 113레이아웃 시프트가 일어나는 순간
3. 114next/image가 대신 해주는 일
4. 115next/font — 폰트 때문에 튀지 않게
5. 116번들 줄이기 — 무거운 것은 잘라낸다
6. 117무엇이 번들을 키우는가
7. 118측정 도구
8. 119React Compiler
9. 120Turbopack
10. 121성능 개선의 우선순위
11. 1228장 요약

▸ 9. CSS의 문제 13

1. 124Tailwind를 배우기 전에
2. 125CSS의 근본 문제 세 가지
3. 126해결 시도의 역사
4. 127BEM — 규율로 해결하기
5. 128CSS-in-JS — 코로케이션으로 해결하기
6. 129Tailwind의 제안
7. 130같은 것을 세 가지 방식으로
8. 131"관심사의 분리"라는 반론
9. 132남는 진짜 문제: 반복
10. 133유틸리티가 실제로 만드는 CSS
11. 134CSS 크기 비교
12. 135Tailwind가 안 맞는 경우
13. 1369장 요약

▸ 10. Tailwind CSS v4 15

1. 138설치 — 이게 전부다
2. 139v3에서 온 사람이 가장 먼저 놀라는 것
3. 140@theme — 디자인 토큰이 곧 유틸리티
4. 141네임스페이스가 곧 규칙
5. 142기본 스케일을 눈으로
6. 143타이포 스케일
7. 144색 팔레트
8. 145변형(variant) — 조건부 스타일
9. 146반응형은 모바일 우선
10. 147group과 peer
11. 148임의 값 — 스케일 밖으로 나가야 할 때
12. 149반드시 알아야 할 제약: 클래스 이름은 정적이어야 한다
13. 150다크 모드
14. 151유용한 유틸리티 몇 가지
15. 15210장 요약

▸ 11. Tailwind 실전 14

1. 154긴 클래스 문자열 읽는 법
2. 155규칙 1: 클래스 정렬을 자동화한다
3. 156규칙 2: cn() 유틸리티를 만든다
4. 157cn()의 정체
5. 158cn()이 여는 것: 오버라이드 가능한 컴포넌트
6. 159규칙 3: variant는 cva로 관리한다
7. 160cva를 직접 움직여 보기
8. 161compoundVariants — 조합에만 적용되는 규칙
9. 162규칙 4: @apply를 쓰지 않는다
10. 163@apply가 정당한 드문 경우
11. 164커스텀 유틸리티가 필요하면 @utility
12. 165규칙 5: 언제 컴포넌트로 뽑을 것인가
13. 166자주 쓰는 조합 치트시트
14. 16711장 요약

▸ 12. 디자인 토큰 17

1. 169이 장이 이 덱의 중심이다
2. 170토큰이란 무엇인가
3. 1713단 구조
4. 172왜 의미 층이 필요한가
5. 173shadcn/ui의 토큰 목록
6. 174-foreground 규칙이 하는 일
7. 175실제 CSS
8. 176다크 모드가 공짜인 이유
9. 177@theme inline으로 Tailwind에 연결
10. 178두 층을 구분해서 보기
11. 179radius는 파생 스케일로
12. 180왜 oklch인가
13. 181토큰 추가하기 — warning을 예로
14. 182색 이외의 토큰
15. 183토큰 안티패턴
16. 184Figma와 이름 맞추기
17. 18512장 요약

▸ 13. shadcn/ui 12

1. 187공식 문서의 첫 문장
2. 188무슨 일이 일어나는지 직접 보기
3. 189전통적 라이브러리와의 비교
4. 190"복붙이랑 뭐가 다른가?"
5. 191무엇 위에 서 있는가
6. 1922026년 7월: 기본 베이스가 Base UI로 바뀌었다
7. 193Radix → Base UI 주요 차이
8. 194어떤 컴포넌트들이 있나
9. 195실물로 보기
10. 196트레이드오프를 정직하게
11. 197언제 shadcn/ui가 답이 아닌가
12. 19813장 요약

▸ 14. 설치와 구조 13

1. 200처음부터 끝까지
2. 201init이 하는 일
3. 202components.json 전체 구조
4. 203필드별 의미
5. 204cssVariables를 반드시 true로
6. 205baseColor — 중립색 고르기
7. 206style — 여덟 가지 시각적 성격
8. 207CLI 명령어 전체
9. 208알아두면 좋은 플래그
10. 209의존성이 자동으로 따라온다
11. 210모노레포에서
12. 211설치 후 파일 지도
13. 21214장 요약

▸ 15. 컴포넌트 해부 16

1. 214이 장의 목적
2. 215전체 골격
3. 216베이스 클래스 — 모든 variant가 공유하는 것
4. 217눈여겨볼 세 가지
5. 218aria-invalid 를 눈으로
6. 219variant 정의
7. 220여기서 하나도 원시 색이 없다
8. 221/90 은 무엇인가
9. 222함수 본문
10. 223forwardRef가 사라졌다
11. 224data-slot — 바깥에서 스타일링하는 훅
12. 225buttonVariants를 export하는 이유
13. 226합성 컴포넌트 — Card를 예로
14. 227합성의 결과물
15. 228render 프롭 — 태그를 바꾸기
16. 22915장 요약

▸ 16. 컴포넌트가 자산이 되는 방식 19

1. 231"자산"이 되려면 무엇이 필요한가
2. 232세 개의 층으로 나눈다
3. 233층별 규칙
4. 234ui/를 언제 고치는가
5. 235수정을 추적 가능하게 만들기
6. 236--diff가 보여주는 것
7. 237가운데 층에 무엇이 쌓이는가
8. 238EmptyState 예시
9. 239여기까지가 한 프로젝트의 이야기다
10. 240자체 레지스트리 — 전체 그림
11. 241registry.json
12. 242registry-item.json 전체 필드
13. 243type의 종류
14. 244빌드하고 호스팅하기
15. 245네임스페이스 등록
16. 246사내 레지스트리에 인증 붙이기
17. 247성숙도 단계
18. 248자산화를 방해하는 것들
19. 24916장 요약

▸ 17. 디자인 시스템 적용 22

1. 251먼저 해보고 시작하자
2. 252디자인 시스템의 네 구성요소
3. 253세 가지 시나리오
4. 254A. 브랜드 색만 입히기 (30분)
5. 255B. Material Design 3 채택
6. 256Material 3 매핑 결과
7. 257토큰만으로 안 되는 것
8. 258구조적 차이를 반영한 결과
9. 259B-2. Radix Colors 채택
10. 260Radix Colors가 좋은 이유
11. 261C. 사내 디자인 시스템 매핑
12. 2622단계 — 매핑 표는 이렇게 생겼다
13. 2633단계 — 갭을 처리하는 세 가지 방법
14. 2644단계 — 최종 파일 형태
15. 2655단계 — 컴포넌트 차이는 최소로
16. 2666단계 — 검증
17. 267검증 화면 예시
18. 268도구들
19. 269테마를 레지스트리로 배포하기
20. 270멀티 브랜드 — 한 앱에서 여러 테마
21. 271안티패턴
22. 27217장 요약

▸ 18. 접근성 12

1. 274왜 이 장이 필요한가
2. 275프리미티브가 해주는 것
3. 276키보드만으로 조작하기
4. 277포커스 링을 지우지 말 것
5. 278색만으로 정보를 전달하지 않기
6. 279폼 접근성 — 라벨과 오류
7. 280아이콘 버튼에는 이름을 준다
8. 281동적 콘텐츠 알리기
9. 282모션 줄이기
10. 283점검 방법
11. 284실수로 깨뜨리는 것들
12. 28518장 요약

▸ 19. 폼과 상태 11

1. 287상태를 네 종류로 나눈다
2. 288흔한 오해: 전부 전역에 넣기
3. 289URL 상태를 다루는 법
4. 290폼: React Hook Form + zod
5. 291스키마를 서버와 공유한다
6. 292폼 상태를 눈으로
7. 293Server Function과 함께 쓰기
8. 294서버 상태를 클라이언트에서 다뤄야 할 때
9. 295전역 클라이언트 상태가 진짜 필요할 때
10. 296결정표
11. 29719장 요약

▸ 20. 실전 13

1. 299첫날 체크리스트
2. 300첫 주에 정할 것
3. 301컴포넌트 카탈로그를 만드는 가장 싼 방법
4. 302실전 패턴 1: 목록 화면
5. 303실전 패턴 2: 삭제 확인
6. 304실전 패턴 3: 낙관적 삭제
7. 305실전 패턴 4: 로딩 상태 세 단계
8. 306안티패턴 모음 (1) — Next.js
9. 307안티패턴 모음 (2) — Tailwind · shadcn
10. 308코드 리뷰 체크리스트
11. 309팀에 도입할 때의 순서
12. 310마이그레이션 시 자주 나오는 질문
13. 31120장 요약

▸ 21. 정리 7

1. 313세 도구를 한 줄로 다시
2. 314이 덱에서 가장 중요한 세 장
3. 315자주 틀리는 것 다섯 개
4. 3162026년 8월 기준 버전 정리
5. 317다음에 볼 것
6. 318마지막으로
7. 319마무리

▸ 0. 오리엔테이션 6

1. 3이 덱은 누구를 위한 것인가
2. 4이 덱에서 다루는 것과 다루지 않는 것
3. 5전체 로드맵
4. 6미리 잡아두면 좋은 멘탈 모델 3가지
5. 7실습 환경 준비물
6. 8자주 나올 용어 미리보기

▸ 1. 왜 Supabase인가 19

1. 10백엔드를 처음부터 만들 때 반복되는 일들
2. 11BaaS라는 선택지
3. 12Supabase의 한 줄 정의
4. 13"그냥 Postgres다"가 왜 중요한가
5. 14Firebase와의 결정적 차이 (1) 데이터 모델
6. 15Firebase와의 결정적 차이 (2) 쿼리
7. 16Firebase와의 결정적 차이 (3) 종속성
8. 17비교표: Supabase vs Firebase vs 직접 구축
9. 18제품 구성 한눈에 보기
10. 19개발 속도가 실제로 빨라지는 지점
11. 20오픈소스와 셀프호스팅이라는 탈출구
12. 21Supabase를 쓰면 좋은 경우
13. 22Supabase를 쓰면 안 되는(신중해야 할) 경우
14. 23자주 나오는 오해 (1) "SQL 몰라도 되죠?"
15. 24자주 나오는 오해 (2) "백엔드가 아예 필요 없다"
16. 25자주 나오는 오해 (3) "RLS만 켜면 안전하다"
17. 26도입 판단 체크리스트
18. 27비용 감각 미리 잡기
19. 281장 요약

▸ 2. 아키텍처 뜯어보기 16

1. 30전체 아키텍처 한 장
2. 31요청 하나가 지나가는 길
3. 32Envoy — API 게이트웨이
4. 33PostgREST — 테이블을 REST로
5. 34PostgREST가 만드는 엔드포인트
6. 35Auth (GoTrue) — JWT 발급기
7. 36Realtime — WAL 구독 + 브로드캐스트
8. 37Storage API — 메타데이터는 Postgres에
9. 38Edge Functions — Deno 런타임
10. 39Supavisor — 커넥션 풀러
11. 40pg_meta와 Studio
12. 41스키마 지도: 무엇이 어디에 있나
13. 42API 키와 Postgres 역할의 연결
14. 43세 가지 접근 경로 비교
15. 44이 구조에서 나오는 결론들
16. 452장 요약

▸ 3. 시작하기 19

1. 47두 갈래 시작 경로
2. 48대시보드로 프로젝트 만들기
3. 49대시보드 둘러보기 — 어디에 뭐가 있나
4. 50프로젝트 자격 증명 확인하기
5. 51첫 테이블 만들기 (SQL Editor)
6. 52supabase-js 설치와 클라이언트 생성
7. 53첫 조회 / 삽입
8. 54여기서 멈추면 안 되는 이유
9. 55CLI 설치
10. 56supabase init — 프로젝트 구조
11. 57supabase start — 로컬 스택
12. 58로컬 스택 구성 요소와 포트
13. 59첫 마이그레이션 만들기
14. 60supabase db reset — 재현 가능한 DB
15. 61seed.sql — 개발용 데이터
16. 62원격 프로젝트와 연결하기
17. 63타입 생성 — 여기서 개발 경험이 갈린다
18. 64config.toml 훑어보기
19. 653장 요약 + 권장 워크플로

▸ 4. Postgres 최소 지식 18

1. 67왜 Postgres를 따로 짚는가
2. 68스키마 설계의 출발점 — auth.users
3. 69profiles 패턴 — 가장 먼저 만드는 테이블
4. 70profiles 패턴이 필요한 이유
5. 71자주 쓰는 데이터 타입
6. 72uuid vs bigint — 기본 키 선택
7. 73timestamptz를 반드시 써야 하는 이유
8. 74관계 표현 (1) 1:N
9. 75관계 표현 (2) N:M
10. 76제약 조건 — DB가 대신 지켜주는 것
11. 77enum vs check vs 참조 테이블
12. 78인덱스 기초
13. 79인덱스를 언제 어디에 만드나
14. 80뷰와 머티리얼라이즈드 뷰
15. 81트랜잭션과 원자성
16. 82데이터베이스 함수 (RPC) 맛보기
17. 83트리거 — updated_at 자동 갱신
18. 844장 요약

▸ 5. Data API와 supabase-js 21

1. 86Data API의 정체
2. 87클라이언트 생성 옵션
3. 88select 기본
4. 89필터 연산자 총정리
5. 90복합 조건 — or, and, not
6. 91정렬과 페이지네이션
7. 92개수 세기
8. 93단일 행 — single / maybeSingle
9. 94관계 조회 (1) 기본 조인
10. 95관계 조회 (2) 별칭과 다중 외래 키
11. 96관계 조회 (3) inner join과 자식 필터
12. 97관계 조회의 한계
13. 98insert
14. 99update / delete
15. 100upsert
16. 101RPC — 데이터베이스 함수 호출
17. 102JSON 컬럼 다루기
18. 103전문 검색 (textSearch)
19. 104에러 처리 패턴
20. 105타입 안전성 활용
21. 1065장 요약 + 안티패턴

▸ 6. Auth 27

1. 108Auth가 해결하는 문제
2. 109인증과 인가는 다르다
3. 110auth.users 테이블 구조
4. 111JWT 구조 뜯어보기
5. 112access token과 refresh token
6. 113세션 생명주기
7. 114이메일 + 비밀번호 가입
8. 115이메일 확인 플로우
9. 116로그인과 로그아웃
10. 117매직 링크 / OTP
11. 118소셜 로그인 (OAuth) 설정
12. 119소셜 로그인 코드와 콜백
13. 120PKCE 플로우
14. 121익명 로그인
15. 122전화번호 인증
16. 123SSO / SAML
17. 124비밀번호 재설정
18. 125사용자 메타데이터 — user vs app
19. 126커스텀 클레임과 RBAC
20. 127커스텀 클레임 활용
21. 128Auth Hooks
22. 129MFA (다중 인증)
23. 130서명 키와 getClaims
24. 131getClaims vs getUser vs getSession
25. 132Admin API — 서버에서 사용자 관리
26. 133흔한 Auth 함정 모음
27. 1346장 요약

▸ 7. RLS — Row Level Security 21

1. 136RLS 한 문장 정의
2. 137RLS가 없으면 벌어지는 일
3. 138RLS 켜기와 기본 거부
4. 139권한(GRANT)과 정책(POLICY)은 다른 층이다
5. 140정책 문법 해부
6. 141using vs with check
7. 142연산별 정책 4종 세트
8. 143헬퍼 함수 — auth.uid(), auth.jwt()
9. 144패턴 1 — 소유자만 (가장 기본)
10. 145패턴 2 — 공개 읽기 + 소유자 쓰기
11. 146패턴 3 — 팀 / 조직 멤버십
12. 147패턴 4 — 역할 기반 (RBAC)
13. 148패턴 5 — 가시성 범위 (public / friends / private)
14. 149permissive vs restrictive
15. 150security definer 헬퍼 함수
16. 151성능 (1) — 함수를 select로 감싸기
17. 152성능 (2) — 인덱스와 명시적 필터
18. 153성능 (3) — 역할 지정과 조인 회피
19. 154RLS 우회 경로 점검
20. 155RLS 테스트하는 법
21. 1567장 요약 + 체크리스트

▸ 8. Storage 13

1. 158Storage의 구조
2. 159버킷 만들기 — public vs private
3. 160업로드
4. 161다운로드와 URL 3종
5. 162Storage RLS 정책
6. 163폴더 구조로 권한 나누기
7. 164이미지 변환
8. 165재개 가능 업로드 (TUS)
9. 166S3 호환 접근
10. 167파일 메타데이터를 앱 테이블과 연결하기
11. 168대용량 · 보안 업로드 패턴
12. 169Storage 함정 모음
13. 1708장 요약

▸ 9. Realtime 15

1. 172Realtime의 세 가지 기능
2. 173채널이라는 공통 추상
3. 174Broadcast 기초
4. 175Broadcast — self / ack / HTTP 전송
5. 176Presence
6. 177Postgres Changes 설정
7. 178Postgres Changes 구독과 필터
8. 179Postgres Changes와 RLS
9. 180Broadcast from Database — 두 방식의 장점 합치기
10. 181무엇을 언제 쓰나 — 선택 가이드
11. 182확장성 — 반드시 알아야 할 차이
12. 183private 채널과 인가
13. 184실전 — 낙관적 UI와 재연결
14. 185Realtime 함정 모음
15. 1869장 요약

▸ 10. Edge Functions 13

1. 188Edge Functions란
2. 189첫 함수 만들기
3. 190로컬 실행과 배포
4. 191호출 방법
5. 192시크릿(환경 변수) 관리
6. 193함수 안에서 DB 접근 — 두 가지 방식
7. 194JWT 검증과 인가
8. 195의존성 관리
9. 196CORS 처리
10. 197Database Webhooks와 연동
11. 198언제 Edge Function을 쓰나
12. 199제약과 함정
13. 20010장 요약

▸ 11. 확장으로 넓히기 13

1. 202확장(extension)이라는 개념
2. 203확장 설치하기
3. 204pgvector (1) — 임베딩 검색이란
4. 205pgvector (2) — 스키마와 인덱스
5. 206pgvector (3) — 검색 함수와 호출
6. 207pg_cron — 스케줄 작업
7. 208pg_net — DB에서 HTTP 호출
8. 209pgmq — 메시지 큐
9. 210Foreign Data Wrappers
10. 211Vault — 시크릿 저장
11. 212기타 알아둘 확장들
12. 213조합 패턴 — cron + queue + edge function
13. 21411장 요약

▸ 12. Vercel과의 역할 배분 22

1. 216흔한 오해 — 둘은 경쟁 관계인가
2. 217한 문장 역할 배분
3. 218Vercel이 잘하는 것
4. 219Supabase가 잘하는 것
5. 220겹치는 영역 지도
6. 221표준 아키텍처 한 장
7. 222요청 흐름 3종
8. 223판단 기준 (1) — 서버 로직을 어디에 둘까
9. 224판단 기준 (2) — 비교표
10. 225판단 기준 (3) — 실제 사례로 배치해보기
11. 226데이터 접근 경로 선택 — Data API vs 직접 연결
12. 227리전 배치 — 지연 시간의 핵심
13. 228캐싱 역할 분담
14. 229환경 변수 배치
15. 230Vercel 통합 — 두 가지 연결 방식
16. 231프리뷰 배포와 Supabase 브랜치 매핑
17. 232Auth Redirect URL과 프리뷰 문제
18. 233비용 관점의 역할 배분
19. 234파일 업로드 경로 설계
20. 235Vercel 없이 Supabase를 쓰는 경우
21. 236안티패턴 모음
22. 23712장 요약

▸ 13. Next.js 실전 통합 22

1. 239왜 별도 패키지가 필요한가
2. 240환경 변수
3. 241브라우저 클라이언트
4. 242서버 클라이언트
5. 243쿠키 처리 규칙
6. 244middleware.ts — 세션 갱신
7. 245middleware.ts — 라우트 보호까지
8. 246middleware 주의사항
9. 247Server Component에서 데이터 조회
10. 248라우트 보호 패턴
11. 249Server Action으로 로그인
12. 250Server Action으로 데이터 변경
13. 251Route Handler
14. 252클라이언트 컴포넌트에서 조회
15. 253Realtime을 클라이언트 컴포넌트에서
16. 254캐싱과 동적 렌더링
17. 255관리자 클라이언트 분리
18. 256타입 공유 구조
19. 257로그아웃과 세션 정리
20. 258디렉터리 구조 예시
21. 259Next.js 통합 함정 모음
22. 26013장 요약

▸ 14. 운영 19

1. 262환경 분리 전략
2. 263마이그레이션의 규칙
3. 264마이그레이션 작성 요령
4. 265파괴적 변경 다루기
5. 266무중단 스키마 변경 순서
6. 267브랜칭 개요
7. 268브랜칭 워크플로
8. 269CI/CD 파이프라인 설계
9. 270GitHub Actions — 검증
10. 271GitHub Actions — 배포
11. 272시크릿 관리
12. 273백업과 복구
13. 274모니터링과 로그
14. 275Advisors 활용
15. 276프로덕션 체크리스트 — 보안
16. 277프로덕션 체크리스트 — 안정성
17. 278사고 대응 시나리오
18. 279팀 규칙으로 만들 것들
19. 28014장 요약

▸ 15. 성능 · 비용 · 한계 17

1. 282성능 문제의 지도
2. 283진단 도구 — EXPLAIN ANALYZE
3. 284인덱스로 해결되는 것들
4. 285RLS 성능 재점검
5. 286N+1 제거
6. 287페이지네이션 최적화
7. 288커넥션 관리
8. 289컴퓨트 크기와 한계
9. 290캐싱 전략
10. 291비용 구조 이해 (1) — 무엇에 돈이 나가나
11. 292비용 구조 이해 (2) — 대역폭이 조용한 킬러
12. 293비용 절감 체크리스트
13. 294확장 한계 — 언제 벽에 부딪히나
14. 295읽기 부하 분산
15. 296쓰기 부하 대응
16. 297언제 Supabase를 벗어나야 하나
17. 29815장 요약

▸ 16. 실전 패턴과 안티패턴 17

1. 300시나리오 1 — 멀티테넌트 SaaS (스키마)
2. 301시나리오 1 — RLS 헬퍼 함수
3. 302시나리오 1 — 정책 적용
4. 303시나리오 1 — 초대 플로우
5. 304시나리오 2 — 실시간 채팅 (스키마와 정책)
6. 305시나리오 2 — 전송과 구독
7. 306시나리오 3 — 결제 연동 (Stripe)
8. 307시나리오 3 — 웹훅 처리와 멱등성
9. 308시나리오 4 — 파일 기반 문서 앱
10. 309시나리오 5 — AI 챗봇 (RAG)
11. 310감사 로그 패턴 (1) — 테이블
12. 311감사 로그 패턴 (2) — 트리거
13. 312소프트 삭제 패턴
14. 313알림 패턴
15. 314안티패턴 총정리 (1) — 보안
16. 315안티패턴 총정리 (2) — 설계와 성능
17. 31616장 요약

▸ 17. 정리 7

1. 318전체 그림 되짚기
2. 319꼭 기억할 10가지
3. 320첫 프로젝트 시작 순서
4. 321학습 로드맵
5. 322참고 자료
6. 323자주 받는 질문
7. 324마무리

1. 2왜 Phaser인가
2. 3Phaser 4 핵심 구조
3. 4라이브 데모
4. 5슬라이드 임베드 시 주의점
5. 6정리