Backstage 개발자 포털은 Spotify가 대규모의 현대 소프트웨어 개발 복잡성을 해결하기 위해 처음 만든 오픈 소스 플랫폼입니다. 이 플랫폼은 엔지니어링 팀이 모든 소프트웨어 구성 요소, API, 서비스 및 인프라를 단일 인터페이스에서 발견하고, 문서화하고, 관리하며, 운영할 수 있는 통합 허브 역할을 합니다.
조직이 성장하고, 서비스가 증가하며, 팀이 더욱 전문화됨에 따라 개발자들은 종종 문서나 소유권을 찾거나 종속성을 이해하는 데 어려움을 겪습니다. Backstage 개발자 포털은 가시성, 검색 가능성 및 셀프 서비스를 위한 중앙 집중식의 사용자 정의 가능한 플랫폼을 제공하여 이러한 문제를 해결합니다. 이를 통해 개발자들은 마찰을 줄이고 더 빠르게 움직일 수 있습니다.
버튼
Backstage 개발자 포털이 중요한 이유
Backstage 개발자 포털은 단순한 내부 위키나 대시보드가 아닙니다. 이는 개발자 생산성과 운영 우수성에 대한 전략적 투자입니다. 다음은 Spotify, Wise, Netflix와 같은 기업의 플랫폼 엔지니어링 팀을 위한 최고의 솔루션이 된 이유입니다.
- 지식 중앙 집중화: 문서, API 사양, 소유권 세부 정보 및 인프라 도구를 한곳에 통합합니다.
- 향상된 개발자 경험: 리소스를 쉽게 찾고, 프로젝트에 온보딩하며, 모범 사례를 따르게 함으로써 인지 부하를 줄입니다.
- 셀프 서비스 자동화: 수동적인 병목 현상 없이 개발자가 서비스 또는 API를 생성, 배포 및 관리할 수 있도록 합니다.
- 일관성 및 규정 준수: 템플릿, 스코어카드 및 자동화된 검사를 통해 조직 표준을 강제합니다.
- 확장성: 수백 또는 수천 개의 마이크로 서비스와 팀을 가진 조직에 적응합니다.
잘 구현된 Backstage 개발자 포털은 고속, 저마찰 엔지니어링 조직의 중추입니다.
Backstage 개발자 포털의 핵심 기능
Backstage 개발자 포털의 힘을 이해하기 위해 주요 기능을 살펴보겠습니다.
1. 소프트웨어 카탈로그
모든 Backstage 개발자 포털의 핵심에는 소프트웨어 카탈로그가 있습니다. 이는 서비스, 라이브러리, API, 데이터 파이프라인 등 모든 소프트웨어 구성 요소의 중앙 집중식 인벤토리입니다. 각 카탈로그 항목은 다음과 같은 세부 정보를 제공합니다.
- 소유권 (팀, 스쿼드 또는 개인)
- 설명 및 문서 링크
- 소스 코드 저장소
- 배포 상태 및 환경
- 관련 리소스 및 종속성
이러한 가시성은 "누가 무엇을 소유하는가"에 대한 혼란을 없애고 재사용 가능한 구성 요소를 쉽게 발견할 수 있게 합니다.
2. API 관리
API와 마이크로 서비스의 증가로 인해 API 문서 및 사용 관리가 중요합니다. Backstage 개발자 포털은 API 사양 (OpenAPI, Swagger, GraphQL 등)과 원활하게 통합되어 코드 및 소유권 정보와 함께 대화형 API 문서를 표시합니다.
팁: Apidog와 같은 도구는 여기에 완벽하게 맞아떨어집니다. Apidog에서 API를 설계하고 문서화한 다음 Backstage를 통해 이를 노출하면 강력한 엔드투엔드 API 수명 주기를 생성합니다.
버튼
3. 소프트웨어 템플릿
Backstage 개발자 포털은 팀이 모범 사례를 내장하여 새로운 서비스, 라이브러리 또는 인프라 구성 요소를 부트스트랩할 수 있도록 하는 소프트웨어 템플릿을 제공합니다. 템플릿은 다음을 강제할 수 있습니다.
- 기술 스택 선택 (Node.js, Go, Python 등)
- 보안 및 규정 준수 검사
- 표준화된 문서
- CI/CD 파이프라인과의 통합
이를 통해 새로운 프로젝트가 올바르게 시작되고 온보딩 시간과 기술 부채가 줄어듭니다.
4. 플러그인 생태계
Backstage 개발자 포털의 중요한 강점은 확장성입니다. 커뮤니티는 인기 있는 DevOps 도구, 클라우드 제공업체, 모니터링 시스템, 보안 스캐너 등과 통합되는 수백 개의 플러그인을 유지 관리합니다. 일반적인 통합에는 다음이 포함됩니다.
- Kubernetes 클러스터 및 배포
- CI/CD 파이프라인 (Jenkins, GitHub Actions, GitLab CI)
- 사고 관리 (PagerDuty, Opsgenie)
- API 문서 생성기 (Apidog와 같은)
- 보안 및 규정 준수 대시보드
5. 검색 및 발견
Backstage 개발자 포털은 강력한 검색 기능을 제공하여 서비스, API, 저장소, 문서 또는 소유자를 쉽게 찾을 수 있도록 합니다. 더 이상 Slack이나 오래된 스프레드시트를 뒤질 필요가 없습니다.
6. 문서 허브
문서는 Backstage 개발자 포털에서 중요한 요소입니다. 팀은 코드로서의 문서(Markdown 또는 유사)를 작성하고 서비스와 함께 렌더링하여 항상 최신 정보를 한 번의 클릭으로 볼 수 있도록 합니다.
조직이 Backstage 개발자 포털을 사용하는 방법
Backstage 개발자 포털의 실용적인 실제 적용 사례를 살펴보겠습니다.
신규 개발자 온보딩
Spotify 및 Wise와 같은 회사에서 신규 채용자는 Backstage 개발자 포털을 사용하여 다음을 수행합니다.
- 서비스 및 API 카탈로그 찾아보기
- 팀 소유권 및 프로젝트 종속성 이해
- 최신 온보딩 가이드 및 런북 액세스
- 승인된 템플릿을 사용하여 새로운 서비스 신속하게 생성
이는 온보딩 시간과 혼란을 극적으로 줄입니다.
서비스 소유권 및 책임
명확한 소유권과 문서를 표면화함으로써 Backstage 개발자 포털은 팀이 다음을 수행하는 데 도움을 줍니다.
- 불분명한 유지 관리자가 있는 "고아" 서비스 방지
- 사건 및 질문을 올바른 사람에게 전달
- 서비스 상태, 배포 및 사고 추적
API 설계 및 문서화
팀은 Apidog와 같은 도구를 사용하여 API를 설계하고 문서화한 다음, 이러한 API를 Backstage 개발자 포털 내에 노출하여 쉽게 검색, 테스트 및 협업할 수 있도록 합니다. API 사용자는 더 이상 사양을 찾아 헤매지 않아도 됩니다. 사양은 항상 제공되며 코드 및 소유 팀과 연결됩니다.
셀프 서비스 인프라
엔지니어는 Backstage 개발자 포털의 셀프 서비스 작업을 통해 새로운 환경을 구축하고, 클라우드 리소스를 프로비저닝하거나, 마이크로 서비스를 배포할 수 있습니다. 더 이상 운영 티켓을 기다릴 필요가 없습니다!
엔지니어링 지표 및 표준
Backstage 개발자 포털은 스코어카드 및 품질 대시보드를 통합하여 팀이 다음을 추적하도록 돕습니다.
- 코드 품질 및 테스트 커버리지
- 조직 표준 준수
- 보안 취약점 및 개선 상태
Backstage 개발자 포털 설정: 모범 사례
1. 명확한 카탈로그로 시작
기존의 모든 서비스, API 및 라이브러리로 소프트웨어 카탈로그를 채우는 것부터 시작하십시오. 명확한 소유권을 할당하고 문서 링크를 사용할 수 있도록 하십시오.
2. API 도구 통합
API 설계 및 문서화 프로세스를 포털에 연결하십시오. 예를 들어, Apidog를 API 모델링 및 테스트에 사용한 다음, 통합된 가시성을 위해 문서를 Backstage로 직접 가져옵니다.
3. 템플릿으로 표준화 강제
새로운 프로젝트를 위한 템플릿을 개발하여 모든 서비스가 보안, 규정 준수 및 문서화를 위한 모범 사례로 시작되도록 하십시오.
4. 사용자 경험 우선
조직의 워크플로에 맞춰 Backstage 개발자 포털의 UI 및 탐색을 사용자 정의하십시오. 개발자들이 실제로 사용할 브랜드, 단축키 및 플러그인을 사용하십시오.
5. 문서화 문화 조성
Backstage의 문서 기능을 활용하여 팀이 최신 코드로서의 문서를 유지 관리하도록 장려하십시오. 문서 업데이트를 개발 워크플로의 일부로 만드십시오.
6. 가능한 경우 자동화
Backstage 플러그인 및 통합을 통해 온보딩, 서비스 생성 및 일반적인 작업을 자동화하십시오. 수동적인 병목 현상을 줄이고 개발자가 셀프 서비스를 할 수 있도록 지원하십시오.
실제 사례: Wise와 Backstage 개발자 포털
Wise (이전 TransferWise)는 낮은 문서 품질, 낮은 검색 가능성, 엔지니어의 높은 인지 부하와 같은 문제를 해결하기 위해 Backstage 개발자 포털을 채택했습니다. Backstage를 구현함으로써:
- 모든 서비스 및 API 문서를 중앙 집중화하여 즉시 검색할 수 있게 되었습니다.
- 소유권 및 팀 매핑이 표준화되어 사고 해결이 개선되었습니다.
- Apidog와 같은 도구를 사용한 API 설계 및 문서화가 표준 워크플로의 일부가 되었습니다.
- 셀프 서비스 템플릿을 통해 팀은 조직의 모범 사례를 따르면서 새로운 서비스를 신속하게 생성할 수 있었습니다.
그 결과, 개발자 만족도 향상, 빠른 온보딩, 엔지니어링 속도 증가를 가져왔습니다.
Apidog를 Backstage 개발자 포털과 통합하기
조직이 API 설계, 테스트 및 문서화를 위한 Apidog와 Backstage 개발자 포털을 결합할 때 강력한 워크플로가 나타납니다.
1. Apidog에서 API 설계 및 테스트: Apidog의 시각적 인터페이스를 사용하여 API 엔드포인트를 설계하고, 모의 응답을 생성하며, 대화형 문서를 만듭니다.
2. API 사양을 Backstage로 내보내기: Apidog에서 Swagger/OpenAPI 정의를 Backstage 개발자 포털로 가져와 코드 및 소유권 세부 정보와 함께 표시합니다.
3. API 검색 및 거버넌스 활성화: 개발자는 Backstage에서 직접 API를 검색하고, 탐색하고, 상호 작용하여 일관된 사용 및 규정 준수를 보장할 수 있습니다.
이러한 통합은 개발 주기를 단축하고, API 채택을 촉진하며, 문서를 실제 사용과 일치시킵니다.
버튼
Backstage 개발자 포털에 대한 자주 묻는 질문
어떤 유형의 조직이 Backstage 개발자 포털에서 가장 많은 이점을 얻나요?
여러 서비스, API 또는 엔지니어링 팀이 있는 모든 조직이 혜택을 받습니다. 특히 검색 가능성, 문서 확산 또는 셀프 서비스 병목 현상으로 어려움을 겪는 조직에 유용합니다.
Backstage 개발자 포털은 오픈 소스인가요?
네! Backstage는 Apache 2.0 라이선스하에 오픈 소스입니다. 호스팅 솔루션을 원하는 팀을 위한 관리형 및 상업용 제품(예: Spotify Portal, Roadie)도 있습니다.
Backstage 개발자 포털을 사용자 정의할 수 있나요?
물론입니다. 포털은 플러그인, 테마 및 사용자 정의 워크플로를 통해 조직의 고유한 요구 사항에 맞게 고도로 확장 가능합니다.
Backstage 개발자 포털은 API 관리와 어떤 관련이 있나요?
API를 발견하고, 문서화하고, 운영하는 통합된 장소를 제공합니다. Apidog와 같은 도구를 통합하면 더 나은 설계, 테스트 및 문서화 기능을 통해 API 경험이 향상됩니다.
버튼
결론: Backstage 개발자 포털로 엔지니어링 팀의 역량을 극대화하세요
Backstage 개발자 포털은 현대 엔지니어링 조직이 운영되는 방식을 변화시키고 있습니다. 지식을 중앙 집중화하고, 온보딩을 간소화하며, 표준을 강제하고, 셀프 서비스를 지원함으로써 마찰을 줄이고 제공 속도를 높입니다.
이제 막 시작하거나 수백 개의 서비스로 확장하는 중이든, Backstage 개발자 포털에 투자하고 API 개발을 위한 Apidog와 같은 동급 최고의 도구와 통합하면 개발자 만족도를 높이고 운영 오버헤드를 줄이며 비즈니스를 빠르게 움직일 수 있습니다.
버튼