|
| 1 | +--- |
| 2 | +title: ネームスペースのデフォルトのメモリー要求と制限を設定する |
| 3 | +content_type: task |
| 4 | +weight: 10 |
| 5 | +description: >- |
| 6 | + ネームスペースのデフォルトのメモリーリソース制限を定義して、そのネームスペース内のすべての新しいPodにメモリーリソース制限が設定されるようにします。 |
| 7 | +--- |
| 8 | + |
| 9 | +<!-- overview --> |
| 10 | + |
| 11 | +このページでは、{{< glossary_tooltip text="ネームスペース" term_id="namespace" >}}のデフォルトのメモリー要求と制限を設定する方法を説明します。 |
| 12 | + |
| 13 | +Kubernetesクラスターはネームスペースに分割することができます。デフォルトのメモリー[制限](/ja/docs/concepts/configuration/manage-resources-containers/#requests-and-limits)を持つネームスペースがあり、独自のメモリー制限を指定しないコンテナでPodを作成しようとすると、{{< glossary_tooltip text="コントロールプレーン" term_id="control-plane" >}}はそのコンテナにデフォルトのメモリー制限を割り当てます。 |
| 14 | + |
| 15 | +Kubernetesは、このトピックで後ほど説明する特定の条件下で、デフォルトのメモリー要求を割り当てます。 |
| 16 | + |
| 17 | + |
| 18 | + |
| 19 | +## {{% heading "prerequisites" %}} |
| 20 | + |
| 21 | + |
| 22 | +{{< include "task-tutorial-prereqs.md" >}} |
| 23 | + |
| 24 | +クラスターにネームスペースを作成するには、アクセス権が必要です。 |
| 25 | + |
| 26 | +クラスターの各ノードには、最低でも2GiBのメモリーが必要です。 |
| 27 | + |
| 28 | + |
| 29 | + |
| 30 | +<!-- steps --> |
| 31 | + |
| 32 | +## ネームスペースの作成 |
| 33 | + |
| 34 | +この演習で作成したリソースがクラスターの他の部分から分離されるように、ネームスペースを作成します。 |
| 35 | + |
| 36 | +```shell |
| 37 | +kubectl create namespace default-mem-example |
| 38 | +``` |
| 39 | + |
| 40 | +## LimitRangeとPodの作成 |
| 41 | + |
| 42 | +以下は、{{< glossary_tooltip text="LimitRange" term_id="limitrange" >}}のマニフェストの例です。このマニフェストでは、デフォルトのメモリー要求とデフォルトのメモリー制限を指定しています。 |
| 43 | + |
| 44 | +{{< codenew file="admin/resource/memory-defaults.yaml" >}} |
| 45 | + |
| 46 | +default-mem-exampleネームスペースにLimitRangeを作成します: |
| 47 | + |
| 48 | +```shell |
| 49 | +kubectl apply -f https://k8s.io/examples/admin/resource/memory-defaults.yaml --namespace=default-mem-example |
| 50 | +``` |
| 51 | + |
| 52 | +default-mem-exampleネームスペースでPodを作成し、そのPod内のコンテナがメモリー要求とメモリー制限の値を独自に指定しない場合、{{< glossary_tooltip text="コントロールプレーン" term_id="control-plane" >}}はデフォルト値のメモリー要求256MiBとメモリー制限512MiBを適用します。 |
| 53 | + |
| 54 | +以下は、コンテナを1つ持つPodのマニフェストの例です。コンテナは、メモリー要求とメモリー制限を指定していません。 |
| 55 | + |
| 56 | +{{< codenew file="admin/resource/memory-defaults-pod.yaml" >}} |
| 57 | + |
| 58 | +Podを作成します: |
| 59 | + |
| 60 | +```shell |
| 61 | +kubectl apply -f https://k8s.io/examples/admin/resource/memory-defaults-pod.yaml --namespace=default-mem-example |
| 62 | +``` |
| 63 | + |
| 64 | +Podの詳細情報を表示します: |
| 65 | + |
| 66 | +```shell |
| 67 | +kubectl get pod default-mem-demo --output=yaml --namespace=default-mem-example |
| 68 | +``` |
| 69 | + |
| 70 | +この出力は、Podのコンテナのメモリー要求が256MiBで、メモリー制限が512MiBであることを示しています。 |
| 71 | +これらはLimitRangeで指定されたデフォルト値です。 |
| 72 | + |
| 73 | +```shell |
| 74 | +containers: |
| 75 | +- image: nginx |
| 76 | + imagePullPolicy: Always |
| 77 | + name: default-mem-demo-ctr |
| 78 | + resources: |
| 79 | + limits: |
| 80 | + memory: 512Mi |
| 81 | + requests: |
| 82 | + memory: 256Mi |
| 83 | +``` |
| 84 | + |
| 85 | +Podを削除します: |
| 86 | + |
| 87 | +```shell |
| 88 | +kubectl delete pod default-mem-demo --namespace=default-mem-example |
| 89 | +``` |
| 90 | + |
| 91 | +## コンテナの制限を指定し、要求を指定しない場合 |
| 92 | + |
| 93 | +以下は1つのコンテナを持つPodのマニフェストです。コンテナはメモリー制限を指定しますが、メモリー要求は指定しません。 |
| 94 | + |
| 95 | +{{< codenew file="admin/resource/memory-defaults-pod-2.yaml" >}} |
| 96 | + |
| 97 | +Podを作成します: |
| 98 | + |
| 99 | + |
| 100 | +```shell |
| 101 | +kubectl apply -f https://k8s.io/examples/admin/resource/memory-defaults-pod-2.yaml --namespace=default-mem-example |
| 102 | +``` |
| 103 | + |
| 104 | +Podの詳細情報を表示します: |
| 105 | + |
| 106 | +```shell |
| 107 | +kubectl get pod default-mem-demo-2 --output=yaml --namespace=default-mem-example |
| 108 | +``` |
| 109 | + |
| 110 | +この出力は、コンテナのメモリー要求がそのメモリー制限に一致するように設定されていることを示しています。 |
| 111 | +コンテナにはデフォルトのメモリー要求値である256Miが割り当てられていないことに注意してください。 |
| 112 | + |
| 113 | +``` |
| 114 | +resources: |
| 115 | + limits: |
| 116 | + memory: 1Gi |
| 117 | + requests: |
| 118 | + memory: 1Gi |
| 119 | +``` |
| 120 | + |
| 121 | +## コンテナの要求を指定し、制限を指定しない場合 |
| 122 | + |
| 123 | +1つのコンテナを持つPodのマニフェストです。コンテナはメモリー要求を指定しますが、メモリー制限は指定しません。 |
| 124 | + |
| 125 | +{{< codenew file="admin/resource/memory-defaults-pod-3.yaml" >}} |
| 126 | + |
| 127 | +Podを作成します: |
| 128 | + |
| 129 | +```shell |
| 130 | +kubectl apply -f https://k8s.io/examples/admin/resource/memory-defaults-pod-3.yaml --namespace=default-mem-example |
| 131 | +``` |
| 132 | + |
| 133 | +Podの詳細情報を表示します: |
| 134 | + |
| 135 | +```shell |
| 136 | +kubectl get pod default-mem-demo-3 --output=yaml --namespace=default-mem-example |
| 137 | +``` |
| 138 | + |
| 139 | +この出力は、コンテナのメモリー要求が、コンテナのマニフェストで指定された値に設定されていることを示しています。 |
| 140 | +コンテナは512MiB以下のメモリーを使用するように制限されていて、これはネームスペースのデフォルトのメモリー制限と一致します。 |
| 141 | + |
| 142 | +``` |
| 143 | +resources: |
| 144 | + limits: |
| 145 | + memory: 512Mi |
| 146 | + requests: |
| 147 | + memory: 128Mi |
| 148 | +``` |
| 149 | + |
| 150 | +## デフォルトのメモリー制限と要求の動機 |
| 151 | + |
| 152 | +ネームスペースにメモリー{{< glossary_tooltip text="リソースクォータ" term_id="resource-quota" >}}が設定されている場合、メモリー制限のデフォルト値を設定しておくと便利です。 |
| 153 | + |
| 154 | +以下はリソースクォータがネームスペースに課す制限のうちの2つです。 |
| 155 | + |
| 156 | +* ネームスペースで実行されるすべてのPodについて、Podとその各コンテナにメモリー制限を設ける必要があります(Pod内のすべてのコンテナに対してメモリー制限を指定すると、Kubernetesはそのコンテナの制限を合計することでPodレベルのメモリー制限を推測することができます)。 |
| 157 | +* メモリー制限は、当該Podがスケジュールされているノードのリソース予約を適用します。ネームスペース内のすべてのPodに対して予約されるメモリーの総量は、指定された制限を超えてはなりません。 |
| 158 | +* また、ネームスペース内のすべてのPodが実際に使用するメモリーの総量も、指定された制限を超えてはなりません。 |
| 159 | + |
| 160 | +LimitRangeの追加時: |
| 161 | + |
| 162 | +コンテナを含む、そのネームスペース内のいずれかのPodが独自のメモリー制限を指定していない場合、コントロールプレーンはそのコンテナにデフォルトのメモリー制限を適用し、メモリーのResourceQuotaによって制限されているネームスペース内でPodを実行できるようにします。 |
| 163 | + |
| 164 | +## クリーンアップ |
| 165 | + |
| 166 | +ネームスペースを削除します: |
| 167 | + |
| 168 | +```shell |
| 169 | +kubectl delete namespace default-mem-example |
| 170 | +``` |
| 171 | + |
| 172 | + |
| 173 | + |
| 174 | +## {{% heading "whatsnext" %}} |
| 175 | + |
| 176 | + |
| 177 | +### クラスター管理者向け |
| 178 | + |
| 179 | +* [Configure Default CPU Requests and Limits for a Namespace](/docs/tasks/administer-cluster/manage-resources/cpu-default-namespace/) |
| 180 | + |
| 181 | +* [Namespaceに対する最小および最大メモリー制約の構成](ja/docs/tasks/administer-cluster/manage-resources/memory-constraint-namespace/) |
| 182 | + |
| 183 | +* [Configure Minimum and Maximum CPU Constraints for a Namespace](/docs/tasks/administer-cluster/manage-resources/cpu-constraint-namespace/) |
| 184 | + |
| 185 | +* [Configure Memory and CPU Quotas for a Namespace](/docs/tasks/administer-cluster/manage-resources/quota-memory-cpu-namespace/) |
| 186 | + |
| 187 | +* [Configure a Pod Quota for a Namespace](/docs/tasks/administer-cluster/manage-resources/quota-pod-namespace/) |
| 188 | + |
| 189 | +* [Configure Quotas for API Objects](/docs/tasks/administer-cluster/quota-api-object/) |
| 190 | + |
| 191 | +### アプリケーション開発者向け |
| 192 | + |
| 193 | +* [コンテナおよびPodへのメモリーリソースの割り当て](ja/docs/tasks/configure-pod-container/assign-memory-resource/) |
| 194 | + |
| 195 | +* [コンテナおよびPodへのCPUリソースの割り当て](ja/docs/tasks/configure-pod-container/assign-cpu-resource/) |
| 196 | + |
| 197 | +* [PodにQuality of Serviceを設定する](ja/docs/tasks/configure-pod-container/quality-service-pod/) |
0 commit comments