본문으로 건너뛰기

StatefulSet


리소스 아이콘​

리소스 개요​

Pod 집합의 배포 및 확장을 관리하고 이러한 Pod의 순서와 고유성에 대한 보장을 제공하는 쿠버네티스 리소스입니다.

연관 리소스​

상위 리소스​

연결 리소스​

리소스 설정 값​

  • service_name : StatefulSet 리소스의 이름

  • namespace : StatefulSet 리소스가 배포될 네임스페이스

  • annotations : 쿠버네티스 시스템에서 필요한 정보들을 표시해 주기 위해서 사용하는 key-value

  • labels : 객체를 구분하기 위해서 사용자가 임의로 원하는 값을 지정

  • template_labels : 노드별로 생성되는 파드(Pod) 설정될 Label

  • pod_management_policy : 노드에서 파드(Pod)를 교체하거나 축소할 때 파드(Pod)가 생성되는 방법을 제어 - Parallel,OrderedReady

  • revision_history_limit : StatefulSet의 개정 기록에 유지될 최대 개정 수, 기본값은 10

  • service_name : statefulset을 관리하는 Headless 서비스 이름

  • replicas : 원하는 Pod 복제본 수 - 기본값은 1

  • containers : 파드(Pod)에 속한 컨테이너에 대한 템플릿을 정의 - 기본 설정값을 세팅하고 적용한 후에 세부 설정값을 세팅할 수 있습니다.

    • name : 컨테이너의 이름을 정의

      • image : 사용할 Docker 이미지 이름

      • args : 컨테이너 내에서 실행될 명령어

      • command : 컨테이너 내에서 실행될 명령어

      • port : 컨테이너에서 노출할 포트 목록

      • resources : 컨테이너의 컴퓨팅 리소스의 양을 지정 - 세부설정

        • name : 최소/최대 컴퓨팅 리소스 양 지정 - Limits, requests
        • cpu : cpu의 양을 지정
        • memory : 메모리의 양을 지정

      • probe : Pod의 상태를 진단하는 방법 정의 - 세부설정

        • name : Probe 방법을 선택 - startup,liveness,readiness
        • http_get_path : HTTP 서버에 액세스하기 위한 경로
        • http_get_port : 컨테이너에서 액세스할 포트 번호
        • http_header : 요청에 설정할 사용자 정의 헤더
        • initial_delay_seconds : 컨테이너가 시작된 후 프로브가 시작되기 전까지의 시간(초)
        • period_seconds : 프로브를 수행하는 빈도(초)

      • env : 컨테이너 환경에 설정할 key-vaule 쌍의 블록 - 세부 설정

        • name : env 변수 이름 설정
        • value : env 변수로 설정할 값

      • volume_mount : 컨테이너의 파일 시스템에 마운트할 파드(Pod) 볼륨 - 세부 설정

        • name : 볼륨 마운트 이름 설정
        • path
          • mount_path : 볼륨을 마운트해야 하는 컨테이너 내의 경로
          • sub_path : 볼륨을 마운트해야 하는 컨테이너 내의 경로

  • volume : 파드(Pod)에 속한 컨테이너가 탑재할 수 있는 볼륨 목록

    • name : 볼륨 이름
      • type : 마운트할 볼륨의 타입 - EmptyDir,ConfigMap,PersistentVolumeClaim
      • target_name : 영구 볼륨 클레임의 이름
      • default_mode : 생성된 파일에 사용할 모드 - 0 ~ 0777 사이, 기본값은 0644
      • read_only : true인 경우 읽기 전용으로 마운트되고 그렇지 않은 경우 읽기/쓰기 가능

  • image_pull_secrets : Container에서 사용하는 이미지를 가져오는 데 필요한 권한이 담긴 동일한 네임스페이스에 있는 Secret

참고 자료​