{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"style":{"value":"none"}},"macroMetadata":{"macroId":{"value":"6cad5fe9-76f2-4f0a-a4fd-ffef1dfb96c2"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"e5ad2b7b-af64-4c72-8905-f1fffb85e51b"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Guide to Upgrading Kubernetes Configuration","type":"text"}]},{"type":"paragraph","content":[{"text":"Upgrading Kubernetes involves several key steps, including updating the control plane components (API server, etcd, controller manager, and scheduler), worker nodes (kubelet and kube-proxy), and updating any configuration files as needed. Below is a detailed guide to upgrading Kubernetes configuration safely and effectively.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Prerequisites","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Administrative access to the Kubernetes cluster","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"kubectl configured to interact with your cluster","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Backup of current cluster state and configurations","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Understanding of the current Kubernetes version and the target version","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step-by-Step Upgrade Process","type":"text","marks":[{"type":"strong"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"1. ","type":"text"},{"text":"Backup Existing Configuration and Data","type":"text","marks":[{"type":"strong"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Backup etcd Data:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On the master node, create a backup of etcd data.","type":"text"}]},{"type":"paragraph","content":[{"text":"Code: ","type":"text"},{"text":"ETCDCTL_API=3 etcdctl snapshot save snapshot.db","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Backup Kubernetes Manifests and Configurations:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Backup the ","type":"text"},{"text":"/etc/kubernetes","type":"text","marks":[{"type":"code"}]},{"text":" directory and any other relevant configuration files.","type":"text"}]},{"type":"paragraph","content":[{"text":"Code ","type":"text"},{"text":"sudo cp -r /etc/kubernetes /etc/kubernetes_backup_$(date +%Y%m%d)","type":"text","marks":[{"type":"code"}]}]}]}]}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":3},"content":[{"text":"2. ","type":"text"},{"text":"Upgrade Control Plane Components","type":"text","marks":[{"type":"strong"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Drain and Cordone the Master Node:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Ensure no workloads are running on the master node during the upgrade.","type":"text"}]},{"type":"paragraph","content":[{"text":"Code: ","type":"text"},{"text":"kubectl drain --ignore-daemonsets --delete-local-data kubectl cordon ","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Update kubeadm:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On the master node, upgrade kubeadm to the desired version.","type":"text"}]},{"type":"paragraph","content":[{"text":"Code: ","type":"text"},{"text":"sudo apt-get update && sudo apt-get install -y kubeadm=","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Upgrade the Control Plane:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Use kubeadm to upgrade the Kubernetes control plane components.","type":"text"}]},{"type":"paragraph","content":[{"text":"Code: ","type":"text"},{"text":"sudo kubeadm upgrade apply v","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Update kubelet and kubectl:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Upgrade kubelet and kubectl on the master node.","type":"text"}]},{"type":"paragraph","content":[{"text":"Code: ","type":"text"},{"text":"sudo apt-get update && sudo apt-get install -y kubelet= kubectl= sudo systemctl daemon-reload sudo systemctl restart kubelet","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Uncordon the Master Node:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Allow workloads to run on the master node again.","type":"text"}]},{"type":"paragraph","content":[{"text":"Code: ","type":"text"},{"text":"kubectl uncordon ","type":"text","marks":[{"type":"code"}]}]}]}]}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":3},"content":[{"text":"3. ","type":"text"},{"text":"Upgrade Worker Nodes","type":"text","marks":[{"type":"strong"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Drain the Worker Node:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Ensure no workloads are running on the worker node during the upgrade.","type":"text"}]}]}]}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":2}}],"content":[{"text":"Code: ","type":"text"},{"text":"kubectl drain --ignore-daemonsets --delete-local-data","type":"text","marks":[{"type":"code"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Update kubeadm on Worker Node:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Upgrade kubeadm to the desired version on the worker node.","type":"text"}]},{"type":"paragraph","content":[{"text":"Code: ","type":"text"},{"text":"sudo apt-get update && sudo apt-get install -y kubeadm=","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Upgrade the Node:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Use kubeadm to upgrade the Kubernetes components on the worker node.","type":"text"}]},{"type":"paragraph","content":[{"text":"Code: ","type":"text"},{"text":"sudo kubeadm upgrade node","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Update kubelet on Worker Node:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Upgrade kubelet on the worker node.","type":"text"}]},{"type":"paragraph","content":[{"text":"Code: ","type":"text"},{"text":"sudo apt-get update && sudo apt-get install -y kubelet= sudo systemctl daemon-reload sudo systemctl restart kubelet","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Uncordon the Worker Node:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Allow workloads to run on the worker node again.","type":"text"}]},{"type":"paragraph","content":[{"text":"Code: ","type":"text"},{"text":"kubectl uncordon ","type":"text","marks":[{"type":"code"}]}]}]}]}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":3},"content":[{"text":"4. ","type":"text"},{"text":"Update Kubernetes Configuration Files","type":"text","marks":[{"type":"strong"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Review and Update Configurations:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Review the configuration files (e.g., ","type":"text"},{"text":"kube-apiserver.yaml","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"kube-controller-manager.yaml","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"kube-scheduler.yaml","type":"text","marks":[{"type":"code"}]},{"text":", and ","type":"text"},{"text":"kubelet-config.yaml","type":"text","marks":[{"type":"code"}]},{"text":") and update them if necessary to reflect any new settings or deprecations.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Apply New Configurations:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Apply the updated configuration files using kubectl or by directly modifying the manifests in ","type":"text"},{"text":"/etc/kubernetes/manifests","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Restart Affected Components:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Restart any affected Kubernetes components to apply the new configurations.","type":"text"}]},{"type":"paragraph","content":[{"text":"Code: ","type":"text"},{"text":"sudo systemctl restart kubelet","type":"text","marks":[{"type":"code"}]}]}]}]}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":3},"content":[{"text":"5. ","type":"text"},{"text":"Verify the Upgrade","type":"text","marks":[{"type":"strong"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Check Cluster Status:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Verify that the Kubernetes cluster is healthy and running the desired version.","type":"text"}]},{"type":"paragraph","content":[{"text":"Code: ","type":"text"},{"text":"kubectl get nodes kubectl get pods --all-namespaces","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Monitor Logs:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Check the logs of critical components (API server, controller manager, scheduler, etcd) for any errors or warnings.","type":"text"}]},{"type":"paragraph","content":[{"text":"Code: ","type":"text"},{"text":"sudo journalctl -u kubelet -f","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Test Workloads:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Ensure that workloads are running correctly and that there are no issues with deployments, services, or other resources.","type":"text"}]}]}]}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":3},"content":[{"text":"6. ","type":"text"},{"text":"Post-Upgrade Tasks","type":"text","marks":[{"type":"strong"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Clean Up:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Remove any backup files or temporary data if everything is functioning correctly.","type":"text"}]},{"type":"paragraph","content":[{"text":"Code: ","type":"text"},{"text":"sudo rm -rf /etc/kubernetes_backup_$(date +%Y%m%d)","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Update Documentation:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Document the upgrade process, including any configuration changes and issues encountered, for future reference.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Regular Monitoring:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Continue to monitor the Kubernetes cluster to ensure it operates smoothly after the upgrade.","type":"text"}]}]}]}]}]},{"type":"paragraph"}],"version":1}

Browser not supported