From df40d54f0bb5581cba108b47dc1730e40bd8c190 Mon Sep 17 00:00:00 2001 From: Qiming Date: Tue, 14 Nov 2017 07:01:44 +0800 Subject: [PATCH] Clarify GPU resource requests and limits (#6294) --- docs/tasks/manage-gpus/scheduling-gpus.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/tasks/manage-gpus/scheduling-gpus.md b/docs/tasks/manage-gpus/scheduling-gpus.md index fa701e4cfa..1d4b743fd3 100644 --- a/docs/tasks/manage-gpus/scheduling-gpus.md +++ b/docs/tasks/manage-gpus/scheduling-gpus.md @@ -48,7 +48,11 @@ spec: alpha.kubernetes.io/nvidia-gpu: 3 # requesting 3 GPUs ``` -- GPUs can be specified in the `limits` section only. +- GPUs are only supposed to be specified in the `limits` section, which means: + * You can specify GPU `limits` without specifying `requests` because Kubernetes + will use the limit as the request value by default. + * You can specify GPU in both `limits` and `requests` but these two values must equal. + * You cannot specify GPU `requests` without specifying `limits`. - Containers (and pods) do not share GPUs. - Each container can request one or more GPUs. - It is not possible to request a portion of a GPU.