Edit This Page

쿠버네티스 오브젝트 관리

kubectl 커맨드라인 툴은 쿠버네티스 오브젝트를 생성하고 관리하기 위한 몇 가지 상이한 방법을 지원한다. 이 문서는 여러가지 접근법에 대한 개요을 제공한다.

• 관리 기법
• 명령형 명령어
• 명령형 오브젝트 구성
• 선언형 오브젝트 구성
• 다음 내용

관리 기법

경고: 쿠버네티스 오브젝트는 오직 하나의 기법을 사용하여 관리되어야 한다. 동일한 오브젝트에 대해 혼합하고 일치시키는 기법은 확실하지 않은 동작을 초래하게 된다.

명령형 명령어

명령형 명령어를 사용할 경우, 사용자는 클러스터 내 활성 오브젝트를 대상으로 직접 동작시킨다. 사용자는 kubectl 명령어에 인수 또는 플래그로 작업을 제공한다.

이것은 클러스터에서 일회성 작업을 개시시키거나 동작시키기 위한 가장 단순한 방법이다. 이 기법은 활성 오브젝트를 대상으로 직접적인 영향을 미치기 때문에, 이전 구성에 대한 이력을 제공해 주지 않는다.

예시

디프롤이먼트 오브젝트를 생성하기 위해 nginx 컨테이너의 인스턴스를 구동 시킨다.

kubectl run nginx --image nginx

다른 문법을 이용하여 동일한 작업을 수행한다.

kubectl create deployment nginx --image nginx

트레이드 오프

오브젝트 구성과 비교한 장점은

• 명령어가 익히기에 단순, 용이하고 기억하기 쉽다.
• 명령어가 클러스터에 변경을 주기 위해 오직 단일 과정만이 필요하다.

오브젝트 구성과 비교한 단점은

• 명령어가 변경 검토 프로세스와 통합되지 않는다.
• 명령어가 변경에 관한 감사 추적을 제공하지 않는다.
• 명렁어가 활성 동작 중인 경우를 제외하고는 레코드의 소스를 제공하지 않는다.
• 명령어가 새로운 오브젝트 생성을 위한 템플릿을 제공하지 않는다.

명령형 오브젝트 구성

명령형 오브젝트 구성에서, kubectl 명령은 작업 (생성, 대체 등), 선택적 플래그, 그리고 최소 하나의 파일 이름을 정의한다. 그 파일은 YAML 또는 JSON 형식으로 오브젝트의 완전한 정의를 포함해야만 한다.

오브젝트 정의에 대한 더 자세한 내용은 API 참조를 참고한다.

경고: 명령형 replace 명령은 기존 spec을 새롭게 제공된 것으로 대체하며, 구성 파일에서 누락된 오브젝트에 대한 모든 변경사항은 없어진다. 이러한 접근은 구성 파일에 대해 독립적으로 spec이 업데이트되는 형태의 리소스와 함께 사용하면 안된다. 예를 들어, LoadBalancer 형태의 서비스는 externalIPs 필드를 클러스터 구성과는 독립적으로 업데이트한다.

예시

구성 파일에 정의된 오브젝트를 생성한다.

kubectl create -f nginx.yaml

두 개의 구성 파일에 정의된 오브젝트를 삭제한다.

kubectl delete -f nginx.yaml -f redis.yaml

활성 동작하는 구성을 덮어씀으로서 구성 파일에 정의된 오브젝트를 업데이트한다.

kubectl replace -f nginx.yaml

트레이드 오프

명령형 명령과 비교한 장점은

• 오브젝트 구성이 Git과 같은 소스 컨트롤 시스템에 보관되어 질 수 있다.
• 오브젝트 구성은 푸시와 감사 추적 전에 변경사항을 검토하는 것과 같은 프로세스들과 통합할 수 있다.
• 오브젝트 구성이 새로운 오브젝트 생성을 위한 템플릿을 제공한다.

명령형 명령과 비교한 단점은

• 오브젝트 구성이 오브젝트 스키마에 대한 기본적인 이해를 필요로 한다.
• 오브젝트 구성이 YAML 파일을 기록하는 추가적인 과정을 필요로 한다.

선언형 오브젝트 구성과 비교한 장점은

• 명령형 오브젝트 구성의 작용은 보다 간결하고 이해하기에 용이하다.
• 쿠버네티스 버전 1.5 부터, 명령형 오브젝트 구성이 더욱 발달한다.

선언형 오브젝트 구성과 비교한 단점은

• 명령형 오브젝트 구성은 디렉토리가 아닌, 파일에 대해 가장 효과가 있다.
• 활성 오브젝트에 대한 업데이트는 구성 파일 내 반영되어야만 한다. 그렇지 않으면 다음 대체가 이루어지는 동안 유실 될 것이다.

선언형 오브젝트 구성

선언형 오브젝트 구성을 사용할 경우, 사용자는 로컬에 보관된 오브젝트 구성 파일을 대상으로 작동시키지만, 사용자는 파일에서 수행 할 작업을 정의하지 않는다. 생성, 업데이트, 그리고 삭제 작업은 kubectl에 의해 오브젝트 마다 자동으로 감지된다. 이것은 다른 오브젝트를 위해 필요할 수도 있는 다른 작업에서, 디렉토리들을 대상으로 동작할 수 있도록 해준다.

참고: 선언형 오브젝트 구성은 비록 그 변경사항이 오브젝트 구성 파일로 되돌려 병합될 수 없기는 하지만, 다른 작성자에 의해 이루어진 변경사항을 유지한다. 이는 전체 오브젝트 구성을 대체하기 위해 replace API 작업을 이용하는 대신, 오직 인지된 차이점을 기록하기 위한 patch API 작업을 이용함으로서 가능하다.

예시

configs 디렉토리 내 모든 오브젝트 구성 파일을 처리하고 활성 오브젝트를 생성 또는 패치한다. 먼저 어떠한 변경이 이루어지게 될지 알아보기 위해 diff 하고 나서 적용할 수 있다.

kubectl diff -f configs/
kubectl apply -f configs/

재귀적으로 디렉토리를 처리한다.

kubectl diff -R -f configs/
kubectl apply -R -f configs/

트레이드 오프

명령형 오브젝트 구성과 비교한 장점은

• 구성 파일로 되돌려 병합될 수 없기는 하지만, 활성 오브젝트에 직접 이루어진 변경사항이 유지된다.
• 선언형 오브젝트 구성은 디렉토리에 관한 동작에 대해 더 나은 지원을 하고 자동으로 오브젝트 마다의 작업(생성, 패치, 삭제)을 감지한다.

명령형 오브젝트 구성과 비교한 단점은

• 선언형 오브젝트 구성은 예측이 불가할 경우 디버그 하기가 더 어렵고 결과를 이해하기가 더 어렵다.
• 차이점를 이용한 부분적 업데이트는 복잡한 병합과 패치 작업을 만들어 낸다.

다음 내용

• 명령형 명령어를 이용한 쿠버네티스 오브젝트 관리하기
• 오브젝트 구성을 이용한 쿠버네티스 오브젝트 관리하기 (명령형)
• 오브젝트 구성을 이용한 쿠버네티스 오브젝트 관리하기 (선언형)
• Kubectl 명령어 참조
• 쿠버네티스 API 참조

피드백

이 페이지가 도움이 되었나요?

Thanks for the feedback. If you have a specific, answerable question about how to use Kubernetes, ask it on Stack Overflow. Open an issue in the GitHub repo if you want to report a problem or suggest an improvement.