Виселення, ініційоване API, — це процес, під час якого ви використовуєте Eviction API для створення обʼєкта Eviction, що запускає коректне завершення роботи Podʼа.
Ви можете ініціювати виселення, викликавши Eviction API безпосередньо або програмно,
використовуючи клієнт API-сервера, наприклад, команду kubectl drain. Це створює обʼєкт Eviction, що змушує API-сервер завершити роботу Podʼа.
Виселення, ініційовані API, враховують налаштовані вами PodDisruptionBudgets та terminationGracePeriodSeconds.
Використання API для створення обʼєкта Eviction для Podʼа схоже на виконання контрольованої політикою операції DELETE над Podʼом.
Ви можете використовувати клієнтську бібліотеку Kubernetes, щоб отримати доступ до API Kubernetes та створити обʼєкт Eviction. Для цього надішліть POST-запит на виконання операції, подібний до наведеного нижче прикладу:
{
"apiVersion": "policy/v1",
"kind": "Eviction",
"metadata": {
"name": "quux",
"namespace": "default"
}
}
Також ви можете спробувати виконати операцію виселення, звернувшись до API за допомогою curl або wget, як у наведеному нижче прикладі:
curl -v -H 'Content-type: application/json' https://your-cluster-api-endpoint.example/api/v1/namespaces/default/pods/quux/eviction -d @eviction.json
Коли ви запитуєте виселення за допомогою API, API-сервер виконує перевірки допуску і відповідає одним із таких способів:
200 OK: виселення дозволено, субресурс Eviction створюється, і Pod видаляється, подібно до надсилання DELETE-запиту на URL Podʼа.429 Too Many Requests: виселення на цей момент не дозволено через налаштований PodDisruptionBudget. Можливо, ви зможете спробувати виселення пізніше. Ви також можете отримати цю відповідь через обмеження швидкості API.500 Internal Server Error: виселення не дозволено через помилкову конфігурацію, наприклад, якщо декілька PodDisruptionBudget посилаються на той самий Pod.Якщо Pod, який ви хочете виселити, не є частиною робочого навантаження, яке має PodDisruptionBudget, API-сервер завжди повертає 200 OK та дозволяє виселення.
Якщо API-сервер дозволяє виселення, Pod видаляється так:
Pod в API-сервері оновлюється з часовою міткою видалення, після чого API-сервер вважає ресурс Pod таким, що завершив роботу. Ресурс Pod також позначений налаштованим періодом належного завершення роботи.Pod позначений для припинення та починає належним чином завершувати локальний Pod.Pod треба видалити.Pod.У деяких випадках ваші застосунки можуть потрапити в непрацездатний стан, де Eviction API буде повертати лише відповіді 429 або 500, поки ви не втрутитеся. Це може відбуватися, наприклад, якщо ReplicaSet створює Podʼи для вашого застосунку, але нові Podʼи не переходять в стан Ready. Ви також можете помітити цю поведінку у випадках, коли останній виселений Pod мав довгий період належного завершення роботи.
Якщо ви помічаєте застряглі виселення, спробуйте одне з таких рішень: