Ця сторінка показує, як призначити контейнеру запит (request) та обмеження (limit) памʼяті. Контейнеру гарантовано стільки памʼяті, скільки він запитує, але йому не дозволено використовувати більше памʼяті, ніж дозволяє обмеження.
Вам треба мати кластер Kubernetes, а також інструмент командного рядка kubectl має бути налаштований для роботи з вашим кластером. Рекомендується виконувати ці настанови у кластері, що має щонайменше два вузли, які не виконують роль вузлів управління. Якщо у вас немає кластера, ви можете створити його, за допомогою minikube або використовувати одну з цих пісочниць:
Для перевірки версії введіть kubectl version.
Кожен вузол у вашому кластері повинен мати принаймні 300 MiB памʼяті.
Деякі кроки на цій сторінці потребують запуску metrics-server у вашому кластері. Якщо у вас уже працює metrics-server, ці кроки можна пропустити.
Якщо ви використовуєте Minikube, виконайте таку команду, щоб увімкнути metrics-server:
minikube addons enable metrics-server
Щоб перевірити, чи працює metrics-server або інший постачальник API метрик ресурсів (metrics.k8s.io), виконайте таку команду:
kubectl get apiservices
Якщо API метрик ресурсів доступне, вивід міститиме посилання на metrics.k8s.io.
NAME
v1beta1.metrics.k8s.io
Створіть простір імен, щоб ресурси, які ви створюєте в цій вправі, були ізольовані від решти кластера.
kubectl create namespace mem-example
Щоб вказати запит памʼяті для контейнера, додайте поле resources.requests.memory до маніфесту ресурсів контейнера. Щоб вказати обмеження памʼяті, додайте resources.limits.memory.
У цій вправі ви створюєте Pod з одним контейнером. Контейнер має запит памʼяті 100 MiB та обмеження памʼяті 200 MiB. Ось файл конфігурації Podʼа:
apiVersion: v1
kind: Pod
metadata:
name: memory-demo
namespace: mem-example
spec:
containers:
- name: memory-demo-ctr
image: polinux/stress
resources:
requests:
memory: "100Mi"
limits:
memory: "200Mi"
command: ["stress"]
args: ["--vm", "1", "--vm-bytes", "150M", "--vm-hang", "1"]
Розділ args у файлі конфігурації задає аргументи для контейнера під час його запуску. Аргументи "--vm-bytes", "150M" вказують контейнеру спробувати виділити 150 MiB памʼяті.
Створіть Pod:
kubectl apply -f https://k8s.io/examples/pods/resource/memory-request-limit.yaml --namespace=mem-example
Перевірте, що контейнер Podʼа працює:
kubectl get pod memory-demo --namespace=mem-example
Перегляньте детальну інформацію про Pod:
kubectl get pod memory-demo --output=yaml --namespace=mem-example
Вивід показує, що єдиний контейнер у Podʼі має запит памʼяті 100 MiB та обмеження памʼяті 200 MiB.
...
resources:
requests:
memory: 100Mi
limits:
memory: 200Mi
...
Виконайте команду kubectl top, щоб отримати метрики для Podʼа:
kubectl top pod memory-demo --namespace=mem-example
Вивід показує, що Pod використовує приблизно 162,900,000 байтів памʼяті, тобто близько 150 MiB. Це більше за запит Podʼа в 100 MiB, але в межах обмеження Podʼа у 200 MiB.
NAME CPU(cores) MEMORY(bytes)
memory-demo <something> 162856960
Видаліть свій Pod:
kubectl delete pod memory-demo --namespace=mem-example
Контейнер може перевищити свій запит памʼяті, якщо на вузлі є вільна памʼять. Але контейнеру не дозволено використовувати більше памʼяті, ніж дозволяє його обмеження. Якщо контейнер виділяє більше памʼяті, ніж дозволяє обмеження, він стає кандидатом на завершення. Якщо контейнер і далі споживає памʼять понад обмеження, його буде завершено. Якщо завершений контейнер можна перезапустити, kubelet перезапускає його, як і в разі будь-якого іншого збою під час виконання.
У цій вправі ви створюєте Pod, який намагається виділити більше памʼяті, ніж дозволяє його обмеження. Ось файл конфігурації Podʼа з одним контейнером із запитом памʼяті 50 MiB та обмеженням памʼяті 100 MiB:
apiVersion: v1
kind: Pod
metadata:
name: memory-demo-2
namespace: mem-example
spec:
containers:
- name: memory-demo-2-ctr
image: polinux/stress
resources:
requests:
memory: "50Mi"
limits:
memory: "100Mi"
command: ["stress"]
args: ["--vm", "1", "--vm-bytes", "250M", "--vm-hang", "1"]
У розділі args файлу конфігурації видно, що контейнер спробує виділити 250 MiB памʼяті, що значно перевищує обмеження в 100 MiB.
Створіть Pod:
kubectl apply -f https://k8s.io/examples/pods/resource/memory-request-limit-2.yaml --namespace=mem-example
Перегляньте детальну інформацію про Pod:
kubectl get pod memory-demo-2 --namespace=mem-example
На цей момент контейнер може працювати або бути знищеним. Повторіть попередню команду, доки контейнер не буде знищено:
NAME READY STATUS RESTARTS AGE
memory-demo-2 0/1 OOMKilled 1 24s
Отримайте більш детальний огляд стану контейнера:
kubectl get pod memory-demo-2 --output=yaml --namespace=mem-example
Вивід показує, що контейнер був знищений через вичерпання памʼяті (OOM):
lastState:
terminated:
containerID: 65183c1877aaec2e8427bc95609cc52677a454b56fcb24340dbd22917c23b10f
exitCode: 137
finishedAt: 2017-06-20T20:52:19Z
reason: OOMKilled
startedAt: null
Контейнер у цьому завданні може бути перезапущений, тому kubelet перезапускає його. Повторіть цю команду кілька разів, щоб переконатися, що контейнер постійно знищується та перезапускається:
kubectl get pod memory-demo-2 --namespace=mem-example
Вивід показує, що контейнер знищується, перезапускається, знищується знову, знову перезапускається і так далі:
kubectl get pod memory-demo-2 --namespace=mem-example
NAME READY STATUS RESTARTS AGE
memory-demo-2 0/1 OOMKilled 1 37s
kubectl get pod memory-demo-2 --namespace=mem-example
NAME READY STATUS RESTARTS AGE
memory-demo-2 1/1 Running 2 40s
Перегляньте детальну інформацію про історію Podʼа:
kubectl describe pod memory-demo-2 --namespace=mem-example
Вивід показує, що контейнер раз у раз запускається й завершується збоєм:
... Normal Created Created container with id 66a3a20aa7980e61be4922780bf9d24d1a1d8b7395c09861225b0eba1b1f8511
... Warning BackOff Back-off restarting failed container
Перегляньте детальну інформацію про вузли вашого кластера:
kubectl describe nodes
Вивід містить запис про знищення контейнера через умову вичерпання памʼяті:
Warning OOMKilling Memory cgroup out of memory: Kill process 4481 (stress) score 1994 or sacrifice child
Видаліть свій Pod:
kubectl delete pod memory-demo-2 --namespace=mem-example
Запити й обмеження памʼяті повʼязані з контейнерами, але корисно уявляти, що запит і обмеження памʼяті має Pod. Запит памʼяті для Podʼа — це сума запитів памʼяті всіх контейнерів у Podʼі. Так само обмеження памʼяті для Podʼа — це сума обмежень усіх контейнерів у Podʼі.
Планування Podʼа ґрунтується на запитах. Pod призначається для запуску на вузол, лише якщо на вузлі достатньо вільної памʼяті, щоб задовольнити запит памʼяті Podʼа.
У цій вправі ви створюєте Pod із запитом памʼяті настільки великим, що він перевищує місткість будь-якого вузла у вашому кластері. Ось файл конфігурації Podʼа з одним контейнером, який запитує 1000 GiB памʼяті, що, найімовірніше, перевищує місткість будь-якого вузла у вашому кластері.
apiVersion: v1
kind: Pod
metadata:
name: memory-demo-3
namespace: mem-example
spec:
containers:
- name: memory-demo-3-ctr
image: polinux/stress
resources:
requests:
memory: "1000Gi"
limits:
memory: "1000Gi"
command: ["stress"]
args: ["--vm", "1", "--vm-bytes", "150M", "--vm-hang", "1"]
Створіть Pod:
kubectl apply -f https://k8s.io/examples/pods/resource/memory-request-limit-3.yaml --namespace=mem-example
Перегляньте статус Podʼа:
kubectl get pod memory-demo-3 --namespace=mem-example
Вивід показує, що статус Podʼа — PENDING. Це означає, що Pod не заплановано для запуску на жодному вузлі, і він залишатиметься у стані PENDING безстроково:
kubectl get pod memory-demo-3 --namespace=mem-example
NAME READY STATUS RESTARTS AGE
memory-demo-3 0/1 Pending 0 25s
Перегляньте детальну інформацію про Pod, включаючи події:
kubectl describe pod memory-demo-3 --namespace=mem-example
Вивід показує, що контейнер не може бути запланований через нестачу памʼяті на вузлах:
Events:
... Reason Message
------ -------
... FailedScheduling No nodes are available that match all of the following predicates:: Insufficient memory (3).
Ресурс памʼяті вимірюється в байтах. Памʼять можна вказати як звичайне ціле число або як число з фіксованою комою з одним із таких суфіксів: E, P, T, G, M, K, Ei, Pi, Ti, Gi, Mi, Ki. Наприклад, такі значення приблизно однакові:
128974848, 129e6, 129M, 123Mi
Видаліть свій Pod:
kubectl delete pod memory-demo-3 --namespace=mem-example
Якщо ви не вказуєте обмеження памʼяті для контейнера, можлива одна з таких ситуацій:
Контейнер не має верхньої межі обсягу памʼяті, яку він використовує. Контейнер може використати всю памʼять, доступну на вузлі, де він працює, що, своєю чергою, може викликати OOM Killer. Крім того, у разі OOM Kill контейнер без обмежень ресурсів має більше шансів бути знищеним.
Контейнер працює в просторі імен, що має стандартне обмеження памʼяті, і контейнеру автоматично призначається це стандартне обмеження. Адміністратори кластера можуть використовувати LimitRange, щоб задати стандартне значення обмеження памʼяті.
Налаштувавши запити й обмеження памʼяті для контейнерів, що працюють у вашому кластері, можна ефективно використовувати ресурси памʼяті, доступні на вузлах кластера. Тримаючи запит памʼяті Podʼа низьким, ви даєте Podʼу добрі шанси бути запланованим. Маючи обмеження памʼяті, більше за запит памʼяті, ви досягаєте двох речей:
Видаліть простір імен. Це видалить всі Podʼи, які ви створили для цього завдання:
kubectl delete namespace mem-example
Налаштування стандартних запитів і обмежень памʼяті для простору імен
Налаштування стандартних запитів і обмежень CPU для простору імен
Налаштування мінімальних і максимальних обмежень памʼяті для простору імен
Налаштування мінімальних і максимальних обмежень CPU для простору імен
Зміна розміру ресурсів CPU та памʼяті, призначених контейнерам