Kubernetes (K8S): Object Config File(구성파일: yaml)
최근 들어 Infra를 Code 형태로 관리하는 IaC(Infrastructure As Code)가 각광을 받고 있다.
Infra를 Source 코드화 해서 사용을 하면 대량 배포 시 멱등성을 확보할 수 있고 배포 후 변경관리가 용이하다는 장점을 갖기 때문이다.
K8S에서는 Object를 배포, 삭제, 변경하거나 Object의 정보확인 시 개별 명령어를 각각 입력할 필요없이 설정 파일을 명령으로 실행하면 대단히 편리하다.
K8S 역시 명령어보다는 설정 파일의 형태로 관리하는 것을 적극 권장한다.
https://github.com/kubernetes/examples/tree/master/guestbook/all-in-one
참조할 예제 파일들이 존재
1. Field
1.1. apiVersion
1.1.1. Object를 생성하기 위해서 사용하는 Kubernete API 버젼
1.1.2. Pod(po): v1
1.1.3. Service(svc): v1
1.1.4. Deployment(deploy): apps/v1
1.1.5. Namespace: v1
1.1.6. ReplicaSet(rs): apps/v1
# kubectl api-resources 확인 가능
1.2. kind: 생성하려는 Object 종류
1.2.1. object: Namespace, Pod, Service, Deployment, DaemonSet, Label, ReplicaSet 등
1.2.1.1. 클러스터의 상태를 나타내는 단위(entities)입니다.
1.2.1.2. “의도를 담은 레코드”입니다. 생성된 클러스터는 그 의도대로 존재할 수 있도록 최선을 다함.
1.2.1.3. 이를 클러스터의 “의도한 상태(desired state)“ 지칭.
1.2.1.4. 쿠버네티스는 항상 오브젝트의 “현재 상태”를 “의도한 상태”와 동일하게 만들게끔 작동.
1.2.1.5. 이때 의도한 상태란 다음과 같습니다.
- 어떤 파드(컨테이너)들이 어느 노드에서 동작(running) 중인지
- 컨테이너들의 논리 그룹과 매핑된 IP 엔드포인트
- 동작 중인 컨테이너 레플리카(replicas)의 개수
1.3. metadata
1.3.1. Object를 유일하게 구분할 수 있는 Data
1.3.2. 이름 문자열, UID, 선택적인 Namespace
1.4. spec
1.4.1. Object에 대해서 의도한 상태
1.5. 동작구조
1.5.1. 구성 파일은 Cluster에 적용되기 전 Version Controller에 저장
1.5.2. 구성 파일을 저장함으로서 필요시 구성의 변경사항 Rollback 가능
1.5.3. Cluster의 재생성 및 복원에 사용
2. Test
2.1. 테스트 구성파일 작성
# vi nginx.yml
apiVersion: v1
kind: Service
metadata:
name: nginx-svc
labels:
app: web
tier: frontend
role: master
spec:
# type: NodePort
ports:
- port: 80
targetPort: 80
# nodePort: 31000
selector:
app: web
tier: frontend
role: master
---
apiVersion: apps/v1
kind: Deployment
metadata:
name: nginx-dep
spec:
selector:
matchLabels:
app: web
tire: frontend
role: master
replicas: 1
template:
metadata:
labels:
app: web
tire: frontend
role: master
spec:
containers:
- name: master
image: nginx
resources:
requests:
cpu: 100m
memory: 100Mi
ports:
- containerPort: 80
2.2. 적용 및 svc, deployment 확인
# kubectl apply -f nginx.yml
# kubectl get svc
# kubectl get deploy
# kubectl get pod
2.3. service type을 NodePort로 변경, nodePort: 31000으로 수정
2.3.1. 쿠버네티스 컨트롤 플레인은 포트 범위에서 할당한다(기본값: 30000-32767)
2.4. 적용 전 diff 명령어를 이용하여 Version 관리가 되고 있음을 확인합니다.
# kubectl diff -f nginx.yml
2.5. 적용 후 변경 사항을 확인 합니다.
2.5.1. service port type과 port가 변경된 것 이외에는 아무런 변경사항이 없음을 확인합니다.
3. yml 파일을 통한 구성 확인
3.1. 생성되는 Object 정보 조회
# kubectl get -f nginx.yml
# kubectl describe -f nginx.yml
3.2. 생성되는 Object에 대한 자세한 정보 조회
여러분들은 replicas도 변경해서 테스트 해보시기 바랍니다.
Have a nice day!