这篇教程指导如何给容器分配申请的内存和内存限制。我们保证让容器获得足够的内存 资源,但是不允许它使用超过限制的资源。

Before you begin

You need to have a Kubernetes cluster, and the kubectl command-line tool must be configured to communicate with your cluster. If you do not already have a cluster, you can create one by using Minikube.

你的集群里每个节点至少必须拥有300M的内存。

这个教程里有几个步骤要求Heapster , 但是如果你没有Heapster的话,也可以完成大部分的实验,就算跳过这些Heapster 步骤,也不会有什么问题。

检查看Heapster服务是否运行,执行命令:

  1. kubectl get services --namespace=kube-system

如果Heapster服务正在运行,会有如下输出:

  1. NAMESPACE NAME CLUSTER-IP EXTERNAL-IP PORT(S) AGE
  2. kube-system heapster 10.11.240.9 <none> 80/TCP 6d

创建一个命名空间

创建命名空间,以便你在实验中创建的资源可以从集群的资源中隔离出来。

  1. kubectl create namespace mem-example

配置内存申请和限制

给容器配置内存申请,只要在容器的配置文件里添加resources:requests就可以了。配置限制的话, 则是添加resources:limits。

本实验,我们创建包含一个容器的Pod,这个容器申请100M的内存,并且内存限制设置为200M,下面 是配置文件:

memory-request-limit.yaml 给容器和Pod分配内存资源 - 图1
  1. apiVersion: v1
  2. kind: Pod
  3. metadata:
  4. name: memory-demo
  5. spec:
  6. containers:
  7. - name: memory-demo-ctr
  8. image: vish/stress
  9. resources:
  10. limits:
  11. memory: "200Mi"
  12. requests:
  13. memory: "100Mi"
  14. args:
  15. - -mem-total
  16. - 150Mi
  17. - -mem-alloc-size
  18. - 10Mi
  19. - -mem-alloc-sleep
  20. - 1s

在这个配置文件里,args代码段提供了容器所需的参数。-mem-total 150Mi告诉容器尝试申请150M 的内存。

创建Pod:

  1. kubectl create -f https://k8s.io/docs/tasks/configure-pod-container/memory-request-limit.yaml --namespace=mem-example

验证Pod的容器是否正常运行:

  1. kubectl get pod memory-demo --namespace=mem-example

查看Pod的详细信息:

  1. kubectl get pod memory-demo --output=yaml --namespace=mem-example

这个输出显示了Pod里的容器申请了100M的内存和200M的内存限制。

  1. ...
  2. resources:
  3. limits:
  4. memory: 200Mi
  5. requests:
  6. memory: 100Mi
  7. ...

启动proxy以便我们可以访问Heapster服务:

  1. kubectl proxy

在另外一个命令行窗口,从Heapster服务获取内存使用情况:

  1. curl http://localhost:8001/api/v1/proxy/namespaces/kube-system/services/heapster/api/v1/model/namespaces/mem-example/pods/memory-demo/metrics/memory/usage

这个输出显示了Pod正在使用162,900,000字节的内存,大概就是150M。这很明显超过了申请 的100M,但是还没达到200M的限制。

  1. {
  2. "timestamp": "2017-06-20T18:54:00Z",
  3. "value": 162856960
  4. }

删除Pod:

  1. kubectl delete pod memory-demo --namespace=mem-example

超出容器的内存限制

只要节点有足够的内存资源,那容器就可以使用超过其申请的内存,但是不允许容器使用超过其限制的 资源。如果容器分配了超过限制的内存,这个容器将会被优先结束。如果容器持续使用超过限制的内存, 这个容器就会被终结。如果一个结束的容器允许重启,kubelet就会重启他,但是会出现其他类型的运行错误。

本实验,我们创建一个Pod尝试分配超过其限制的内存,下面的这个Pod的配置文档,它申请50M的内存, 内存限制设置为100M。

memory-request-limit-2.yaml 给容器和Pod分配内存资源 - 图2
  1. apiVersion: v1
  2. kind: Pod
  3. metadata:
  4. name: memory-demo-2
  5. spec:
  6. containers:
  7. - name: memory-demo-2-ctr
  8. image: vish/stress
  9. resources:
  10. requests:
  11. memory: 50Mi
  12. limits:
  13. memory: "100Mi"
  14. args:
  15. - -mem-total
  16. - 250Mi
  17. - -mem-alloc-size
  18. - 10Mi
  19. - -mem-alloc-sleep
  20. - 1s

在配置文件里的args段里,可以看到容器尝试分配250M的内存,超过了限制的100M。

创建Pod:

  1. kubectl create -f https://k8s.io/docs/tasks/configure-pod-container/memory-request-limit-2.yaml --namespace=mem-example

查看Pod的详细信息:

  1. kubectl get pod memory-demo-2 --namespace=mem-example

这时候,容器可能会运行,也可能会被杀掉。如果容器还没被杀掉,重复之前的命令直至 你看到这个容器被杀掉:

  1. NAME READY STATUS RESTARTS AGE
  2. memory-demo-2 0/1 OOMKilled 1 24s

查看容器更详细的信息:

  1. kubectl get pod memory-demo-2 --output=yaml --namespace=mem-example

这个输出显示了容器被杀掉因为超出了内存限制。

  1. lastState:
  2. terminated:
  3. containerID: docker://65183c1877aaec2e8427bc95609cc52677a454b56fcb24340dbd22917c23b10f
  4. exitCode: 137
  5. finishedAt: 2017-06-20T20:52:19Z
  6. reason: OOMKilled
  7. startedAt: null

本实验里的容器可以自动重启,因此kubelet会再去启动它。输入多几次这个命令看看它是怎么 被杀掉又被启动的:

  1. kubectl get pod memory-demo-2 --namespace=mem-example

这个输出显示了容器被杀掉,被启动,又被杀掉,又被启动的过程:

  1. stevepe@sperry-1:~/steveperry-53.github.io$ kubectl get pod memory-demo-2 --namespace=mem-example
  2. NAME READY STATUS RESTARTS AGE
  3. memory-demo-2 0/1 OOMKilled 1 37s
  4. stevepe@sperry-1:~/steveperry-53.github.io$ kubectl get pod memory-demo-2 --namespace=mem-example
  5. NAME READY STATUS RESTARTS AGE
  6. memory-demo-2 1/1 Running 2 40s

查看Pod的历史详细信息:

  1. kubectl describe pod memory-demo-2 --namespace=mem-example

这个输出显示了Pod一直重复着被杀掉又被启动的过程:

  1. ... Normal Created Created container with id 66a3a20aa7980e61be4922780bf9d24d1a1d8b7395c09861225b0eba1b1f8511
  2. ... Warning BackOff Back-off restarting failed container
  3.  

查看集群里节点的详细信息:

  1. kubectl describe nodes

输出里面记录了容器被杀掉是因为一个超出内存的状况出现:

  1. Warning OOMKilling Memory cgroup out of memory: Kill process 4481 (stress) score 1994 or sacrifice child

删除Pod:

  1. kubectl delete pod memory-demo-2 --namespace=mem-example

配置超出节点能力范围的内存申请

内存的申请和限制是针对容器本身的,但是认为Pod也有容器的申请和限制是一个很有帮助的想法。 Pod申请的内存就是Pod里容器申请的内存总和,类似的,Pod的内存限制就是Pod里所有容器的 内存限制的总和。

Pod的调度策略是基于请求的,只有当节点满足Pod的内存申请时,才会将Pod调度到合适的节点上。

在这个实验里,我们创建一个申请超大内存的Pod,超过了集群里任何一个节点的可用内存资源。 这个容器申请了1000G的内存,这个应该会超过你集群里能提供的数量。

memory-request-limit-3.yaml 给容器和Pod分配内存资源 - 图3
  1. apiVersion: v1
  2. kind: Pod
  3. metadata:
  4. name: memory-demo-3
  5. spec:
  6. containers:
  7. - name: memory-demo-3-ctr
  8. image: vish/stress
  9. resources:
  10. limits:
  11. memory: "1000Gi"
  12. requests:
  13. memory: "1000Gi"
  14. args:
  15. - -mem-total
  16. - 150Mi
  17. - -mem-alloc-size
  18. - 10Mi
  19. - -mem-alloc-sleep
  20. - 1s

创建Pod:

  1. kubectl create -f https://k8s.io/docs/tasks/configure-pod-container/memory-request-limit-3.yaml --namespace=mem-example

查看Pod的状态:

  1. kubectl get pod memory-demo-3 --namespace=mem-example

输出显示Pod的状态是Pending,因为Pod不会被调度到任何节点,所有它会一直保持在Pending状态下。

  1. kubectl get pod memory-demo-3 --namespace=mem-example
  2. NAME READY STATUS RESTARTS AGE
  3. memory-demo-3 0/1 Pending 0 25s

查看Pod的详细信息包括事件记录

  1. kubectl describe pod memory-demo-3 --namespace=mem-example

这个输出显示容器不会被调度因为节点上没有足够的内存:

  1. Events:
  2. ... Reason Message
  3. ------ -------
  4. ... 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.比如,下面几种写法表示相同的数值:alue:

  1. 128974848, 129e6, 129M , 123Mi

删除Pod:

  1. kubectl delete pod memory-demo-3 --namespace=mem-example

如果不配置内存限制

如果不给容器配置内存限制,那下面的任意一种情况可能会出现:

  • 容器使用内存资源没有上限,容器可以使用当前节点上所有可用的内存资源。
  • 容器所运行的命名空间有默认内存限制,容器会自动继承默认的限制。集群管理员可以使用这个文档 LimitRange来配置默认的内存限制。

内存申请和限制的原因

通过配置容器的内存申请和限制,你可以更加有效充分的使用集群里内存资源。配置较少的内存申请, 可以让Pod跟任意被调度。设置超过内存申请的限制,可以达到以下效果:

  • Pod可以在负载高峰时更加充分利用内存。
  • 可以将Pod的内存使用限制在比较合理的范围。

清理

删除命名空间,这会顺便删除命名空间里的Pod。

  1. kubectl delete namespace mem-example

译者:NickSu86 原文链接

K8S中文社区微信公众号

原文: http://docs.kubernetes.org.cn/729.html