Це багатосторінковий друкований вигляд цього розділу. Натисність щоб друкувати.
Адміністрування кластера
1 - Адміністрування з kubeadm
Якщо у вас ще немає кластера, дивіться створення кластерів за допомогою kubeadm.
Завдання в цьому розділі призначені для тих, хто адмініструє наявний кластер:
1.1 - Оновлення вузлів Linux
Ця сторінка пояснює, як оновити робочі вузли Linux, створені за допомогою kubeadm.
Перш ніж ви розпочнете
Вам потрібен доступ до оболонки на всіх вузлах, а інструмент командного рядка kubectl має бути налаштований для звʼязку з вашим кластером. Рекомендується виконувати цей підручник у кластері, що має принаймні два вузли, які не є вузлами панелі управління.
Для перевірки версії введіть kubectl version.
- Ознайомтеся з процесом оновлення решти вашого кластера kubeadm. Вам потрібно буде спочатку оновити вузли панелі управління перед оновленням робочих вузлів Linux.
Зміна репозиторію пакунків
Якщо ви використовуєте репозиторії пакунків, що належать спільноті (pkgs.k8s.io), вам потрібно увімкнути репозиторій пакунків для потрібного мінорного релізу Kubernetes. Це пояснено в документі Зміна репозиторію пакунків Kubernetes.
apt.kubernetes.io та yum.kubernetes.io) визнані
застарілими та заморожені станом на 13 вересня 2023.
Наполегливо рекомендується використання нових репозиторіїв пакунків, розміщених за адресою pkgs.k8s.io,
які є обовʼязковими для встановлення версій Kubernetes, випущених після 13 вересня 2023 року.
Застарілі репозиторії та їх вміст можуть бути видалені у будь-який момент у майбутньому без попереднього повідомлення.
Нові репозиторії пакунків надають можливість завантаження версій Kubernetes, починаючи з v1.24.0.Оновлення робочих вузлів
Оновлення kubeadm та kubectl
Оновіть kubeadm та kubectl:
Примітка:
kubectl має бути в межах однієї мінорної версії від kube-apiserver згідно з політикою розбіжності версій. Якщо ви оновлюєте панель управління через кілька мінорних версій перед оновленням робочих вузлів, локальний kubectl на вузлі може вийти за межі дозволеної розбіжності. Оновлення kubectl разом з kubeadm тут гарантує, що він залишається в межах підтримуваного діапазону версій протягом усього процесу оновлення вузла.# замініть x у 1.37.x-* на останню версію патча
sudo apt-mark unhold kubeadm kubectl && \
sudo apt-get update && sudo apt-get install -y kubeadm='1.37.x-*' kubectl='1.37.x-*' && \
sudo apt-mark hold kubeadm kubectl
Для систем з DNF4 (Fedora < 41, RHEL/CentOS < 10):
# замініть x у 1.37.x-* на останню версію патча
sudo dnf install -y kubeadm-'1.37.x-*' kubectl-'1.37.x-*' --disableexcludes=kubernetes
Для систем з DNF5:
# замініть x у 1.37.x-* на останню версію патча
sudo dnf install -y kubeadm-'1.37.x-*' kubectl-'1.37.x-*' --setopt=disable_excludes=kubernetes
Виклик "kubeadm upgrade"
Для робочих вузлів це оновлює локальну конфігурацію kubelet:
sudo kubeadm upgrade node
Виконайте drain вузла
Підготуйте вузол до обслуговування, позначивши його як недоступний для планування та виселивши робочі навантаження:
# виконайте цю команду на вузлі панелі управління
# замініть <node-to-drain> імʼям вузла, для якого ви виконуєте drain
kubectl drain <node-to-drain> --ignore-daemonsets
Оновлення kubelet
Оновіть kubelet:
# замініть x у 1.37.x-* на останню версію патча sudo apt-mark unhold kubelet && \ sudo apt-get update && sudo apt-get install -y kubelet='1.37.x-*' && \ sudo apt-mark hold kubeletДля систем з DNF4 (Fedora < 41, RHEL/CentOS < 10):
# замініть x у 1.37.x-* на останню версію патча sudo dnf install -y kubelet-'1.37.x-*' --disableexcludes=kubernetesДля систем з DNF5:
# замініть x у 1.37.x-* на останню версію патча sudo dnf install -y kubelet-'1.37.x-*' --setopt=disable_excludes=kubernetesПерезапустіть kubelet:
sudo systemctl daemon-reload sudo systemctl restart kubelet
Виконайте uncordon вузла
Поверніть вузол в роботу, позначивши його як придатний для планування:
# виконайте цю команду на вузлі панелі управління
# замініть <node-to-uncordon> імʼям вашого вузла
kubectl uncordon <node-to-uncordon>
Що далі
- Подивіться, як оновити вузли Windows.
1.2 - Оновлення вузлів Windows
Ця сторінка пояснює, як оновити вузол Windows, створений за допомогою kubeadm.
Перш ніж ви розпочнете
Вам потрібен доступ до оболонки на всіх вузлах, а інструмент командного рядка kubectl має бути налаштований для звʼязку з вашим кластером. Рекомендується виконувати цей підручник у кластері, що має принаймні два вузли, які не є вузлами панелі управління.
Версія вашого Kubernetes сервера має бути не старішою ніж 1.17.Для перевірки версії введіть kubectl version.
- Ознайомтеся з процесом оновлення інших вузлів вашого кластера kubeadm. Вам слід оновити вузли панелі управління перед оновленням вузлів Windows.
Оновлення робочих вузлів
Оновлення kubeadm
З вузла Windows оновіть kubeadm:
# замініть 1.37.0 на вашу бажану версію curl.exe -Lo <path-to-kubeadm.exe> "https://dl.k8s.io/v1.37.0/bin/windows/amd64/kubeadm.exe"
Виконайте drain вузла
З машини з доступом до API Kubernetes підготуйте вузол до обслуговування, позначивши його як недоступний для планування та виселивши робочі навантаження:
# замініть <node-to-drain> імʼям вашого вузла, для якого ви виконуєте drain kubectl drain <node-to-drain> --ignore-daemonsetsВи повинні побачити подібний вивід:
node/ip-172-31-85-18 cordoned node/ip-172-31-85-18 drained
Оновлення конфігурації kubelet
З вузла Windows виконайте таку команду, щоб синхронізувати нову конфігурацію kubelet:
kubeadm upgrade node
Оновлення kubelet та kube-proxy
З вузла Windows оновіть та перезапустіть kubelet:
stop-service kubelet curl.exe -Lo <path-to-kubelet.exe> "https://dl.k8s.io/v1.37.0/bin/windows/amd64/kubelet.exe" restart-service kubeletЗ вузла Windows оновіть та перезапустіть kube-proxy.
stop-service kube-proxy curl.exe -Lo <path-to-kube-proxy.exe> "https://dl.k8s.io/v1.37.0/bin/windows/amd64/kube-proxy.exe" restart-service kube-proxy
Примітка:
Якщо ви запускаєте kube-proxy в контейнері HostProcess всередині Podʼа, а не як службу Windows, ви можете оновити kube-proxy, застосувавши нову версію ваших маніфестів kube-proxy.Виконайте uncordon вузла
З машини з доступом до API Kubernetes поверніть вузол в роботу, позначивши його як придатний для планування:
# замініть <node-to-drain> імʼям вашого вузла kubectl uncordon <node-to-drain>
Що далі
- Подивіться, як оновити вузли Linux.
2 - Міграція з dockershim
Цей розділ містить інформацію, яку вам потрібно знати під час міграції з dockershim на інші середовища виконання контейнерів.
Після оголошення про застарілість dockershim в Kubernetes 1.20, виникли питання, як це вплине на різні робочі навантаження та розгортання самого Kubernetes. Наш Dockershim Removal FAQ допоможе вам краще зрозуміти проблему.
Dockershim був видалений з Kubernetes з випуском v1.24. Якщо ви використовуєте Docker Engine через dockershim як своє середовище виконання контейнерів і хочете оновитись до v1.24, рекомендується або мігрувати на інше середовище виконання, або знайти альтернативний спосіб отримання підтримки Docker Engine. Ознайомтеся з розділом середовище виконання контейнерів, щоб дізнатися про ваші варіанти.
Версія Kubernetes з dockershim (1.23) вийшла зі стану підтримки, а v1.24 скоро вийде зі стану підтримки. Переконайтеся, що повідомляєте про проблеми з міграцією, щоб проблеми могли бути вчасно виправлені, і ваш кластер був готовий до видалення dockershim. Після виходу v1.24 зі стану підтримки вам доведеться звертатися до вашого постачальника Kubernetes за підтримкою або оновлювати кілька версій одночасно, якщо є критичні проблеми, які впливають на ваш кластер.
Ваш кластер може мати більше одного типу вузлів, хоча така конфігурація не є поширеною.
Ці завдання допоможуть вам здійснити міграцію:
- Перевірте, чи вас стосується видалення dockershim
- Міграція телеметрії та агентів безпеки з dockershim
Що далі
- Ознайомтеся з середовищами виконання контейнерів, щоб зрозуміти які з варіантів вам доступні.
- Якщо ви знайшли дефект або іншу технічну проблему, повʼязану з відмовою від dockershim, ви можете повідомити про проблему проєкту Kubernetes.
3 - Керування ресурсами памʼяті, CPU та API
4 - Встановлення постачальника мережевої політики
5 - Розробка Cloud Controller Manager
Cloud Controller Manager (cloud-controller-manager) є компонент панелі управління Kubernetes, що вбудовує логіку управління, специфічну для хмари. Cloud controller manager дозволяє звʼязувати ваш кластер з API хмарного провайдера та відокремлює компоненти, що взаємодіють із хмарною платформою, від компонентів, які взаємодіють тільки з вашим кластером.
Відокремлюючи логіку сумісності між Kubernetes і базовою хмарною інфраструктурою, компонент cloud-controller-manager дає змогу хмарним провайдерам випускати функції з іншою швидкістю порівняно з основним проєктом Kubernetes.
Контекст
Оскільки хмарні постачальники розробляють і випускають свої продукти в іншому темпі, ніж проєкт Kubernetes, винесення специфічного для постачальника коду в окремий бінарний файл cloud-controller-manager дає змогу хмарним постачальникам розвиватися незалежно від основного коду Kubernetes.
Проєкт Kubernetes надає кістяк коду cloud-controller-manager з інтерфейсами Go, щоб дозволити вам (або вашому постачальнику хмар) додати свої власні реалізації. Це означає, що постачальник хмар може реалізувати cloud-controller-manager, імпортуючи пакунки з ядра Kubernetes; кожен постачальник хмар буде реєструвати свій власний код, викликаючи cloudprovider.RegisterCloudProvider, щоб оновити глобальну змінну доступних постачальників хмар.
Розробка
Зовнішня реалізація
Для створення зовнішнього cloud-controller-manager для вашої хмари:
- Створіть пакунок Go з реалізацією, яка задовольняє cloudprovider.Interface.
- Використовуйте
main.goу cloud-controller-manager з ядра Kubernetes як шаблон для свогоmain.go. Як зазначено вище, єдина відмінність полягатиме у пакунку хмари, який буде імпортуватися. - Імпортуйте свій пакунок хмари в
main.go, переконайтеся, що ваш пакунок має блокinitдля запускуcloudprovider.RegisterCloudProvider.
Багато постачальників хмар публікують код свого менеджера контролерів як відкритий код. Якщо ви створюєте новий cloud-controller-manager з нуля, за відправну точку можна взяти наявний зовнішній cloud-controller-manager.
У коді Kubernetes
Для внутрішніх постачальників хмар можна запустити внутрішній cloud-controller-manager як DaemonSet у вашому кластері. Докладніше дивіться Адміністрування Cloud Controller Manager.
6 - Посилення безпеки динамічного виділення ресурсів у вашому кластері
Ця сторінка показує адміністраторам кластера, як посилити авторизацію для динамічного виділення ресурсів (DRA) з акцентом на доступ з мінімальними привілеями для оновлень статусу ResourceClaim.
Перш ніж ви розпочнете
Вам треба мати кластер Kubernetes, а також інструмент командного рядка kubectl має бути налаштований для роботи з вашим кластером. Рекомендується виконувати ці настанови у кластері, що має щонайменше два вузли, які не виконують роль вузлів управління. Якщо у вас немає кластера, ви можете створити його, за допомогою minikube або використовувати одну з цих пісочниць:
Для перевірки версії введіть
kubectl version.- У вашому кластері налаштовано динамічне виділення ресурсів.
- Ви можете редагувати ресурси RBAC та перезапускати або розгортати компоненти DRA.
Визначте компоненти DRA, які оновлюють статус
Задокументуйте, які ідентичності (зазвичай ServiceAccount) оновлюють статус ResourceClaim у вашому кластері. Типові компоненти, що записують статус:
- kube-scheduler або власний контролер виділення
- драйвери DRA, локальні для вузла
- багатовузлові контролери статусу DRA
Надання мінімально необхідних дозволів для синтетичних субресурсів
Починаючи з Kubernetes v1.36, оновлення статусу DRA вимагають дозволів на синтетичні субресурси на додаток до resourceclaims/status.
Надання дозволів для планувальника та контролера виділення
Застосуйте роль, яка дозволяє оновлення, повʼязані з привʼязкою:
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
name: dra-binding-updater
rules:
- apiGroups: ["resource.k8s.io"]
resources: ["resourceclaims/status"]
verbs: ["get", "patch", "update"]
- apiGroups: ["resource.k8s.io"]
resources: ["resourceclaims/binding"]
verbs: ["patch", "update"]
Надання дозволів для драйверів, локальних для вузла
Використовуйте вузлово-орієнтовані дієслова для драйверів, локальних для вузла:
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
name: dra-node-driver-status-updater
rules:
- apiGroups: ["resource.k8s.io"]
resources: ["resourceclaims/status"]
verbs: ["get", "patch", "update"]
- apiGroups: ["resource.k8s.io"]
resources: ["resourceclaims/driver"]
verbs: ["associated-node:patch", "associated-node:update"]
resourceNames: ["dra.example.com"]
Надання дозволів для багатовузлового контролера лише за потреби
Використовуйте arbitrary-node:* лише для компонентів, які повинні оновлювати статус з будь-якого вузла:
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
name: dra-multinode-status-updater
rules:
- apiGroups: ["resource.k8s.io"]
resources: ["resourceclaims/status"]
verbs: ["get", "patch", "update"]
- apiGroups: ["resource.k8s.io"]
resources: ["resourceclaims/driver"]
verbs: ["arbitrary-node:patch", "arbitrary-node:update"]
resourceNames: ["dra.example.com"]
Привʼязка ролей до конкретних ідентичностей
Створіть обʼєкти ClusterRoleBinding для кожної ідентичності компонента та уникайте спільного використання широкої ролі між не повʼязаними між собою компонентами DRA.
Обмежте правила resourceclaims/driver за допомогою resourceNames, де це можливо, щоб ідентичність могла оновлювати статус лише для конкретного драйвера DRA, яким вона керує.
Перевірка та моніторинг
- Перевірте, що кожна ідентичність має лише необхідні дієслова та субресурси.
- Підтвердіть, що оновлення статусу DRA працюють після розгортання.
- Спостерігайте за подіями аудиту API-сервера щодо відхилених запитів
resourceclaims/bindingтаresourceclaims/driver.
Що далі
7 - Використання CoreDNS для виявлення Service
Ця сторінка описує процес оновлення CoreDNS та як встановити CoreDNS.
Перш ніж ви розпочнете
Вам треба мати кластер Kubernetes, а також інструмент командного рядка kubectl має бути налаштований для роботи з вашим кластером. Рекомендується виконувати ці настанови у кластері, що має щонайменше два вузли, які не виконують роль вузлів управління. Якщо у вас немає кластера, ви можете створити його, за допомогою minikube або використовувати одну з цих пісочниць:
Версія вашого Kubernetes сервера має бути не старішою ніж v1.9.Для перевірки версії введіть kubectl version.
Про CoreDNS
CoreDNS — це гнучкий, розширюваний DNS-сервер, який є стандартною реалізацією DNS кластера Kubernetes. Як і Kubernetes, проєкт CoreDNS розміщено в CNCF.
Встановлення CoreDNS
Для ручного розгортання дивіться документацію на вебсайті CoreDNS.
Оновлення CoreDNS
Ви можете перевірити версію CoreDNS, яку kubeadm встановлює для кожної версії Kubernetes на сторінці Версія CoreDNS у Kubernetes.
CoreDNS можна оновити вручну, якщо ви хочете оновити лише CoreDNS або використати власний образ. Для плавного оновлення доступні корисні рекомендації та покрокова інструкція. Переконайтеся, що під час оновлення кластера наявна конфігурація CoreDNS ("Corefile") зберігається.
Якщо ви оновлюєте свій кластер за допомогою інструменту kubeadm, kubeadm може самостійно зберегти поточну конфігурацію CoreDNS.
Налаштування CoreDNS
Коли використання ресурсів має значення, може бути корисно налаштувати конфігурацію CoreDNS. Докладніше дивіться документацію з масштабування CoreDNS.
Що далі
Ви можете налаштувати CoreDNS для підтримки багатьох сценаріїв, окрім базового розвʼязання імен Service, змінивши конфігурацію CoreDNS ("Corefile"). Докладніше дивіться документацію втулка CoreDNS kubernetes або прочитайте Custom DNS Entries for Kubernetes у блозі CoreDNS.