Skip to content

[ja] Translate content/en/docs/concepts/configuration/windows-resource-management.md into Japanese #51279

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: main
Choose a base branch
from

Conversation

kimitoboku
Copy link

Description
Translated content/en/docs/concepts/configuration/windows-resource-management.md into Japanese.

Issue
Closes: #51278

/area localization
/language ja

@k8s-ci-robot k8s-ci-robot added area/localization General issues or PRs related to localization language/ja Issues or PRs related to Japanese language cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. labels Jun 16, 2025
@k8s-ci-robot
Copy link
Contributor

Welcome @kimitoboku!

It looks like this is your first PR to kubernetes/website 🎉. Please refer to our pull request process documentation to help your PR have a smooth ride to approval.

You will be prompted by a bot to use commands during the review process. Do not be afraid to follow the prompts! It is okay to experiment. Here is the bot commands documentation.

You can also check if kubernetes/website has its own contribution guidelines.

You may want to refer to our testing guide if you run into trouble with your tests not passing.

If you are having difficulty getting your pull request seen, please follow the recommended escalation practices. Also, for tips and tricks in the contribution process you may want to read the Kubernetes contributor cheat sheet. We want to make sure your contribution gets all the attention it needs!

Thank you, and welcome to Kubernetes. 😃

@k8s-ci-robot k8s-ci-robot requested a review from b1gb4by June 16, 2025 12:34
@k8s-ci-robot k8s-ci-robot added the sig/docs Categorizes an issue or PR as relevant to SIG Docs. label Jun 16, 2025
@k8s-ci-robot k8s-ci-robot requested a review from nasa9084 June 16, 2025 12:34
@k8s-ci-robot k8s-ci-robot added the size/M Denotes a PR that changes 30-99 lines, ignoring generated files. label Jun 16, 2025
Copy link

netlify bot commented Jun 16, 2025

Pull request preview available for checking

Built without sensitive environment variables

Name Link
🔨 Latest commit 68d0d30
🔍 Latest deploy log https://app.netlify.com/projects/kubernetes-io-main-staging/deploys/685012bb2300260008c00537
😎 Deploy Preview https://deploy-preview-51279--kubernetes-io-main-staging.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@kimitoboku kimitoboku requested a review from nasa9084 June 16, 2025 12:49
@nasa9084
Copy link
Member

/lgtm
/assign @Okabe-Junya

thank you for contributing, welcome ;)

@k8s-ci-robot k8s-ci-robot added the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Jun 16, 2025
@kimitoboku kimitoboku changed the title [ja] Translated Translated content/en/docs/concepts/configuration/windows-resource-management.md into Japanese [ja] Translated content/en/docs/concepts/configuration/windows-resource-management.md into Japanese Jun 16, 2025
@Okabe-Junya
Copy link
Member

/retitle [ja] Translate content/en/docs/concepts/configuration/windows-resource-management.md into Japanese

@k8s-ci-robot k8s-ci-robot changed the title [ja] Translated content/en/docs/concepts/configuration/windows-resource-management.md into Japanese [ja] Translate content/en/docs/concepts/configuration/windows-resource-management.md into Japanese Jun 16, 2025
@Okabe-Junya
Copy link
Member

Copy link
Member

@Okabe-Junya Okabe-Junya left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

コントリビューションありがとうございます!
いくつかコメントしたので確認・修正をお願いします


Linuxノードでは、{{< glossary_tooltip text="cgroups" term_id="cgroup" >}} がリソース管理のPodの境界として使われています。
コンテナはネットワーク、プロセス、ファイルシステムが分離された境界内に作成されます。
Linux cgroup APIsを利用して、CPU, IO、メモリの統計情報を収集することが出来ます。
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Linux cgroup APIsを利用して、CPU, IO、メモリの統計情報を収集することが出来ます
Linux cgroup APIを利用して、CPUIO、メモリの統計情報を収集することができます

c.f. https://kubernetes.io/ja/docs/contribute/localization

, ->

〇、〇、〇(※列挙はすべて読点で統一)

APIs -> API

またこれらの単語は、複数形ではなく単数形を用います。 例えば、原文に"pods"と表記されている場合でも、日本語訳では"Pod"と表記してください。

コンテナはネットワーク、プロセス、ファイルシステムが分離された境界内に作成されます。
Linux cgroup APIsを利用して、CPU, IO、メモリの統計情報を収集することが出来ます。

対照的に、Windows は、システム名前空間フィルターを使用してコンテナごとに[_job object_](https://learn.microsoft.com/ja-jp/windows/win32/procthread/job-objects)を利用し、すべてのプロセスをコンテナ内に含めて、ホストからの論理的な分離を実現しています。
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
対照的に、Windows は、システム名前空間フィルターを使用してコンテナごとに[_job object_](https://learn.microsoft.com/ja-jp/windows/win32/procthread/job-objects)を利用し、すべてのプロセスをコンテナ内に含めて、ホストからの論理的な分離を実現しています。
対照的にWindowsは、システム名前空間フィルターを使用してコンテナごとに[_job object_](https://learn.microsoft.com/ja-jp/windows/win32/procthread/job-objects)を利用し、すべてのプロセスをコンテナ内に含めて、ホストからの論理的な分離を実現しています。

https://kubernetes.io/ja/docs/contribute/localization/#style-guide

英単語と日本語の間に半角スペースは不要

コンテナはネットワーク、プロセス、ファイルシステムが分離された境界内に作成されます。
Linux cgroup APIsを利用して、CPU, IO、メモリの統計情報を収集することが出来ます。

対照的に、Windows は、システム名前空間フィルターを使用してコンテナごとに[_job object_](https://learn.microsoft.com/ja-jp/windows/win32/procthread/job-objects)を利用し、すべてのプロセスをコンテナ内に含めて、ホストからの論理的な分離を実現しています。
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
対照的に、Windows は、システム名前空間フィルターを使用してコンテナごとに[_job object_](https://learn.microsoft.com/ja-jp/windows/win32/procthread/job-objects)を利用し、すべてのプロセスをコンテナ内に含めて、ホストからの論理的な分離を実現しています。
対照的に、Windows は、システム名前空間フィルターを使用してコンテナごとに[_ジョブオブジェクト_](https://learn.microsoft.com/ja-jp/windows/win32/procthread/job-objects)を利用し、すべてのプロセスをコンテナ内に含めて、ホストからの論理的な分離を実現しています。

リンク先の(おそらく機械翻訳された)ページをどこまで信用するかによりますが、リンク先のタイトルである ジョブオブジェクト に合わせて良いと思いました

Linux cgroup APIsを利用して、CPU, IO、メモリの統計情報を収集することが出来ます。

対照的に、Windows は、システム名前空間フィルターを使用してコンテナごとに[_job object_](https://learn.microsoft.com/ja-jp/windows/win32/procthread/job-objects)を利用し、すべてのプロセスをコンテナ内に含めて、ホストからの論理的な分離を実現しています。
(JobオブジェクトはWindowsのプロセス分離のための機構であり、Kubernetesの{{< glossary_tooltip term_id="job" text="Job" >}}とは異なります。)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
(JobオブジェクトはWindowsのプロセス分離のための機構であり、Kubernetesの{{< glossary_tooltip term_id="job" text="Job" >}}とは異なります。)
(ジョブオブジェクトはWindowsのプロセス分離のための機構であり、Kubernetesの{{< glossary_tooltip term_id="job" text="Job" >}}とは異なります。)

"Job" 表記だと(k8s Jobとの)ミスリーティングに繋がるので、カタカナ表記にしていただきたいです
(↑と同じ)

対照的に、Windows は、システム名前空間フィルターを使用してコンテナごとに[_job object_](https://learn.microsoft.com/ja-jp/windows/win32/procthread/job-objects)を利用し、すべてのプロセスをコンテナ内に含めて、ホストからの論理的な分離を実現しています。
(JobオブジェクトはWindowsのプロセス分離のための機構であり、Kubernetesの{{< glossary_tooltip term_id="job" text="Job" >}}とは異なります。)

Windowsコンテナではネームスペースフィルタリングを行わずに実行する方法はありません。
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Windowsコンテナではネームスペースフィルタリングを行わずに実行する方法はありません
Windowsコンテナでは名前空間のフィルタリングを行わずに実行する方法はありません

名前空間 / ネームスペースで表記揺れしていそうなので統一していただきたいです(Windowsのドキュメントに準拠するなら名前空間で良いかと思います)

## メモリ管理 {#resource-management-memory}

WindowsではLinuxのようなOut-of-Memoryによるプロセスの終了は提供されていません。
Windowsではすべてのユーザモードでのメモリアロケーションを仮想的に取り扱います、そのためpagefilesが必ず必要になります。
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Windowsではすべてのユーザモードでのメモリアロケーションを仮想的に取り扱います、そのためpagefilesが必ず必要になります
Windowsではすべてのユーザモードでのメモリアロケーションを仮想的に取り扱います。
そのためpagefilesが必ず必要になります。

IMO: 原文では , and ... と続いていますが、日本語では文を区切った方が読みやすいように感じました

WindowsではLinuxのようなOut-of-Memoryによるプロセスの終了は提供されていません。
Windowsではすべてのユーザモードでのメモリアロケーションを仮想的に取り扱います、そのためpagefilesが必ず必要になります。

Windowsノードではプロセスのメモリオーバコミットを行いません。
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Windowsノードではプロセスのメモリオーバコミットを行いません
Windowsノードではプロセスのメモリオーバーコミットを行いません

ref. https://kubernetes.io/ja/docs/contribute/localization/#long-vowel

-er、-or、-ar、-cy、-gyで終わる単語は長音を付与する
例: 「クラスター」「セレクター」「サイドカー」「ポリシー」「トポロジー」


Windowsは様々なプロセスに割り当てるCPU時間を制限することは出来ますが、最小限のCPU時間を保証することは出来ません。

Windowsでは、 kubeletプロセスの `--windows-priorityclass` コマンドラインフラグによる [scheduling priority](https://learn.microsoft.com/ja-jp/windows/win32/procthread/scheduling-priorities) の設定をサポートしています。
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Windowsでは、 kubeletプロセスの `--windows-priorityclass` コマンドラインフラグによる [scheduling priority](https://learn.microsoft.com/ja-jp/windows/win32/procthread/scheduling-priorities) の設定をサポートしています。
Windowsでは、kubeletプロセスの`--windows-priorityclass`コマンドラインフラグによる[scheduling priority](https://learn.microsoft.com/ja-jp/windows/win32/procthread/scheduling-priorities)の設定をサポートしています。


Windowsでは、 kubeletプロセスの `--windows-priorityclass` コマンドラインフラグによる [scheduling priority](https://learn.microsoft.com/ja-jp/windows/win32/procthread/scheduling-priorities) の設定をサポートしています。
このフラグによりkubeletプロセスは同じWindowsホスト上で動作している他のプロセスと比べて多くのCPU時間のスライスを得ることが出来ます。
許容される値とその意味に関する詳細は [Windows Priority Classes](https://docs.microsoft.com/ja-jp/windows/win32/procthread/scheduling-priorities#priority-class) を参照して下さい。
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
許容される値とその意味に関する詳細は [Windows Priority Classes](https://docs.microsoft.com/ja-jp/windows/win32/procthread/scheduling-priorities#priority-class) を参照して下さい。
許容される値とその意味に関する詳細は[Windows Priority Classes](https://docs.microsoft.com/ja-jp/windows/win32/procthread/scheduling-priorities#priority-class)を参照して下さい。

Windowsでは、 kubeletプロセスの `--windows-priorityclass` コマンドラインフラグによる [scheduling priority](https://learn.microsoft.com/ja-jp/windows/win32/procthread/scheduling-priorities) の設定をサポートしています。
このフラグによりkubeletプロセスは同じWindowsホスト上で動作している他のプロセスと比べて多くのCPU時間のスライスを得ることが出来ます。
許容される値とその意味に関する詳細は [Windows Priority Classes](https://docs.microsoft.com/ja-jp/windows/win32/procthread/scheduling-priorities#priority-class) を参照して下さい。
実行中のPodによりkubeletのCPUサイクルが不足しないためには、このフラグを `ABOVE_NORMAL_PRIORITY_CLASS` 以上に設定して下さい。
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
実行中のPodによりkubeletのCPUサイクルが不足しないためには、このフラグを `ABOVE_NORMAL_PRIORITY_CLASS` 以上に設定して下さい。
実行中のPodによりkubeletのCPUサイクルが不足しないためには、このフラグを`ABOVE_NORMAL_PRIORITY_CLASS`以上に設定して下さい。

(以下のセクションも同様に不要な空白を削除してください)

https://kubernetes.io/ja/docs/contribute/localization/#basic-policy

英単語と日本語の間に半角スペースは不要

  • 例: Kubernetesクラスター
    • カッコ()の前後にも半角スペースは不要

@k8s-ci-robot
Copy link
Contributor

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please ask for approval from nasa9084. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@Okabe-Junya
Copy link
Member

Okabe-Junya commented Jun 16, 2025

/lgtm cancel
(since some changes are required to merge)
/label tide/merge-method-squash

@k8s-ci-robot k8s-ci-robot added tide/merge-method-squash Denotes a PR that should be squashed by tide when it merges. and removed lgtm "Looks good to me", indicates that a PR is ready to be merged. labels Jun 16, 2025
@k8s-ci-robot k8s-ci-robot requested a review from Okabe-Junya June 16, 2025 14:44
Comment on lines +46 to +51
オペレーティングシステムやコンテナランタイム、kubeletのようなKubernetesのホストプロセスによって利用されるCPUやメモリを考慮するために、kubeletの `--kube-reserved` や `--system-reserved` フラグを利用して、リソースを予約することが出来ます(また、予約する必要もあります)。
Windowsではこれらの値はノードの [allocatable](/docs/tasks/administer-cluster/reserve-compute-resources/#node-allocatable) リソースの計算のみに利用されます。

{{< caution >}}
ワークロードをデプロイする時に、コンテナにメモリとCPUの制限を設定して下さい。
これにより、 `NodeAllocatable` が減少し、クラスタ全体のスケジューラーがどのPodをどのノードに配置するかの決定に役立ちます。
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
オペレーティングシステムやコンテナランタイム、kubeletのようなKubernetesのホストプロセスによって利用されるCPUやメモリを考慮するために、kubeletの `--kube-reserved``--system-reserved` フラグを利用して、リソースを予約することが出来ますまた、予約する必要もあります
Windowsではこれらの値はノードの [allocatable](/docs/tasks/administer-cluster/reserve-compute-resources/#node-allocatable) リソースの計算のみに利用されます。
{{< caution >}}
ワークロードをデプロイする時に、コンテナにメモリとCPUの制限を設定して下さい。
これにより、 `NodeAllocatable` が減少し、クラスタ全体のスケジューラーがどのPodをどのノードに配置するかの決定に役立ちます。
オペレーティングシステムやコンテナランタイム、kubeletのようなKubernetesのホストプロセスによって利用されるCPUやメモリを考慮するために、kubeletの`--kube-reserved``--system-reserved`フラグを利用して、リソースを予約することが出来ます(また、予約する必要もあります)
Windowsではこれらの値はノードの[allocatable](/docs/tasks/administer-cluster/reserve-compute-resources/#node-allocatable)リソースの計算のみに利用されます。
{{< caution >}}
ワークロードをデプロイする時に、コンテナにメモリとCPUの制限を設定して下さい。
これにより、`NodeAllocatable`が減少し、クラスタ全体のスケジューラーがどのPodをどのノードに配置するかの決定に役立ちます。

体裁だけ少しいじりました。
括弧は半角で固定だった気がします。

記号類は感嘆符「!」と疑問符「?」のみ全角、それ以外は半角で表記


## メモリ管理 {#resource-management-memory}

WindowsではLinuxのようなOut-of-Memoryによるプロセスの終了は提供されていません。
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
WindowsではLinuxのようなOut-of-Memoryによるプロセスの終了は提供されていません。
WindowsではLinuxのようなOut-Of-Memoryによるプロセスの終了は提供されていません。

下のほうにOut-Of-Memory(OOM)とあるので、あわせました

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

一般的に Out-of-memory と表記する印象がある(ターミナルなどへの出力もこの表記だったはず)なので、Out-of-memory の方が良いかもしれませんね。とはいえnitpick なのでどちらでも良いと思います。

ただ、指摘していただいた通り、少なくともページ内での表記は一貫して欲しいです(他の用語も同様)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area/localization General issues or PRs related to localization cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. language/ja Issues or PRs related to Japanese language sig/docs Categorizes an issue or PR as relevant to SIG Docs. size/M Denotes a PR that changes 30-99 lines, ignoring generated files. tide/merge-method-squash Denotes a PR that should be squashed by tide when it merges.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

[ja] Translate docs/concepts/configuration/windows-resource-management.md into Japanese
5 participants