Glasskube, 기술 문서 프레임워크를 Docusaurus에서 Starlight로 마이그레이션

2025-05-27
Glasskube, 기술 문서 프레임워크를 Docusaurus에서 Starlight로 마이그레이션

Glasskube의 엔지니어인 Philip이 기술 문서 프레임워크를 Docusaurus에서 Starlight로 마이그레이션한 경험을 공유합니다. 이 글에서는 디자인, SEO, 개발자 경험, 빌드 속도, 확장성 등 여러 측면에서 두 프레임워크를 비교합니다. React 기반의 Docusaurus는 빌드 속도가 느리고 사용자 정의가 제한적입니다. 반면 Astro 기반의 Starlight는 빌드 속도가 빠르고 Tailwind CSS를 지원하지만 Mermaid 통합 및 마케팅 페이지 기능이 부족합니다. Glasskube는 몇 가지 단점이 있지만 뛰어난 개발자 경험과 현대적인 외관을 제공하기 때문에 Starlight를 선택했습니다. 이 글에서는 문서 구조, 사용자 행동 분석, 작성 스타일 등 기술 문서 작성에 대한 통찰력도 공유하며, 간결성과 명확성을 강조합니다.

더 보기

AWS EKS에서 제로 다운타임 배포를 달성하는 세 가지 단계

2025-03-10
AWS EKS에서 제로 다운타임 배포를 달성하는 세 가지 단계

Glasskube의 엔지니어인 Jakob은 AWS EKS에서 제로 다운타임 배포를 달성한 경험을 공유합니다. 이 글에서는 AWS 로드 밸런서 컨트롤러의 작동 방식을 자세히 설명하고 롤링 업데이트 중에 발생할 수 있는 두 가지 다운타임 문제(헬스 체크 지연 및 Pod 종료 지연)를 지적합니다. 그리고 세 가지 해결책으로 Pod Readiness Gates 활성화, 애플리케이션의 우아한 종료 구현, 사이드카 컨테이너 사용 또는 애플리케이션에 종료 지연 추가를 제안합니다. 이 세 가지 단계를 통해 롤링 업데이트 중 502/504 오류를 효과적으로 방지하고 100% 제로 다운타임 배포를 달성할 수 있습니다.

더 보기

Java/Kotlin에서 Go로: 효율적인 전환

2025-02-18
Java/Kotlin에서 Go로: 효율적인 전환

이 글에서는 Java와 Kotlin에서 Go로의 개발자 전환 과정을 설명합니다. 처음에는 Java의 성숙한 생태계와 Spring 프레임워크를 선호했지만, 프로젝트 규모와 복잡성이 증가하면서 느린 시작 시간과 높은 리소스 소비가 병목 현상을 야기했습니다. Kubernetes 도구와 자체 호스팅 소프트웨어 배포 플랫폼 개발을 추진력 삼아 Go로 전환했고, 놀랍도록 원활하게 진행되었습니다. 저자는 Go의 빠른 시작 시간, 낮은 리소스 소비, 경량 생태계를 중요한 장점으로 강조합니다. Java의 장점도 인정하지만, 클라우드 네이티브 애플리케이션과 Kubernetes에서는 Go가 더 나은 선택이라고 결론짓습니다.

더 보기
개발