4. kubeadm, kubelet, kubectl 설치

cat <<EOF > /etc/yum.repos.d/kubernetes.repo
[kubernetes]
name=Kubernetes
baseurl=http://mirrors.aliyun.com/kubernetes/yum/repos/kubernetes-el7-x86_64
enabled=1
gpgcheck=0
repo_gpgcheck=0
EOF

yum install -y kubelet-1.20.5 kubeadm-1.20.5 kubectl-1.20.5 --disableexcludes=kubernetes
systemctl enable kubelet && systemctl start kubelet

5. 마스터 노드 초기화

5.1 기본 설정 파일 생성

kubeadm config print init-defaults > kubeadm-init.yaml

kubeadm-init.yaml 파일에서 다음 두 항목을 수정합니다:

1. advertiseAddress: 1.2.3.4를 마스터 노드의 실제 IP (예: 192.168.3.191)로 변경합니다.
2. imageRepository: k8s.gcr.io를 imageRepository: registry.cn-hangzhou.aliyuncs.com/google_containers로 변경합니다.

최종 파일 예시는 다음과 같습니다:

apiVersion: kubeadm.k8s.io/v1beta2
kind: InitConfiguration
localAPIEndpoint:
  advertiseAddress: 192.168.3.191
  bindPort: 6443
nodeRegistration:
  criSocket: /var/run/dockershim.sock
  name: kmaster
  taints:
  - effect: NoSchedule
    key: node-role.kubernetes.io/master
---
apiServer:
  timeoutForControlPlane: 4m0s
apiVersion: kubeadm.k8s.io/v1beta2
certificatesDir: /etc/kubernetes/pki
clusterName: kubernetes
controllerManager: {}
dns:
  type: CoreDNS
etcd:
  local:
    dataDir: /var/lib/etcd
imageRepository: registry.cn-hangzhou.aliyuncs.com/google_containers
kind: ClusterConfiguration
kubernetesVersion: v1.20.1
networking:
  dnsDomain: cluster.local
  serviceSubnet: 10.96.0.0/12
  podSubnet: 10.244.0.0/16
scheduler: {}

5.2 이미지 Pull 및 클러스터 초기화

kubeadm config images pull --config kubeadm-init.yaml
kubeadm init --config kubeadm-init.yaml

초기화가 완료되면 다음과 유사한 출력이 나타납니다. 이 토큰을 워커 노드 연결에 사용합니다.

kubeadm join 192.168.3.10:6443 --token abcdef.0123456789abcdef \
    --discovery-token-ca-cert-hash sha256:13aff926...

5.3 kubectl 설정

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

6. 네트워크 플러그인 설치 (Calico)

curl https://docs.projectcalico.org/v3.20/manifests/calico.yaml -O

calico.yaml 파일을 편집하여 IP 자동 감지 설정을 추가합니다:

- name: CLUSTER_TYPE
  value: "k8s,bgp"
- name: IP_AUTODETECTION_METHOD
  value: "interface=en.*"
- name: IP
  value: "autodetect"
- name: CALICO_IPV4POOL_IPIP
  value: "Never"

kubectl apply -f calico.yaml

잠시 후 마스터 노드의 상태가 Ready로 변경됩니다:

[root@kmaster ~]$ kubectl get node
NAME      STATUS   ROLES                  AGE   VERSION
kmaster   Ready    control-plane,master   48m   v1.20.5

7. 워커 노드 추가

각 워커 노드에서 마스터 초기화 시 출력된 kubeadm join 명령어를 실행합니다.

kubeadm join 192.168.3.10:6443 --token abcdef.0123456789abcdef \
    --discovery-token-ca-cert-hash sha256:37eb59b...

8. 클러스터 상태 확인

[root@kmaster ~]# kubectl get node
NAME      STATUS   ROLES                  AGE   VERSION
kmaster   Ready    control-plane,master   26m   v1.20.5
kworker1  Ready    <none>                 5m    v1.20.5
kworker2  Ready    <none>                 4m    v1.20.5

[root@kmaster ~]# kubectl get pod -n kube-system -o wide

모든 kube-system 네임스페이스의 파드가 Running 상태인지 확인합니다.

Kubernetes Dashboard 설치 (선택 사항)

대시보드 배포 파일 다운로드 및 수정

wget https://raw.githubusercontent.com/kubernetes/dashboard/v2.4.0/aio/deploy/recommended.yaml

recommended.yaml 파일에서 kubernetes-dashboard 서비스의 스펙을 편집하여 type: NodePort와 nodePort: 30443을 추가합니다.

kubectl apply -f recommended.yaml

관리자 사용자 생성

cat > dashboard-admin.yaml << EOF
kind: ClusterRoleBinding
apiVersion: rbac.authorization.k8s.io/v1
metadata:
  name: admin
  annotations:
    rbac.authorization.kubernetes.io/autoupdate: "true"
roleRef:
  kind: ClusterRole
  name: cluster-admin
  apiGroup: rbac.authorization.k8s.io
subjects:
- kind: ServiceAccount
  name: admin
  namespace: kube-system
---
apiVersion: v1
kind: ServiceAccount
metadata:
  name: admin
  namespace: kube-system
  labels:
    kubernetes.io/cluster-service: "true"
    addonmanager.kubernetes.io/mode: Reconcile
EOF

kubectl apply -f dashboard-admin.yaml

로그인 토큰 확인

kubectl -n kube-system get secret | grep admin-token
kubectl -n kube-system describe secret admin-token-w94tz
# 또는 JSONPath를 이용하여 직접 추출
kubectl -n kube-system get secret admin-token-w94tz -o jsonpath={.data.token} | base64 -d

획득한 토큰을 사용하여 브라우저에서 https://{노드_IP}:30443 주소로 접속합니다.

대시보드 접속 시 인증서 오류 해결 (선택 사항, 크롬 브라우저)

openssl genrsa -out dashboard.key 2048
openssl req -new -out dashboard.csr -key dashboard.key -subj '/CN={Master_IP}'
openssl x509 -req -in dashboard.csr -signkey dashboard.key -out dashboard.crt

kubectl delete secret kubernetes-dashboard-certs -n kubernetes-dashboard
kubectl create secret generic kubernetes-dashboard-certs --from-file=dashboard.key --from-file=dashboard.crt -n kubernetes-dashboard

kubectl get pod -n kubernetes-dashboard | grep -v NAME | awk '{print "kubectl delete po " $1 " -n kubernetes-dashboard"}' | sh