본문으로 건너뛰기

인스턴스

CRD 상세 화면에서 인스턴스 탭을 클릭하거나, 사이드바에서 해당 CRD의 인스턴스 메뉴를 선택하면 해당 CRD 타입의 모든 CR 인스턴스 목록을 확인할 수 있습니다.

인스턴스 목록 및 탐색​

콘솔에서는 클러스터에 등록된 모든 CRD에 대해 인스턴스를 탐색할 수 있습니다. 각 인스턴스 목록에서는 다음 정보를 확인할 수 있습니다.

  • 이름: 인스턴스의 고유 이름
  • 네임스페이스: 네임스페이스 범위 CRD인 경우 소속 네임스페이스
  • 생성 시간: 인스턴스가 생성된 시각
  • 추가 열: CRD에 정의된 추가 프린터 열의 값

네임스페이스 필터를 사용하여 특정 네임스페이스의 인스턴스만 조회할 수 있으며, 검색 기능으로 이름 기반 필터링도 가능합니다.

인스턴스 상세​

인스턴스 목록에서 특정 항목을 클릭하면 상세 화면으로 이동합니다. 상세 화면에서는 인스턴스의 전체 데이터와 상태를 확인할 수 있습니다.

  • 메타데이터: 이름, 네임스페이스, 레이블, 어노테이션, UID, 생성 시간
  • 스펙(Spec): 인스턴스의 선언적 설정 데이터. CRD 스키마에 따른 구조화된 정보가 표시됩니다.
  • 상태(Status): 인스턴스의 현재 상태 정보. 컨트롤러에 의해 업데이트됩니다.
  • 이벤트: 인스턴스와 관련된 Kubernetes 이벤트

YAML 편집​

상세 화면에서 편집 버튼을 클릭하면 YAML 편집기가 열립니다. 현재 인스턴스의 전체 YAML이 로드되며, 수정 후 Apply 버튼을 클릭하여 변경 사항을 적용할 수 있습니다.

YAML 편집기에서는 구문 하이라이팅, Managed Fields 표시/숨기기, 유효성 검증 기능을 사용할 수 있습니다.

CRD 스키마 기반 폼 편집​

CRD에 JSON 스키마가 정의되어 있는 경우, 폼 편집기를 통해 시각적 인터페이스로 인스턴스를 편집할 수 있습니다. 폼 편집기는 스키마에 정의된 필드 타입에 따라 적절한 입력 컨트롤(텍스트 필드, 숫자 입력, 드롭다운 선택, 키-값 편집기 등)을 자동으로 생성합니다.

폼 편집기와 YAML 편집기는 서로 전환이 가능하며, 한쪽에서 수정한 내용이 다른 쪽에 즉시 반영됩니다.

인스턴스 생성​

새 CR 인스턴스를 생성할 때는 인스턴스 목록 화면 상단의 + 버튼을 클릭합니다. CRD의 API 그룹, 버전, 종류(Kind)가 자동으로 설정된 YAML 템플릿이 제공되며, 스키마가 있는 경우 폼 편집기를 통해 직관적으로 필드를 입력할 수 있습니다.

인스턴스 삭제​

인스턴스 상세 화면 또는 목록에서 삭제 작업을 수행할 수 있습니다. 삭제 시 확인 대화상자가 표시되며, 리소스 이름을 입력하여 삭제를 확인합니다.