Copy tasks/configure-pod-container/extended-resource.md from en/ directory.

2020-07-24 17:42:47 +09:00
parent 1e6f8a4a2c
commit 13fd6ad44b
1 changed files with 145 additions and 0 deletions
@@ -0,0 +1,145 @@
+---
+title: Assign Extended Resources to a Container
+content_type: task
+weight: 40
+---
+
+<!-- overview -->
+
+{{< feature-state state="stable" >}}
+
+This page shows how to assign extended resources to a Container.
+
+
+
+
+## {{% heading "prerequisites" %}}
+
+
+{{< include "task-tutorial-prereqs.md" >}} {{< version-check >}}
+
+Before you do this exercise, do the exercise in
+[Advertise Extended Resources for a Node](/docs/tasks/administer-cluster/extended-resource-node/).
+That will configure one of your Nodes to advertise a dongle resource.
+
+
+
+
+<!-- steps -->
+
+## Assign an extended resource to a Pod
+
+To request an extended resource, include the `resources:requests` field in your
+Container manifest. Extended resources are fully qualified with any domain outside of
+`*.kubernetes.io/`. Valid extended resource names have the form `example.com/foo` where
+`example.com` is replaced with your organization's domain and `foo` is a
+descriptive resource name.
+
+Here is the configuration file for a Pod that has one Container:
+
+{{< codenew file="pods/resource/extended-resource-pod.yaml" >}}
+
+In the configuration file, you can see that the Container requests 3 dongles.
+
+Create a Pod:
+
+```shell
+kubectl apply -f https://k8s.io/examples/pods/resource/extended-resource-pod.yaml
+```
+
+Verify that the Pod is running:
+
+```shell
+kubectl get pod extended-resource-demo
+```
+
+Describe the Pod:
+
+```shell
+kubectl describe pod extended-resource-demo
+```
+
+The output shows dongle requests:
+
+```yaml
+Limits:
+  example.com/dongle: 3
+Requests:
+  example.com/dongle: 3
+```
+
+## Attempt to create a second Pod
+
+Here is the configuration file for a Pod that has one Container. The Container requests
+two dongles.
+
+{{< codenew file="pods/resource/extended-resource-pod-2.yaml" >}}
+
+Kubernetes will not be able to satisfy the request for two dongles, because the first Pod
+used three of the four available dongles.
+
+Attempt to create a Pod:
+
+```shell
+kubectl apply -f https://k8s.io/examples/pods/resource/extended-resource-pod-2.yaml
+```
+
+Describe the Pod
+
+```shell
+kubectl describe pod extended-resource-demo-2
+```
+
+The output shows that the Pod cannot be scheduled, because there is no Node that has
+2 dongles available:
+
+
+```
+Conditions:
+  Type    Status
+  PodScheduled  False
+...
+Events:
+  ...
+  ... Warning   FailedScheduling  pod (extended-resource-demo-2) failed to fit in any node
+fit failure summary on nodes : Insufficient example.com/dongle (1)
+```
+
+View the Pod status:
+
+```shell
+kubectl get pod extended-resource-demo-2
+```
+
+The output shows that the Pod was created, but not scheduled to run on a Node.
+It has a status of Pending:
+
+```yaml
+NAME                       READY     STATUS    RESTARTS   AGE
+extended-resource-demo-2   0/1       Pending   0          6m
+```
+
+## Clean up
+
+Delete the Pods that you created for this exercise:
+
+```shell
+kubectl delete pod extended-resource-demo
+kubectl delete pod extended-resource-demo-2
+```
+
+
+
+## {{% heading "whatsnext" %}}
+
+
+### For application developers
+
+* [Assign Memory Resources to Containers and Pods](/docs/tasks/configure-pod-container/assign-memory-resource/)
+* [Assign CPU Resources to Containers and Pods](/docs/tasks/configure-pod-container/assign-cpu-resource/)
+
+### For cluster administrators
+
+* [Advertise Extended Resources for a Node](/docs/tasks/administer-cluster/extended-resource-node/)
+
+