First Japanese l10n work for release-1.15. (#17693)

* traslate /docs/concepts/architecture/_index.md into Japanese (#15456)

* tranaslated (#15458)

* translate /ja/docs/reference/_index.md (#15624)

* translate /ja/docs/reference/_index.md

* Update content/ja/docs/reference/_index.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/reference/_index.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/reference/_index.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* patch reviews

* Follow the dir structure of en in setup (#15590)

* follow the dir structure of en in setup

* delete unrelated files

* wip removing ja

* removeg ja

* remove ja

* Update content/ja/docs/setup/_index.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* review

* numbered list

* Update content/ja/docs/setup/_index.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/setup/_index.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Translate /docs/setup/turnkey/aws.md in Japanese (#15640)

* Translate content/ja/docs/setup/turnkey/aws.md

partially

* Update content/ja/docs/setup/turnkey/aws.md

... Kubernetes cluster on AWS: AWS上でKubernetesクラスターを...
https://github.com/kubernetes/website/pull/15640/files#r310338415

Co-Authored-By: Kohei Ota <kohei.ota@zozo.com>

* Update content/ja/docs/setup/turnkey/aws.md (Kubernetes Operations)

- replace English commas with Japanese one (、)
- Management: 管理

Co-Authored-By: Kohei Ota <kohei.ota@zozo.com>

* Update content/ja/docs/setup/turnkey/aws.md (kube-aws)

- replace English commas
- insert a Japanese comma

Co-Authored-By: Kohei Ota <kohei.ota@zozo.com>

* Update content/ja/docs/setup/turnkey/aws.md (kubectl)

- 断定でなく選択を与えるニュアンス

Co-Authored-By: Kohei Ota <kohei.ota@zozo.com>

* Translate content/ja/docs/setup/turnkey/aws.md

completely

Signed-off-by: Takuma Hashimoto <takumaxd+github@gmail.com>

* fix translation

https://github.com/kubernetes/website/pull/15640#discussion_r310418805
自身がsupportするのでなく、Kubernetes Operationsがsupportしている、というニュアンス

Signed-off-by: Takuma Hashimoto <takumaxd+github@gmail.com>

* fix mistranslation

https://github.com/kubernetes/website/pull/15640#discussion_r310419122
ここでのwithはusingに近い意味合いで

Signed-off-by: Takuma Hashimoto <takumaxd+github@gmail.com>

* fix translation

https://github.com/kubernetes/website/pull/15640#discussion_r310568505
ここでのthroughは通過や媒介という意味合いよりも、手段を表すと捉える

Signed-off-by: Takuma Hashimoto <takumaxd+github@gmail.com>

* Update content/ja/docs/setup/turnkey/aws.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/setup/production-environment/turnkey/aws.md

Co-Authored-By: Tim Bannister <tim@scalefactory.com>

* Translate docs/tutorials/stateless-application/expose-external-ip-address.md in Japanese (#15672)

* Copy from content/ja/docs/tutorials/stateless-application/

Signed-off-by: Takuma Hashimoto <takumaxd+github@gmail.com>

* update link to Japanese document

Signed-off-by: Takuma Hashimoto <takumaxd+github@gmail.com>

* Translate expose-external-ip-address in Japanese

Signed-off-by: Takuma Hashimoto <takumaxd+github@gmail.com>

* Update content/ja/docs/tutorials/stateless-application/expose-external-ip-address.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/tutorials/stateless-application/expose-external-ip-address.md

やや不自然だった

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/tutorials/stateless-application/expose-external-ip-address.md

s/ロードバランサ/ロードバランサー/

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/tutorials/stateless-application/expose-external-ip-address.md

s/サーバ/サーバー/

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Revert "update link to Japanese document"

This reverts commit 9237f63402b0e642600d1ea24c6b410f877c165e.
https://github.com/kubernetes/website/pull/15672#discussion_r311327200

* remove a new line

段落としては同じ

* Update content/ja/docs/tutorials/stateless-application/expose-external-ip-address.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/tutorials/stateless-application/expose-external-ip-address.md

https://github.com/kubernetes/website/pull/15672#discussion_r312317653

* Update content/ja/docs/tutorials/stateless-application/expose-external-ip-address.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/tutorials/stateless-application/expose-external-ip-address.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Translate concepts/architecture/nodes.md into Japanese (#15625)

* Translate concepts/architecture/nodes.md into Japanese

* update translation

* fix translation

* eviction

* Update content/ja/docs/concepts/architecture/nodes.md

Co-Authored-By: makocchi <makocchi@gmail.com>

* Update content/ja/docs/concepts/architecture/nodes.md

Co-Authored-By: makocchi <makocchi@gmail.com>

* plural

* review

* node

* Update content/ja/docs/concepts/architecture/nodes.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/nodes.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/nodes.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/nodes.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/nodes.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/nodes.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/nodes.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/nodes.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/nodes.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/nodes.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/nodes.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/nodes.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/nodes.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/nodes.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/nodes.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/nodes.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/nodes.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/nodes.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* healthy

* review

* namespace

* Translate tasks/run-application/force-delete-stateful-set-pod/ in Japanese (#15835)

* ja-trans: tasks/run-application/force-delete-stateful-set-pod/

* Update content/ja/docs/tasks/run-application/force-delete-stateful-set-pod.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/tasks/run-application/force-delete-stateful-set-pod.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/tasks/run-application/force-delete-stateful-set-pod.md

* Update content/ja/docs/tasks/run-application/force-delete-stateful-set-pod.md

* Translate concepts/architecture/master-node-communication.md into Japanese (#15638)

* translate master node communication

* Update content/ja/docs/concepts/architecture/master-node-communication.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/master-node-communication.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/master-node-communication.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/master-node-communication.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/master-node-communication.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/master-node-communication.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/master-node-communication.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/master-node-communication.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/master-node-communication.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* deprecated

* Update content/ja/docs/concepts/architecture/master-node-communication.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/master-node-communication.md

Co-Authored-By: Takuya Tokuda <cs.toku.mail@gmail.com>

* Update content/ja/docs/concepts/architecture/master-node-communication.md

Co-Authored-By: Takuya Tokuda <cs.toku.mail@gmail.com>

* Update content/ja/docs/concepts/architecture/master-node-communication.md

Co-Authored-By: Takuya Tokuda <cs.toku.mail@gmail.com>

* Translate /docs/tasks/tools/install-kubectl.md in Japanese (#15678)

* Copy from content/en/docs/tasks/tools/install-kubectl.md

Signed-off-by: Takuma Hashimoto <takumaxd+github@gmail.com>

* fix link to install-kubectl

Signed-off-by: Takuma Hashimoto <takumaxd+github@gmail.com>

* Translate Headings and Subheadings

Signed-off-by: Takuma Hashimoto <takumaxd+github@gmail.com>

* translate text of install-kubectl in Japanese

Signed-off-by: Takuma Hashimoto <takumaxd+github@gmail.com>

* Update content/ja/docs/tasks/tools/install-kubectl.md

s/ユーザ/ユーザー/

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/tasks/tools/install-kubectl.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update install-kubectl.md

s/する:/してください:/g

* Translate /docs/tutorials/configuration/configure-redis-using-configmap.md in Japanese  (#15639)

* translate redis example

* add index

* Update content/ja/docs/tutorials/configuration/configure-redis-using-configmap.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/tutorials/configuration/configure-redis-using-configmap.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/tutorials/configuration/configure-redis-using-configmap.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* review

* Translate docs/concepts/configuration/overview.md in Japanese  (#15627)

* Translate docs/concepts/configuration/overview.md in Japanese

* Update content/ja/docs/concepts/configuration/overview.md

Co-Authored-By: Tim Bannister <tim@scalefactory.com>

* Update content/ja/docs/concepts/configuration/overview.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/configuration/overview.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/configuration/overview.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/configuration/overview.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Fix terminology in Japanese translation (#15889)

* cluster

* cluster

* node

* cluster

* Update content/ja/docs/tutorials/kubernetes-basics/deploy-app/deploy-intro.html

Co-Authored-By: Takuya Tokuda <cs.toku.mail@gmail.com>

* sitemap and search (#15927)

* Translate tasks/debug-application-cluster/debug-pod-replication-contr… (#15883)

* Translate tasks/debug-application-cluster/debug-pod-replication-controller/ in Japanese

* Update content/ja/docs/tasks/debug-application-cluster/debug-pod-replication-controller.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/tasks/debug-application-cluster/debug-pod-replication-controller.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/tasks/debug-application-cluster/debug-pod-replication-controller.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* fix missing parenthesis (#16044)

```
Error: Error building site: "/src/content/ja/docs/tasks/debug-application-cluster/debug-pod-replication-controller.md:106:10": unrecognized character in shortcode action: U+003E '>'. Note: Parameters with non-alphanumeric args must be quoted
```

* Translate tasks/configure-pod-container/configure-volume-storage/ in Japanese (#16058)

* Translate tasks/configure-pod-container/configure-volume-storage/ in Japanese

* Update content/ja/docs/tasks/configure-pod-container/configure-volume-storage.md

Co-Authored-By: inductor <kohei.ota@zozo.com>

* Update content/ja/docs/tasks/configure-pod-container/configure-volume-storage.md

Co-Authored-By: inductor <kohei.ota@zozo.com>

* Translate text of docs/setup/release/version-skew-policy.md in Japanese (#15903)

* translate content/ja/docs/setup/release/version-skew-policy.md in Japanese

* translate "version skew"

https://github.com/kubernetes/website/pull/15903#issuecomment-524518826

バージョン間の差異 となる
タイトルは原文どおりに用語として残し、初回の文でskew=差異であることを明示する
以降はskewを翻訳する

* fix translation

- 格助詞漏れ
- more than 1...は1を含まないそれ以上の値であり、実質「2以上」となるので、そのように訳したほうが自然

* delete unnecessary sentences

* update translation

cf. 422f5b0e6a0c52f844cfae66cde01f47fca4cf4e

* update translation

componentsが当該バージョンをサポートするのでなく、kube-apiserverのバージョンの結果ほかのcomponentsが当該バージョンをサポート**される**イメージ

* Translate concepts/architecture/cloud-controller/ into Japanese (#16099)

* Translate concepts/architecture/cloud-controller/ into Japanese

* Revise sentences based on suggestion by reviewers

* Revise a sentence based on suggestion by a reviewer

* Fix wording to distinguish Kubernetes related resources from others

* fix a typo (#16121)

* fix some wording on home (#16127)

* Translate contribute / _index.md to Japanese (#16050)

* translate contribute index into Japanese

* modify some terms

* modify according to style guide

* use same terminology about contribute

* Update content/ja/docs/contribute/_index.md

Co-Authored-By: Takuya Tokuda <cs.toku.mail@gmail.com>

* Translate concepts/overview/components and related glossaries in Japanase (#16034)

* Translate concepts/overview/components and related glossaries in Japanese

* Revise sentences based on suggestion by reviewers

* Translate tasks/configure-pod-container/assign-memory-resource/ in Japanese (#16055)

* copy from content/en/docs/tasks/configure-pod-container/assign-memory-resource to ja directory

* translate tasks/configure-pod-container/assign-memory-resource/ in Japanese

* Update content/ja/docs/tasks/configure-pod-container/_index.md

Co-Authored-By: inductor <kohei.ota@zozo.com>

* Update content/ja/docs/tasks/configure-pod-container/_index.md

Co-Authored-By: inductor <kohei.ota@zozo.com>

* fix translation

%s/メモリ/メモリー/g

* Translate tasks/access-application-cluster/communicate-containers-same-pod-shared-volume/ in Japanese (#16183)

* Translate concepts/configuration/assign-pod-node/ in Japanese (#16221)

* issue 15552

* Update content/ja/docs/concepts/configuration/assign-pod-node.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/configuration/assign-pod-node.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/configuration/assign-pod-node.md

Co-Authored-By: Naoki Oketani <okepy.naoki@gmail.com>

* Update content/ja/docs/concepts/configuration/assign-pod-node.md

Co-Authored-By: Naoki Oketani <okepy.naoki@gmail.com>

* Update content/ja/docs/concepts/configuration/assign-pod-node.md

Co-Authored-By: Naoki Oketani <okepy.naoki@gmail.com>

* Update content/ja/docs/concepts/configuration/assign-pod-node.md

Co-Authored-By: Naoki Oketani <okepy.naoki@gmail.com>

* Update content/ja/docs/concepts/configuration/assign-pod-node.md

Co-Authored-By: Naoki Oketani <okepy.naoki@gmail.com>

* Update content/ja/docs/concepts/configuration/assign-pod-node.md

Co-Authored-By: Naoki Oketani <okepy.naoki@gmail.com>

* Update content/ja/docs/concepts/configuration/assign-pod-node.md

Co-Authored-By: Naoki Oketani <okepy.naoki@gmail.com>

* Update content/ja/docs/concepts/configuration/assign-pod-node.md

Co-Authored-By: Naoki Oketani <okepy.naoki@gmail.com>

* modification after a review

* Translate docs/tasks/administer-cluster/developing-cloud-controller-manager in ja (#16088)

* Translate docs/tasks/administer-cluster/developing-cloud-controller-manager/ in Japanese

* Update content/ja/docs/tasks/administer-cluster/developing-cloud-controller-manager.md

Co-Authored-By: inductor <kohei.ota@zozo.com>

* Update content/ja/docs/tasks/administer-cluster/developing-cloud-controller-manager.md

Co-Authored-By: inductor <kohei.ota@zozo.com>

* Update content/ja/docs/tasks/administer-cluster/developing-cloud-controller-manager.md

Co-Authored-By: inductor <kohei.ota@zozo.com>

* Update content/ja/docs/tasks/administer-cluster/developing-cloud-controller-manager.md

Co-Authored-By: inductor <kohei.ota@zozo.com>

* Remove reviewers section

* Modified wording to unified

* Remove unnecessary brackets

* Translate concepts/overview/working-with-objects/object-management/ into Japanese (#16400)

* Translate concepts/overview/working-with-objects/object-management/ into Japanese

* Refine some words based on review comments

* Add a word to refine a sentence based on a review comment

* Translate content/ja/docs/concepts/cluster-administration/controller-… (#16351)

* Translate content/ja/docs/concepts/cluster-administration/controller-metrics in ja

* Improved to format a text

* Fix inconsistent spellings

* Update content/ja/docs/concepts/cluster-administration/controller-metrics.md

Co-Authored-By: Naoki Oketani <okepy.naoki@gmail.com>

* Update content/ja/docs/concepts/cluster-administration/controller-metrics.md

Co-Authored-By: Naoki Oketani <okepy.naoki@gmail.com>

* Translate concepts/extend-kubernetes/extend-cluster/ and related glossaries into Japanese (#16636)

* Translate concepts/extend-kubernetes/extend-cluster/ and related glossaries into Japanese

* Apply suggestions from code review by inductor

Co-Authored-By: inductor <kohei.ota@zozo.com>

* Update a translation for extension point

* Apply suggestions from code review by sftim

Co-Authored-By: Tim Bannister <tim@scalefactory.com>

* Apply suggestions from code review by sftim

* Fix the translation for document

* Apply a suggestion from code review by nasa9084

* Apply suggestions from code review by inductor and nasa9084

* fix: s/kubernetes/Kubernetes/ (#16057)

* Translate reference/command-line-tools-reference/feature-gates in Japanese (#16554)

* Translate docs/reference/command-line-tools-reference/feature-gates in ja

* Fix inconsistent spellings

* Update content/ja/docs/reference/command-line-tools-reference/feature-gates.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/reference/command-line-tools-reference/feature-gates.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/reference/command-line-tools-reference/feature-gates.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/reference/command-line-tools-reference/feature-gates.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/reference/command-line-tools-reference/feature-gates.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/reference/command-line-tools-reference/feature-gates.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/reference/command-line-tools-reference/feature-gates.md

Co-Authored-By: Naoki Oketani <okepy.naoki@gmail.com>

* Update content/ja/docs/reference/command-line-tools-reference/feature-gates.md

Co-Authored-By: Naoki Oketani <okepy.naoki@gmail.com>

* Update content/ja/docs/reference/command-line-tools-reference/feature-gates.md

Co-Authored-By: Naoki Oketani <okepy.naoki@gmail.com>

* ポッド -> Pod

* Update content/ja/docs/reference/command-line-tools-reference/feature-gates.md

Co-Authored-By: Naoki Oketani <okepy.naoki@gmail.com>

* Update content/ja/docs/reference/command-line-tools-reference/feature-gates.md

Co-Authored-By: Naoki Oketani <okepy.naoki@gmail.com>

* ポッドreadinessゲート -> Pod readiness gate

* ポッド -> pod

* Pods -> Pod

* Fix typo: Kunbernetes -> Kubernetes

* 機能ゲート -> フィーチャーゲート

* リポジトリ -> リポジトリー

* キー=値 -> key=value

* Translate concepts/storage/volume-pvc-datasource in Japanese (#16775)

* Translate concepts/storage/volume-pvc-datasource in Japanese

* Remove original English contents(forgot to remove)

* Container Storage Interface -> コンテナストレージインターフェイス

* フューチャーゲート -> フィーチャーゲート

* Improved a translate to more natural expression

* Update content/ja/docs/reference/glossary/csi.md

Co-Authored-By: inductor <kohei.ota@zozo.com>

* Update content/ja/docs/reference/glossary/storage-class.md

Co-Authored-By: inductor <kohei.ota@zozo.com>

* Update content/ja/docs/reference/glossary/storage-class.md

Co-Authored-By: inductor <kohei.ota@zozo.com>

* Update content/ja/docs/reference/glossary/storage-class.md

Co-Authored-By: inductor <kohei.ota@zozo.com>

* Update content/ja/docs/reference/glossary/storage-class.md

Co-Authored-By: inductor <kohei.ota@zozo.com>

* Update content/ja/docs/reference/glossary/storage-class.md

Co-Authored-By: inductor <kohei.ota@zozo.com>

* Improved a translate to more natural expression

* Remove an unnecessary line break

* Improved some translate words to natural sentence

* Improved translate

* Fix translate

* Translate docs/reference/glossary/selector.md in Japanese (#17375)

* Translate docs/reference/glossary/selector.md in Japanese

* Translate title into Japanese

Co-Authored-By: bells17 <bells171@gmail.com>

* Translate tasks/configure-pod-container/share-process-namespace/ into Japanese (#16220)

* Translate tasks/configure-pod-container/share-process-namespace/ into Japanese

* reflect review

* Translate tasks/access-application-cluster/connecting-frontend-backend/ into Japanese (#16270)

* Translate tasks/access-application-cluster/connecting-frontend-backend/ into Japanese

* reflect review

* translate tooltip text

Co-Authored-By: bells17 <bells171@gmail.com>

* Translate concepts/extend-kubernetes/operator/ into Japanese (#16455)

* Translate concepts/extend-kubernetes/operator/ into Japanese

* Update the word operator into Japanese

* Apply suggestions by inductor and oke-py from code review

Co-Authored-By: inductor <kohei.ota@zozo.com>
Co-Authored-By: Naoki Oketani <okepy.naoki@gmail.com>

* Apply suggestions by inductor from code review

Co-Authored-By: inductor <kohei.ota@zozo.com>

* Refine sentences under bullet points

* Refine sentences in response to the review by makocchi-git

* Translate concepts/extend-kubernetes/api-extension/apiserver-aggregation/ into Japanese (#16662)

* Translate concepts/extend-kubernetes/api-extension/apiserver-aggregation/ into Japanese

* Apply suggestions from code review by inductor

Co-Authored-By: inductor <kohei.ota@zozo.com>

* Apply suggestions from review by MasayaAoyama

* Apply a suggestion from review by MasayaAoyama

* assign inductor as sig-docs-ja approver (#17412) (#17517)

* traslate /docs/concepts/architecture/_index.md into Japanese (#15456)

* tranaslated (#15458)

* translate /ja/docs/reference/_index.md (#15624)

* translate /ja/docs/reference/_index.md

* Update content/ja/docs/reference/_index.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/reference/_index.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/reference/_index.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* patch reviews

* Follow the dir structure of en in setup (#15590)

* follow the dir structure of en in setup

* delete unrelated files

* wip removing ja

* removeg ja

* remove ja

* Update content/ja/docs/setup/_index.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* review

* numbered list

* Update content/ja/docs/setup/_index.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/setup/_index.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Translate /docs/setup/turnkey/aws.md in Japanese (#15640)

* Translate content/ja/docs/setup/turnkey/aws.md

partially

* Update content/ja/docs/setup/turnkey/aws.md

... Kubernetes cluster on AWS: AWS上でKubernetesクラスターを...
https://github.com/kubernetes/website/pull/15640/files#r310338415

Co-Authored-By: Kohei Ota <kohei.ota@zozo.com>

* Update content/ja/docs/setup/turnkey/aws.md (Kubernetes Operations)

- replace English commas with Japanese one (、)
- Management: 管理

Co-Authored-By: Kohei Ota <kohei.ota@zozo.com>

* Update content/ja/docs/setup/turnkey/aws.md (kube-aws)

- replace English commas
- insert a Japanese comma

Co-Authored-By: Kohei Ota <kohei.ota@zozo.com>

* Update content/ja/docs/setup/turnkey/aws.md (kubectl)

- 断定でなく選択を与えるニュアンス

Co-Authored-By: Kohei Ota <kohei.ota@zozo.com>

* Translate content/ja/docs/setup/turnkey/aws.md

completely

Signed-off-by: Takuma Hashimoto <takumaxd+github@gmail.com>

* fix translation

https://github.com/kubernetes/website/pull/15640#discussion_r310418805
自身がsupportするのでなく、Kubernetes Operationsがsupportしている、というニュアンス

Signed-off-by: Takuma Hashimoto <takumaxd+github@gmail.com>

* fix mistranslation

https://github.com/kubernetes/website/pull/15640#discussion_r310419122
ここでのwithはusingに近い意味合いで

Signed-off-by: Takuma Hashimoto <takumaxd+github@gmail.com>

* fix translation

https://github.com/kubernetes/website/pull/15640#discussion_r310568505
ここでのthroughは通過や媒介という意味合いよりも、手段を表すと捉える

Signed-off-by: Takuma Hashimoto <takumaxd+github@gmail.com>

* Update content/ja/docs/setup/turnkey/aws.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/setup/production-environment/turnkey/aws.md

Co-Authored-By: Tim Bannister <tim@scalefactory.com>

* Translate docs/tutorials/stateless-application/expose-external-ip-address.md in Japanese (#15672)

* Copy from content/ja/docs/tutorials/stateless-application/

Signed-off-by: Takuma Hashimoto <takumaxd+github@gmail.com>

* update link to Japanese document

Signed-off-by: Takuma Hashimoto <takumaxd+github@gmail.com>

* Translate expose-external-ip-address in Japanese

Signed-off-by: Takuma Hashimoto <takumaxd+github@gmail.com>

* Update content/ja/docs/tutorials/stateless-application/expose-external-ip-address.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/tutorials/stateless-application/expose-external-ip-address.md

やや不自然だった

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/tutorials/stateless-application/expose-external-ip-address.md

s/ロードバランサ/ロードバランサー/

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/tutorials/stateless-application/expose-external-ip-address.md

s/サーバ/サーバー/

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Revert "update link to Japanese document"

This reverts commit 9237f63402b0e642600d1ea24c6b410f877c165e.
https://github.com/kubernetes/website/pull/15672#discussion_r311327200

* remove a new line

段落としては同じ

* Update content/ja/docs/tutorials/stateless-application/expose-external-ip-address.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/tutorials/stateless-application/expose-external-ip-address.md

https://github.com/kubernetes/website/pull/15672#discussion_r312317653

* Update content/ja/docs/tutorials/stateless-application/expose-external-ip-address.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/tutorials/stateless-application/expose-external-ip-address.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Translate concepts/architecture/nodes.md into Japanese (#15625)

* Translate concepts/architecture/nodes.md into Japanese

* update translation

* fix translation

* eviction

* Update content/ja/docs/concepts/architecture/nodes.md

Co-Authored-By: makocchi <makocchi@gmail.com>

* Update content/ja/docs/concepts/architecture/nodes.md

Co-Authored-By: makocchi <makocchi@gmail.com>

* plural

* review

* node

* Update content/ja/docs/concepts/architecture/nodes.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/nodes.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/nodes.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/nodes.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/nodes.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/nodes.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/nodes.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/nodes.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/nodes.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/nodes.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/nodes.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/nodes.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/nodes.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/nodes.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/nodes.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/nodes.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/nodes.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/nodes.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* healthy

* review

* namespace

* Translate tasks/run-application/force-delete-stateful-set-pod/ in Japanese (#15835)

* ja-trans: tasks/run-application/force-delete-stateful-set-pod/

* Update content/ja/docs/tasks/run-application/force-delete-stateful-set-pod.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/tasks/run-application/force-delete-stateful-set-pod.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/tasks/run-application/force-delete-stateful-set-pod.md

* Update content/ja/docs/tasks/run-application/force-delete-stateful-set-pod.md

* Translate concepts/architecture/master-node-communication.md into Japanese (#15638)

* translate master node communication

* Update content/ja/docs/concepts/architecture/master-node-communication.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/master-node-communication.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/master-node-communication.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/master-node-communication.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/master-node-communication.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/master-node-communication.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/master-node-communication.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/master-node-communication.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/master-node-communication.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* deprecated

* Update content/ja/docs/concepts/architecture/master-node-communication.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/architecture/master-node-communication.md

Co-Authored-By: Takuya Tokuda <cs.toku.mail@gmail.com>

* Update content/ja/docs/concepts/architecture/master-node-communication.md

Co-Authored-By: Takuya Tokuda <cs.toku.mail@gmail.com>

* Update content/ja/docs/concepts/architecture/master-node-communication.md

Co-Authored-By: Takuya Tokuda <cs.toku.mail@gmail.com>

* Translate /docs/tasks/tools/install-kubectl.md in Japanese (#15678)

* Copy from content/en/docs/tasks/tools/install-kubectl.md

Signed-off-by: Takuma Hashimoto <takumaxd+github@gmail.com>

* fix link to install-kubectl

Signed-off-by: Takuma Hashimoto <takumaxd+github@gmail.com>

* Translate Headings and Subheadings

Signed-off-by: Takuma Hashimoto <takumaxd+github@gmail.com>

* translate text of install-kubectl in Japanese

Signed-off-by: Takuma Hashimoto <takumaxd+github@gmail.com>

* Update content/ja/docs/tasks/tools/install-kubectl.md

s/ユーザ/ユーザー/

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/tasks/tools/install-kubectl.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update install-kubectl.md

s/する:/してください:/g

* Translate /docs/tutorials/configuration/configure-redis-using-configmap.md in Japanese  (#15639)

* translate redis example

* add index

* Update content/ja/docs/tutorials/configuration/configure-redis-using-configmap.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/tutorials/configuration/configure-redis-using-configmap.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/tutorials/configuration/configure-redis-using-configmap.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* review

* Translate docs/concepts/configuration/overview.md in Japanese  (#15627)

* Translate docs/concepts/configuration/overview.md in Japanese

* Update content/ja/docs/concepts/configuration/overview.md

Co-Authored-By: Tim Bannister <tim@scalefactory.com>

* Update content/ja/docs/concepts/configuration/overview.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/configuration/overview.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/configuration/overview.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/configuration/overview.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Fix terminology in Japanese translation (#15889)

* cluster

* cluster

* node

* cluster

* Update content/ja/docs/tutorials/kubernetes-basics/deploy-app/deploy-intro.html

Co-Authored-By: Takuya Tokuda <cs.toku.mail@gmail.com>

* sitemap and search (#15927)

* Translate tasks/debug-application-cluster/debug-pod-replication-contr… (#15883)

* Translate tasks/debug-application-cluster/debug-pod-replication-controller/ in Japanese

* Update content/ja/docs/tasks/debug-application-cluster/debug-pod-replication-controller.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/tasks/debug-application-cluster/debug-pod-replication-controller.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/tasks/debug-application-cluster/debug-pod-replication-controller.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* fix missing parenthesis (#16044)

```
Error: Error building site: "/src/content/ja/docs/tasks/debug-application-cluster/debug-pod-replication-controller.md:106:10": unrecognized character in shortcode action: U+003E '>'. Note: Parameters with non-alphanumeric args must be quoted
```

* Translate tasks/configure-pod-container/configure-volume-storage/ in Japanese (#16058)

* Translate tasks/configure-pod-container/configure-volume-storage/ in Japanese

* Update content/ja/docs/tasks/configure-pod-container/configure-volume-storage.md

Co-Authored-By: inductor <kohei.ota@zozo.com>

* Update content/ja/docs/tasks/configure-pod-container/configure-volume-storage.md

Co-Authored-By: inductor <kohei.ota@zozo.com>

* Translate text of docs/setup/release/version-skew-policy.md in Japanese (#15903)

* translate content/ja/docs/setup/release/version-skew-policy.md in Japanese

* translate "version skew"

https://github.com/kubernetes/website/pull/15903#issuecomment-524518826

バージョン間の差異 となる
タイトルは原文どおりに用語として残し、初回の文でskew=差異であることを明示する
以降はskewを翻訳する

* fix translation

- 格助詞漏れ
- more than 1...は1を含まないそれ以上の値であり、実質「2以上」となるので、そのように訳したほうが自然

* delete unnecessary sentences

* update translation

cf. 422f5b0e6a0c52f844cfae66cde01f47fca4cf4e

* update translation

componentsが当該バージョンをサポートするのでなく、kube-apiserverのバージョンの結果ほかのcomponentsが当該バージョンをサポート**される**イメージ

* Translate concepts/architecture/cloud-controller/ into Japanese (#16099)

* Translate concepts/architecture/cloud-controller/ into Japanese

* Revise sentences based on suggestion by reviewers

* Revise a sentence based on suggestion by a reviewer

* Fix wording to distinguish Kubernetes related resources from others

* fix a typo (#16121)

* fix some wording on home (#16127)

* Translate contribute / _index.md to Japanese (#16050)

* translate contribute index into Japanese

* modify some terms

* modify according to style guide

* use same terminology about contribute

* Update content/ja/docs/contribute/_index.md

Co-Authored-By: Takuya Tokuda <cs.toku.mail@gmail.com>

* Translate concepts/overview/components and related glossaries in Japanase (#16034)

* Translate concepts/overview/components and related glossaries in Japanese

* Revise sentences based on suggestion by reviewers

* Translate tasks/configure-pod-container/assign-memory-resource/ in Japanese (#16055)

* copy from content/en/docs/tasks/configure-pod-container/assign-memory-resource to ja directory

* translate tasks/configure-pod-container/assign-memory-resource/ in Japanese

* Update content/ja/docs/tasks/configure-pod-container/_index.md

Co-Authored-By: inductor <kohei.ota@zozo.com>

* Update content/ja/docs/tasks/configure-pod-container/_index.md

Co-Authored-By: inductor <kohei.ota@zozo.com>

* fix translation

%s/メモリ/メモリー/g

* Translate tasks/access-application-cluster/communicate-containers-same-pod-shared-volume/ in Japanese (#16183)

* Translate concepts/configuration/assign-pod-node/ in Japanese (#16221)

* issue 15552

* Update content/ja/docs/concepts/configuration/assign-pod-node.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/configuration/assign-pod-node.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/concepts/configuration/assign-pod-node.md

Co-Authored-By: Naoki Oketani <okepy.naoki@gmail.com>

* Update content/ja/docs/concepts/configuration/assign-pod-node.md

Co-Authored-By: Naoki Oketani <okepy.naoki@gmail.com>

* Update content/ja/docs/concepts/configuration/assign-pod-node.md

Co-Authored-By: Naoki Oketani <okepy.naoki@gmail.com>

* Update content/ja/docs/concepts/configuration/assign-pod-node.md

Co-Authored-By: Naoki Oketani <okepy.naoki@gmail.com>

* Update content/ja/docs/concepts/configuration/assign-pod-node.md

Co-Authored-By: Naoki Oketani <okepy.naoki@gmail.com>

* Update content/ja/docs/concepts/configuration/assign-pod-node.md

Co-Authored-By: Naoki Oketani <okepy.naoki@gmail.com>

* Update content/ja/docs/concepts/configuration/assign-pod-node.md

Co-Authored-By: Naoki Oketani <okepy.naoki@gmail.com>

* Update content/ja/docs/concepts/configuration/assign-pod-node.md

Co-Authored-By: Naoki Oketani <okepy.naoki@gmail.com>

* modification after a review

* Translate docs/tasks/administer-cluster/developing-cloud-controller-manager in ja (#16088)

* Translate docs/tasks/administer-cluster/developing-cloud-controller-manager/ in Japanese

* Update content/ja/docs/tasks/administer-cluster/developing-cloud-controller-manager.md

Co-Authored-By: inductor <kohei.ota@zozo.com>

* Update content/ja/docs/tasks/administer-cluster/developing-cloud-controller-manager.md

Co-Authored-By: inductor <kohei.ota@zozo.com>

* Update content/ja/docs/tasks/administer-cluster/developing-cloud-controller-manager.md

Co-Authored-By: inductor <kohei.ota@zozo.com>

* Update content/ja/docs/tasks/administer-cluster/developing-cloud-controller-manager.md

Co-Authored-By: inductor <kohei.ota@zozo.com>

* Remove reviewers section

* Modified wording to unified

* Remove unnecessary brackets

* Translate concepts/overview/working-with-objects/object-management/ into Japanese (#16400)

* Translate concepts/overview/working-with-objects/object-management/ into Japanese

* Refine some words based on review comments

* Add a word to refine a sentence based on a review comment

* Translate content/ja/docs/concepts/cluster-administration/controller-… (#16351)

* Translate content/ja/docs/concepts/cluster-administration/controller-metrics in ja

* Improved to format a text

* Fix inconsistent spellings

* Update content/ja/docs/concepts/cluster-administration/controller-metrics.md

Co-Authored-By: Naoki Oketani <okepy.naoki@gmail.com>

* Update content/ja/docs/concepts/cluster-administration/controller-metrics.md

Co-Authored-By: Naoki Oketani <okepy.naoki@gmail.com>

* Translate concepts/extend-kubernetes/extend-cluster/ and related glossaries into Japanese (#16636)

* Translate concepts/extend-kubernetes/extend-cluster/ and related glossaries into Japanese

* Apply suggestions from code review by inductor

Co-Authored-By: inductor <kohei.ota@zozo.com>

* Update a translation for extension point

* Apply suggestions from code review by sftim

Co-Authored-By: Tim Bannister <tim@scalefactory.com>

* Apply suggestions from code review by sftim

* Fix the translation for document

* Apply a suggestion from code review by nasa9084

* Apply suggestions from code review by inductor and nasa9084

* fix: s/kubernetes/Kubernetes/ (#16057)

* Translate reference/command-line-tools-reference/feature-gates in Japanese (#16554)

* Translate docs/reference/command-line-tools-reference/feature-gates in ja

* Fix inconsistent spellings

* Update content/ja/docs/reference/command-line-tools-reference/feature-gates.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/reference/command-line-tools-reference/feature-gates.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/reference/command-line-tools-reference/feature-gates.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/reference/command-line-tools-reference/feature-gates.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/reference/command-line-tools-reference/feature-gates.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/reference/command-line-tools-reference/feature-gates.md

Co-Authored-By: nasa9084 <nasa9084@users.noreply.github.com>

* Update content/ja/docs/reference/command-line-tools-reference/feature-gates.md

Co-Authored-By: Naoki Oketani <okepy.naoki@gmail.com>

* Update content/ja/docs/reference/command-line-tools-reference/feature-gates.md

Co-Authored-By: Naoki Oketani <okepy.naoki@gmail.com>

* Update content/ja/docs/reference/command-line-tools-reference/feature-gates.md

Co-Authored-By: Naoki Oketani <okepy.naoki@gmail.com>

* ポッド -> Pod

* Update content/ja/docs/reference/command-line-tools-reference/feature-gates.md

Co-Authored-By: Naoki Oketani <okepy.naoki@gmail.com>

* Update content/ja/docs/reference/command-line-tools-reference/feature-gates.md

Co-Authored-By: Naoki Oketani <okepy.naoki@gmail.com>

* ポッドreadinessゲート -> Pod readiness gate

* ポッド -> pod

* Pods -> Pod

* Fix typo: Kunbernetes -> Kubernetes

* 機能ゲート -> フィーチャーゲート

* リポジトリ -> リポジトリー

* キー=値 -> key=value

* Translate concepts/storage/volume-pvc-datasource in Japanese (#16775)

* Translate concepts/storage/volume-pvc-datasource in Japanese

* Remove original English contents(forgot to remove)

* Container Storage Interface -> コンテナストレージインターフェイス

* フューチャーゲート -> フィーチャーゲート

* Improved a translate to more natural expression

* Update content/ja/docs/reference/glossary/csi.md

Co-Authored-By: inductor <kohei.ota@zozo.com>

* Update content/ja/docs/reference/glossary/storage-class.md

Co-Authored-By: inductor <kohei.ota@zozo.com>

* Update content/ja/docs/reference/glossary/storage-class.md

Co-Authored-By: inductor <kohei.ota@zozo.com>

* Update content/ja/docs/reference/glossary/storage-class.md

Co-Authored-By: inductor <kohei.ota@zozo.com>

* Update content/ja/docs/reference/glossary/storage-class.md

Co-Authored-By: inductor <kohei.ota@zozo.com>

* Update content/ja/docs/reference/glossary/storage-class.md

Co-Authored-By: inductor <kohei.ota@zozo.com>

* Improved a translate to more natural expression

* Remove an unnecessary line break

* Improved some translate words to natural sentence

* Improved translate

* Fix translate

* Translate docs/reference/glossary/selector.md in Japanese (#17375)

* Translate docs/reference/glossary/selector.md in Japanese

* Translate title into Japanese

Co-Authored-By: bells17 <bells171@gmail.com>

* Translate tasks/configure-pod-container/share-process-namespace/ into Japanese (#16220)

* Translate tasks/configure-pod-container/share-process-namespace/ into Japanese

* reflect review

* Translate tasks/access-application-cluster/connecting-frontend-backend/ into Japanese (#16270)

* Translate tasks/access-application-cluster/connecting-frontend-backend/ into Japanese

* reflect review

* translate tooltip text

Co-Authored-By: bells17 <bells171@gmail.com>

* Translate concepts/extend-kubernetes/operator/ into Japanese (#16455)

* Translate concepts/extend-kubernetes/operator/ into Japanese

* Update the word operator into Japanese

* Apply suggestions by inductor and oke-py from code review

Co-Authored-By: inductor <kohei.ota@zozo.com>
Co-Authored-By: Naoki Oketani <okepy.naoki@gmail.com>

* Apply suggestions by inductor from code review

Co-Authored-By: inductor <kohei.ota@zozo.com>

* Refine sentences under bullet points

* Refine sentences in response to the review by makocchi-git

* Translate concepts/extend-kubernetes/api-extension/apiserver-aggregation/ into Japanese (#16662)

* Translate concepts/extend-kubernetes/api-extension/apiserver-aggregation/ into Japanese

* Apply suggestions from code review by inductor

Co-Authored-By: inductor <kohei.ota@zozo.com>

* Apply suggestions from review by MasayaAoyama

* Apply a suggestion from review by MasayaAoyama

* ja-trans: content/ja/case-studies/sos (#17338)

* Add case-studies for SOS International(JP)

* Add logo file

* fixup! Add case-studies for SOS International(JP)

* Update content/ja/case-studies/sos/index.html

Co-Authored-By: inductor <kohei.ota@zozo.com>

* Update content/ja/case-studies/sos/index.html

Co-Authored-By: inductor <kohei.ota@zozo.com>

* Update content/ja/case-studies/sos/index.html

Co-Authored-By: inductor <kohei.ota@zozo.com>

* Update content/ja/case-studies/sos/index.html

Co-Authored-By: inductor <kohei.ota@zozo.com>

* ja-trans:Translate concepts/services-networking/service/ into Japanese (#14917) (#16319)

* ja-trans:Translate concepts/services-networking/service/ into Japanese (#14917)

* ja-trans: Improve Japanese translation in concepts/services-networking/service/ (#14917)

* ja-trans: Improve Japanese translation in concepts/services-networking/service/ (#14917)

* ja-trans: Improve Japanese translation in concepts/services-networking/_index.md (#14917)

* ja-trans: Improve Japanese translation in reference/glossary/namespace.md (#14917)

* ja-trans: Improve Japanese translation in concepts/services-networking/service/ (#14917)

* ja-trans: Improve Japanese translation in concepts/services-networking/service/ (#14917)

* ja-trans: content/ja/case-studies/nordstrom (#16953)

* Add case-studies for Nordstrom(JP)

* fixup! Add case-studies for Nordstrom(JP)

* Update content/ja/case-studies/nordstrom/index.html

line 25
eコマースサイト->ECサイト
技術運用->技術的な運用
探して->模索して

Co-Authored-By: inductor <kohei.ota@zozo.com>

* mod some sentences

* fixup! mod some sentences

* Update content/ja/case-studies/nordstrom/index.html

Line98 
・クラスター ->クラスタ
・表現を修正

Co-Authored-By: inductor <kohei.ota@zozo.com>

* Update content/ja/case-studies/nordstrom/index.html

向上->改善

Co-Authored-By: Naoki Oketani <okepy.naoki@gmail.com>

* Update content/ja/case-studies/nordstrom/index.html

クラスタ -> クラスター

Co-Authored-By: Naoki Oketani <okepy.naoki@gmail.com>

* fixup! Update content/ja/case-studies/nordstrom/index.html

* Translate docs/reference/glossary/node.md into Japanese (#17680)

* Translate docs/reference/glossary/control-plane.md into Japanese (#17679)

* Translate docs/reference/glossary/control-plane.md into Japanese

* Update content/ja/docs/reference/glossary/control-plane.md

Co-Authored-By: inductor <kohei.ota@zozo.com>

* Update content/ja/docs/reference/glossary/control-plane.md

Co-Authored-By: inductor <kohei.ota@zozo.com>

* ja-trans: Translate concepts/scheduling/kube-scheduler/ in Japanese #17118 (#17586)

* ja-trans:Translate concepts/scheduling/kube-scheduler/ into Japanese (#17118)

* ja-trans: Improve Japanese translation in concepts/scheduling/kube-scheduler/  (#17118)

* ja-trans: Improve Japanese translation in concepts/scheduling/kube-scheduler/  (#17118)
This commit is contained in:
inductor
2019-11-20 14:25:19 -08:00
committed by Kubernetes Prow Robot
parent 8c88039129
commit 4532bd2bdb
141 changed files with 8780 additions and 1891 deletions
@@ -0,0 +1,4 @@
---
title: "Kubernetes アーキテクチャー"
weight: 30
---
@@ -0,0 +1,238 @@
---
title: クラウドコントローラーマネージャーとそのコンセプト
content_template: templates/concept
weight: 30
---
{{% capture overview %}}
クラウドコントローラマネージャー(CCM)のコンセプト(バイナリと混同しないでください)は、もともとクラウドベンダー固有のソースコードと、Kubernetesのコアソースコードを独立して進化させることが出来るように作られました。クラウドコントローラーマネージャーは、Kubernetesコントローラーマネージャー、APIサーバー、そしてスケジューラーのような他のマスターコンポーネントと並行して動きます。またKubernetesのアドオンとしても動かすことができ、その場合はKubernetes上で動きます。
クラウドコントローラーマネージャーの設計は「プラグイン機構」をベースにしています。そうすることで、新しいクラウドプロバイダーがプラグインを使ってKubernetesと簡単に統合出来るようになります。新しいクラウドプロバイダーに向けてKubernetesのオンボーディングを行ったり、古いモデルを利用しているクラウドプロバイダーに、新しいCCMモデルに移行させるような計画があります。
このドキュメントでは、クラウドコントローラーマネージャーの背景にあるコンセプトと、それに関連する機能の詳細について話します。
これが、クラウドコントローラーマネージャーを除いた、Kubernetesクラスターのアーキテクチャ図です。
![Pre CCM Kube Arch](/images/docs/pre-ccm-arch.png)
{{% /capture %}}
{{% capture body %}}
## 設計
上で示した図で分かるように、Kubernetesとクラウドプロバイダーはいくつかの異なるコンポーネントを通じて連携します:
* Kubelet
* Kubernetesコントローラーマネージャー
* Kubernetes APIサーバー
CCMは、前述した3つのコンポーネントのクラウド依存のロジックを統合し、クラウドとの単一の連携ポイントとなります。CCMを利用した新しいアーキテクチャは下記のようになります:
![CCM Kube Arch](/images/docs/post-ccm-arch.png)
## CCMのコンポーネント
CCMは、Kubernetesコントローラーマネージャー(KCM)からいくつかの機能群を切り離し、別のプロセスとして動かします。具体的には、KCMに含まれるクラウド依存のコントローラーを分離します。KCMは、下記に示すクラウド依存のコントローラーループを持っています:
* ノードコントローラー
* ボリュームコントローラー
* ルートコントローラー
* サービスコントローラー
バージョン1.9では、CCMは前述のリスト内の下記コントローラーを動かします:
* ノードコントローラー
* ルートコントローラー
* サービスコントローラー
{{< note >}}
ボリュームコントローラーは、意図的にCCMの一部になっていません。複雑さと、ベンダー固有のボリュームロジックを抽象化するのに費やした労力を考え、CCMの一部に移行しないことが決定されました。
{{< /note >}}
CCMを使ったボリュームをサポートする元の計画は、プラガブルなボリュームをサポートするため、Flexボリュームを使うことでした。しかし、競合しているCSIとして知られている機能が、Flexを置き換える予定です。
これらのダイナミクスを考慮し、我々はCSIが利用できるようになるまで、間を取った暫定措置を取ることにしました。
## CCMの機能群
CCMは、クラウドに依存しているKubernetesのコンポーネントから機能を継承しています。このセクションはそれらのコンポーネントをベースに構造化されています。
### 1. Kubernetesコントローラーマネージャー
CCMの大半の機能は、KCMから派生しています。前セクションで説明したとおり、CCMは下記のコントロールループを動かします:
* ノードコントローラー
* ルートコントローラー
* サービスコントローラー
#### ノードコントローラー
ノードコントローラーは、クラウドプロバイダーからクラスター内で稼働しているノードの情報を取得し、初期化する責務を持ちます。ノードコントローラーは下記に示す機能を実行します:
1. ノードをクラウド特有のゾーン/リージョンラベルで初期化する
2. ノードをクラウド特有のインスタンス詳細情報(例、タイプ、サイズ)で初期化する
3. ノードのネットワークアドレスとホスト名を取得する
4. ノードが応答しなくなった場合、ノードがクラウドから削除されているかを確認する。クラウドからノードが削除されていた場合、KubernetesからNodeオブジェクトを削除する
#### ルートコントローラー
ルートコントローラーは、クラスタ内の異なるノード上で稼働しているコンテナが相互に通信出来るように、クラウド内のルートを適切に設定する責務を持ちます。ルートコントローラーはGoogle Compute Engineのクラスターのみに該当します。
#### サービスコントローラー
サービスコントローラーは、サービスの作成、更新、そして削除イベントの待ち受けに責務を持ちます。Kubernetes内のサービスの現在の状態を、クラウド上のロードバランサー(ELB、Google LB、またOracle Cloud Infrastructure LBなど)に反映するための設定を行います。更に、クラウドロードバランサーのバックエンドが最新の状態になっていることを保証します。
### 2. Kubelet
ノードコントローラーは、kubeletのクラウドに依存した機能も含んでいます。CCMの登場以前、kubeletはIPアドレス、リージョン/ゾーンラベル、そしてインスタンスタイプ情報のような、クラウド特有の情報を元にノードを初期化する責務を持っていました。CCMが登場したことで、この初期化操作がkubeletからCCMに移行されました。
この新しいモデルでは、kubeletはクラウド特有の情報無しでノードを初期化します。しかし、新しく作成されたノードにtaintを付けて、CCMがクラウド特有の情報でノードを初期化するまで、コンテナがスケジュールされないようにします。その後、taintを削除します。
## プラグイン機構
クラウドコントローラーマネージャーは、Goのインターフェースを利用してクラウドの実装をプラグイン化出来るようにしています。具体的には、[こちら](https://github.com/kubernetes/cloud-provider/blob/9b77dc1c384685cb732b3025ed5689dd597a5971/cloud.go#L42-L62)で定義されているクラウドプロバイダーインターフェースを利用しています。
上で強調した4つの共有コントローラーの実装、そしていくつかの共有クラウドプロバイダーインターフェースと一部の連携機能は、Kubernetesのコアにとどまります。クラウドプロバイダー特有の実装はコア機能外で構築され、コア機能内で定義されたインターフェースを実装します。
プラグインを開発するためのさらなる情報は、[クラウドコントローラーマネージャーを開発する](/docs/tasks/administer-cluster/developing-cloud-controller-manager/)を参照してください。
## 認可
このセクションでは、CCMが操作を行うために様々なAPIオブジェクトに必要な権限を分類します。
### ノードコントローラー
ノードコントローラーはNodeオブジェクトのみに対して働きます。Nodeオブジェクトに対して、get、list、create、update、patch、watch、そしてdeleteの全権限が必要です。
v1/Node:
- Get
- List
- Create
- Update
- Patch
- Watch
- Delete
### ルートコントローラー
ルートコントローラーは、Nodeオブジェクトの作成を待ち受け、ルートを適切に設定します。Nodeオブジェクトについて、get権限が必要です。
v1/Node:
- Get
### サービスコントローラー
サービスコントローラーは、Serviceオブジェクトの作成、更新、削除イベントを待ち受け、その後、サービスのエンドポイントを適切に設定します。
サービスにアクセスするため、list、watchの権限が必要です。サービスを更新するため、patch、updateの権限が必要です。
サービスのエンドポイントを設定するため、create、list、get、watchそしてupdateの権限が必要です。
v1/Service:
- List
- Get
- Watch
- Patch
- Update
### その他
CCMコア機能の実装は、イベントのcreate権限と、セキュアな処理を保証するため、ServiceAccountのcreate権限が必要です。
v1/Event:
- Create
- Patch
- Update
v1/ServiceAccount:
- Create
CCMのRBAC ClusterRoleはこのようになります:
```yaml
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
name: cloud-controller-manager
rules:
- apiGroups:
- ""
resources:
- events
verbs:
- create
- patch
- update
- apiGroups:
- ""
resources:
- nodes
verbs:
- '*'
- apiGroups:
- ""
resources:
- nodes/status
verbs:
- patch
- apiGroups:
- ""
resources:
- services
verbs:
- list
- patch
- update
- watch
- apiGroups:
- ""
resources:
- serviceaccounts
verbs:
- create
- apiGroups:
- ""
resources:
- persistentvolumes
verbs:
- get
- list
- update
- watch
- apiGroups:
- ""
resources:
- endpoints
verbs:
- create
- get
- list
- watch
- update
```
## ベンダー実装
下記のクラウドプロバイダーがCCMを実装しています:
* [Digital Ocean](https://github.com/digitalocean/digitalocean-cloud-controller-manager)
* [Oracle](https://github.com/oracle/oci-cloud-controller-manager)
* [Azure](https://github.com/kubernetes/cloud-provider-azure)
* [GCP](https://github.com/kubernetes/cloud-provider-gcp)
* [AWS](https://github.com/kubernetes/cloud-provider-aws)
* [BaiduCloud](https://github.com/baidu/cloud-provider-baiducloud)
* [Linode](https://github.com/linode/linode-cloud-controller-manager)
## クラスター管理
CCMを設定、動かすための完全な手順は[こちら](/docs/tasks/administer-cluster/running-cloud-controller/#cloud-controller-manager)で提供されています。
{{% /capture %}}
@@ -0,0 +1,72 @@
---
title: マスターとノード間の通信
content_template: templates/concept
weight: 20
---
{{% capture overview %}}
本ドキュメントでは、KubernetesにおけるMaster(実態はAPIサーバー)及びクラスター間のコミュニケーション経路についてまとめます。
この文書の目的は、信頼できないネットワーク上(またはクラウドプロバイダ上の完全にパブリックなIP上)でクラスタを実行できるように、ユーザーがインストールをカスタマイズしてネットワーク構成を強化できるようにすることです。
{{% /capture %}}
{{% capture body %}}
## クラスターからマスターへの通信
クラスターからマスターへのすべての通信経路は、APIサーバーで終端します(他のマスターコンポーネントはどれもリモートサービスを公開するように設計されていません)。
一般的には、1つ以上の形式のクライアント[認証](/docs/reference/access-authn-authz/authentication/)が有効になっている状態で、APIサーバーはセキュアなHTTPSポート(443)でリモート接続をlistenするように構成されています。
特に[匿名のリクエスト](/docs/reference/access-authn-authz/authentication/#anonymous-requests)または[サービスアカウントトークン](/docs/reference/access-authn-authz/authentication/#service-account-tokens)が許可されている場合は、1つまたは複数の[認証](/docs/reference/access-authn-authz/authorization/)を有効にする必要があります。
ノードには、有効なクライアント認証情報を使って安全にAPIサーバーに接続できるように、クラスターのパブリックなルート証明書をプロビジョニングする必要があります。
たとえば、GKEのデフォルト設定では、kubeletに提供されるクライアント認証情報はクライアント証明書の形式です。
kubeletのクライアント証明書を自動プロビジョニングする方法については、[kubelet TLSブートストラッピング](/docs/reference/command-line-tools-reference/kubelet-tls-bootstrapping/)を参照してください。
APIサーバーに接続したいPodは、サービスアカウントを利用することで接続を安全にすることができます。そうすることで、Podが作成されたときにKubernetesがパブリックなルート証明書と有効なBearer TokenをPodに自動的に挿入します。
`kubernetes`サービスには(すべてのネームスペースで)、APIサーバー上のHTTPSエンドポイントに(kube-proxy経由で)リダイレクトされる仮想IPアドレスが設定されています。
マスターコンポーネントは、セキュアなポートを介してクラスターAPIサーバーとも通信します。
その結果、クラスター(ノードとそのノードで実行されているPod)からマスターへの接続はデフォルトで保護され、信頼できないネットワークやパブリックネットワークを介して実行できます。
## マスターからクラスターへの通信
マスター(APIサーバー)からクラスターへの通信には、2つの主要な通信経路があります。
1つ目は、APIサーバーからクラスター内の各ノードで実行されるkubeletプロセスへの通信です。
2つ目は、APIサーバーのプロキシ機能を介した、APIサーバーから任意のノード、Pod、またはサービスへのアクセスです。
### APIサーバーからkubeletへの通信
APIサーバーからkubeletへの接続は以下の目的で使用されます:
* Podのログを取得する
* 実行中のPodに(kubectlを通して)接続する
* kubeletのポート転送機能を提供する
これらの接続は、kubeletのHTTPSエンドポイントで終了します。
デフォルトでは、APIサーバーはkubeletが提供する証明書を検証しないため、接続は中間者攻撃を受けやすく、**安全でない**信頼できないネットワークやパブリックなネットワークを介して実行されることになります。
この接続を検証するには、`--kubelet-certificate-authority`フラグを使用して、kubeletが提供する証明書を確認するために使用するルート証明書バンドルをAPIサーバーに提供します。
それができない場合は、信頼できないネットワークやパブリックなネットワークを介した接続を回避するために、必要に応じてAPIサーバーとkubeletの間でSSHトンネリングを使用してください。
最後に、kubeletのAPIを保護するために[kubeletの認証認可](/docs/admin/kubelet-authentication-authorization/)を有効にする必要があります。
### APIサーバーからノード、Pod、サービスへの通信
APIサーバーからノード、Pod、またはサービスへの接続はデフォルトで平文のHTTP接続になるため、認証も暗号化もされません。
API URL内のノード、Pod、またはサービス名に`https:`を付けることで安全なHTTPS接続で実行できますが、HTTPSエンドポイントから提供される証明書を検証したりクライアントの資格情報を提供したりすることはありませんし、暗号化されているという完全性を保証するものでもありません。
これらの接続を信頼できないネットワークや公衆ネットワークを介して実行するのは、現時点において安全ではありません。
### SSHトンネル
Kubernetesはマスターからクラスターへの通信経路を保護するためにSSHトンネルをサポートしています。
この設定では、APIサーバーはクラスター内の各ノード(ポート22でlistenしているsshサーバーに接続)へのSSHトンネルを開始し、トンネルを介してkubelet、ノード、Pod、またはサービス宛てのすべてのトラフィックを渡します。
このトンネルにより、ノードが実行されているネットワークの外部にトラフィックが公開されないようにします。
SSHトンネルは現在非推奨なので、自分がしていることが分からない限り、使用しないでください。この通信チャネルに代わるものが設計されています。
{{% /capture %}}
@@ -0,0 +1,222 @@
---
title: ノード
content_template: templates/concept
weight: 10
---
{{% capture overview %}}
ノードは、以前には `ミニオン` としても知られていた、Kubernetesにおけるワーカーマシンです。1つのノードはクラスターの性質にもよりますが、1つのVMまたは物理的なマシンです。各ノードには[Pod](/docs/concepts/workloads/pods/pod/)を動かすために必要なサービスが含まれており、マスターコンポーネントによって管理されています。ノード上のサービスには[コンテナランタイム](/docs/concepts/overview/components/#node-components)、kubelet、kube-proxyが含まれています。詳細については、設計ドキュメントの[Kubernetes Node](https://git.k8s.io/community/contributors/design-proposals/architecture/architecture.md#the-kubernetes-node)セクションをご覧ください。
{{% /capture %}}
{{% capture body %}}
## ノードのステータス
ノードのステータスには以下のような情報が含まれます:
* [Addresses](#addresses)
* [Conditions](#condition)
* [CapacityとAllocatable](#capacity)
* [Info](#info)
ノードのステータスや、ノードに関するその他の詳細は、下記のコマンドを使うことで表示できます:
```shell
kubectl describe node <ノード名>
```
各セクションについては、下記で説明します。
### Addresses
これらのフィールドの使い方は、お使いのクラウドプロバイダーやベアメタルの設定内容によって異なります。
* HostName: ノードのカーネルによって伝えられたホスト名です。kubeletの`--hostname-override`パラメーターによって上書きすることができます。
* ExternalIP: 通常は、外部にルーティング可能(クラスターの外からアクセス可能)なノードのIPアドレスです。
* InternalIP: 通常は、クラスター内でのみルーティング可能なノードのIPアドレスです。
### Conditions {#condition}
`conditions`フィールドは全ての`Running`なノードのステータスを表します。例として、以下のような状態を含みます:
| ノードのCondition | 概要 |
|----------------|-------------|
| `OutOfDisk` | 新しいPodを追加するために必要なディスク容量が足りない場合に`True`になります。それ以外のときは`False`です。 |
| `Ready` | ノードの状態がHealthyでPodを配置可能な場合に`True`になります。ノードの状態に問題があり、Podが配置できない場合に`False`になります。ノードコントローラーが、`node-monitor-grace-period`で設定された時間内(デフォルトでは40秒)に該当ノードと疎通できない場合、`Unknown`になります。 |
| `MemoryPressure` | ノードのメモリが圧迫されているときに`True`になります。圧迫とは、メモリの空き容量が少ないことを指します。それ以外のときは`False`です。 |
| `PIDPressure` | プロセスが圧迫されているときに`True`になります。圧迫とは、プロセス数が多すぎることを指します。それ以外のときは`False`です。 |
| `DiskPressure` | ノードのディスク容量がが圧迫されているときに`True`になります。圧迫とは、ディスクの空き容量が少ないことを指します。それ以外のときは`False`です。 |
| `NetworkUnavailable` | ノードのネットワークが適切に設定されていない場合に`True`になります。それ以外のときは`False`です。 |
ノードのConditionはJSONオブジェクトで表現されます。例えば、正常なノードの場合は以下のようなレスポンスが表示されます。
```json
"conditions": [
{
"type": "Ready",
"status": "True",
"reason": "KubeletReady",
"message": "kubelet is posting ready status",
"lastHeartbeatTime": "2019-06-05T18:38:35Z",
"lastTransitionTime": "2019-06-05T11:41:27Z"
}
]
```
Ready conditionが`pod-eviction-timeout`に設定された時間を超えても`Unknown``False`のままになっている場合、[kube-controller-manager](/docs/admin/kube-controller-manager/)に引数が渡され、該当ノード上にあるPodはノードコントローラーによって削除がスケジュールされます。デフォルトの退役のタイムアウトの時間は**5分**です。ノードが到達不能ないくつかの場合においては、APIサーバーが該当ノードのkubeletと疎通できない状態になっています。その場合、APIサーバーがkubeletと再び通信を確立するまでの間、Podの削除を行うことはできません。削除がスケジュールされるまでの間、削除対象のPodたちは切り離されたノードの上で稼働を続けることになります。
バージョン1.5よりも前のKubernetesでは、ノードコントローラーはAPIサーバーから到達不能なそれらのPodを[強制削除](/docs/concepts/workloads/pods/pod/#force-deletion-of-pods)していました。しかしながら、1.5以降では、ノードコントローラーはクラスター内でPodが停止するのを確認するまでは強制的に削除しないようになりました。到達不能なノード上で動いているPodは`Terminating`または`Unknown`のステータスになります。Kubernetesが基盤となるインフラストラクチャーを推定できない場合、クラスター管理者は手動でNodeオブジェクトを削除する必要があります。KubernetesからNodeオブジェクトを削除すると、そのノードで実行されているすべてのPodオブジェクトがAPIサーバーから削除され、それらの名前が解放されます。
バージョン1.12において、`TaintNodesByCondition`機能がBetaに昇格し、それによってノードのライフサイクルコントローラーがconditionを表した[taint](/docs/concepts/configuration/taint-and-toleration/)を自動的に生成するようになりました。
同様に、スケジューラーがPodを配置するノードを検討する際、ノードのtaintとPodのtolerationsを見るかわりにconditionを無視するようになりました。
ユーザーは、古いスケジューリングモデルか、新しくてより柔軟なスケジューリングモデルのどちらかを選択できるようになりました。
上記のtolerationがないPodは古いスケジュールモデルに従ってスケジュールされます。しかし、特定のノードのtaintを許容するPodについては、条件に合ったノードにスケジュールすることができます。
{{< caution >}}
この機能を有効にすると、conditionが観測されてからtaintが作成されるまでの間にわずかな遅延が発生します。
この遅延は通常1秒未満ですが、正常にスケジュールされているが、kubeletによって配置を拒否されたPodの数が増える可能性があります。
{{< /caution >}}
### CapacityとAllocatable {#capacity}
ノードで利用可能なリソース(CPU、メモリ、およびノードでスケジュールできる最大Pod数)について説明します。
capacityブロック内のフィールドは、ノードが持っているリソースの合計量を示します。
allocatableブロックは、通常のPodによって消費されるノード上のリソースの量を示します。
CapacityとAllocatableについて深く知りたい場合は、ノード上でどのように[コンピュートリソースが予約されるか](/docs/tasks/administer-cluster/reserve-compute-resources/#node-allocatable)を読みながら学ぶことができます。
### Info
カーネルのバージョン、Kubernetesのバージョン(kubeletおよびkube-proxyのバージョン)、(使用されている場合)Dockerのバージョン、OS名など、ノードに関する一般的な情報です。
この情報はノードからkubeletを通じて取得されます。
## 管理 {#management}
[Pod](/docs/concepts/workloads/pods/pod/)や[Service](/docs/concepts/services-networking/service/)と違い、ノードは本質的にはKubernetesによって作成されません。GCPのようなクラウドプロバイダーによって外的に作成されるか、VMや物理マシンのプールに存在するものです。そのため、Kubernetesがノードを作成すると、そのノードを表すオブジェクトが作成されます。作成後、Kubernetesはそのノードが有効かどうかを確認します。 たとえば、次の内容からノードを作成しようとしたとします:
```json
{
"kind": "Node",
"apiVersion": "v1",
"metadata": {
"name": "10.240.79.157",
"labels": {
"name": "my-first-k8s-node"
}
}
}
```
Kubernetesは内部的にNodeオブジェクトを作成し、 `metadata.name`フィールドに基づくヘルスチェックによってノードを検証します。ノードが有効な場合、つまり必要なサービスがすべて実行されている場合は、Podを実行する資格があります。それ以外の場合、該当ノードが有効になるまではいかなるクラスターの活動に対しても無視されます。
{{< note >}}
Kubernetesは無効なノードのためにオブジェクトを保存し、それをチェックし続けます。
このプロセスを停止するには、Nodeオブジェクトを明示的に削除する必要があります。
{{< /note >}}
現在、Kubernetesのノードインターフェースと相互作用する3つのコンポーネントがあります。ノードコントローラー、kubelet、およびkubectlです。
### ノードコントローラー
ノードコントローラーは、ノードのさまざまな側面を管理するKubernetesのマスターコンポーネントです。
ノードコントローラーは、ノードの存続期間中に複数の役割を果たします。1つ目は、ノードが登録されたときにCIDRブロックをノードに割り当てることです(CIDR割り当てがオンになっている場合)。
2つ目は、ノードコントローラーの内部ノードリストをクラウドの利用可能なマシンのリストと一致させることです。
クラウド環境で実行している場合、ノードに異常があると、ノードコントローラーはクラウドプロバイダーにそのNodeのVMがまだ使用可能かどうかを問い合わせます。
使用可能でない場合、ノードコントローラーはノードのリストから該当ノードを削除します。
3つ目は、ノードの状態を監視することです。
ノードが到達不能(例えば、ノードがダウンしているなどので理由で、ノードコントローラーがハートビートの受信を停止した場合)になると、ノードコントローラーは、NodeStatusのNodeReady conditionをConditionUnknownに変更する役割があります。その後も該当ノードが到達不能のままであった場合、Graceful Terminationを使って全てのPodを退役させます。デフォルトのタイムアウトは、ConditionUnknownの報告を開始するまで40秒、その後Podの追い出しを開始するまで5分に設定されています。
ノードコントローラーは、`--node-monitor-period`に設定された秒数ごとに各ノードの状態をチェックします。
バージョン1.13よりも前のKubernetesにおいて、NodeStatusはノードからのハートビートでした。Kubernetes 1.13から、NodeLeaseがアルファ機能として導入されました(Feature Gate `NodeLease`, [KEP-0009](https://github.com/kubernetes/community/blob/master/keps/sig-node/0009-node-heartbeat.md))。
NodeLeaseが有効になっている場合、各ノードは `kube-node-lease`というNamespaceに関連付けられた`Lease`オブジェクトを持ち、ノードによって定期的に更新されます。NodeStatusとNodeLeaseの両方がノードからのハートビートとして扱われます。NodeLeaseは頻繁に更新されますが、NodeStatusはノードからマスターへの変更があるか、または十分な時間が経過した場合にのみ報告されます(デフォルトは1分で、到達不能の場合のデフォルトタイムアウトである40秒よりも長いです)。NodeLeaseはNodeStatusよりもはるかに軽量であるため、スケーラビリティとパフォーマンスの両方の観点においてノードのハートビートのコストを下げます。
Kubernetes 1.4では、マスターに問題が発生した場合の対処方法を改善するように、ノードコントローラーのロジックをアップデートしています(マスターのネットワークに問題があるため)
バージョン1.4以降、ノードコントローラーは、Podの退役について決定する際に、クラスター内のすべてのノードの状態を調べます。
ほとんどの場合、排除の速度は1秒あたり`--node-eviction-rate`に設定された数値(デフォルトは秒間0.1)です。つまり、10秒間に1つ以上のPodをノードから追い出すことはありません。
特定のアベイラビリティーゾーン内のノードのステータスが異常になると、ノード排除の挙動が変わります。ノードコントローラーは、ゾーン内のノードの何%が異常(NodeReady条件がConditionUnknownまたはConditionFalseである)であるかを同時に確認します。
異常なノードの割合が少なくとも `--healthy-zone-threshold`に設定した値を下回る場合(デフォルトは0.55)であれば、退役率は低下します。クラスターが小さい場合(すなわち、 `--large-cluster-size-threshold`の設定値よりもノード数が少ない場合。デフォルトは50)、退役は停止し、そうでない場合、退役率は秒間で`--secondary-node-eviction-rate`の設定値(デフォルトは0.01)に減少します。
これらのポリシーがアベイラビリティーゾーンごとに実装されているのは、1つのアベイラビリティーゾーンがマスターから分割される一方、他のアベイラビリティーゾーンは接続されたままになる可能性があるためです。
クラスターが複数のクラウドプロバイダーのアベイラビリティーゾーンにまたがっていない場合、アベイラビリティーゾーンは1つだけです(クラスター全体)。
ノードを複数のアベイラビリティゾーンに分散させる主な理由は、1つのゾーン全体が停止したときにワークロードを正常なゾーンに移動できることです。
したがって、ゾーン内のすべてのノードが異常である場合、ノードコントローラーは通常のレート `--node-eviction-rate`で退役します。
コーナーケースは、すべてのゾーンが完全にUnhealthyである(すなわち、クラスタ内にHealthyなノードがない)場合です。
このような場合、ノードコントローラーはマスター接続に問題があると見なし、接続が回復するまですべての退役を停止します。
Kubernetes 1.6以降では、ノードコントローラーは、Podがtaintを許容しない場合、 `NoExecute`のtaintを持つノード上で実行されているPodを排除する責務もあります。
さらに、デフォルトで無効になっているアルファ機能として、ノードコントローラーはノードに到達できない、または準備ができていないなどのノードの問題に対応するtaintを追加する責務があります。
`NoExecute`のtaint及び上述のアルファ機能に関する詳細は、[こちらのドキュメント](/docs/concepts/configuration/taint-and-toleration/)をご覧ください。
バージョン1.8以降、ノードコントローラーに対してノードの状態を表すtaintを作成する責務を持たせることができます。これはバージョン1.8のアルファ機能です。
### ノードの自己登録
kubeletのフラグ `--register-node`がtrue(デフォルト)のとき、kubeletは自分自身をAPIサーバーに登録しようとします。これはほとんどのディストリビューションで使用されている推奨パターンです。
自己登録については、kubeletは以下のオプションを伴って起動されます:
- `--kubeconfig` - 自分自身をAPIサーバーに対して認証するための資格情報へのパス
- `--cloud-provider` - 自身に関するメタデータを読むためにクラウドプロバイダーと会話する方法
- `--register-node` - 自身をAPIサーバーに自動的に登録
- `--register-with-taints` - 与えられたtaintのリストでノードを登録します (カンマ区切りの `<key>=<value>:<effect>`). `register-node`がfalseの場合、このオプションは機能しません
- `--node-ip` - ノードのIPアドレス
- `--node-labels` - ノードをクラスターに登録するときに追加するラベル(1.13以降の[NodeRestriction許可プラグイン](/docs/reference/access-authn-authz/admission-controllers/#noderestriction)によって適用されるラベルの制限を参照)
- `--node-status-update-frequency` - kubeletがノードのステータスをマスターにPOSTする頻度の指定
[ノード認証モード](/docs/reference/access-authn-authz/node/)および[NodeRestriction許可プラグイン](/docs/reference/access-authn-authz/admission-controllers/#noderestriction)が有効になっている場合、kubeletは自分自身のノードリソースを作成/変更することのみ許可されています。
#### 手動によるノード管理 {#manual-node-administration}
クラスター管理者はNodeオブジェクトを作成および変更できます。
管理者が手動でNodeオブジェクトを作成したい場合は、kubeletフラグ `--register-node = false`を設定してください。
管理者は`--register-node`の設定に関係なくNodeリソースを変更することができます。
変更には、ノードにラベルを設定し、それをunschedulableとしてマークすることが含まれます。
ノード上のラベルは、スケジューリングを制御するためにPod上のノードセレクタと組み合わせて使用できます。
例えば、Podをノードのサブセットでのみ実行する資格があるように制限します。
ノードをunschedulableとしてマークすると、新しいPodがそのノードにスケジュールされるのを防ぎますが、ノード上の既存のPodには影響しません。
これは、ノードの再起動などの前の準備ステップとして役立ちます。たとえば、ノードにスケジュール不可能のマークを付けるには、次のコマンドを実行します:
```shell
kubectl cordon $ノード名
```
{{< note >}}
DaemonSetコントローラーによって作成されたPodはKubernetesスケジューラーをバイパスし、ノード上のunschedulable属性を考慮しません。
これは、再起動の準備中にアプリケーションからアプリケーションが削除されている場合でも、デーモンがマシンに属していることを前提としているためです。
{{< /note >}}
### ノードのキャパシティ
ノードのキャパシティ(CPUの数とメモリの量)はNodeオブジェクトの一部です。
通常、ノードは自分自身を登録し、Nodeオブジェクトを作成するときにキャパシティを報告します。
[手動によるノード管理](#manual-node-administration)を実行している場合は、ノードを追加するときにキャパシティを設定する必要があります。
Kubernetesスケジューラーは、ノード上のすべてのPodに十分なリソースがあることを確認します。
ノード上のコンテナが要求するリソースの合計がノードキャパシティ以下であることを確認します。
これは、kubeletによって開始されたすべてのコンテナを含みますが、[コンテナランタイム](/docs/concepts/overview/components/#node-components)によって直接開始されたコンテナやコンテナの外で実行されているプロセスは含みません。
Pod以外のプロセス用にリソースを明示的に予約したい場合は、このチュートリアルに従って[Systemデーモン用にリソースを予約](/docs/tasks/administer-cluster/reserve-compute-resources/#system-reserved)してください。
## APIオブジェクト
NodeはKubernetesのREST APIにおけるトップレベルのリソースです。APIオブジェクトに関する詳細は以下の記事にてご覧いただけます:
[Node APIオブジェクト](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#node-v1-core).
{{% /capture %}}