컴포넌트 등록 해제 및 삭제하기

원문 보기 위키 갱신 2026.10.07

Create 버튼을 사용하거나 app-config 파일에 추가해서 등록한 YAML 파일의 URL은 모두 엔티티 프로바이더가 처리해요. 이 글에서는 카탈로그에서 엔티티를 수동으로 등록 해제하거나 삭제하는 방법을 설명드릴게요.

출처: 문서

본문

대상 독자: 개발자

Create 버튼을 사용하거나 app-config 파일에 추가해서 등록한 YAML 파일의 URL은 모두 엔티티 프로바이더가 처리해요.

엔티티 프로바이더가 엔티티 삭제를 발행하면 암시적 삭제가 발생해요. 해당 엔티티와, 그 엔티티에서 처리된 전체 엔티티 트리는 즉시 삭제 대상으로 간주돼요.

하지만 카탈로그에서 엔티티를 수동으로 등록 해제하거나, 개별 엔티티를 직접 명시적으로 삭제할 수도 있어요.

엔티티를 등록 해제하면 카탈로그에 더 이상 표시되지 않지만, 저장소에는 catalog-info.yaml 파일이 그대로 유지돼요. 이 덕분에 나중에 엔티티를 다시 카탈로그에 등록할 수 있게 돼요.

엔티티를 등록 해제하려면:

카탈로그에서 등록을 해제할 엔티티를 선택해요. 이 예시에서는 mytutorial을 등록 해제하고 있어요.

점 세 개를 선택해요.

드롭다운 메뉴에서 Unregister entity를 선택해요.

UNREGISTER LOCATION을 선택해요. 엔티티가 카탈로그에서 제거돼요.

카탈로그에서 엔티티를 삭제할 수도 있어요. 다만 이를 위해서는 엔티티와 연결된 catalog-info.yaml 엔티티 정의 파일도 함께 삭제해야 해요.

엔티티를 삭제하려면:

저장소에서 해당 엔티티의 다음 엔티티 정의 파일을 삭제해요:

Backstage 앱 카탈로그 보기에서 삭제할 엔티티를 선택해요. 이 예시에서는 mytutorial을 삭제하고 있어요.

엔티티 정의 파일을 삭제했으므로, catalog-info.yaml 파일을 찾을 수 없다는 오류가 표시돼요.

점 세 개를 선택해요.

드롭다운 메뉴에서 Unregister entity를 선택해요.

ADVANCED OPTIONS를 선택해요.

DELETE ENTITY를 선택해요.

엔티티가 성공적으로 삭제되었다는 확인 메시지가 잠시 표시돼요. 엔티티는 더 이상 카탈로그에 표시되지 않아요.