207 lines
9.0 KiB
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>
|