whentimeslows/website
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Translate concepts/policy/limit-range into Japanese.

Browse Source
This commit is contained in:
TAKAHASHI Shuuji
2020-07-29 18:41:18 +09:00
parent 143d27a6fc
commit aaeb478b2e
1 changed files with 31 additions and 39 deletions
Download Patch File Download Diff File Expand all files Collapse all files
content/ja/docs/concepts/policy/limit-range.md
+31 -39
View File
@@ -1,65 +1,57 @@
--- ---
reviewers: title: Limit Range
- nelvadas
title: Limit Ranges
content_type: concept content_type: concept
weight: 10 weight: 10
--- ---
<!-- overview --> <!-- overview -->
By default, containers run with unbounded [compute resources](/docs/concepts/configuration/manage-resources-containers/) on a Kubernetes cluster. デフォルトでは、コンテナは、Kubernetesクラスター上の[計算リソース](/docs/concepts/configuration/manage-resources-containers/)の消費を制限されずに実行されます。リソースクォータを利用すれば、クラスター管理者はリソースの消費と作成を{{< glossary_tooltip text="名前空間" term_id="namespace" >}}ベースで制限することができます。名前空間内では、Podやコンテナは名前空間のリソースクォータで定義された範囲内でできるだけ多くのCPUとメモリを消費できてしまうため、1つのPodまたはコンテナが利用可能なすべてのリソースを専有してしまう恐れがあります。LimitRangeを利用すれば、このような名前空間内での(Podやコンテナへの)リソースの割り当てを制限するポリシーを定めることができます。
With resource quotas, cluster administrators can restrict resource consumption and creation on a {{< glossary_tooltip text="namespace" term_id="namespace" >}} basis.
Within a namespace, a Pod or Container can consume as much CPU and memory as defined by the namespace's resource quota. There is a concern that one Pod or Container could monopolize all available resources. A LimitRange is a policy to constrain resource allocations (to Pods or Containers) in a namespace.
<!-- body --> <!-- body -->
A _LimitRange_ provides constraints that can: *LimitRange*を利用すると、次のような制約を課せるようになります。
- Enforce minimum and maximum compute resources usage per Pod or Container in a namespace. - 名前空間内のPodまたはコンテナごとに、計算リソースの使用量の最小値と最大値を強制する。
- Enforce minimum and maximum storage request per PersistentVolumeClaim in a namespace. - 名前空間内のPersistentVolumeClaimごとに、ストレージリクエストの使用量の最小値と最大値を強制する。
- Enforce a ratio between request and limit for a resource in a namespace. - 名前空間内で、リソースのrequestとlimitの割合を強制する
- Set default request/limit for compute resources in a namespace and automatically inject them to Containers at runtime. - 名前空間内の計算リソースのデフォルトのrequest/limitの値を設定して、実行時にコンテナに自動的に注入する。
## Enabling LimitRange ## LimitRangeを有効にする
LimitRange support has been enabled by default since Kubernetes 1.10. Kubernetes 1.10以降では、LimitRangeのサポートはデフォルトで有効になりました。
A LimitRange is enforced in a particular namespace when there is a LimitRangeが特定の名前空間内で強制されるのは、その名前空間内にLimitRangeオブジェクトが存在する場合です。
LimitRange object in that namespace.
The name of a LimitRange object must be a valid LimitRangeオブジェクトの名前は、有効な[DNSサブドメイン名](/ja/docs/concepts/overview/working-with-objects/names#dns-subdomain-names)でなければなりません。
[DNS subdomain name](/docs/concepts/overview/working-with-objects/names#dns-subdomain-names).
### Overview of Limit Range ### Limit Rangeの概要
- The administrator creates one LimitRange in one namespace. - 管理者は、1つの名前空間に1つのLimitRangeを作成します。
- Users create resources like Pods, Containers, and PersistentVolumeClaims in the namespace. - ユーザーは、Pod、コンテナ、PersistentVolumeClaimsのようなリソースを名前空間内に作成します。
- The `LimitRanger` admission controller enforces defaults and limits for all Pods and Containers that do not set compute resource requirements and tracks usage to ensure it does not exceed resource minimum, maximum and ratio defined in any LimitRange present in the namespace. - `LimitRanger` admissionコントローラーは、計算リソース要求が設定されていないすべてのPodとコンテナに対して、デフォルト値と制限値を強制します。そして、リソースの使用量を追跡し、名前空間内に存在するすべてのLimitRangeで定義された最小値、最大値、割合を外れないことを保証します。
- If creating or updating a resource (Pod, Container, PersistentVolumeClaim) that violates a LimitRange constraint, the request to the API server will fail with an HTTP status code `403 FORBIDDEN` and a message explaining the constraint that have been violated. - LimitRangeの制約を破るようなリソース(Pod、コンテナ、PersistentVolumeClaim)の作成や更新を行うと、APIサーバーへのリクエストがHTTPステータスコード`403 FORBIDDEN`で失敗し、破られた制約を説明するメッセージが返されます。
- If a LimitRange is activated in a namespace for compute resources like `cpu` and `memory`, users must specify - 名前空間内でLimitRangeが`cpu`や`memory`などの計算リソースに対して有効になっている場合、ユーザーはrequestsやlimitsに値を指定しなければなりません。指定しなかった場合、システムはPodの作成を拒否する可能性があります。
requests or limits for those values. Otherwise, the system may reject Pod creation. - LimitRangeの制約違反は、PodのAdmissionステージでのみ発生し、Running状態のPodでは発生しせん。
- LimitRange validations occurs only at Pod Admission stage, not on Running Pods.
Examples of policies that could be created using limit range are: 以下は、LimitRangeを使用して作成できるポリシーの例です。
- In a 2 node cluster with a capacity of 8 GiB RAM and 16 cores, constrain Pods in a namespace to request 100m of CPU with a max limit of 500m for CPU and request 200Mi for Memory with a max limit of 600Mi for Memory. - 8GiBのRAMと16コアのCPUの容量がある2ノードのクラスター上で、名前空間内のPodに対して、CPUには100mのrequestと最大500mのlimitの制約を課し、メモリには200Miのrequestと600Miのlimitの制約を課す。
- Define default CPU limit and request to 150m and memory default request to 300Mi for Containers started with no cpu and memory requests in their specs. - Spec内のrequestsにcpuやmemoryを指定せずに起動したコンテナに対して、CPUにはデフォルトで150mのlimitとrequestを、メモリにはデフォルトで300Miのrequestをそれぞれ定義する。
In the case where the total limits of the namespace is less than the sum of the limits of the Pods/Containers, 名前空間のlimitの合計が、Podやコンテナのlimitの合計よりも小さくなる場合、リソースの競合が起こる可能性があります。その場合、コンテナやPodは作成されません。
there may be contention for resources. In this case, the Containers or Pods will not be created.
Neither contention nor changes to a LimitRange will affect already created resources. LimitRangeに対する競合や変更は、すでに作成済みのリソースに対しては影響しません。
## {{% heading "whatsnext" %}} ## {{% heading "whatsnext" %}}
Refer to the [LimitRanger design document](https://git.k8s.io/community/contributors/design-proposals/resource-management/admission_control_limit_range.md) for more information. より詳しい情報は、[LimitRangerの設計ドキュメント](https://git.k8s.io/community/contributors/design-proposals/resource-management/admission_control_limit_range.md)を参照してください。
For examples on using limits, see: 制限の使用例については、以下のページを読んでください。
- [how to configure minimum and maximum CPU constraints per namespace](/docs/tasks/administer-cluster/manage-resources/cpu-constraint-namespace/). - [名前空間ごとにCPUの最小値と最大値の制約を設定する方法](/docs/tasks/administer-cluster/manage-resources/cpu-constraint-namespace/)。
- [how to configure minimum and maximum Memory constraints per namespace](/docs/tasks/administer-cluster/manage-resources/memory-constraint-namespace/). - [名前空間ごとにメモリの最小値と最大値の制約を設定する方法](/docs/tasks/administer-cluster/manage-resources/memory-constraint-namespace/)。
- [how to configure default CPU Requests and Limits per namespace](/docs/tasks/administer-cluster/manage-resources/cpu-default-namespace/). - [名前空間ごとにCPUのRequestとLimitのデフォルト値を設定する方法](/docs/tasks/administer-cluster/manage-resources/cpu-default-namespace/)。
- [how to configure default Memory Requests and Limits per namespace](/docs/tasks/administer-cluster/manage-resources/memory-default-namespace/). - [名前空間ごとにメモリのRequestとLimitのデフォルト値を設定する方法](/docs/tasks/administer-cluster/manage-resources/memory-default-namespace/)。
- [how to configure minimum and maximum Storage consumption per namespace](/docs/tasks/administer-cluster/limit-storage-consumption/#limitrange-to-limit-requests-for-storage). - [名前空間ごとにストレージ消費量の最小値と最大値を設定する方法](/docs/tasks/administer-cluster/limit-storage-consumption/#limitrange-to-limit-requests-for-storage)。
- a [detailed example on configuring quota per namespace](/docs/tasks/administer-cluster/manage-resources/quota-memory-cpu-namespace/). - [名前空間ごとのクォータを設定する詳細な例](/docs/tasks/administer-cluster/manage-resources/quota-memory-cpu-namespace/)。