본문 바로가기

TechDocs3

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에 활력을! TechDocs 완벽 설치 및 Yarn 워크스페이스 설정 가이드 안녕하세요! 오늘은 Backstage의 핵심 기능 중 하나이자 개발자 경험(DevEx)의 꽃이라 불리는 TechDocs(테크독스)를 설치하는 방법에 대해 아주 상세히 알아보겠습니다. 🚀새로운 Backstage 모노레포를 구축한 뒤, "문서를 코드로(Documentation as Code)" 관리하기 위해 TechDocs를 추가하려고 할 때 어떤 명령어를 어떤 순서로 입력해야 할지 막막하셨죠? Yarn 워크스페이스 환경에서 프론트엔드와 백엔드 패키지를 완벽하게 설치하는 '정석 가이드'를 공개합니다! 💡🏗️ TechDocs 설치, 왜 Yarn 워크스페이스 방식인가요?Backstage는 기본적으로 모노레포(Monorepo) 구조를 채택하고 있습니다. 프론트엔드(packages/app)와 백엔드(packa.. 2025. 12. 26.
🛠️ Backstage 핵심 기능 총정리: 개발 생산성을 높이는 5가지 무기 안녕하세요!우리는 앞서 Backstage가 무엇인지, 왜 필요한지 배웠습니다. 이제는 실제 현장에서 개발자들이 가장 많이 열어보고 사용하는 Backstage의 5대 핵심 기능을 하나씩 파헤쳐 보려 합니다. 이 기능들이 어떻게 상호작용하며 '황금 경로(Golden Path)'를 만들어내는지 함께 확인해 보시죠! 🌟📌 이번 포스팅의 학습 목표 (Learning Objectives)이 글을 읽고 나면 여러분은 다음 내용을 완벽히 이해하게 됩니다:소프트웨어 카탈로그(Catalog)의 개념과 작동 원리 이해 📑스캐폴더(Scaffolder)를 통한 자동화된 프로젝트 생성 방법 🏗️검색(Search) 기능의 확장성 파악 🔍TechDocs가 '코드로 쓰는 문서'를 실현하는 방식 학습 📝플러그인(Plugins.. 2025. 12. 21.