용어 사전
검색 가능한 Backstage 용어 사전입니다.
출처: 문서
본문
본 용어 사전은 Backstage 문서와 관련된 용어를 정의합니다. 각 항목은 용어에 대한 간결한 정의와 추가 맥락을 제공합니다.
Access Token (액세스 토큰)
최종 사용자를 대신해 리소스에 접근할 수 있는 권한을 나타내는 토큰으로, 사용자의 실제 신원을 숨기는 방식으로 동작합니다. 일반적으로 만료 시간이 짧고 일련의 scope로 제한됩니다. OAuth 프로토콜의 일부이며, 자세한 내용은 해당 문서를 참조하세요.
Administrator (관리자)
조직을 위해 Backstage 앱을 설치, 구성, 유지 관리할 책임이 있는 사람을 말합니다. 사용자 역할 중 하나입니다.
API
두 애플리케이션 또는 구성 요소가 데이터나 기능을 주고받고 통신할 수 있게 하는, 정의된 규칙·프로토콜·도구로 구성된 소프트웨어 인터페이스입니다.
API는 대규모 소프트웨어 생태계를 효율적으로 확장할 수 있게 해주는 핵심 추상화입니다. Backstage 모델에서 API는 일급 시민(first-class citizen)이며, 생태계 전반에서 기존 기능을 발견하는 주요 수단입니다. Backstage 시스템 모델을 참조하세요.
App (앱)
Backstage의 설치된 인스턴스를 말합니다. 앱은 단일 개발자나 개발 그룹을 위한 로컬 앱일 수도 있고, 전체 기업이 사용하는 조직용 앱일 수도 있습니다.
Authentication (인증)
리소스·시스템·네트워크에 접근하려는 사용자, 시스템 또는 엔터티의 신원을 검증하는 과정입니다. "당신이 주장하는 사람이 맞습니까?"라는 질문에 답합니다. 자세한 내용은 위키백과 문서를 참조하세요.
Authorization (인가)
인증된 사용자나 시스템이 시스템·애플리케이션·리소스 내에서 수행할 수 있는 작업을 결정하는 과정입니다. 인증 이후에 이루어지며 "무엇에 접근하거나 무엇을 할 수 있습니까?"라는 질문에 답합니다. 사용자에게 특정 권한, 접근 권리 또는 역할을 부여하는 과정을 포함합니다. 자세한 내용은 위키백과 문서를 참조하세요.
Authorization Code Grant (인가 코드 그랜트)
Code Grant를 참조하세요.
Backstage
-
Spotify에서 처음 만든, 개발자 포털을 만들고 배포하기 위한 오픈 소스 프레임워크입니다. Backstage는 Cloud Native Computing Foundation의 인큐베이션 단계 오픈 소스 프로젝트입니다.
-
Backstage 프레임워크 자체를 말합니다.
Backstage Framework (Backstage 프레임워크)
Backstage 플러그인이 올라가는 실제 프레임워크입니다. 프레임워크는 프런트엔드와 백엔드에 걸쳐 있으며, 선언적 통합, 구성 읽기, 데이터베이스 관리 등 핵심 기능을 포함합니다.
Bundle
-
배포 산출물(artifact)의 모음입니다.
-
번들링 과정의 산출물로, 여러 패키지를 단일 배포 산출물 집합으로 묶습니다.
Catalog (카탈로그)
Software Catalog를 참조하세요.
Cloud Native Computing (클라우드 네이티브 컴퓨팅)
"조직이 공개·사설·하이브리드 클라우드 같은 현대적·역동적 환경에서 확장 가능한 애플리케이션을 구축·실행할 수 있게 해주는 기술 집합. 컨테이너, 서비스 메시, 마이크로서비스, 불변 인프라, 선언적 API가 이러한 접근 방식을 보여줍니다." (CNCF Cloud Native 정의 v1.1)
Cloud Native Computing Foundation (CNCF)
클라우드 네이티브 컴퓨팅의 촉진과 발전에 전념하는 재단입니다. CNCF의 사명은 "클라우드 네이티브 컴퓨팅을 보편화하는 것"입니다 (CNCF 헌장).
CNCF는 Linux Foundation의 일부입니다.
Code Grant (코드 그랜트)
OAuth 2.0 맥락에서, 애플리케이션이 사용자의 리소스 접근 권한 부여를 받은 후 인가 코드를 받는 과정을 말합니다. 이 코드는 이후 액세스 토큰과 어쩌면 리프레시 토큰으로 교환되며, 애플리케이션은 이를 사용해 사용자를 대신해 데이터에 접근합니다. 애플리케이션이 사용자의 자격 증명을 직접 다루지 않고 보호된 리소스에 접근할 수 있는 안전한 방법입니다. 자세한 내용은 OAuth 문서를 참조하세요.
Collator (검색 플러그인)
특정 규칙 집합에 따라 데이터를 정렬하거나 인덱싱하는 Backstage의 전문 구성 요소입니다. Backstage 검색에서 collator는 무엇을 검색할 수 있는지 정의하는 데 사용됩니다. 구체적으로, 문서 제목·위치·텍스트를 포함한 최소 필드 집합을 가진 문서의 읽기 가능한 객체 스트림이며, collator가 정의한 다른 필드는 얼마든지 포함할 수 있습니다. 단일 collator는 특정 유형의 문서 정의와 수집을 담당합니다.
Backstage에는 Catalog와 TechDocs용 "기본" collator가 포함되어 있어 즉시 검색을 시작할 수 있습니다. Backstage 커뮤니티에서 더 많은 collator를 얻을 수 있습니다. Collator에서 자세히 알아보세요.
Component (카탈로그 플러그인)
-
특정 기능을 캡슐화하는 모듈형·독립적·재사용 가능한 소프트웨어 단위입니다. 잘 정의된 인터페이스와 명시적으로 지정된 의존성을 가지며, 더 큰 소프트웨어 시스템을 구축하기 위해 다른 구성 요소와 통합되도록 설계되었습니다.
-
Backstage가 소프트웨어 카탈로그에서 관리하는 소프트웨어 제품입니다. 구성 요소는 서비스, 웹사이트, 라이브러리, 데이터 파이프라인 또는 단일 엔터티로 관리되는 다른 소프트웨어 산출물일 수 있습니다.
Backstage 구성 요소는 다른 구성 요소가 소비하도록 API를 구현할 수 있습니다. 반대로 다른 구성 요소가 구현한 API를 소비하거나, 런타임에 연결된 구성 요소나 리소스에 직접 의존할 수도 있습니다.
Backstage 시스템 모델을 참조하세요.
Condition (권한 플러그인)
권한 플러그인 내에서 사용자가 특정 엔터티에 대해 작업을 수행할 권한을 부여받기 위해 충족해야 하는, 엔터티에 대해 평가되는 기준입니다. 예로는 isOwner나 hasRole이 있습니다.
Conditional Decision (권한 플러그인)
권한 플러그인에서 흔히 볼 수 있는 결정 메커니즘으로, 리소스에 대한 접근이나 작업을 결정하기 위해 사용자별로 실시간 조건(술어)을 평가합니다. 이를 통해 매우 세밀하고 맥락을 인식하는 제어가 가능합니다. Conditional Decisions를 참조하세요.
Contributor (기여자)
Backstage 같은 오픈 소스 제품 개선을 돕는 자원봉사자입니다. 이 봉사 활동에는 코딩, 테스트, 기술 문서 작성, 사용자 지원 등의 작업이 포함됩니다. 사용자 역할 중 하나입니다.
Declarative Integration (선언적 통합)
완전한 React 페이지를 호스팅하는 대신 구성 파일에서 정의가 가능하도록 하는 Backstage 프런트엔드 플러그인의 새로운 패러다임입니다. 프런트엔드 시스템을 참조하세요.
Decorator (검색 플러그인)
인덱싱 과정 중 Collator(읽기 스트림)와 Indexer(쓰기 스트림) 사이에 위치하는 변환 스트림입니다. 문서 데코레이터는 검색 인덱스를 준비하면서 메타데이터를 추가·제거·필터링하거나 새 문서를 주입하는 방식으로 문서를 수정하는 데 사용됩니다.
예를 들어, 소프트웨어 카탈로그가 소프트웨어 엔터티를 이해하더라도 그 사용량이나 품질을 추적하지 않을 수 있습니다. 데코레이터는 이 추가 메타데이터를 더할 수 있으며, 이를 사용해 검색 결과에 편향을 주거나 Backstage 인스턴스의 검색 경험을 향상시킬 수 있습니다.
Deployment Artifacts (배포 산출물)
런타임 배포에 필요한 모든 정보를 포함한 실행 파일 또는 패키지 파일입니다. 배포 산출물은 패키지 레지스트리에서 호스팅될 수 있습니다.
Developer (개발자)
-
소프트웨어 애플리케이션과 시스템을 설계, 구축, 테스트, 배포, 유지 관리하는 전문가입니다. 개발자는 본질적으로 아이디어나 요구 사항을 기능적인 디지털 제품으로 바꿉니다.
-
Backstage 앱을 만들거나, 수정하거나, 사용하는 사람으로 정의되는 사용자 역할입니다. 실제로는 소프트웨어 개발자가 아닐 수도 있습니다.
Developer Portal (개발자 포털)
-
개발자에게 조직 내에서 소프트웨어 제품을 효과적으로 구축, 통합, 배포, 관리하는 데 필요한 모든 리소스·도구·문서·정보를 제공하는 중앙 집중식 셀프 서비스 인터페이스입니다.
-
Backstage는 개발자 포털의 구체적인 예로, 조직의 소프트웨어 프로젝트 개발과 유지 관리를 간소화하도록 설계된 사용자 인터페이스와 데이터베이스를 갖춘 중앙 집중식 시스템입니다. 조직의 서비스·웹사이트·모바일 기능·라이브러리·기타 소프트웨어 구성 요소에 대한 접근을 중앙 집중화하고 체계화하는 강력한 소프트웨어 카탈로그를 특징으로 합니다. Backstage는 새 프로젝트와 구성 요소 생성을 단순화하는 소프트웨어 템플릿도 포함합니다.
Backstage는 개발자 포털이자 새로운 맞춤형 개발자 포털을 만들기 위한 플러그인 기반 프레임워크입니다.
Document (검색 플러그인)
-
보관과 전달을 목적으로 어떤 매체에 기록된 정보 조각 또는 데이터입니다.
-
발견하고 검색할 수 있는 정보나 데이터의 추상적인 표현입니다. 검색 목적상 문서는 소프트웨어 엔터티, TechDocs 페이지 또는 인덱싱된 다른 데이터 유형을 나타낼 수 있습니다. Backstage에서 문서는 최소한 제목, 본문(핵심 텍스트 내용 포함), 위치(원본을 가리키는 URL 등)를 포함해야 하는 메타데이터 필드로 구성됩니다.
Domain
-
용어, 도메인 모델, 지표, KPI, 비즈니스 목적 또는 문서를 공유하는 시스템 모음, 즉 경계 컨텍스트(bounded context)를 형성합니다.
-
일반적으로 웹사이트, 이메일 서버, 인터넷의 다른 리소스를 식별하는 데 사용되는 고유한 사람이 읽을 수 있는 주소로,
google.com이나example.store같은 것입니다. 좁게는 웹 주소에서 마지막 점 뒤의 부분인 최상위 도메인(TLD)을 가리킬 수 있는데,.com이나.org같은 일반 TLD,.us나.uk같은 국가 코드,.gov나.edu같은 후원 TLD가 있습니다. -
시스템이나 엔터티를 비즈니스 단위와 연결하는 영역입니다. 시스템 모델의 Domain을 참조하세요.
Entity (엔터티)
-
분리되고 구별된 단위로 존재하는 무엇입니다. 그 존재는 실재하거나 추상적일 수 있고, 물리적이거나 개념적일 수 있으며, 영속적이거나 일시적일 수 있습니다.
-
Backstage 소프트웨어 카탈로그에서 카탈로그화되는 대상입니다. 엔터티는 kind, namespace, name의 고유한 조합으로 식별됩니다. 관련 핵심 개념과 처리 방식은 The Life of an Entity를 참조하세요.
Evaluator (평가자)
Backstage가 조직과 요구 사항에 적합한 솔루션인지 평가하는 사람입니다. 배포 전 사용 사례를 가진 유일한 사용자 역할입니다.
ID Token (ID 토큰)
주로 OpenID Connect(OIDC) 표준으로 정의되는 인증 과정에서 사용되는 보안 토큰입니다. 주요 목적은 사용자가 ID 공급자에 의해 성공적으로 인증되었음을 증명하는 것입니다. JSON Web Token을 참조하세요.
Index (검색 플러그인)
검색 엔진이 개발자 포털 내에서 관련 정보를 빠르게 찾는 데 사용하는 문서 모음입니다. 본질적으로 전체 데이터셋을 훑지 않고도 문서를 빠르게 찾을 수 있게 해주는 조회 테이블입니다.
Indexer (검색 플러그인)
Backstage 검색 플랫폼에서 indexer라는 용어는 개발자가 일반적으로 상호작용하는 구성 요소나 개념이 아니라, 처리된 문서를 가져와 선택한 검색 엔진의 인덱스에 추가하는 검색 백엔드 내의 전반적인 과정 또는 쓰기 스트림을 말합니다.
Backstage에서 indexer를 이해하려면 검색 시스템으로의 데이터 흐름을 이해하는 것이 도움이 됩니다:
-
Collator가 특정 소스에서 원시 데이터를 읽고 문서 스트림으로 변환하는데, 각 문서는 검색 플랫폼이 이해하는 형식(예: title, text, location 필드, 그리고 잠재적으로 다른 메타데이터)으로 구성됩니다.
-
문서 스트림이 collator에서 흘러나올 때 데코레이터가 이를 가로챌 수 있습니다. 데코레이터는 원래 collator가 가지지 못한 맥락을 풍부하게 하기 위해 문서 내 필드를 선택적으로 추가·제거·수정합니다 (예: Catalog의 소유권 정보를 TechDocs 문서에 추가).
-
선택적 데코레이션 후, 최종 확정된 검색 문서 스트림이 검색 엔진의 인덱스에 기록됩니다. 이것이 indexer라는 용어가 암시하는 것입니다. 이 구조화된 문서를 가져와 Lunr, PostgreSQL, Elasticsearch 같은 선택한 검색 엔진에 삽입하여 검색 가능하게 만드는 기능이 바로 그것입니다.
Backstage의 plugin-search-backend-node 패키지가 이 전체 인덱싱 과정을 조율합니다. collator, 데코레이터, 특정 검색 엔진과의 연결, 그리고 이러한 인덱싱 작업이 실행되는 일정을 관리합니다.
Integrator (통합자)
-
Backstage가 다른 소프트웨어 시스템과 상호 운용할 수 있게 하는 하나 이상의 플러그인을 개발하는 사람입니다. 사용자 역할 중 하나입니다.
-
Backstage와 통합되는 소프트웨어를 개발하는 사람을 가리킬 수도 있습니다.
JSON Web Token (JWT)
JSON 객체로 당사자 간 정보를 안전하게 전송하기 위한, 널리 쓰이는 소형·자족적 오픈 표준입니다. 사용자의 신원(인증)과 권한(인가)을 검증하는 데 흔히 사용됩니다. 각 JWT는 점으로 구분된 헤더, 페이로드, 디지털 서명으로 구성됩니다. JWT는 종종 암호화되며, 항상 무결성을 위해 서명됩니다.
이 표준은 OpenID Connect의 핵심 구성 요소입니다. 자세한 내용은 위키백과 문서를 참조하세요.
Kind (종류)
Backstage 소프트웨어 카탈로그에서 엔터티의 분류로, 예를 들어 service, database, team이 있습니다. kind|namespace|name 삼중항의 요소로, 고유성에 중요한 개념입니다.
Kind|namespace|name 삼중항
소프트웨어 카탈로그 엔터티의 기본 참조입니다. 사람이 읽을 수 있으며 Backstage 인스턴스 전체에서 고유해야 합니다.
Kubernetes (Backstage 플러그인)
서비스 소유자 중심의 Kubernetes 리소스 뷰를 가능하게 하는 Backstage 핵심 플러그인입니다.
Kubernetes (CNCF 프로젝트)
Kubernetes(K8s)는 컨테이너화된 애플리케이션의 배포, 확장, 관리를 자동화하는 오픈 소스 플랫폼입니다. 원래 Google이 프로덕션 워크로드를 관리하기 위해 개발했으며, 이후 오픈 소스 지원과 유지 관리를 위해 Cloud Native Computing Foundation(CNCF)에 제공되었습니다.
공식 웹사이트에 따르면 Kubernetes는 롤아웃, 롤백, 로드 밸런싱을 자동으로 처리합니다. 스토리지 시스템을 마운트하고, 리소스 요구 사항과 기타 제약 조건에 따라 컨테이너를 동적으로 할당하며, 배치 실행을 관리하고, 충돌한 컨테이너를 재시작하는 등의 작업을 합니다. 추가 정보는 위키백과의 Kubernetes 문서를 참조하세요.
Local Package (로컬 패키지)
모노레포 내의 패키지 중 하나입니다. 패키지는 패키지 레지스트리에 게시될 수도 있고 아닐 수도 있습니다.
Monorepo (모노레포)
-
조직에 속한 모든 프로젝트 같은 관련 소프트웨어 프로젝트 모음의 단일 저장소입니다.
-
단일 프로젝트 내에 여러 패키지로 구성되며, 패키지가 서로 로컬 의존성을 가질 수 있는 프로젝트 구조입니다. 흔히 yarn workspaces 같은 도구로 활성화됩니다.
Name (이름)
작성 예정입니다. kind|namespace|name 삼중항의 요소로, 고유성에 중요한 개념입니다.
Namespace (카탈로그 플러그인)
엔터티를 구성하는 데 사용할 수 있는 선택적 속성입니다. kind|namespace|name 삼중항의 요소로, 고유성에 중요한 개념입니다.
OAuth
OAuth 2.0을 말하며, 웹사이트나 애플리케이션("클라이언트")이 다른 서비스("리소스 서버")의 보호된 리소스(사용자 데이터나 기능 같은 것)에 사용자("리소스 소유자")를 대신해, 사용자의 로그인 자격 증명을 클라이언트 애플리케이션과 공유하지 않고 접근할 수 있게 하는 업계 표준 인가 프레임워크입니다.
OAuth 2.0과 OIDC(그 위에 구축됨)에 대한 설명은 OAuth 2.0 explained를 참조하세요.
Objective (목적)
Backstage와 상호작용하는 사용자 역할의 높은 수준의 목표입니다. 예를 들어, 관리자 사용자 역할의 목적 중 일부는 Backstage 인스턴스(앱)를 유지하고, 플러그인을 통해 기능을 추가·업데이트하며, 문제를 해결하는 것입니다.
Offline Access (오프라인 접근)
리프레시 토큰과 액세스 토큰을 모두 결과로 만드는 OAuth 2.0 흐름으로, 리프레시 토큰은 만료가 길거나 만료되지 않으며 향후 더 많은 액세스 토큰을 요청하는 데 사용될 수 있습니다. 이를 통해 사용자는 토큰 발급자에 대해 "오프라인" 상태가 되지만, 추가 사용자 상호작용 없이 나중에 더 많은 토큰을 요청할 수 있습니다.
OpenID Connect (OIDC)
인증을 표준화하는 OAuth 2.0 위의 계층입니다. 자세한 내용은 위키백과 문서를 참조하세요.
OSS
오픈 소스 소프트웨어(Open source software).
Package (패키지)
-
실행 파일, 라이브러리, 구성 파일, 메타데이터 및 소프트웨어(또는 관련 소프트웨어 그룹)를 쉽게 설치·관리·사용할 수 있게 하는 기타 필수 구성 요소의 번들 모음입니다. 모든 의존성이 포함되거나 쉽게 확인되어 설치를 단순화하고, 무결성 검사를 제공하며, 쉽게 업그레이드하거나 제거할 수 있게 하는 소프트웨어 배포용 표준화된 형식입니다.
-
Node.js 생태계의 패키지로, 흔히 패키지 레지스트리에 게시됩니다.
Package Registry (패키지 레지스트리)
패키지를 호스팅하는 서비스입니다. 가장 대표적인 예는 NPM입니다.
Package Role (패키지 역할)
패키지의 선언된 역할입니다. package roles를 참조하세요.
Permission (권한)
사용자, 그룹 또는 시스템 프로세스가 특정 리소스에 대해 수행할 수 있는 접근 수준과 작업 유형을 정의하는 특정 규칙이나 설정입니다. 권한은 인증 후 "무엇을 할 수 있는지"를 결정하는 인가의 핵심 구성 요소입니다. 권한은 객체나 리소스의 속성입니다. Privilege(권한)와 밀접하게 관련됩니다 (용어는 종종 같은 의미로 사용됩니다).
Permission (권한 플러그인)
-
작업을 특정 사용자로 제한할 수 있게 하는 Backstage 핵심 플러그인이자 프레임워크입니다.
-
지정된 조건 집합이 존재할 때 사용자가 특정 리소스 또는 리소스 집합에 접근할 권한이 있는지 결정하는 규칙입니다.
기본적으로 Backstage 엔드포인트는 보호되지 않으며, 어떤 사용자든 어떤 리소스에든 모든 작업을 수행할 수 있습니다. 권한 프레임워크는 통합자가 어떤 사용자가 어떤 리소스와 작업에 접근할 수 있는지 정확히 지정하는 규칙을 구성할 수 있게 하여 이를 해결합니다. 이 프레임워크 내에서 권한은 고유한 이름을 가진 규칙(또는 조건) 집합과 그 평가 결과에 따라 반환할 결과입니다.
예로는 엔터티가 시스템의 일부가 아니면 false를 반환하는 권한 규칙이 있는데, 여기서 엔터티와 시스템은 규칙에 대해 구성됩니다. (예시는 Defining custom permission rules를 참조하세요.)
자세한 내용은 Permissions Overview and Concepts를 참조하세요.
Persona (사용자 유형)
User Role의 대체 용어입니다.
Plugin (플러그인)
개발자 포털에 특정 기능, 특성, 통합을 추가하는 기본 구성 블록입니다. Backstage 프레임워크 밖의 모든 기능은 핵심 기능을 포함해 플러그인으로 구현됩니다. 이 모듈형 아키텍처는 Backstage의 핵심 차별점으로, 높은 사용자 정의성과 확장성을 제공합니다.
플러그인은 특정 작업을 수행하거나 외부 시스템과 통합하도록 설계된 자족적 코드 단위입니다. 모놀리식 애플리케이션 대신 Backstage는 이러한 독립 플러그인 모음으로 조립됩니다.
하나의 논리적 플러그인은 종종 프런트엔드(UI) 구성 요소와 백엔드(API) 구성 요소로 구성됩니다.
-
프런트엔드 플러그인은 일반적으로 React와 TypeScript로 작성되어 개발자가 상호작용하는 페이지, 카드, 사이드바 항목, 대시보드 같은 사용자 인터페이스 요소를 제공합니다.
-
백엔드 플러그인은 Node.js와 TypeScript로 작성되며, 데이터 가져오기, 비즈니스 로직, 외부 서비스(Git 공급자, CI/CD 시스템, 클라우드 플랫폼 등)와의 통합을 처리하고 프런트엔드가 소비할 API를 노출합니다.
다양한 유형의 플러그인이 있습니다 (yarn new를 실행하면 볼 수 있습니다). 현재 목록은 다음과 같습니다:
plugin- 새 프런트엔드 플러그인backend-plugin- 새 백엔드 플러그인backend-module- 새 백엔드 모듈web-library- 새 웹 라이브러리 패키지plugin-common- 새 동형(isomorphic) 공통 플러그인 패키지plugin-node- 새Node.js라이브러리 플러그인 패키지plugin-react- 새 웹 라이브러리 플러그인 패키지
플러그인 생성, 제안, 소프트웨어 카탈로그 통합 방법은 Introduction to Plugins를 참조하세요. 프런트엔드 플러그인 생성 방법은 Create a Backstage Plugin을 참조하세요.
커뮤니티 주도 플러그인 목록은 Plugin directory를 참조하세요. 다만 그 페이지에 없을 수 있는 더 많은 플러그인을 포함하는 커뮤니티 플러그인 저장소가 있습니다.
Policy (권한 플러그인)
누가 어떤 리소스에 무엇을 할 수 있고 어떤 조건에서 할 수 있는지를 규정하는 Backstage 권한 프레임워크의 핵심 구성 요소입니다.
Backstage 정책은 요청(사용자 및 원하는 권한/리소스 작업에 대한 정보 포함)을 받아 인가 결정(허용, 거부 또는 조건부 결정)을 반환하는 함수나 규칙 집합으로 구현됩니다. 정책은 역할 기반 액세스 제어나 속성 기반 액세스 제어 같은 인가 모델과 독립적입니다. Policy를 참조하세요.
정책은 권한 프레임워크에서 TypeScript 코드로 정의됩니다. 예시는 Writing a permission policy를 참조하세요.
Policy Decision (권한 플러그인)
리소스 목록에 대해 작업을 수행하려는 사용자 요청에 대한 특정 응답입니다. Approve, Deny 또는 Conditional일 수 있습니다. Backstage에서 정책은 요청 승인 여부에 대한 결정만 담당하며, 요청자(일반적으로 백엔드)가 그 결정을 집행할 책임이 있습니다. Policy decision versus enforcement를 참조하세요.
Popup (팝업)
이전 창 위에 열리는 별도의 브라우저 창입니다.
Privileges (권한)
privilege라는 용어는 Backstage 권한 프레임워크의 핵심 개념 측면에서 정의된 추상화가 아닙니다. 대신 Backstage의 인가 모델은 리소스에 대해 사용자가 취할 수 있는 작업을 결정하기 위해 permissions, policies, conditions를 중심으로 구축됩니다. Backstage 맥락에서 privilege를 만나면 "접근 수준"의 더 일반적이고 구어적인 의미로 사용되거나 개념을 가리키는 것일 가능성이 높습니다.
Backstage 맥락 밖에서 privilege는 일반적으로 사용자나 프로세스가 시스템 내에서 수행할 수 있는 작업을 정의하는 특정 규칙이나 설정을 말하며, 종종 시스템 전반의 작업이나 기능과 관련됩니다. Privilege는 Permission과 밀접하게 관련됩니다. 용어는 종종 같은 의미로 사용됩니다.
Procedure (사용 유형)
일반적으로 사용 사례의 일부로, 목표를 달성하는 작업 집합입니다. 프로시저는 다른 프로시저를 포함하는 높은 수준일 수도 있고, 단일 작업만큼 단순할 수도 있습니다.
Query Translators (검색 플러그인)
검색 엔진과 Backstage 검색 백엔드 사이의 추상화 계층입니다. Backstage 검색 클라이언트의 검색어, 필터, 원하는 문서 유형을 포함한 추상 검색 쿼리를 가져와 Backstage가 사용하는 특정 검색 엔진에 최적화된 구체적인 쿼리로 변환하는 선택적 백엔드 구성 요소입니다.
이 변환 계층은 Backstage 구성 요소가 Elasticsearch나 Solr 같은 개별 검색 엔진의 고유 기능을 활용하면서도 상세한 인터페이스와의 긴밀한 결합을 유지할 수 있게 하므로 중요합니다. Backstage의 사전 패키지 검색 엔진에는 간단한 내장 변환기가 포함되어 있지만, 조직의 고유한 맥락에 맞게 검색 결과를 크게 향상하고 조정하기 위해 사용자 지정 Query Translator를 구현할 수 있습니다.
Refresh token (리프레시 토큰)
OAuth 클라이언트가 액세스 토큰이 만료될 때 새 액세스 토큰을 받는 데 사용할 수 있는 특수 토큰입니다. OAuth Refresh Tokens를 참조하세요.
Resource (카탈로그 플러그인)
구성 요소가 필요로 하는 데이터베이스 같은 물리적 또는 가상 인프라 조각을 나타내는 엔터티입니다. 시스템 모델을 참조하세요.
Resource (권한 플러그인)
사용자가 상호작용하고 권한을 부여할 수 있는 객체의 표현입니다. 소프트웨어 카탈로그 리소스와 혼동하지 마세요.
Role (역할)
User Role을 참조하세요.
Rule (권한 플러그인)
보호하는 리소스와 관련된 특정 유형의 동적 액세스 제어입니다. 간단한 예로 "조건 Y가 참이면 현재 사용자가 리소스 X에 접근할 수 있다"가 있습니다. 카탈로그 플러그인은 카탈로그 엔터티용 리소스와 엔터티에 주어진 어노테이션이 있는지 확인하는 규칙을 정의합니다.
Scaffolder (스캐폴더)
Software Templates의 또 다른 이름입니다. (이 용어는 Software Templates를 새 구성 요소와 프로젝트 구축의 스캐폴드로 사용하는 것에서 유래했습니다.)
Scope (범위)
OAuth를 사용하여 사용자에게 부여할 수 있는 특정 유형의 접근 권한을 설명하는 문자열로, 보통 액세스 토큰과 함께 사용됩니다.
OAuth에서 액세스 제어는 애플리케이션에 부여된 특정 권한을 정의하는 scope를 통해 관리됩니다. OAuth 서비스는 프로필 정보 보기, 사용자 데이터 읽기·쓰기 같은 특정 scope 집합에 연결된 액세스 토큰을 발급할 수 있습니다. scope의 형식과 처리는 각 OAuth 공급자 고유하며, 사용 가능한 scope는 일반적으로 해당 인증 솔루션 문서에 자세히 나와 있습니다 (예시는 https://developers.google.com/identity/protocols/oauth2/scopes 참조).
scope와 OAuth에 대한 자세한 내용은 OAuth and OpenID Connect를 참조하세요.
Search (검색)
소프트웨어 카탈로그와 TechDocs를 포함한 Backstage 앱 검색을 위한 프레임워크를 제공하는 Backstage 플러그인입니다. Backstage의 핵심 기능입니다.
Search Engine (Backstage 검색)
Backstage Search가 모듈형 설계를 통해 활용할 수 있는 기존 검색 기술입니다. Lunr는 Backstage Search의 기본 검색입니다. Backstage와 함께 사전 패키지된 검색 엔진 중 하나이거나 인스턴스에 맞게 특별히 선택된 것일 수 있습니다.
Software Catalog (소프트웨어 카탈로그)
-
생태계의 모든 소프트웨어(서비스, 웹사이트, 라이브러리, 데이터 파이프라인 등)에 대한 소유권과 메타데이터를 추적하는 중앙 집중식 시스템입니다. 카탈로그는 코드와 함께 저장되고 Backstage에서 수집·시각화되는 메타데이터 YAML 파일을 중심으로 구축됩니다.
-
소프트웨어 카탈로그 기능을 구현하는 Backstage 플러그인입니다. Backstage의 핵심 기능입니다.
소프트웨어 카탈로그는 Backstage의 핵심 기능입니다. 개요, 카탈로그 내 엔터티의 생애, 카탈로그 구성 방법, 아키텍처와 상위 수준 설계, 구성·사용자 정의 방법, API에 대해서는 Backstage Software Catalog를 참조하세요. 개요에는 카탈로그 작동 방식, 구성 요소 추가 방법, 소프트웨어 찾는 방법 등이 설명되어 있습니다.
Software Templates (Scaffolder)
-
Backstage 소프트웨어 템플릿 도구에서 생성·관리되는 "골격" 소프트웨어 프로젝트입니다.
-
Backstage에서 구성 요소를 생성하기 위한 Backstage 플러그인입니다. 기본적으로 코드 골격을 로드하고, 일부 변수를 템플릿 처리한 다음, GitHub나 GitLab 같은 위치에 템플릿을 게시할 수 있습니다.
소프트웨어 템플릿은 Backstage의 핵심 기능입니다. 새 소프트웨어 구성 요소와 프로젝트를 구축하는 유틸리티로 인해 Scaffolder라고도 알려져 있습니다. 개요, 구성 방법, 자체 템플릿 추가, 템플릿 작성, 테스트 등에 대해서는 Backstage Software Templates를 참조하세요. 개요에는 시작 방법, 템플릿 선택, 입력 검증, 템플릿 실행, 데모 보기 같은 정보가 설명되어 있습니다.
System (카탈로그 플러그인)
기능을 수행하기 위해 협력하는 엔터티 모음입니다. 시스템은 일반적으로 소수의 구성 요소, 리소스, 비공개 또는 공개 API로 구성됩니다. 카탈로그 문서를 참조하세요.
Task (사용 유형)
특정 결과를 얻기 위한 낮은 수준의 단계별 절차입니다.
TechDocs
소프트웨어 구성 요소 코드와 함께 저장된 Markdown 파일로 기술 문서를 생성·관리하는 문서 솔루션입니다. Backstage의 핵심 기능입니다. TechDocs Documentation을 참조하세요.
Token (토큰)
정보를 포함하는 문자열입니다. 형식과 내용은 목적과 사용 방식에 따라 달라집니다.
Use Case (사용 사례)
사용자 역할이 Backstage와 상호작용하는 목적입니다. Objective와 관련됩니다. 목적(objective)은 사용자가 달성하려는 것이고, 사용 사례(use case)는 사용자가 그것을 수행하는 방법입니다.
User (사용자)
Backstage 또는 Backstage 제품/애플리케이션의 모든 소비자입니다. 직원·계약자 같은 개인과, API를 통해 백엔드와 상호작용하거나 사용자 인터페이스를 조작하여 사람을 대신하는 역할을 하는 소프트웨어를 모두 포함합니다.
User Role (사용자 역할)
특정 사용 사례 집합에 대해 Backstage를 사용할 권한이 있는 Backstage 사용자의 분류입니다. evaluator, administrator, developer, integrator, contributor 중 하나입니다.