본문 바로가기

annotations2

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 확장하기: 커스텀 애노테이션 정의와 예약어 충돌 방지 전략 안녕하세요! 오늘은 Backstage의 유연성을 극대화해주는 애노테이션(Annotations), 그중에서도 관리를 위해 필수적인 네임스페이싱(Namespacing) 규칙에 대해 깊이 있게 다뤄보겠습니다. 🚀Backstage를 운영하다 보면 기본 기능 외에 우리 조직만의 특별한 데이터를 추가하고 싶을 때가 많죠. 이때 사용하는 것이 애노테이션입니다. 하지만 아무 이름이나 사용하면 시스템 내부 충돌이 발생할 수 있습니다. 오늘은 절대로 사용해서는 안 되는 '예약된 접두사'와 올바른 네임스페이싱 전략을 완벽히 정리해 드립니다! 💡🏗️ Backstage 애노테이션이란?Backstage의 catalog-info.yaml 파일에서 metadata.annotations 섹션은 엔티티에 대한 비정형 메타데이터를 .. 2025. 12. 26.