본문 바로가기

yaml9

Backstage 마스터하기: 소스 코드로 향하는 지도, source-location 어노테이션 완벽 가이드 안녕하세요! 오늘은 Backstage의 소프트웨어 카탈로그를 지탱하는 가장 중요한 메타데이터 중 하나인 backstage.io/source-location 어노테이션(Annotation)에 대해 아주 깊이 있게 파헤쳐 보겠습니다. 🚀Backstage를 사용하다 보면 서비스의 상세 페이지에서 "View Source" 버튼을 누르거나, 문서 위치를 연결할 때 이 설정을 자주 접하게 됩니다. 도대체 이 한 줄의 설정이 어떤 마법을 부리는지, 왜 중요한지 완벽하게 이해해 보세요! 💡🏗️ backstage.io/source-location이란 무엇인가요?Backstage에서 관리되는 모든 자원(컴포넌트, API, 리소스 등)은 엔티티(Entity)라고 불리는 YAML 파일로 정의됩니다. 이때 backstag.. 2025. 12. 27.
Backstage 모노레포의 보물창고, "common-library" 완벽 활용법 안녕하세요! 오늘은 Backstage의 패키지 관리 시스템에서 아주 중요한 역할을 담당하는 "common-library" 역할(Role)에 대해 깊이 있게 탐구해 보는 시간을 갖겠습니다. 🚀Backstage 프로젝트가 커지다 보면 여러 플러그인에서 공통적으로 사용하는 유틸리티 함수나 UI 컴포넌트들이 생겨나기 마련입니다. 이때 코드의 중복을 막고 효율적으로 관리하기 위해 사용되는 것이 바로 이 "common-library"입니다. 💡 🏗️ Backstage의 패키지 역할(Role) 시스템 이해하기Backstage는 모노레포(Monorepo) 내의 수많은 패키지를 효율적으로 빌드하고 관리하기 위해 각 패키지마다 '역할'을 부여합니다. package.json 파일의 backstage.role 필드에 이.. 2025. 12. 27.
Backstage 확장하기: 커스텀 애노테이션 정의와 예약어 충돌 방지 전략 안녕하세요! 오늘은 Backstage의 유연성을 극대화해주는 애노테이션(Annotations), 그중에서도 관리를 위해 필수적인 네임스페이싱(Namespacing) 규칙에 대해 깊이 있게 다뤄보겠습니다. 🚀Backstage를 운영하다 보면 기본 기능 외에 우리 조직만의 특별한 데이터를 추가하고 싶을 때가 많죠. 이때 사용하는 것이 애노테이션입니다. 하지만 아무 이름이나 사용하면 시스템 내부 충돌이 발생할 수 있습니다. 오늘은 절대로 사용해서는 안 되는 '예약된 접두사'와 올바른 네임스페이싱 전략을 완벽히 정리해 드립니다! 💡🏗️ Backstage 애노테이션이란?Backstage의 catalog-info.yaml 파일에서 metadata.annotations 섹션은 엔티티에 대한 비정형 메타데이터를 .. 2025. 12. 26.
[실전 Istio] Egress Gateway로 외부 트래픽 보안 챙기기 (feat. TLS 발신 설정) 안녕하세요! 👋 오늘은 Kubernetes 환경에서 Istio를 사용할 때, 외부 서비스로 나가는 트래픽을 안전하고 효율적으로 관리하는 방법에 대해 아주 상세하게 파헤쳐 보려고 합니다.제공해주신 코드는 Istio의 꽃이라 할 수 있는 Egress Gateway를 활용하여, 클러스터 내부의 애플리케이션이 외부의 야후 파이낸스(finance.yahoo.com)에 접근하는 시나리오를 담고 있습니다.그런데 그냥 접근하는 게 아닙니다! 🤫 애플리케이션은 편하게 HTTP로 요청을 보내지만, 클러스터를 빠져나갈 때는 Istio가 자동으로 안전한 HTTPS로 업그레이드해 주는 TLS Origination(TLS 발신) 구성을 다루고 있습니다.이 구성이 어떻게 작동하는지, 각 YAML 파일이 어떤 역할을 하는지 하나.. 2025. 11. 29.
YAML, 어디까지 알고 계신가요? 📜 버전별 완벽 정리 (1.0부터 1.2까지) 안녕하세요! 개발자라면 누구나 한 번쯤은 마주쳤을 YAML. Kubernetes 설정부터 GitHub Actions 워크플로우, Ansible 플레이북까지 정말 다양한 곳에서 사용되고 있죠. 🧐 그런데 혹시 YAML에도 여러 버전이 있다는 사실, 알고 계셨나요? 특히 특정 버전의 미묘한 차이 때문에 예상치 못한 오류를 경험하기도 합니다. 오늘은 YAML의 탄생부터 현재 표준인 1.2 버전까지, 그 전체적인 맥락과 핵심적인 차이점을 샅샅이 파헤쳐 보겠습니다!YAML의 탄생: "마크업 언어가 아니라고?" 🤔YAML의 역사는 2001년으로 거슬러 올라갑니다. Clark Evans가 처음 제안하고 Ingy döt Net, Oren Ben-Kiki와 함께 개발을 시작했죠.초기 이름: 처음에는 Yet Anoth.. 2025. 11. 4.
⚙️ Helm 마스터하기: CRD 설치는 건너뛰고, 템플릿만 쏙 뽑아보기! 안녕하세요, 쿠버네티스 유저 여러분! 👋 오늘은 Helm을 더욱 강력하고 유연하게 사용할 수 있게 해주는 두 가지 핵심 기능에 대해 알아보려고 합니다. 바로 CRD(Custom Resource Definitions) 설치를 건너뛰는 기능과, 차트를 실제로 설치하지 않고 결과물인 쿠버네티스 매니페스트(YAML)만 확인하는 기능입니다. 이 기능들이 왜 필요하고, 언제 어떻게 사용해야 하는지 궁금하셨나요? CI/CD 파이프라인을 구축하거나, 복잡한 차트를 안전하게 관리하고 싶다면 오늘 내용에 꼭 주목해 주세요! 🚀 🤔 CRD, 왜 설치를 건너뛰고 싶을까요?Helm 차트에는 애플리케이션에 필요한 CRD가 crds/ 디렉터리에 포함된 경우가 많습니다. helm install을 실행하면 Helm은 다른 템플릿.. 2025. 10. 4.