앱에서 확장 구성하기
앱에서 확장 구성하기 (Configuring Extensions in the App)
Backstage 앱의 모든 확장은 정적 구성을 통해 구성할 수 있어요. 이 구성은 모두 app.extensions 구성 키 아래에서 이루어져요. Backstage용 구성을 작성하는 방법에 대한 더 일반적인 정보는 구성 작성 섹션을 참고하세요.
출처: 문서
본문
Backstage 앱의 모든 확장은 정적 구성을 통해 구성할 수 있어요. 이 구성은 모두 app.extensions 구성 키 아래에서 이루어져요. Backstage용 구성을 작성하는 방법에 대한 더 일반적인 정보는 구성 작성 섹션을 참고하세요.
확장 구성 스키마 (Extension Configuration Schema)
이 섹션은 app.extensions 구성의 형식과 사용 가능한 다양한 축약형(shorthand)에 초점을 맞춰요.
개별 확장을 구성하는 가장 완전하고 상세한 형식은 다음과 같아요.
app: extensions: - <id>: attachTo: id: <parent-id> input: <input-name> disabled: <true/false> config: <extension-specific-config->
모든 최상위 필드(attachTo, disabled, config)는 선택 사항이에요. 모든 확장 구현은 이 모든 필드에 대해 구성에 제공되지 않을 때 사용될 기본값을 제공해야 해요.
disabled 필드는 구성의 환경 변수 치환이 항상 실제 부울이 아닌 문자열을 생성하기 때문에 문자열 'true'와 'false'도 받아들여요.
app.extensions는 항상 객체가 아닌 배열이라는 점에 유의하세요. 예를 들어 다음은 유효하지 않아요.
INVALID (유효하지 않음)
app: extensions: <id>: # Invalid, this should be an array item, `app.extensions` is now an object config: ...
이 스키마 외에도 사용할 수 있는 축약형이 여러 가지 있어요.
전체 객체 대신 확장의 ID를 문자열로만 지정할 수 있어요. 이는 disabled를 false로 설정한 것과 동등해요.
app: extensions: - '<id>'
ID로 개별 확장을 활성화/비활성화할 수 있으며, 이 경우 값은 부울이에요.
app: extensions: - <id>: <true/false>
이것도 문자열 'true'와 'false'를 받아들이므로 값이 환경 변수에서 올 수 있어요. 예: - <id>: ${SOME_EXTENSION_ENABLED}.