[kubernetes] Deployment로 pod 배포하기

Kubernetes는 컨테이너화된 애플리케이션을 자동으로 배포, 확장, 관리하는 오픈 소스 플랫폼이며, 다양한 환경에서 일관된 애플리케이션 실행을 가능하게 해주는 컨테이너 오케스트레이션 도구입니다.

 

Kubernetes에서 Deployment는 애플리케이션을 선언적으로 배포하고 관리하는 리소스로, Pod의 생성, 업데이트, 확장 및 롤백을 자동화합니다. 이를 통해 안정적인 상태를 유지하며 원하는 개수의 Pod를 보장하고 애플리케이션의 지속적인 배포를 지원합니다.

 

Kubernetes에서 Deployment를 통해 pod를 배포하는 방법을 알아보도록 하겠습니다.

 

 


 

주요 기능

Kubernetes Deployment는 애플리케이션 배포, 업데이트, 확장 및 롤백을 자동화하는 Kubernetes의 핵심 리소스입니다.
Deployment는 선언적 접근 방식을 사용하여 애플리케이션의 원하는 상태를 정의하고, 이를 기반으로 Kubernetes가 클러스터에서 해당 상태를 유지하도록 관리합니다.

  • Pod의 선언적 관리 : 사용자는 YAML 파일로 애플리케이션의 상태를 정의하고, Deployment는 이를 자동으로 관리합니다.
  • 롤링 업데이트 : 애플리케이션 버전을 순차적으로 업데이트하여 무중단 배포를 지원합니다.
  • 롤백 : 문제가 발생하면 이전 버전으로 쉽게 되돌릴 수 있습니다.
  • 자동 복구 : Pod가 비정상 상태일 경우 자동으로 재생성하거나 복제본을 유지합니다.
  • 확장 : 수평 확장을 통해 애플리케이션의 Pod 개수를 조정할 수 있습니다.

 

 

Deployment를 사용하는 이유

직접 배포된 Pod는 클러스터 내에서 특정 노드가 다운되거나 문제가 발생할 경우 자동으로 재생성되지 않으며, 확장성과 관리의 어려움이 있습니다.또한 새로운 버전의 애플리케이션을 배포하거나 설정을 변경하는 경우, 기존 Pod를 삭제하고 새로운 Pod를 수동으로 생성하고 롤백도 수동 작업이 필요합니다.

 

이와 같이 직접 Pod를 배포하는 것은 여러 문제점과 관리에 비효율적이기 때문에 Deployment를 사용하여 Pod를 배포하는 것이 좋습니다.

 

 

 


 

실행 방법

kubectl 명령을 사용하여 Deployment를 생성하거나 YAML 파일을 사용하여 Deployment를 생성할 수 있습니다.

 

kubectl 명령을 사용한 Deployment 생성

kubectl 명령은 간단한 방식으로 Deployment를 생성할 수 있습니다.

# kubectl create deployment nginx-deployment --image=nginx:1.21 --replicas=3
deployment.apps/nginx-deployment created

 

 

YAML 파일을 사용한 Deployment 생성

YAML 파일은 Deployment의 세부 설정을 명시적으로 작성할 때 유용합니다.

# cat nginx-deployment.yaml

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-deployment
spec:
  replicas: 3
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: nginx:1.21


kubectl create -f nginx-deployment.yaml
deployment.apps/nginx-deployment created

 

 

 


확인

kubectl get deployments 명령어를 통해 deployment의 상태를 확인할 수 있으며 -o wide 옵션을 추가하면 추가 정보 또한 확인할 수 있습니다.

# kubectl get deployments -o wide
NAME               READY   UP-TO-DATE   AVAILABLE   AGE    CONTAINERS   IMAGES       SELECTOR
nginx-deployment   3/3     3            3           114s   nginx        nginx:1.21   app=nginx
  • NAME : deployments의 이름
  • READY : Ready 상태인 Pod의 수와 Deployment가 관리하는 총 Pod 수를 표시
    • x/y x/y 형식으로 표시되며, x는 Ready 상태(정상 실행 중)인 Pod의 수이고, y는 Deployment가 관리하는 총 Pod의 수를 나타냅니다
  • UP-TO-DATE : 업데이트된 템플릿(이미지, 설정 등)을 기반으로 생성된 Pod의 수
  • AVAILABLE : 사용자 요청을 처리할 준비가 된 Pod의 수
  • AGE : Deployment가 생성된 후 경과된 시간
  • CONTAINERS : Deployment에서 관리하는 Pod 내 컨테이너 이름
  • IMAGES : Deployment에서 사용된 컨테이너 이미지
  • SELECTOR : Deployment가 관리하는 Pod를 식별하기 위한 Label

 

 

kubectl get deployments 명령어를 통해 deployment를 통해 생성된 pod를 확인할 수 있습니다.
설정한 replicas 값 만큼 총 3개의 pod가 생성되었습니다.

# kubectl get pod
NAME                                READY   STATUS    RESTARTS   AGE
nginx-deployment-6c789f6549-42gqp   1/1     Running   0          6m50s
nginx-deployment-6c789f6549-qtn8b   1/1     Running   0          6m50s
nginx-deployment-6c789f6549-zpv46   1/1     Running   0          6m50s

 

 

 


 

Kubernetes에서 Deployment를 통해 pod를 배포하는 방법을 알아봤습니다.

 

직접 Pod를 배포할 경우 여러 문제점과 관리에 비효율적이기 때문에 Deployment를 사용하여 Pod를 배포하는 것이 좋습니다. kubectl 명령을 사용하면 빠르게 Deployment를 통해 pod를 배포할 수 있으며, YAML 파일을 활용하면 세부 설정과 재사용 가능한 구성을 작성할 수 있습니다. 또한, kubectl get deployments 명령어를 통해 Pod의 배포 상태 및 상세 정보를 확인할 수 있습니다.

 

지금까지 Deployment를 통해 pod를 배포하는 방법을 알아보는 시간을 가졌습니다.

 

 

유익하게 보셨다면 공감을 눌러주고, 댓글로 의견을 공유해 남겨주시면 감사하겠습니다!

 

 

 

[Reference]
https://kubernetes.io/ko/docs/concepts/workloads/controllers/deployment/

 

 

 

[kubernetes] pod 실행하기

Kubernetes는 컨테이너화된 애플리케이션을 자동으로 배포, 확장, 관리하는 오픈 소스 플랫폼이며, 다양한 환경에서 일관된 애플리케이션 실행을 가능하게 해주는 컨테이너 오케스트레이션 도구입니다.

 

Kubernetes에서 Pod는 하나 이상의 컨테이너와 스토리지, 네트워크를 공유하며 동일한 환경에서 동작하며 컨테이너를 실행하기 위한 가장 작은 단위입니다. Kubernetes에서 Pod를 실행하는 방법은 간단하며, kubectl 명령줄 도구를 사용하거나 YAML 파일을 작성하여 Pod를 생성할 수 있습니다.

 

 

 


실행 방법

kubectl 명령을 사용한 Pod를 실행하거나 YAML 파일을 사용하여 Pod를 실행할 수 있습니다.

 

kubectl 명령을 사용한 Pod 실행

가장 간단한 방법은 kubectl 명령을 사용하는 것입니다. 예를 들어, Nginx 컨테이너를 실행하려면 다음 명령을 사용할 수 있습니다:

# kubectl run nginx-pod --image=nginx
pod/nginx-pod created

 

 

YAML 파일을 사용한 Pod 실행

더 복잡한 설정이 필요하거나 재사용 가능한 구성을 원한다면 YAML 파일을 작성하여 Pod를 생성할 수 있습니다.

# cat nginx-pod.yaml

apiVersion: v1
kind: Pod
metadata:
  name: nginx-pod
spec:
  containers:
  - name: nginx-pod
    image: nginx


# kubectl create -f nginx-pod.yaml
pod/nginx-pod created

 

 

 


확인

kubectl get pods 명령어를 통해 pod의 상태를 확인할 수 있으며 -o wide 옵션을 추가하면 추가 정보 또한 확인할 수 있습니다.

# kubectl get pods nginx-pod -o wide
NAME        READY   STATUS    RESTARTS   AGE   IP          NODE         NOMINATED NODE   READINESS GATES
nginx-pod   1/1     Running   0          23m   10.85.0.4   k8s-wn-001   <none>           <none>

 

  • NAME : Pod의 이름
  • READY : Pod 내의 컨테이너가 실행 중인지와 준비 상태인지의 비율
    • x/y 형식으로 표시되며, x는 준비 상태(Ready)인 컨테이너의 수이고, y는 Pod에 포함된 총 컨테이너 수를 나타냅니다.
  • STATUS : Pod의 현재 상태
    • Pending : Pod가 스케줄링 중이거나 아직 실행 준비가 되지 않은 상태
    • Running : Pod의 모든 컨테이너가 실행 중이며 최소한 하나가 준비 상태
    • Succeeded : Pod가 정상적으로 종료됨(모든 컨테이너 종료)
    • Failed : 하나 이상의 컨테이너가 비정상적으로 종료됨
    • Unknown : Pod 상태를 알 수 없는 경우
  • RESTARTS : Pod 내 컨테이너가 재시작된 횟수
  • AGE : Pod가 생성된 후 경과된 시간
  • IP : Pod의 내부 IP 주소
  • NODE : Pod가 실행 중인 워커 노드의 이름
  • NOMINATED NODE : Pod가 스케줄링될 예정인 노드
  • READINESS GATES : 추가적인 준비 상태 조건(옵션).

 


 

 

Kubernetes에서 Pod를 실행하는 방법에 대해 알아봤습니다.

 

kubectl 명령을 사용하면 빠르게 Pod를 실행할 수 있으며, YAML 파일을 활용하면 재사용 가능한 구성을 작성할 수 있습니다. 또한, kubectl get pods 명령어를 통해 Pod의 상태를 확인하고 디버깅할 수 있으며 -o wide 옵션을 사용하면 Pod가 실행 중인 노드와 IP 정보 등 추가 정보를 확인할 수 있습니다.

 

지금까지 Kubernetes에서 Pod를 실행하는 방법을 알아보는 시간을 가졌습니다.

 

 

유익하게 보셨다면 공감을 눌러주고, 댓글로 의견을 공유해 남겨주시면 감사하겠습니다!

 

 

 

[Reference]
https://kubernetes.io/docs/concepts/workloads/pods/

 

 

 

 

[kubernetes] kubectl explain 명령어


Kubernetes는 컨테이너화된 애플리케이션을 자동으로 배포, 확장, 관리하는 오픈 소스 플랫폼이며, 다양한 환경에서 일관된 애플리케이션 실행을 가능하게 해주는 컨테이너 오케스트레이션 도구입니다.

 

kubectl explain 명령어는 Kubernetes 리소스의 API 정보를 조회하는 데 사용됩니다. Kubernetes에서 관리하는 리소스와 해당 필드에 대한 상세한 정보를 확인할 수 있으며 사용 방법을 파악하기 위해 활용됩니다.

 

kubectl explain 명령어 사용을 알아봅시다

 

 

 


 

명령어 형식

# kubectl explain {리소스} {필드} {옵션}

 

kubectl explain 명령어는 위와 같은 형식을 사용합니다.

 

특정 리소스의 구조와 가능한 필드를 파악하고, 특정 필드가 무엇을 의미하는지 설명을 제공합니다.
리소스의 하위 필드로 점진적으로 탐색할 수 있으며, Kubernetes API 버전에 맞는 최신 정보를 제공합니다.

 

 

 


출력 예시

# kubectl explain pods
KIND:       Pod
VERSION:    v1

DESCRIPTION:
    Pod is a collection of containers that can run on a host. This resource is
    created by clients and scheduled onto hosts.

FIELDS:
  apiVersion    <string>
    ##### 설명 #####

  kind  <string>
    ##### 설명 #####

  metadata      <ObjectMeta>
    ##### 설명 #####

  spec  <PodSpec>
    ##### 설명 #####

  status        <PodStatus>
    ##### 설명 #####

 

출력 필드 설명

  • KIND: 리소스의 유형(Type)을 나타내며 기본적인 배포 단위를 의미합니다.
  • VERSION: Kubernetes API의 버전을 나타내며 버전에 따라 리소스의 구조나 기능이 달라질 수 있습니다.
  • DESCRIPTION: 리소스의 전반적인 설명을 제공하며 목적, 동작 방식, 및 기본 개념을 간략히 설명합니다.
  • FIELDS: 리소스의 세부 필드 목록과 각 필드의 목적 및 설명을 제공하며 필드 이름, 데이터 유형 등을 설명합니다.

 

 


 

추가 옵션

--recursive 옵션을 사용하여 하위 필드 정보 한번에 보기

# kubectl explain pods.spec.containers  --recursive
KIND:       Pod
VERSION:    v1

FIELD: containers <[]Container>


DESCRIPTION:
    ##### 생략 #####

FIELDS:
  args  <[]string>
  command       <[]string>
  env   <[]EnvVar>
    name        <string> -required-
    value       <string>
    valueFrom   <EnvVarSource>
      configMapKeyRef   <ConfigMapKeySelector>
        key     <string> -required-
        name    <string>
        optional        <boolean>
      ##### 생략 #####

 

 

--api-version 옵션을 사용하여 특정 API 버전의 리소스 정보 확인

API 버전에 따라 빌드 정보가 다른 것을 확인할 수 있습니다.

# kubectl explain hpa.spec --api-version=autoscaling/v1

##### 생략 #####
FIELDS:
  maxReplicas   <integer> -required-
    ##### 생략 #####

  minReplicas   <integer>
    ##### 생략 #####

  scaleTargetRef        <CrossVersionObjectReference> -required-
    ##### 생략 #####

  targetCPUUtilizationPercentage        <integer>
    ##### 생략 #####


# kubectl explain hpa.spec --api-version=autoscaling/v2

##### 생략 #####
FIELDS:
  behavior      <HorizontalPodAutoscalerBehavior>
    ##### 생략 #####

  maxReplicas   <integer> -required-
    ##### 생략 #####

  metrics       <[]MetricSpec>
    ##### 생략 #####

  minReplicas   <integer>
    ##### 생략 #####

  scaleTargetRef        <CrossVersionObjectReference> -required-
    ##### 생략 #####

 

 

 

 


활용

kubectl explain 명령어의 가장 큰 활용 방법은 리소스 정의를 이해하고, YAML 파일을 작성하거나 디버깅할 때 매우 유용하다는 것입니다. 특히 리소스의 구조, 필드, 그리고 필드의 올바른 이름과 사용법 등을 상세히 확인할 수 있습니다.

 

필드의 리소스 타입이 <[]string>인지 <string>인지 구분하여 타입에 맞는 구조로 YAML 파일을 작성할 수 있습니다. 또한 하위 필드에 필요한 옵션 및 정보들을 확인하여 리소스를 생성하거나 디버깅할 때 유용하며 YAML 파일에서 오류가 발생했을 때, 잘못된 필드 이름이나 누락된 필드를 찾을 때 사용할 수 있습니다.

 

Kubernetes 공식 문서를 통해서 각 리소스의 필드에 대한 정보를 확인할 수 있지만, kubectl explain 명령어를 통해서도 상세하게 확인할 수 있으며 명령어를 통해 바로 확인할 수 있다는 장점이 있을 것 같습니다.

 

 

 


 

Kubernetes에서 kubectl explain 명령어를 통해 리소스 정의를 이해하고 활용하는 방법을 알아봤습니다.

 

kubectl explain 명령어는 Kubernetes에서 관리하는 리소스와 해당 필드의 구조, 데이터 타입, 그리고 사용 방법을 상세히 확인할 수 있도록 도와줍니다. 이를 통해 YAML 파일 작성 시 참고하거나, 디버깅 및 리소스 학습 시 유용하게 사용할 수 있습니다.

 

특정 리소스의 구조와 필드를 점진적으로 탐색할 수 있으며, --recursive 옵션을 통해 모든 하위 필드 정보를 한 번에 출력하거나, --api-version 옵션을 통해 API 버전에 따른 차이를 확인할 수 있습니다. 특히 필드의 데이터 타입(<[]string>, <string> 등)를 명확히 파악하여 YAML 파일을 올바르게 작성할 수 있고, 공식 문서를 참조하지 않아도 명령어를 통해 바로 리소스 정보를 확인할 수 있다는 장점이 있습니다.

 

지금까지 Kubernetes에서 kubectl explain 명령어의 사용법과 활용 방법에 대해 알아보는 시간을 가졌습니다.

 

 

유익하게 보셨다면 공감을 눌러주고, 댓글로 의견을 공유해 남겨주시면 감사하겠습니다!

 

 

 

[Reference]
https://kubernetes.io/docs/reference/kubectl/generated/kubectl_explain/

 

 

 

[kubernetes] kubectl api-resources 명령어

Kubernetes는 컨테이너화된 애플리케이션을 자동으로 배포, 확장, 관리하는 오픈 소스 플랫폼이며, 다양한 환경에서 일관된 애플리케이션 실행을 가능하게 해주는 컨테이너 오케스트레이션 도구입니다.

 

kubectl api-resources 명령어는 Kubernetes 클러스터에서 사용할 수 있는 API 리소스 목록을 확인하는 데 사용됩니다. Kubernetes에서 지원하는 리소스와 해당 리소스의 범위(네임스페이스 포함 여부) 및 가능한 동작(verbs)을 표시합니다.

 

kubectl api-resources 명령어 사용을 알아봅시다

 

 

 


출력 예시

# kubectl api-resources
NAME                                SHORTNAMES   APIVERSION                        NAMESPACED   KIND
bindings                                         v1                                true         Binding
componentstatuses                   cs           v1                                false        ComponentStatus
configmaps                          cm           v1                                true         ConfigMap
endpoints                           ep           v1                                true         Endpoints
events                              ev           v1                                true         Event
limitranges                         limits       v1                                true         LimitRange
namespaces                          ns           v1                                false        Namespace
nodes                               no           v1                                false        Node
persistentvolumeclaims              pvc          v1                                true         PersistentVolumeClaim
persistentvolumes                   pv           v1                                false        PersistentVolume
pods                                po           v1                                true         Pod
podtemplates                                     v1                                true         PodTemplate
replicationcontrollers              rc           v1                                true         ReplicationController
resourcequotas                      quota        v1                                true         ResourceQuota
secrets                                          v1                                true         Secret
serviceaccounts                     sa           v1                                true         ServiceAccount
services                            svc          v1                                true         Service
mutatingwebhookconfigurations                    admissionregistration.k8s.io/v1   false        MutatingWebhookConfiguration
validatingadmissionpolicies                      admissionregistration.k8s.io/v1   false        ValidatingAdmissionPolicy
validatingadmissionpolicybindings                admissionregistration.k8s.io/v1   false        ValidatingAdmissionPolicyBinding
validatingwebhookconfigurations                  admissionregistration.k8s.io/v1   false        ValidatingWebhookConfiguration
customresourcedefinitions           crd,crds     apiextensions.k8s.io/v1           false        CustomResourceDefinition
apiservices                                      apiregistration.k8s.io/v1         false        APIService
controllerrevisions                              apps/v1                           true         ControllerRevision
daemonsets                          ds           apps/v1                           true         DaemonSet
deployments                         deploy       apps/v1                           true         Deployment
replicasets                         rs           apps/v1                           true         ReplicaSet
statefulsets                        sts          apps/v1                           true         StatefulSet
selfsubjectreviews                               authentication.k8s.io/v1          false        SelfSubjectReview
tokenreviews                                     authentication.k8s.io/v1          false        TokenReview
localsubjectaccessreviews                        authorization.k8s.io/v1           true         LocalSubjectAccessReview
selfsubjectaccessreviews                         authorization.k8s.io/v1           false        SelfSubjectAccessReview
selfsubjectrulesreviews                          authorization.k8s.io/v1           false        SelfSubjectRulesReview
subjectaccessreviews                             authorization.k8s.io/v1           false        SubjectAccessReview
horizontalpodautoscalers            hpa          autoscaling/v2                    true         HorizontalPodAutoscaler
cronjobs                            cj           batch/v1                          true         CronJob
jobs                                             batch/v1                          true         Job
certificatesigningrequests          csr          certificates.k8s.io/v1            false        CertificateSigningRequest
leases                                           coordination.k8s.io/v1            true         Lease
endpointslices                                   discovery.k8s.io/v1               true         EndpointSlice
events                              ev           events.k8s.io/v1                  true         Event
flowschemas                                      flowcontrol.apiserver.k8s.io/v1   false        FlowSchema
prioritylevelconfigurations                      flowcontrol.apiserver.k8s.io/v1   false        PriorityLevelConfiguration
ingressclasses                                   networking.k8s.io/v1              false        IngressClass
ingresses                           ing          networking.k8s.io/v1              true         Ingress
networkpolicies                     netpol       networking.k8s.io/v1              true         NetworkPolicy
runtimeclasses                                   node.k8s.io/v1                    false        RuntimeClass
poddisruptionbudgets                pdb          policy/v1                         true         PodDisruptionBudget
clusterrolebindings                              rbac.authorization.k8s.io/v1      false        ClusterRoleBinding
clusterroles                                     rbac.authorization.k8s.io/v1      false        ClusterRole
rolebindings                                     rbac.authorization.k8s.io/v1      true         RoleBinding
roles                                            rbac.authorization.k8s.io/v1      true         Role
priorityclasses                     pc           scheduling.k8s.io/v1              false        PriorityClass
csidrivers                                       storage.k8s.io/v1                 false        CSIDriver
csinodes                                         storage.k8s.io/v1                 false        CSINode
csistoragecapacities                             storage.k8s.io/v1                 true         CSIStorageCapacity
storageclasses                      sc           storage.k8s.io/v1                 false        StorageClass
volumeattachments                                storage.k8s.io/v1                 false        VolumeAttachment

 

 

출력 필드 설명

  • NAME: 리소스 이름
  • SHORTNAMES: 리소스의 단축 이름(별칭) / 예시) po는 pods, svc는 services의 단축형
  • APIVERSION: 리소스를 제공하는 API 그룹과 버전
  • NAMESPACED: 해당 리소스가 네임스페이스 범위인지 여부.
    • true: 네임스페이스 내부에 존재
    • false: 클러스터 범위에 존재
  • KIND: 리소스의 오브젝트 종류

 

 


추가 동작

특정 API 그룹에 속한 리소스 보기

# kubectl api-resources --api-group=apps
NAME                  SHORTNAMES   APIVERSION   NAMESPACED   KIND
controllerrevisions                apps/v1      true         ControllerRevision
daemonsets            ds           apps/v1      true         DaemonSet
deployments           deploy       apps/v1      true         Deployment
replicasets           rs           apps/v1      true         ReplicaSet
statefulsets          sts          apps/v1      true         StatefulSet

 

 

지원되는 동작(verbs) 확인

# kubectl api-resources --verbs=list,get
NAME                                SHORTNAMES   APIVERSION                        NAMESPACED   KIND
componentstatuses                   cs           v1                                false        ComponentStatus
configmaps                          cm           v1                                true         ConfigMap
endpoints                           ep           v1                                true         Endpoints
events                              ev           v1                                true         Event
limitranges                         limits       v1                                true         LimitRange
namespaces                          ns           v1                                false        Namespace
nodes                               no           v1                                false        Node
persistentvolumeclaims              pvc          v1                                true         PersistentVolumeClaim
persistentvolumes                   pv           v1                                false        PersistentVolume
pods                                po           v1                                true         Pod
podtemplates                                     v1                                true         PodTemplate
replicationcontrollers              rc           v1                                true         ReplicationController
resourcequotas                      quota        v1                                true         ResourceQuota
secrets                                          v1                                true         Secret
serviceaccounts                     sa           v1                                true         ServiceAccount
services                            svc          v1                                true         Service
mutatingwebhookconfigurations                    admissionregistration.k8s.io/v1   false        MutatingWebhookConfiguration
validatingadmissionpolicies                      admissionregistration.k8s.io/v1   false        ValidatingAdmissionPolicy
validatingadmissionpolicybindings                admissionregistration.k8s.io/v1   false        ValidatingAdmissionPolicyBinding
validatingwebhookconfigurations                  admissionregistration.k8s.io/v1   false        ValidatingWebhookConfiguration
customresourcedefinitions           crd,crds     apiextensions.k8s.io/v1           false        CustomResourceDefinition
apiservices                                      apiregistration.k8s.io/v1         false        APIService
controllerrevisions                              apps/v1                           true         ControllerRevision
daemonsets                          ds           apps/v1                           true         DaemonSet
deployments                         deploy       apps/v1                           true         Deployment
replicasets                         rs           apps/v1                           true         ReplicaSet
statefulsets                        sts          apps/v1                           true         StatefulSet
horizontalpodautoscalers            hpa          autoscaling/v2                    true         HorizontalPodAutoscaler
cronjobs                            cj           batch/v1                          true         CronJob
jobs                                             batch/v1                          true         Job
certificatesigningrequests          csr          certificates.k8s.io/v1            false        CertificateSigningRequest
leases                                           coordination.k8s.io/v1            true         Lease
endpointslices                                   discovery.k8s.io/v1               true         EndpointSlice
events                              ev           events.k8s.io/v1                  true         Event
flowschemas                                      flowcontrol.apiserver.k8s.io/v1   false        FlowSchema
prioritylevelconfigurations                      flowcontrol.apiserver.k8s.io/v1   false        PriorityLevelConfiguration
ingressclasses                                   networking.k8s.io/v1              false        IngressClass
ingresses                           ing          networking.k8s.io/v1              true         Ingress
networkpolicies                     netpol       networking.k8s.io/v1              true         NetworkPolicy
runtimeclasses                                   node.k8s.io/v1                    false        RuntimeClass
poddisruptionbudgets                pdb          policy/v1                         true         PodDisruptionBudget
clusterrolebindings                              rbac.authorization.k8s.io/v1      false        ClusterRoleBinding
clusterroles                                     rbac.authorization.k8s.io/v1      false        ClusterRole
rolebindings                                     rbac.authorization.k8s.io/v1      true         RoleBinding
roles                                            rbac.authorization.k8s.io/v1      true         Role
priorityclasses                     pc           scheduling.k8s.io/v1              false        PriorityClass
csidrivers                                       storage.k8s.io/v1                 false        CSIDriver
csinodes                                         storage.k8s.io/v1                 false        CSINode
csistoragecapacities                             storage.k8s.io/v1                 true         CSIStorageCapacity
storageclasses                      sc           storage.k8s.io/v1                 false        StorageClass
volumeattachments                                storage.k8s.io/v1                 false        VolumeAttachment

 

 

네임스페이스 범위 리소스 확인

# kubectl api-resources --namespaced=false
NAME                                SHORTNAMES   APIVERSION                        NAMESPACED   KIND
componentstatuses                   cs           v1                                false        ComponentStatus
namespaces                          ns           v1                                false        Namespace
nodes                               no           v1                                false        Node
persistentvolumes                   pv           v1                                false        PersistentVolume
mutatingwebhookconfigurations                    admissionregistration.k8s.io/v1   false        MutatingWebhookConfiguration
validatingadmissionpolicies                      admissionregistration.k8s.io/v1   false        ValidatingAdmissionPolicy
validatingadmissionpolicybindings                admissionregistration.k8s.io/v1   false        ValidatingAdmissionPolicyBinding
validatingwebhookconfigurations                  admissionregistration.k8s.io/v1   false        ValidatingWebhookConfiguration
customresourcedefinitions           crd,crds     apiextensions.k8s.io/v1           false        CustomResourceDefinition
apiservices                                      apiregistration.k8s.io/v1         false        APIService
selfsubjectreviews                               authentication.k8s.io/v1          false        SelfSubjectReview
tokenreviews                                     authentication.k8s.io/v1          false        TokenReview
selfsubjectaccessreviews                         authorization.k8s.io/v1           false        SelfSubjectAccessReview
selfsubjectrulesreviews                          authorization.k8s.io/v1           false        SelfSubjectRulesReview
subjectaccessreviews                             authorization.k8s.io/v1           false        SubjectAccessReview
certificatesigningrequests          csr          certificates.k8s.io/v1            false        CertificateSigningRequest
flowschemas                                      flowcontrol.apiserver.k8s.io/v1   false        FlowSchema
prioritylevelconfigurations                      flowcontrol.apiserver.k8s.io/v1   false        PriorityLevelConfiguration
ingressclasses                                   networking.k8s.io/v1              false        IngressClass
runtimeclasses                                   node.k8s.io/v1                    false        RuntimeClass
clusterrolebindings                              rbac.authorization.k8s.io/v1      false        ClusterRoleBinding
clusterroles                                     rbac.authorization.k8s.io/v1      false        ClusterRole
priorityclasses                     pc           scheduling.k8s.io/v1              false        PriorityClass
csidrivers                                       storage.k8s.io/v1                 false        CSIDriver
csinodes                                         storage.k8s.io/v1                 false        CSINode
storageclasses                      sc           storage.k8s.io/v1                 false        StorageClass
volumeattachments                                storage.k8s.io/v1                 false        VolumeAttachment

 

 

 


활용

Kubernetes의 여러가지 기능은 API 리소스를 통해 구현할 수 있습니다.

 

Kubernetes 버전에 따라 사용할 수 있는 기능과 API의 버전은 다릅니다.
기본적으로 Kubernetes 공식 릴리즈 노트를 통해 해당 정보를 확인할 수 있지만 kubectl api-resources 명령어를 통해 현재 사용할 수 있는 API 리소스 리스트를 확인하는 목적이 가장 클 것 같습니다.

 

특정 리소스에 대해 지원되는 API 버전을 확인할 수 있으며, 특정 API 버전이 제거되거나 업데이트될 경우 대체 API로 전환할 수 있습니다. 네임스페이스 범위와 클러스터 범위의 리소스를 명확히 구분하고 싶을 때 kubectl api-resources 명령어를 사용하여 확인할 수 있습니다.

 

 


 

 

Kubernetes에서 kubectl api-resources 명령어를 통해 클러스터에서 사용할 수 있는 API 리소스를 확인하는 방법을 알아봤습니다.

 

kubectl api-resources 명령어는 Kubernetes에서 지원하는 리소스의 이름, 단축 이름(SHORTNAMES), API 그룹과 버전(APIVERSION), 네임스페이스 범위 여부(NAMESPACED), 오브젝트 종류(KIND) 등을 확인할 수 있습니다. 이를 통해 현재 클러스터에서 활성화된 리소스를 쉽게 탐색할 수 있습니다.

 

특정 API 그룹에 속한 리소스를 조회하거나, 네임스페이스 범위의 리소스만 확인하는 등 다양한 옵션을 활용하여 필요한 리소스 정보를 빠르게 얻을 수 있습니다. 또한 Kubernetes 버전별로 지원되는 API 리소스와 버전을 확인할 때 유용하며, 특정 API가 제거되거나 업데이트될 경우 대체 API로 전환하는 데에도 도움을 줍니다.

 

지금까지 Kubernetes에서 kubectl api-resources 명령어의 사용법과 활용 방법에 대해 알아보는 시간을 가졌습니다.

 

 

유익하게 보셨다면 공감을 눌러주고, 댓글로 의견을 공유해 남겨주시면 감사하겠습니다!

 

 

 

[Reference]
https://kubernetes.io/docs/reference/kubectl/generated/kubectl_api-resources/

 

 

 

[kubernetes] kubeadm join Worker 노드 추가하기


Kubernetes는 컨테이너화된 애플리케이션을 자동으로 배포, 확장, 관리하는 오픈 소스 플랫폼이며, 다양한 환경에서 일관된 애플리케이션 실행을 가능하게 해주는 컨테이너 오케스트레이션 도구입니다.

 

kubeadm join 명령어는 Kubernetes 클러스터에 새로운 노드를 추가할 때 사용되는 명령어입니다. Worker 노드를 추가하는 경우, 사전에 Master 노드가 구성되어 있어야 합니다.

 

Kubernetes 클러스터에 Worker 노드를 추가하는 방법을 알아보도록 하겠습니다.

 

 

 


작업 구성

사전에 총 3대의 서버를 Master 노드로 구성 완료한 상태입니다.
총 3대의 Worker 노드를 추가하는 Kubernetes 클러스터 구성을 만들고자 합니다.

 

 

 


사전 작업

기본 작업

Worker 노드는 join 명령어를 통해 Master 노드 클러스터에 연결 및 추가됩니다.


kubeadm join 명령어로 클러스터에 추가하기 위해 기본 사전 작업을 진행합니다.

 

 

 

 

kubeadm join 시 필요한 정보 확인

Worker 노드를 추가할 경우에는 token 값과 CA 인증서 값만 필요하지만 Master 노드를 추가할 경우에는 클러스터 인증서 값이 추가적으로 필요합니다. 아래 링크를 통해 kubeadm join 시 필요한 정보를 사전에 확인 합니다.

 

 

 

 


 

kubeadm join

Worker 노드에서 join 명령어를 통해 Master 노드 클러스터에 연결 및 추가합니다.


kubeadm join 명령어에는 Master 노드 IP 및 Port, 토큰(Token), CA 인증서 해시 값이 필요합니다.

# kubeadm join 10.0.0.11:6443 \ 
              --token fb4jku.kkt1ivfjvxkskxrq \ 
              --discovery-token-ca-cert-hash sha256:48ebf1c55897a3d0e55c19e75648d457b6309f4f0b8c88ae5e3dc871c0d8a1a5 \ 
              --v=5

I1112 16:54:23.022474   33868 join.go:419] [preflight] found NodeName empty; using OS hostname as NodeName
I1112 16:54:23.022891   33868 initconfiguration.go:123] detected and using CRI socket: unix:///var/run/crio/crio.sock

##### 생략 #####

I1112 16:54:25.901893   33868 cert_rotation.go:140] Starting client certificate rotation controller
I1112 16:54:25.902612   33868 kubelet.go:318] [kubelet-start] preserving the crisocket information for the node
I1112 16:54:25.902639   33868 patchnode.go:31] [patchnode] Uploading the CRI Socket information "unix:///var/run/crio/crio.sock" to the Node API object "k8s-wn-001" as an annotation

This node has joined the cluster:
* Certificate signing request was sent to apiserver and a response was received.
* The Kubelet was informed of the new secure connection details.

Run 'kubectl get nodes' on the control-plane to see this node join the cluster.

 

성공적으로 Worker 노드 추가 작업이 완료되었습니다.

 

 

 


클러스터 join 상태 확인

Kubernetes 클러스터에서 현재 구성된 모든 노드(node)에 대한 정보를 확인할 수 있습니다.

# kubectl get nodes
NAME         STATUS   ROLES           AGE   VERSION
k8s-cn-001   Ready    control-plane   12d   v1.31.2
k8s-cn-002   Ready    control-plane   24h   v1.31.2
k8s-cn-003   Ready    control-plane   24h   v1.31.2
k8s-wn-001   Ready    <none>          17h   v1.31.0
k8s-wn-002   Ready    <none>          35m   v1.31.0
k8s-wn-003   Ready    <none>          35m   v1.31.0

 

노드 이름, 상태, 역할, 생성된 시간, 버전 등의 정보를 확인할 수 있으며,

추가된 k8s-wn-001, k8s-wn-002, k8s-wn-003 Worker 노드를 확인할 수 있습니다.

 

 

 


 

Kubernetes에서 kubeadm join 명령어를 통해 Worker 노드를 추가하는 방법을 알아봤습니다.

 

먼저, Worker 노드에서 kubeadm join 명령어를 사용하기 위해 CRI-O, kubeadm, kubelet, kubectl 등을 설치합니다. 이후 kubeadm join 명령어를 사용하여 클러스터에 연결합니다. Worker 노드를 추가할 때는 token 값, CA 인증서 해시 값을 추가하여 Master 노드에 Worker 노드를 추가합니다.

 

이후 kubectl get nodes 명령어로 추가된 Worker 노드 상태를 확인할 수 있습니다.

 

지금까지 Kubernetes에서 kubeadm join 명령어를 통해 Worker 노드를 추가하는 방법을 알아보는 시간을 가졌습니다....! 끝...!

 

 

유익하게 보셨다면 공감을 눌러주고, 댓글로 의견을 공유해 남겨주시면 감사하겠습니다!

 

 

 

[Reference]
https://kubernetes.io/docs/reference/setup-tools/kubeadm/kubeadm-join/

 

 

 

[kubernetes] kubeadm join Master 노드 추가하기


Kubernetes는 컨테이너화된 애플리케이션을 자동으로 배포, 확장, 관리하는 오픈 소스 플랫폼이며, 다양한 환경에서 일관된 애플리케이션 실행을 가능하게 해주는 컨테이너 오케스트레이션 도구입니다.

 

kubeadm join 명령어는 Kubernetes 클러스터에 새로운 노드를 추가할 때 사용되는 명령어입니다. Master 노드를 추가하는 경우, 단순 Worker 노드를 추가하는 것보다 몇 가지 추가 설정이 필요합니다.

 

 

Kubernetes 클러스터에 Master 노드를 추가하는 방법을 알아보도록 하겠습니다.

 

 

 


작업 구성

Kubernetes 클러스터 구성은 총 3대의 서버를 Master 노드로 구성하고자 합니다.


첫 번째 Master(또는 Control Plane) 노드는 init 명령어로 클러스터를 구성합니다.
두 번째와 세 번째 Master 노드는 join 명령어를 통해 클러스터에 노드로 추가되며 추가 시 옵션을 추가하여 Worker 노드가 아닌 Master 노드로 추가될 예정입니다.

 

 

 


사전 작업

 

[첫 번째 Master 노드] kubeadm init 클러스터 구성하기

Kubernetes 클러스터에 control plane이 구성된 첫 번째 Master 노드를 구성합니다.

 

 

 

 

[두 번째, 세 번째 Master 노드]

두 번째, 세 번째 Master 노드는 join 명령어를 통해 첫 번째 Master 노드를 통해 클러스터에 연결 및 추가됩니다.
기본 환경 구성을 위해 첫 번째 Master 노드와 유사하게 kubeadm init 이전까지의 기본 사전 작업을 진행합니다.

 

 

 

 

 

kubeadm join 시 필요한 정보 확인

Worker 노드를 추가할 경우에는 token 값과 CA 인증서 값만 필요하지만 Master 노드를 추가할 경우에는 클러스터 인증서 값이 추가적으로 필요합니다. 아래 링크를 통해 kubeadm join 시 필요한 정보를 사전에 확인 합니다.

 

 

 

 

 


kubeadm join

두 번째, 세 번째 Master 노드는 join 명령어를 통해 첫 번째 Master 노드 클러스터에 연결 및 추가합니다.
kubeadm join 명령어에는 Master 노드 IP 및 Port, 토큰(Token), CA 인증서 해시, 클러스터 인증서 값이 필요합니다.

 

kubeadm join 명령어를 사용하여 클러스터를 추가합니다.

# kubeadm join 10.0.0.11:6443 \ 
              --token fb4jku.kkt1ivfjvxkskxrq \ 
              --discovery-token-ca-cert-hash sha256:48ebf1c55897a3d0e55c19e75648d457b6309f4f0b8c88ae5e3dc871c0d8a1a5 \ 
              --control-plane --certificate-key 9ea5555144a397c54a6ddfec77dc8b14ad5b93d6d006c8fc04092aa88c833f27 \
              --v=5

I1112 09:56:19.086799 1171838 join.go:419] [preflight] found NodeName empty; using OS hostname as NodeName
I1112 09:56:19.086913 1171838 join.go:423] [preflight] found advertiseAddress empty; using default interface's IP address as advertiseAddress
I1112 09:56:19.087599 1171838 initconfiguration.go:123] detected and using CRI socket: unix:///var/run/crio/crio.sock

##### 생략 #####

This node has joined the cluster and a new control plane instance was created:

* Certificate signing request was sent to apiserver and approval was received.
* The Kubelet was informed of the new secure connection details.
* Control plane label and taint were applied to the new node.
* The Kubernetes control plane instances scaled up.
* A new etcd member was added to the local/stacked etcd cluster.

To start administering your cluster from this node, you need to run the following as a regular user:

        mkdir -p $HOME/.kube
        sudo cp -i /etc/kubernetes/admin.conf $HOME/.kube/config
        sudo chown $(id -u):$(id -g) $HOME/.kube/config

Run 'kubectl get nodes' to see this node join the cluster.

 

 

마지막 로그에서 나온 것과 같이 클러스터와 통신할 수 있도록 인증 정보 설정을 추가합니다.

# mkdir -p $HOME/.kube
# sudo cp -i /etc/kubernetes/admin.conf $HOME/.kube/config
# sudo chown $(id -u):$(id -g) $HOME/.kube/config

 

클러스터 추가 작업이 완료되었습니다.

 

 

 


kubeadm join 시 오류 발생

kubeadm join 명령어로 클러스터 추가 시 발생할 수 있는 오류 내용입니다.
kubeadm join 명령어 입력 시 --v=5 옵션을 추가해야 상세 오류 내용을 확인하실 수 있습니다.

 

TOKEN 값 오류 로그

TOKEN 값이 만료되었거나 일치하지 않을 경우 아래와 같이 에러 로그가 발생합니다.

I1031 14:16:15.895101   43351 token.go:228] [discovery] Retrying due to error: could not find a JWS signature in the cluster-info ConfigMap for token ID "sa3r4y"

 

 

CA 인증서 Hash 값 오류 로그

CA 인증서 Hash 값이 일치하지 않을 경우 아래와 같이 에러 로그가 발생합니다.

none of the public keys "sha256:48ebf1c55897a3d0e55c19e75648d457b6309f4f0b8c88ae5e3dc871c0d8a1a5" are pinned

 

 

controlPlaneEndpoint 오류 로그

join 하고자 하는 master 서버 API의  IP, Port 정보가 잘못되었거나 controlPlaneEndpoint가 설정되어 있지 않을 경우 아래와 같이 에러 로그가 발생합니다.

One or more conditions for hosting a new control plane instance is not satisfied.

unable to add a new control plane instance to a cluster that doesn't have a stable controlPlaneEndpoint address

Please ensure that:
* The cluster has a stable controlPlaneEndpoint address.
* The certificates that must be shared among control plane instances are provided.

 

 


클러스터 join 상태 확인

Kubernetes 클러스터에서 현재 구성된 모든 노드(node)에 대한 정보를 확인할 수 있습니다.

# kubectl get nodes
NAME         STATUS   ROLES           AGE     VERSION
k8s-cn-001   Ready    control-plane   12d     v1.31.2
k8s-cn-002   Ready    control-plane   3h32m   v1.31.2
k8s-cn-003   Ready    control-plane   3h26m   v1.31.2

노드 이름, 상태, 역할, 생성된 시간, 버전 등의 정보를 확인할 수 있습니다.

 

 

Kubernetes 클러스터의 핵심 구성 요소들이 실행되는 kube-system 네임스페이스의 리소스를 확인할 수 있습니다.
etcd, kube-api-server, kube-controller-manager, kube-proxy, kube-scheduler 등 Master(또는 Control Plane) 노드에 필요한 구성 요소들이 추가된 노드에 따라 각각 추가된 것을 확인하실 수 있습니다.

# kubectl get all -A
NAMESPACE     NAME                                     READY   STATUS    RESTARTS        AGE
kube-system   pod/coredns-7c65d6cfc9-9znfx             1/1     Running   0               12d
kube-system   pod/coredns-7c65d6cfc9-j76md             1/1     Running   0               12d
kube-system   pod/etcd-k8s-cn-001                      1/1     Running   0               12d
kube-system   pod/etcd-k8s-cn-002                      1/1     Running   0               3h34m
kube-system   pod/etcd-k8s-cn-003                      1/1     Running   0               3h28m
kube-system   pod/kube-apiserver-k8s-cn-001            1/1     Running   0               3h47m
kube-system   pod/kube-apiserver-k8s-cn-002            1/1     Running   0               3h34m
kube-system   pod/kube-apiserver-k8s-cn-003            1/1     Running   0               3h28m
kube-system   pod/kube-controller-manager-k8s-cn-001   1/1     Running   2 (3h48m ago)   12d
kube-system   pod/kube-controller-manager-k8s-cn-002   1/1     Running   0               3h34m
kube-system   pod/kube-controller-manager-k8s-cn-003   1/1     Running   0               3h28m
kube-system   pod/kube-proxy-kx2tk                     1/1     Running   0               3h28m
kube-system   pod/kube-proxy-xgvst                     1/1     Running   0               12d
kube-system   pod/kube-proxy-xs2wk                     1/1     Running   0               3h34m
kube-system   pod/kube-scheduler-k8s-cn-001            1/1     Running   2 (3h48m ago)   12d
kube-system   pod/kube-scheduler-k8s-cn-002            1/1     Running   0               3h34m
kube-system   pod/kube-scheduler-k8s-cn-003            1/1     Running   0               3h28m

NAMESPACE     NAME                 TYPE        CLUSTER-IP   EXTERNAL-IP   PORT(S)                  AGE
default       service/kubernetes   ClusterIP   10.96.0.1    <none>        443/TCP                  12d
kube-system   service/kube-dns     ClusterIP   10.96.0.10   <none>        53/UDP,53/TCP,9153/TCP   12d

NAMESPACE     NAME                        DESIRED   CURRENT   READY   UP-TO-DATE   AVAILABLE   NODE SELECTOR            AGE
kube-system   daemonset.apps/kube-proxy   3         3         3       3            3           kubernetes.io/os=linux   12d

NAMESPACE     NAME                      READY   UP-TO-DATE   AVAILABLE   AGE
kube-system   deployment.apps/coredns   2/2     2            2           12d

NAMESPACE     NAME                                 DESIRED   CURRENT   READY   AGE
kube-system   replicaset.apps/coredns-7c65d6cfc9   2         2         2       12d

 

 

 


 

Kubernetes에서 kubeadm join 명령어를 통해 Master 노드를 추가하는 방법을 알아봤습니다.

 

먼저, Kubernetes 클러스터를 고가용성(HA)으로 구성하기 위해 첫 번째 Master 노드에서 kubeadm init 명령어를 사용하여 클러스터의 control plane을 초기화하고, controlPlaneEndpoint를 설정합니다. 이후 두 번째와 세 번째 Master 노드는 kubeadm join 명령어를 사용하여 클러스터에 연결합니다. Master 노드를 추가할 때는 token 값, CA 인증서 해시, 클러스터 인증서가 필요하며, --control-plane 옵션을 사용하여 Master 노드로 추가합니다.

 

클러스터에 추가된 노드에서 kubectl 명령어를 사용하기 위해 설정 파일을 준비하고 권한을 설정하는 명령을 실행합니다.
이후 kubectl get nodes 명령어로 노드 상태를 확인하고, kubectl get all -A 명령어로 kube-system 네임스페이스 내 핵심 구성 요소들이 각 노드에 추가되어 정상적으로 실행되고 있는지 확인합니다.

 

지금까지 Kubernetes에서 kubeadm join 명령어를 통해 Master 노드를 추가하는 방법을 알아보는 시간을 가졌습니다....! 끝...!

 

 

유익하게 보셨다면 공감을 눌러주고, 댓글로 의견을 공유해 남겨주시면 감사하겠습니다!

 

 

 

[Reference]
https://kubernetes.io/docs/reference/setup-tools/kubeadm/kubeadm-join/
https://kubernetes.io/docs/setup/production-environment/tools/kubeadm/high-availability/

 

 

 

[kubernetes] controlPlaneEndpoint 설정하기


Kubernetes는 컨테이너화된 애플리케이션을 자동으로 배포, 확장, 관리하는 오픈 소스 플랫폼이며, 다양한 환경에서 일관된 애플리케이션 실행을 가능하게 해주는 컨테이너 오케스트레이션 도구입니다.

 

Kubernetes에서 controlPlaneEndpoint 설정은 고가용성(HA)을 위한 필수 구성 요소입니다. 이 설정을 통해 클러스터 내 여러 master 노드를 로드밸런서나 고정 IP를 통해 단일 접점으로 묶어 관리할 수 있습니다. controlPlaneEndpoint를 사용하면, 클러스터의 API 서버에 대한 요청을 단일 엔드포인트로 전달하고, 그 뒤에서 로드밸런서가 요청을 여러 master 노드로 분산 처리하게 됩니다.

 

 

controlPlaneEndpoint에 대해 더 알아보고 설정하는 방법을 알아보도록 하겠습니다.

 

 


controlPlaneEndpoint 란?

 

[ 기능 ]

controlPlaneEndpoint는 클러스터의 API 서버를 외부에서 접근할 수 있는 단일 접점을 제공합니다.
이를 통해 클라이언트(예: kubectl)는 master 노드의 IP 주소가 변경되더라도 항상 동일한 엔드포인트를 사용하여 API 서버에 접근할 수 있습니다.

 

 

[ 필요성 ]

여러 master 노드를 사용하는 경우, API 서버에 대한 접근을 로드밸런서가 담당하도록 하여 고가용성 및 장애 대응을 구현할 수 있습니다. 만약 하나의 master 노드가 다운되더라도, 로드밸런서가 요청을 남은 master 노드로 자동으로 라우팅하여 서비스가 지속되도록 합니다.

 

단일 master 노드를 사용하는 경우에는 controlPlaneEndpoint 설정 없이 클러스터를 사용하여도 문제는 없습니다.

 

 


controlPlaneEndpoint 설정하기

 

kubeadm init 단계에서 설정하기

kubeadm init 단계에서 --control-plane-endpoint 옵션을 추가하여 직접 controlPlaneEndpoint를 설정할 수 있습니다.

# kubeadm init --control-plane-endpoint "10.0.0.11:6443"

 

 

kubeadm init 완료 후 설정하기

Kubernetes configmaps 설정 중 kubeadm-config 설정에 controlPlaneEndpoint 옵션을 추가합니다.

# kubectl edit configmaps -n kube-system kubeadm-config


ClusterConfiguration 섹션에 controlPlaneEndpoint: <IP 및 도메인> 값을 추가합니다.
추가 후 자동으로 적용되며 controlPlaneEndpoint를 통해 안정적으로 API 서버에 접근할 수 있습니다.

 

 


접근 확인

controlPlaneEndpoint가 설정된 로드밸런서나 고정 IP를 통해 Kubernetes API 서버에 접근할 수 있는지 확인하려면, 로컬 머신이나 클러스터의 다른 노드에서 kubectl 명령을 실행합니다.

### 예시
# kubectl get nodes --server https://<controlPlaneEndpoint>:6443
# kubectl get nodes --server https://10.0.0.11:6443
NAME         STATUS   ROLES           AGE   VERSION
k8s-cn-001   Ready    control-plane   12d   v1.31.2
k8s-cn-002   Ready    control-plane   60m   v1.31.2
k8s-cn-003   Ready    control-plane   54m   v1.31.2

 

정상적으로 설정한 controlPlaneEndpoint를 통해 API 서버에 접근하는 것을 확인하실 수 있습니다.

 

 


 

Kubernetes 클러스터에서 controlPlaneEndpoint를 설정하고 확인하는 방법을 알아봤습니다.

 

먼저, 클러스터의 고가용성을 위해 로드밸런서나 고정 IP를 통해 접근할 수 있는 controlPlaneEndpoint를 설정합니다. 이를 위해, kubeadm, kubelet, kubectl 패키지를 설치한 후, kubeadm init 명령어를 사용해 control plane을 초기화합니다. kubeadm init 단계에서 controlPlaneEndpoint 설정을 추가하거나 완료 후 configmaps 설정을 추가하여 controlPlaneEndpoint  설정을 추가할 수 있습니다.

 

마지막으로, kubectl get nodes 명령어에 --server 옵션을 추가하여 설정한 controlPlaneEndpoint를 통해 모든 master 노드가 정상적으로 응답하는지 확인합니다.

 

지금까지 Kubernetes 클러스터에서 controlPlaneEndpoint를 설정하고 확인하는 방법을 알아보는 시간을 가졌습니다....! 끝...!

 

 

유익하게 보셨다면 공감을 눌러주고, 댓글로 의견을 공유해 남겨주시면 감사하겠습니다!

 

 

 

[Reference]
https://kubernetes.io/docs/setup/production-environment/tools/kubeadm/create-cluster-kubeadm/
https://kubernetes.io/docs/reference/config-api/kubeadm-config.v1beta3/

 

 

 

[kubernetes] kubeadm join 시 필요한 정보 확인

Kubernetes는 컨테이너화된 애플리케이션을 자동으로 배포, 확장, 관리하는 오픈 소스 플랫폼이며, 다양한 환경에서 일관된 애플리케이션 실행을 가능하게 해주는 컨테이너 오케스트레이션 도구입니다.

 

kubeadm join 명령어는 Kubernetes 클러스터에 새로운 노드를 추가할 때 사용되는 명령어입니다.
이때 각각의 옵션을 추가하여 필요한 정보를 입력하면 Master(또는 Control Plane) 노드로 추가하거나 Worker 노드로 추가할 수 있습니다. 각각의 경우, kubeadm join을 실행할 때 필요한 정보가 어떤 것인지 확인하고 설정하는 방법을 확인해보도록 하겠습니다.

 

 


kubeadm join 시 필요한 정보 확인

 

 

0. 기본 명령어 구조

kubeadm join 시 사용하는 명령어의 기본적인 구조는 아래와 같습니다.

아래 명령어를 확인 후 필요한 정보에 대한 상세 정보를 확인해봅시다.

kubeadm join <IP:Port> \
          --token <TOKEN> \
          --discovery-token-ca-cert-hash sha256:<HASH> \
          --control-plane --certificate-key <CERTIFICATE_KEY>

 

 

 

1. Master 노드 IP 및 Port

클러스터에 처음 초기화된 Master(또는 Control Plane) 노드의 IP 주소입니다.
Port는 클러스터의 API 서버가 사용하는 정보로 기본적으로 6443번을 사용합니다.

 

필수 값으로 IP:Port 형태로 옵션을 추가하여 사용합니다.

 

 

 

2. token 확인 및 발급 방법

클러스터에 노드를 추가하는 인증 토큰입니다.
필수 값으로 --token <TOKEN> 형태로 옵션을 추가하여 사용합니다.

 

token 확인 시 kubeadm token list 명령어를 사용하여 현재 발급된 token 값을 확인합니다.
발급 시 기본적으로 24시간의 TTL을 가집니다.

# kubeadm token list
TOKEN                     TTL         EXPIRES                USAGES                   DESCRIPTION                                                EXTRA GROUPS
tu3evj.a78mjq13wnb144gz   23h         2024-11-01T01:29:43Z   authentication,signing   The default bootstrap token generated by 'kubeadm init'.   system:bootstrappers:kubeadm:default-node-token

 

 

token 발급 시에는 kubeadm token create 명령어를 사용하며 신규 발급을 할 수 있습니다.

kubeadm init 시에는 자동으로 기본 token 값이 발급됩니다.

# kubeadm token create
vr7t89.jxazmg5p92o9b64u

 

 

 

3. CA 인증서 확인 방법

클러스터의 CA 인증서에 대한 SHA-256 해시 값으로 API 서버에 연결할 때 인증서를 검증하기 위한 값입니다.
필수 값으로 --discovery-token-ca-cert-hash <HASH> 형태로 옵션을 추가하여 사용합니다.

 

CA 인증서 파일은 기본 경로인 /etc/kubernetes/pki/ca.crt 경로에 생성되며 아래 명령어를 통해 Hash 값을 확인할 수 있습니다.

# openssl x509 -pubkey -in /etc/kubernetes/pki/ca.crt | \
    openssl rsa -pubin -outform der 2>/dev/null | \
    sha256sum | \
    awk '{print $1}'
48ebf1c55897a3d0e55c19e75648d457b6309f4f0b8c88ae5e3dc871c0d8a1a5

 

 

 

4. 클러스터 인증서 확인 및 발급 방법

클러스터 인증서란 추가 노드를 Worker 노드가 아닌 Master(또는 Control Plane) 노드로 추가하기 위해 클러스터 부트스트랩(bootstrap) 과정에서 클러스터의 컨트롤 플레인 노드 간에 비밀 값을 공유하기 위한 인증서입니다. Master 노드로 추가 시에만 사용하는 옵션으로 --control-plane --certificate-key <CERTIFICATE_KEY> 형태로 옵션을 추가하여 사용합니다.

 

인증서 발급 시 인증서를 사용하기 위한 키 값이 생성되며 발급 과정에서 키를 복사 후 사용해야 됩니다.
만약 키를 잃어버렸다면, 인증서를 재발급 하거나 클러스터를 재구성해야 할 수 있습니다.

 

클러스터 인증서 발급 여부를 확인하기 위해 kubectl get 명령어와 kubectl describe 명령어를 사용할 수 있습니다.

### 클러스터 인증서 발급 확인
# kubectl get secret kubeadm-certs -n kube-system
NAME            TYPE     DATA   AGE
kubeadm-certs   Opaque   8      7m58s


### 클러스터 인증서 상세 내용 확인
# kubectl describe secret kubeadm-certs -n kube-system
Name:         kubeadm-certs
Namespace:    kube-system
Labels:       <none>
Annotations:  <none>

Type:  Opaque

Data
====
sa.pub:              479 bytes
ca.crt:              1135 bytes
ca.key:              1707 bytes
etcd-ca.crt:         1122 bytes
etcd-ca.key:         1703 bytes
front-proxy-ca.crt:  1151 bytes
front-proxy-ca.key:  1707 bytes
sa.key:              1703 bytes

 

클러스터 인증서 발급 여부만 확인할 수 있으며 키는 확인할 수 없습니다.

 

 

인증서를 신규 발급 및 재발급 시에는 kubeadm init phase upload-certs --upload-certs 명령어를 사용합니다.
클러스터가 이미 초기화된 후에 인증서를 업로드하거나 갱신할 때 사용하는 명령어 입니다.

# kubeadm init phase upload-certs --upload-certs
[upload-certs] Storing the certificates in Secret "kubeadm-certs" in the "kube-system" Namespace
[upload-certs] Using certificate key:
60796e6a29ed231d32af9d59f557c858789166a4809f6296374ae7073d2bfd96

 

 

클러스터 초기화 단계에서 인증서를 생성 및 업로드할 경우에는 kubeadm init --upload-certs 명령어를 통해 클러스터 초기화와 인증서를 생성 및 업로드 작업을 한번에 할 수 있습니다.

# kubeadm init --upload-certs
===== 이후 클러스터 초기화 =====

 

 

 


 

Kubernetes의 kubeadm join 명령어 사용 시 필요한 정보를 확인해봤는데요.

 

새로운 노드를 클러스터에 추가하려면 Master 노드 IP 및 Port, 토큰(Token), CA 인증서 해시, 클러스터 인증서 등이 필요합니다. 각각의 정보들은 명령어를 통해 확인 및 발급하여 관리할 수 있습니다. 클러스터 인증서 같은 경우에는 발급 시에만 키 값을 확인할 수 있어 발급 과정에서 키를 복사 후 저장하여 사용해야 됩니다. 클러스터 추가 시 필요한 정보들을 명확히 확인 후 잘 사용하시기 바랍니다.

 

지금까지 Kubernetes의 kubeadm join 명령어 사용 시 필요한 정보를 확인해보는 방법을 알아봤습니다....! 끝...!

 

 

유익하게 보셨다면 공감을 눌러주고, 댓글로 의견을 공유해 남겨주시면 감사하겠습니다!

 

 

 

[Reference]
https://kubernetes.io/docs/setup/production-environment/tools/kubeadm/high-availability/

 

 

 

+ Recent posts