Files
Resume/dist/02-platform-devops-backend.feat.google-version.html

207 lines
9.0 KiB
HTML

<!doctype html>
<html lang="ko">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>02-platform-devops-backend.feat.google-version</title>
<style>:root {
color-scheme: light;
--ink: #1f2933;
--muted: #52616b;
--rule: #d8dee4;
--accent: #0f766e;
--soft: #eef7f5;
}
@page {
size: A4;
margin: 10mm 12mm 11mm;
}
* {
box-sizing: border-box;
}
body {
margin: 0;
background: #ffffff;
color: var(--ink);
font-family: "Noto Sans CJK KR", "Noto Sans KR", "Apple SD Gothic Neo", "Malgun Gothic", Arial, sans-serif;
font-size: 8.9pt;
line-height: 1.38;
word-break: keep-all;
overflow-wrap: break-word;
}
main {
max-width: 190mm;
margin: 0 auto;
}
h1,
h2,
h3 {
margin: 0;
line-height: 1.25;
letter-spacing: 0;
}
h1 {
padding-bottom: 2.8mm;
border-bottom: 2px solid var(--accent);
font-size: 18.5pt;
font-weight: 800;
}
h2 {
margin-top: 4.6mm;
padding-bottom: 1.1mm;
border-bottom: 1px solid var(--rule);
color: var(--accent);
font-size: 12.1pt;
font-weight: 800;
}
h3 {
margin-top: 3.6mm;
font-size: 10.4pt;
font-weight: 800;
}
.project {
display: block;
break-inside: avoid;
}
.project h3 {
margin-top: 3.8mm;
}
.project:first-of-type h3 {
margin-top: 3mm;
}
p {
margin: 1.7mm 0;
}
a {
color: #0b5cad;
text-decoration: none;
}
hr {
height: 1px;
margin: 3mm 0;
border: 0;
background: var(--rule);
}
table {
width: 100%;
margin: 2mm 0 3mm;
border-collapse: collapse;
font-size: 8.7pt;
}
td,
th {
padding: 1mm 1.6mm;
border-bottom: 1px solid var(--rule);
text-align: left;
vertical-align: top;
}
td:first-child,
th:first-child {
width: 23mm;
color: var(--muted);
font-weight: 700;
}
blockquote {
margin: 1.7mm 0;
padding: 1.5mm 2.2mm;
border-left: 3px solid var(--accent);
background: var(--soft);
color: #334e4a;
}
blockquote p {
margin: 0.8mm 0;
}
ul {
margin: 1.4mm 0 2.2mm;
padding-left: 4.4mm;
}
li {
margin: 0.75mm 0;
padding-left: 0.5mm;
}
strong {
font-weight: 800;
}
code {
padding: 0.1mm 0.7mm;
border-radius: 2px;
background: #f3f4f6;
color: #1f2937;
font-family: "JetBrains Mono", "D2Coding", Consolas, monospace;
font-size: 0.92em;
}
h3 + blockquote {
margin-top: 1.2mm;
}
blockquote + p,
blockquote + ul {
margin-top: 1.6mm;
}
h2,
h3,
blockquote,
table {
break-after: avoid;
}
li,
blockquote,
tr {
break-inside: avoid;
}
</style>
</head>
<body>
<main>
<h1>강동현 · 백엔드 신입 (Platform / DevOps 친화)</h1>
<table><tbody><tr><td></td><td></td></tr><tr><td>Email</td><td>donghyeonka68@gmail.com</td></tr><tr><td>GitHub</td><td><a href="https://github.com/donghyeon-ka">github.com/donghyeon-ka</a></td></tr><tr><td>TechLog</td><td><a href="https://hyeonworks.com">hyeonworks.com</a></td></tr><tr><td>Blog</td><td><a href="https://velog.io/@donghyeon2">velog.io/@donghyeon2</a></td></tr></tbody></table>
<hr>
<h2>Summary</h2>
<p>Spring Boot 애플리케이션이 실제로 실행되는 경로까지 이해하기 위해 K3s, Nginx, Traefik, Keycloak, Vault를 직접 구성해 온 신입 백엔드 개발자입니다.</p>
<p>물리 서버 host에 설정을 하나씩 추가하다 보니 TLS 종료 위치, proxy 신뢰 범위, secret과 session의 저장 위치를 설명하기 어려워졌습니다. 이를 정리하기 위해 <strong>외부 요청이 Nginx를 거쳐 Kubernetes Service까지 도달하는 경로와 각 컴포넌트의 책임을 분리</strong>했습니다.</p>
<p>모든 내용은 개인 home lab / dev 환경에서 검증한 결과이며 운영 경험으로 확대해 표현하지 않았습니다. 현재 <a href="https://hyeonworks.com">hyeonworks.com</a>에서 TechLog frontend를 서비스하고 있으며, backend와 플랫폼의 최종 통합은 진행 중입니다.</p>
<hr>
<h2>Skills</h2>
<p><strong>Core</strong></p>
<ul><li>Kubernetes / K3s, Nginx, Traefik, Kustomize, Helm / HelmChartConfig, NetworkPolicy</li></ul>
<p><strong>Secrets / Identity</strong></p>
<ul><li>HashiCorp Vault 1.17.2, Vault Secrets Operator, Keycloak, oauth2-proxy, Kubernetes Auth</li></ul>
<p><strong>Data / Observability</strong></p>
<ul><li>PostgreSQL / CloudNativePG, Redis, Prometheus, Grafana, Loki, Tempo, Blackbox Exporter</li></ul>
<hr>
<h2>Projects</h2>
<section class="project"><h3>Home Platform — K3s 기반 서비스 실행 환경</h3><blockquote><p>멘토링 기반 개인 프로젝트 · home lab / dev <a href="https://hyeonworks.com">hyeonworks.com</a></p></blockquote><p>서비스를 하나씩 올리면서 host와 cluster의 책임이 섞이기 시작했습니다. 단순히 “접속된다”가 아니라 <strong>요청이 어떤 신뢰 경계를 지나 Pod까지 도달하는지 설명할 수 있는 구조</strong>로 다시 구성했습니다.</p><ul><li>외부 HTTPS를 Host Nginx에서 종료하고 Traefik NodePort를 loopback에만 열어 <code>Internet → Nginx → 127.0.0.1 NodePort → Traefik → Service</code> 경로로 진입점을 제한했습니다.</li><li>외부가 보낸 <code>X-Forwarded-*</code>를 Nginx에서 다시 쓰고, Traefik은 실제 proxy source만 신뢰하도록 범위를 줄였습니다.</li><li>공개 서비스와 관리용 hostname을 분리하고 관리 경로에는 LAN / Tailscale source allowlist를 적용했습니다.</li><li>CloudNativePG / PostgreSQL, Keycloak, workload별 Local PV를 구성하고 서비스별 DB / role / Secret / NetworkPolicy를 분리했습니다.</li><li>Prometheus / Grafana / Loki / Tempo / Blackbox Exporter를 구성해 endpoint, node, log, trace, 인증서 상태를 각각 관측했습니다.</li><li>manifest에 선언된 설정과 live cluster에서 실제 집행되는 상태를 대조해, 선언만 존재하는 항목을 완료로 판단하지 않도록 검증했습니다.</li></ul><p><code>K3s</code> <code>Nginx</code> <code>Traefik</code> <code>Kustomize</code> <code>CloudNativePG</code> <code>Prometheus</code> <code>Grafana</code></p></section>
<section class="project"><h3>Vault Secret Delivery — 애플리케이션 밖으로 secret 책임 분리</h3><blockquote><p>개인 lab · 현재 Vault는 single replica / file storage 구성</p></blockquote><p>Secret 값을 Git에서 제거하는 것만으로는 누가 Vault에 접근하고, workload가 어떤 credential을 받는지 해결되지 않았습니다. 애플리케이션이 Vault API를 직접 알지 않도록 secret 전달 경계를 분리했습니다.</p><ul><li>Vault KV-v2를 source of truth로 두고 <strong>Vault → VSO → Kubernetes Secret → workload</strong> 흐름으로 구성했습니다.</li><li><code>VaultConnection</code> / <code>VaultAuth</code>와 Kubernetes Auth를 사용하고 role / policy를 경로별로 분리했습니다.</li><li>VSO controller → Vault init / unseal → auth / policy → KV seed → destination Secret → workload 순으로 bootstrap dependency를 정리했습니다.</li><li>실행 중 생성되는 registry credential은 생성 후 Vault에 기록하고 consumer가 VSO를 통해 다시 받도록 흐름을 분리했습니다.</li><li>현재 구성은 Vault 1 replica / file storage / local-path PVC 기준이며 Raft HA, auto-unseal 운영 경험으로 표현하지 않았습니다.</li></ul><p><code>Vault 1.17.2</code> <code>Vault Secrets Operator</code> <code>Kubernetes Auth</code> <code>Kustomize</code></p></section>
<section class="project"><h3>Keycloak Multi-node — session과 장애의 실제 위치 확인</h3><blockquote><p>개인 lab · VM 2대 / 2-node K3s</p></blockquote><p>Keycloak replica를 늘리면 session이 자동으로 공유된다고 보기 쉬웠습니다. 이를 확인하기 위해 두 VM에 Keycloak을 나눠 배치하고 DB, cache, network 조건을 바꿔가며 상태의 실제 위치를 확인했습니다.</p><ul><li>Keycloak 26 기본 <code>persistent-user-sessions</code>에서 교차 노드 session 처리가 <strong>공유 PostgreSQL session 조회에 의존</strong>하는 것을 SQL로 확인했습니다.</li><li>persistent session을 끈 조건에서는 JGroups 연결, rolling restart, DB 상태가 결과에 미치는 영향이 달라지는 것을 비교했습니다.</li><li>NetworkPolicy, iptables, <code>tc</code>를 적용했다고 바로 장애로 판단하지 않고 conntrack / packet counter / cluster state로 <strong>장애 주입 자체가 성공했는지 먼저 검증</strong>했습니다.</li><li>Refresh Token Rotation 동시 경쟁과 replica별 JWKS cache 차이처럼 단일 인스턴스에서는 드러나지 않는 상태 경쟁도 확인했습니다.</li></ul><p><code>K3s</code> <code>Keycloak</code> <code>PostgreSQL</code> <code>Redis</code> <code>JGroups</code> <code>Linux networking</code></p><hr></section>
<h2>Links</h2>
<ul><li><strong>TechLog</strong>: <a href="https://hyeonworks.com">hyeonworks.com</a></li><li><strong>GitHub</strong>: <a href="https://github.com/donghyeon-ka">github.com/donghyeon-ka</a></li><li><strong>Blog</strong>: <a href="https://velog.io/@donghyeon2">velog.io/@donghyeon2</a></li></ul>
</main>
</body>
</html>