배포 (Deployment)
COP 콘솔의 '배포(Deployment)' 메뉴에서는 파드(Pod)와 복제 세트(ReplicaSet)에 대한 선언적 업데이트를 제공하는 워크로드를 관리합니다. 배포는 무상태(stateless) 애플리케이션의 롤링 업데이트, 롤백, 스케일링 등을 관리하는 데 가장 일반적으로 사용됩니다.
배포 목록
클러스터에 생성된 배포의 정보가 목록 형태로 표시됩니다.
| 항목 | 설명 |
|---|---|
| 이름 | 배포의 고유한 이름 |
| 네임스페이스 | 배포가 속한 네임스페이스 |
| CPU | 배포의 현재 CPU 사용량 |
| 메모리 | 배포의 현재 메모리 사용량 |
| Pod | 실행 중인 파드 수 / 요청된 파드 수 (예: 1/1) |
| 복제 | 설정된 Replica 수량 |
| 상태 (Conditions) | 배포의 현재 상태 (예: Available, Progressing) |
| 컨테이너 | 배포를 구성하는 컨테이너 이름 |
| 이미지 | 컨테이너가 사용하는 이미지 경로 |
| 경과 시간 | 배포가 생성된 후 경과한 시간 |
리소스 미설정 경고
CPU 또는 메모리 리소스 요청/제한이 설정되지 않은 배포는 해당 열에 경고 뱃지가 표시됩니다. 리소스 설정이 없으면 클러스터의 안정적인 운영에 영향을 줄 수 있으므로 설정을 권장합니다.
요약 칩 필터
목록 상단에 배포 상태별 요약 칩이 표시됩니다.
- Deployments: 전체 배포 수
- Degraded: 성능 저하 상태의 배포 수
- Scaled Down: 축소된 배포 수
- No Resource: 리소스 미설정 배포 수
- No 1st / No 1st: 첫 번째 설정 미적용 배포 수
각 칩을 클릭하면 해당 상태의 배포만 필터링하여 볼 수 있습니다.
동작 메뉴
각 배포 항목의 '더보기(...)' 아이콘을 클릭하면 다음 작업을 수행할 수 있습니다.
- 재시작: 배포에 속한 모든 파드를 롤링 재시작
- 스케일: 배포의 복제본(파드) 수를 조정
- 편집: 배포의 설정을 GUI를 통해 편집
- YAML 보기: 배포의 YAML 정의를 확인
- 삭제: 해당 배포를 삭제
배포 상세
목록에서 특정 배포의 이름을 클릭하면 상세 정보 화면으로 이동합니다.
기본 정보
배포 의 메타데이터(이름, 네임스페이스, 생성 시간, 레이블, 주석 등)와 전략(Strategy) 정보를 확인할 수 있습니다.
조건 (Conditions)
배포의 진행 상태를 나타내는 조건들의 목록입니다.
Available(사용 가능), Progressing(진행 중) 등의 상태와
그 이유를 확인할 수 있습니다.
Pod 템플릿
배포가 생성하는 파드의 템플릿 사양을 확인합니다. 컨테이너 이미지, 포트, 환경 변수, 리소스 설정(CPU/메모리 요청 및 제한) 등의 상세 정보를 포함합니다.
Pod 템플릿의 리소스 설정에서 CPU/메모리의 요청(requests)과 제한(limits)값을 확인할 수 있습니다. 목록에서 리소스 미설정 경고가 표시된 경우 이 섹션에서 적절한 값을 설정하 는 것을 권장합니다.
이벤트
배포와 관련된 생성, 스케일링, 롤아웃 등의 이벤트를 시간순으로 확인할 수 있습니다.
관련 리소스
배포가 관리하는 ReplicaSet, Pod 등 관련 리소스의 목록을 확인하고 각 리소스의 상세 화면으로 이동할 수 있습니다.
레플리카 스케일링
동작 메뉴 또는 상세 화면에서 스케일 기능을 사용하여 배포의 복제본(파드) 수를 조정할 수 있습니다. 원하는 복제본 수를 입력하면 배포 컨트롤러가 자동으로 파드를 생성하거나 종료합니다.
컨테이너 리소스 제한 편집
동작 메뉴의 편집 또는 상세 화면에서 컨테이너의 CPU 및 메모리 리소스 요청(Request)과 제한(Limit)을 설정할 수 있습니다.
| 항목 | 설명 |
|---|---|
| CPU 요청 | 컨테이너가 보장받는 최소 CPU 자원 (단위: millicores(m) 또는 cores) |
| CPU 제한 | 컨테이너가 사용할 수 있는 최대 CPU 자원 (단위: millicores(m) 또는 cores) |
| 메모리 요청 | 컨테이너가 보장받는 최소 메모리 자원 (단위: MiB, GiB 등) |
| 메모리 제한 | 컨테이너가 사용할 수 있는 최대 메모리 자원 (단위: MiB, GiB 등) |
- 요청(Request): 쿠버네티스 스케줄러가 파드를 노드에 배치할 때 참조하는 값입니다. 노드에 요청량 이상의 가용 리소스가 있어야 파드가 스케줄링됩니다.
- 제한(Limit): 컨테이너가 사용할 수 있는 리소스의 상한값입니다. CPU 제한을 초과하면 쓰로틀링이 발생하고, 메모리 제한을 초과하면 OOMKilled로 파드가 종료될 수 있습니다.
리소스 요청과 제한을 적절히 설정하면 클러스터의 안정적인 운영과 효율적인 자원 활용에 도움이 됩니다. 목록에서 리소스 미설정 경고가 표시된 배포는 이 기능을 통해 리소스를 설정하는 것을 권장합니다.
재시작
동작 메뉴 또는 상세 화면에서 재시작 기능을 사용하면 배포에 속한 모든 파드를 롤링 방식으로 재시작합니다. 이를 통해 설정 변경이나 이미지 업데이트를 적용할 수 있습니다.
로그 및 터미널
배포 상세 화면에서 파드의 로그 조회와 터미널 접속을 동시에 활용할 수 있습니다. 로그와 터미널을 각각 단독으로 볼 수도 있고, 화면을 분할하여 함께 확인할 수도 있습니다.
분할 보기
로그와 터미널을 상하로 분할하여 동시에 표시합니다. 로그를 실시간으로 확인하면서 터미널에서 명령을 실행할 수 있어 문제 진단 시 유용합니다.
Pod 상태 표시
화면 오른쪽의 Pod 이 름 옆에 현재 상태가 표시됩니다.
- 녹색 (Running/Ready): 파드가 Running 상태이며 헬스체크(Readiness Probe)에 성공하여 정상 기동이 완료된 상태
- 주황색 (Running/Not Ready): 파드가 Running 상태이지만 아직 Ready가 되지 않은 상태. 헬스체크가 아직 성공하지 않았음을 의미
배포 후 로그를 확인하면서 Pod 상태 색상을 함께 확인하면, 컨테이너가 단순히 Running 상태인지 또는 헬스체크가 성공하여 실제 서비스가 가능한 상태인지를 쉽게 구분할 수 있습니다.