Skip to main content

리스

Lease는 COP에서 클러스터 내부 컴포넌트 간 상태 동기화 또는 리더 선출(Leader Election) 과 같은 고가용성(HA) 시나리오에서 사용되는 리소스 타입입니다.
특히 kube-controller-manager, kube-scheduler, custom controller 등에서 많이 활용되며, 주기적인 갱신을 통해 리더의 생존 여부를 판단하는 데 사용됩니다.

1.Lease란?

  • Kubernetes의 coordination.k8s.io/v1 API 그룹에 속한 리소스입니다.
  • 특정 주체(controller 또는 프로세스)가 Lease 오브젝트의 정보를 주기적으로 갱신함으로써, 현재 활성 상태임을 증명합니다.
  • 이 Lease 오브젝트의 정보는 리더 선출 알고리즘이나 헬스 체크, 상태 감시 로직에 사용됩니다.

2.주요 필드

필드명설명
holderIdentity현재 Lease를 소유한 엔티티 (컨트롤러의 ID 등)
leaseDurationSecondsLease가 유효한 최대 시간 (초 단위)
renewTimeLease를 마지막으로 갱신한 시각
acquireTimeLease가 처음 획득된 시각
leaseTransitionsLease 소유자가 변경된 횟수

3.사용 예시 (YAML)

apiVersion: coordination.k8s.io/v1
kind: Lease
metadata:
name: example-lease
namespace: kube-system
spec:
holderIdentity: 'controller-1'
leaseDurationSeconds: 15
acquireTime: '2024-06-20T01:00:00Z'
renewTime: '2024-06-20T01:00:10Z'
leaseTransitions: 3

4. 리스(Lease) 상세 화면

목록에서 특정 리스(Lease) 리소스를 클릭하면 해당 객체의 상세 정보를 확인할 수 있는 화면으로 이동합니다.


관리 및 제어

화면 우측 상단에는 리스 객체를 관리하고 제어할 수 있는 아이콘들이 있습니다.

  • 편집: 리스 객체의 YAML 설정을 직접 편집합니다.
  • 삭제: 해당 리스 객체를 삭제합니다.
  • 닫기 (X 아이콘): 상세 화면을 닫고 목록으로 돌아갑니다.

상세 정보 및 상태

  • 이름: 리스 리소스의 이름입니다.
  • 네임스페이스: 이 리스가 속한 네임스페이스입니다.
  • 생성일: 리스 리소스가 생성된 시각입니다.
  • Holder Identity: 현재 이 리스를 점유하고 있는 구성 요소(예: 컨트롤 플레인 노드)입니다.
  • 임대 기간 초: 리스의 유효 시간(초)입니다.
  • 갱신 시간: 마지막으로 이 리스가 갱신된 시점입니다.

이벤트 (Events)

이벤트가 발생하면 이 섹션에 관련 로그가 표시됩니다.