update resume & portfolio
This commit is contained in:
@@ -4,86 +4,83 @@
|
||||
|---|---|
|
||||
| Email | donghyeonka68@gmail.com |
|
||||
| GitHub | [github.com/donghyeon-ka](https://github.com/donghyeon-ka) |
|
||||
| TechLog | [hyeonworks.com](https://hyeonworks.com) |
|
||||
| Blog | [velog.io/@donghyeon2](https://velog.io/@donghyeon2) |
|
||||
|
||||
---
|
||||
|
||||
## Summary
|
||||
|
||||
Spring Boot 애플리케이션이 실제로 실행되는 환경까지 이해하려고, K3s 기반 로컬 / dev 플랫폼을 직접 구성해 온 신입 백엔드 개발자입니다.
|
||||
Spring Boot 애플리케이션이 실제로 실행되는 경로까지 이해하기 위해 K3s, Nginx, Traefik, Keycloak, Vault를 직접 구성해 온 신입 백엔드 개발자입니다.
|
||||
|
||||
Ingress 인증 게이트, Vault 기반 secret 주입, default-deny NetworkPolicy, PSS Restricted baseline을 함께 구성하며 애플리케이션 코드 밖의 책임을 명확히 나누는 데 집중했습니다. 백엔드는 JWT 검증과 도메인 처리에 집중하고, 로그인 / 세션 / secret / 네트워크 경계는 플랫폼 계층에서 다루도록 설계했습니다.
|
||||
물리 서버 host에 설정을 하나씩 추가하다 보니 TLS 종료 위치, proxy 신뢰 범위, secret과 session의 저장 위치를 설명하기 어려워졌습니다. 이를 정리하기 위해 **외부 요청이 Nginx를 거쳐 Kubernetes Service까지 도달하는 경로와 각 컴포넌트의 책임을 분리**했습니다.
|
||||
|
||||
아래 내용은 운영 경험이 아니라 로컬 / dev 환경에서 실행 구조를 검증한 결과입니다. 대신 각 결정이 어떤 책임을 분리하기 위한 것인지 드러나도록 정리했습니다.
|
||||
모든 내용은 개인 home lab / dev 환경에서 검증한 결과이며 운영 경험으로 확대해 표현하지 않았습니다. 현재 [hyeonworks.com](https://hyeonworks.com)에서 TechLog frontend를 서비스하고 있으며, backend와 플랫폼의 최종 통합은 진행 중입니다.
|
||||
|
||||
---
|
||||
|
||||
## Skills
|
||||
|
||||
**Core**
|
||||
- Kubernetes (K3s 1.30), Kustomize, Traefik, NetworkPolicy default-deny, PSS Restricted
|
||||
- Kubernetes / K3s, Nginx, Traefik, Kustomize, Helm / HelmChartConfig, NetworkPolicy
|
||||
|
||||
**Secrets / Auth Gateway**
|
||||
- HashiCorp Vault 1.17.2, Vault Secrets Operator, Keycloak, oauth2-proxy, Traefik ForwardAuth, HelmChartConfig
|
||||
**Secrets / Identity**
|
||||
- HashiCorp Vault 1.17.2, Vault Secrets Operator, Keycloak, oauth2-proxy, Kubernetes Auth
|
||||
|
||||
**Validation / Backend**
|
||||
- `kustomize build`, `kubeconform -strict`, `kube-linter`, Java 21, Spring Boot 4, Spring Security Resource Server, PostgreSQL, Flyway
|
||||
**Data / Observability**
|
||||
- PostgreSQL / CloudNativePG, Redis, Prometheus, Grafana, Loki, Tempo, Blackbox Exporter
|
||||
|
||||
---
|
||||
|
||||
## Projects
|
||||
|
||||
### Project-Infra — Kubernetes 기반 백엔드 실행 환경
|
||||
### Home Platform — K3s 기반 서비스 실행 환경
|
||||
|
||||
> 개인 프로젝트 · 2025.11 ~ 현재 · 1 인 · 설계 / 구현 / 로컬 검증
|
||||
> [github.com/donghyeon-ka/project-infra](https://github.com/donghyeon-ka/project-infra)
|
||||
> 멘토링 기반 개인 프로젝트 · home lab / dev
|
||||
> [hyeonworks.com](https://hyeonworks.com)
|
||||
|
||||
Spring Boot 인증 서버가 동작하는 K3s 환경을 구성하고, 인증 게이트 / secret 주입 / 네트워크 정책 / manifest 검증 책임을 분리한 프로젝트입니다.
|
||||
서비스를 하나씩 올리면서 host와 cluster의 책임이 섞이기 시작했습니다. 단순히 “접속된다”가 아니라 **요청이 어떤 신뢰 경계를 지나 Pod까지 도달하는지 설명할 수 있는 구조**로 다시 구성했습니다.
|
||||
|
||||
- Traefik ForwardAuth + oauth2-proxy + Keycloak 조합으로 미인증 요청을 Ingress 계층에서 먼저 차단하도록 구성했습니다.
|
||||
- auth-server는 Ingress 뒤에서 Keycloak JWT를 Resource Server로 다시 검증하게 하여, 로그인 세션 처리와 API 권한 검증을 분리했습니다.
|
||||
- Vault KV-v2 값을 VSO가 Kubernetes Secret으로 동기화하도록 구성하고, 도메인별 Vault role / policy를 나눠 secret 접근 범위를 제한했습니다.
|
||||
- default-deny NetworkPolicy를 기본값으로 두고, 필요한 컴포넌트 간 통신만 명시적으로 허용했습니다.
|
||||
- K3s packaged Traefik manifest를 직접 수정하지 않고 `HelmChartConfig` overlay로 설정을 관리해, 재부팅 시 설정이 사라지는 문제를 피했습니다.
|
||||
- PSS Restricted baseline을 유지하기 위해 Vault의 `disable_mlock` 설정을 선택했고, 그에 따른 swap-off 운영 전제를 명시했습니다.
|
||||
- 주요 overlay에 대해 `kustomize build`, `kubeconform -strict`, `kube-linter` 검증을 실행하는 스크립트를 구성했습니다.
|
||||
- MinIO Operator 설치, namespace / PSS 라벨 적용, Vault init / unseal, VSO 설치 흐름을 반복 실행 가능한 bootstrap script로 분리했습니다.
|
||||
- 외부 HTTPS를 Host Nginx에서 종료하고 Traefik NodePort를 loopback에만 열어 `Internet → Nginx → 127.0.0.1 NodePort → Traefik → Service` 경로로 진입점을 제한했습니다.
|
||||
- 외부가 보낸 `X-Forwarded-*`를 Nginx에서 다시 쓰고, Traefik은 실제 proxy source만 신뢰하도록 범위를 줄였습니다.
|
||||
- 공개 서비스와 관리용 hostname을 분리하고 관리 경로에는 LAN / Tailscale source allowlist를 적용했습니다.
|
||||
- CloudNativePG / PostgreSQL, Keycloak, workload별 Local PV를 구성하고 서비스별 DB / role / Secret / NetworkPolicy를 분리했습니다.
|
||||
- Prometheus / Grafana / Loki / Tempo / Blackbox Exporter를 구성해 endpoint, node, log, trace, 인증서 상태를 각각 관측했습니다.
|
||||
- manifest에 선언된 설정과 live cluster에서 실제 집행되는 상태를 대조해, 선언만 존재하는 항목을 완료로 판단하지 않도록 검증했습니다.
|
||||
|
||||
`Kubernetes` `K3s` `Kustomize` `Traefik` `oauth2-proxy` `Keycloak` `Vault` `VSO` `NetworkPolicy` `PSS`
|
||||
`K3s` `Nginx` `Traefik` `Kustomize` `CloudNativePG` `Prometheus` `Grafana`
|
||||
|
||||
### Project-Auth-Server — 플랫폼 뒤에서 동작하는 Spring Boot 백엔드
|
||||
### Vault Secret Delivery — 애플리케이션 밖으로 secret 책임 분리
|
||||
|
||||
> 개인 프로젝트 · 2025.11 ~ 현재 · 1 인 · 설계 / 구현 / 로컬 검증
|
||||
> [github.com/donghyeon-ka/project-auth-server](https://github.com/donghyeon-ka/project-auth-server)
|
||||
> 개인 lab · 현재 Vault는 single replica / file storage 구성
|
||||
|
||||
플랫폼 계층이 로그인 / 세션을 처리하고, 백엔드는 Resource Server로 JWT를 검증하는 구조의 Spring Boot 인증 서버입니다.
|
||||
Secret 값을 Git에서 제거하는 것만으로는 누가 Vault에 접근하고, workload가 어떤 credential을 받는지 해결되지 않았습니다. 애플리케이션이 Vault API를 직접 알지 않도록 secret 전달 경계를 분리했습니다.
|
||||
|
||||
- `oauth2-client`가 아니라 `oauth2-resource-server`를 사용해 백엔드 책임을 JWT 검증과 권한 매핑으로 좁혔습니다.
|
||||
- Clean / Hexagonal 5 개 모듈 구조와 ArchUnit 테스트로 계층 의존성 위반을 빌드 단계에서 탐지하도록 했습니다.
|
||||
- application 코드가 HTTP status 같은 web 프로토콜 세부사항을 직접 알지 않도록 `ErrorCode`와 HTTP status 매핑을 분리했습니다.
|
||||
- K8s 환경에서는 공식 `flyway/flyway` 이미지를 initContainer로 실행해, 자체 migration 이미지 빌드 사이클을 줄였습니다.
|
||||
- Vault KV-v2를 source of truth로 두고 **Vault → VSO → Kubernetes Secret → workload** 흐름으로 구성했습니다.
|
||||
- `VaultConnection` / `VaultAuth`와 Kubernetes Auth를 사용하고 role / policy를 경로별로 분리했습니다.
|
||||
- VSO controller → Vault init / unseal → auth / policy → KV seed → destination Secret → workload 순으로 bootstrap dependency를 정리했습니다.
|
||||
- 실행 중 생성되는 registry credential은 생성 후 Vault에 기록하고 consumer가 VSO를 통해 다시 받도록 흐름을 분리했습니다.
|
||||
- 현재 구성은 Vault 1 replica / file storage / local-path PVC 기준이며 Raft HA, auto-unseal 운영 경험으로 표현하지 않았습니다.
|
||||
|
||||
`Java 21` `Spring Boot` `Spring Security` `Keycloak` `JPA` `Flyway` `ArchUnit`
|
||||
`Vault 1.17.2` `Vault Secrets Operator` `Kubernetes Auth` `Kustomize`
|
||||
|
||||
### feed-postgresql-query-tuning — PostgreSQL 성능 검증
|
||||
### Keycloak Multi-node — session과 장애의 실제 위치 확인
|
||||
|
||||
> 개인 프로젝트 · 2025.03 ~ 2025.04 · 1 인 · 분석 / 최적화 / 검증
|
||||
> [github.com/donghyeon-ka/feed-postgresql-query-tuning](https://github.com/donghyeon-ka/feed-postgresql-query-tuning)
|
||||
> 개인 lab · VM 2대 / 2-node K3s
|
||||
|
||||
플랫폼 관점에서도 애플리케이션 병목을 관찰할 수 있도록, DB 쿼리 실행 계획과 부하 테스트를 함께 정리한 프로젝트입니다.
|
||||
Keycloak replica를 늘리면 session이 자동으로 공유된다고 보기 쉬웠습니다. 이를 확인하기 위해 두 VM에 Keycloak을 나눠 배치하고 DB, cache, network 조건을 바꿔가며 상태의 실제 위치를 확인했습니다.
|
||||
|
||||
- `EXPLAIN ANALYZE` 기준 피드 목록 조회 쿼리 실행 시간을 **1.77 s → 7.66 ms**로 개선했습니다.
|
||||
- JOIN 구조 변경, 페이지네이션 쿼리 분리, 복합 / 커버링 인덱스 적용을 단계적으로 검증했습니다.
|
||||
- 단일 인스턴스 Locust 1,000 동시 사용자 시나리오에서 약 **900~1,100 RPS** 구간을 확인했습니다.
|
||||
- Keycloak 26 기본 `persistent-user-sessions`에서 교차 노드 session 처리가 **공유 PostgreSQL session 조회에 의존**하는 것을 SQL로 확인했습니다.
|
||||
- persistent session을 끈 조건에서는 JGroups 연결, rolling restart, DB 상태가 결과에 미치는 영향이 달라지는 것을 비교했습니다.
|
||||
- NetworkPolicy, iptables, `tc`를 적용했다고 바로 장애로 판단하지 않고 conntrack / packet counter / cluster state로 **장애 주입 자체가 성공했는지 먼저 검증**했습니다.
|
||||
- Refresh Token Rotation 동시 경쟁과 replica별 JWKS cache 차이처럼 단일 인스턴스에서는 드러나지 않는 상태 경쟁도 확인했습니다.
|
||||
|
||||
`PostgreSQL` `EXPLAIN ANALYZE` `Index design` `Redis` `Locust`
|
||||
`K3s` `Keycloak` `PostgreSQL` `Redis` `JGroups` `Linux networking`
|
||||
|
||||
---
|
||||
|
||||
## Links
|
||||
|
||||
- **TechLog**: [hyeonworks.com](https://hyeonworks.com)
|
||||
- **GitHub**: [github.com/donghyeon-ka](https://github.com/donghyeon-ka)
|
||||
- **메인 프로젝트**: [project-infra](https://github.com/donghyeon-ka/project-infra)
|
||||
- **인증 서버**: [project-auth-server](https://github.com/donghyeon-ka/project-auth-server)
|
||||
- **쿼리 튜닝**: [feed-postgresql-query-tuning](https://github.com/donghyeon-ka/feed-postgresql-query-tuning)
|
||||
- **Blog**: [velog.io/@donghyeon2](https://velog.io/@donghyeon2)
|
||||
|
||||
Reference in New Issue
Block a user