클러스터의 하이브리드 노드 업그레이드

하이브리드 노드 연결 단계에 따라 새 호스트를 하이브리드 노드로 연결합니다. nodeadm install 명령을 실행할 때 대상 Kubernetes 버전을 사용합니다.

대상 Kubernetes 버전의 새 하이브리드 노드와 이전 Kubernetes 버전의 하이브리드 노드 간에 통신을 활성화합니다. 이 구성을 사용하면 워크로드를 대상 Kubernetes 버전의 하이브리드 노드로 마이그레이션하는 동안 포드가 서로 통신할 수 있습니다.

대상 Kubernetes 버전의 하이브리드 노드가 클러스터에 성공적으로 조인되었고 준비됨 상태인지 확인합니다.

다음 명령을 사용하여 제거하려는 각 노드를 예약 불가로 표시합니다. 이는 바꾸고 있는 노드에서 새 포드가 예약되거나 다시 예약되지 않도록 하기 위한 것입니다. 자세한 내용은 Kubernetes 문서의 kubectl cordon을 참조하세요. NODE_NAME을 이전 Kubernetes 버전의 하이브리드 노드 이름으로 바꿉니다.

kubectl cordon NODE_NAME
            

다음 코드 조각을 사용하여 특정 Kubernetes 버전(이 경우 1.28)의 모든 노드를 식별하고 연결할 수 있습니다.

K8S_VERSION=1.28
for node in $(kubectl get nodes -o json | jq --arg K8S_VERSION "$K8S_VERSION" -r '.items[] | select(.status.nodeInfo.kubeletVersion | match("\($K8S_VERSION)")).metadata.name')
do
    echo "Cordoning $node"
    kubectl cordon $node
done

현재 배포가 하이브리드 노드에서 2개 미만의 CoreDNS 복제본을 실행하고 있는 경우, 배포를 복제본 2개 이상으로 확장합니다. 정상 작업 중에 복원력을 위해 하이브리드 노드에서 최소 2개의 CoreDNS 복제본을 실행하는 것이 좋습니다.

kubectl scale deployments/coredns --replicas=2 -n kube-system

다음 명령을 사용하여 클러스터에서 제거할 기존 Kubernetes 버전의 각 하이브리드 노드를 드레이닝합니다. 노드 드레이닝에 대한 자세한 내용은 Kubernetes 설명서의 Safely Drain a Node을 참조하세요. NODE_NAME을 이전 Kubernetes 버전의 하이브리드 노드 이름으로 바꿉니다.

kubectl drain NODE_NAME --ignore-daemonsets --delete-emptydir-data

다음 코드 조각을 사용하여 특정 Kubernetes 버전(이 경우 1.28)의 모든 노드를 식별하고 드레이닝할 수 있습니다.

K8S_VERSION=1.28
for node in $(kubectl get nodes -o json | jq --arg K8S_VERSION "$K8S_VERSION" -r '.items[] | select(.status.nodeInfo.kubeletVersion | match("\($K8S_VERSION)")).metadata.name')
do
    echo "Draining $node"
    kubectl drain $node --ignore-daemonsets --delete-emptydir-data
done

nodeadm을 사용하여 호스트에서 하이브리드 노드 아티팩트를 중지하고 제거할 수 있습니다. root/sudo 권한이 있는 사용자와 함께 nodeadm을 실행해야 합니다. 노드에 포드가 남아 있는 경우 기본적으로 nodeadm uninstall이 진행되지 않습니다. 자세한 정보는 하이브리드 노드 nodeadm 참조 섹션을 참조하세요.

nodeadm uninstall

하이브리드 노드 아티팩트가 중지 및 제거된 상태에서, 클러스터에서 노드 리소스를 제거합니다.

kubectl delete node node-name
            

다음 코드 조각을 사용하여 특정 Kubernetes 버전(이 경우 1.28)의 모든 노드를 식별하고 삭제할 수 있습니다.

K8S_VERSION=1.28
for node in $(kubectl get nodes -o json | jq --arg K8S_VERSION "$K8S_VERSION" -r '.items[] | select(.status.nodeInfo.kubeletVersion | match("\($K8S_VERSION)")).metadata.name')
do
    echo "Deleting $node"
    kubectl delete node $node
done

CNI 선택에 따라 위의 단계를 실행한 후 하이브리드 노드에 아티팩트가 남아 있을 수 있습니다. 자세한 정보는 하이브리드 노드에 대한 CNI 구성을 참조하세요.

다음 명령을 사용하여 업그레이드하는 노드를 예약 불가로 표시합니다. 이는 업그레이드하는 노드에서 새 포드가 예약되거나 다시 예약되지 않도록 하기 위한 것입니다. 자세한 내용은 Kubernetes 문서의 kubectl cordon을 참조하세요. NODE_NAME을 업그레이드하려는 하이브리드 노드의 이름으로 바꿉니다.

kubectl cordon NODE_NAME

다음 명령을 사용하여 업그레이드하려는 노드를 드레이닝합니다. 노드 드레이닝에 대한 자세한 내용은 Kubernetes 설명서의 Safely Drain a Node을 참조하세요. NODE_NAME을 업그레이드하려는 하이브리드 노드의 이름으로 바꿉니다.

kubectl drain NODE_NAME --ignore-daemonsets --delete-emptydir-data

업그레이드하려는 하이브리드 노드에서 nodeadm upgrade를 실행합니다. root/sudo 권한이 있는 사용자와 함께 nodeadm을 실행해야 합니다. 노드 이름은 AWS SSM 및 AWS IAM Roles Anywhere 자격 증명 공급자 모두에 대한 업그레이드를 통해 보존됩니다. 업그레이드 프로세스 중에는 자격 증명 공급자를 변경할 수 없습니다. 하이브리드 노드 nodeadm 참조의 구성 값은 nodeConfig.yaml 섹션을 참조하세요. K8S_VERSION을 업그레이드할 대상 Kubernetes 버전으로 바꿉니다.

nodeadm upgrade K8S_VERSION -c file://nodeConfig.yaml

업그레이드한 후 노드에서 포드를 예약하도록 허용하려면 다음을 입력합니다. NODE_NAME을 노드의 이름으로 바꿉니다.

kubectl uncordon NODE_NAME

하이브리드 노드의 상태를 확인하고 노드가 종료될 때까지 기다렸다가 준비 상태로 새 Kubernetes 버전에서 다시 시작합니다.

kubectl get nodes -o wide -w