Second Japanese l10n work for release-1.13 (kubernetes#14465)

* Update k8s.io/ja/docs/tutorials/kubernetes-basics/create-cluster/cluster-intro/ (kubernetes#13153) * [ja] Translate Hello Minikube in tutorials (kubernetes#13100) (kubernetes#13161) * ja-trans: update supported-doc-versions.md (kubernetes#13186) * [ja] Update /concepts/overview/what-is-kubernetes.md kubernetes#13079 (kubernetes#13187) * ja-trans: update expose-intro.html (kubernetes#13215) * ja-trans: update expose-intro.html * ja-trans: fix broken links by linking to english pages * update deploy-intro.html (kubernetes#13103) (kubernetes#13208) * update deploy-intro.html (kubernetes#13103) * Update content/ja/docs/tutorials/kubernetes-basics/deploy-app/deploy-intro.html add /ja path Co-Authored-By: chidakiyo <[email protected]> * [ja] Update /setup/release/building-from-source.md (kubernetes#13095) (kubernetes#13220) * ja-trans: update /ja/docs/setup/independent/control-plane-flags/ (kubernetes#13228) * ja-trans: Update /setup/turnkey/azure.md (kubernetes#13097) (kubernetes#13224) * ja-trans: update /ja/docs/tutorials/kubernetes-basics/ (kubernetes#13232) * ja-trans: update /ja/docs/tutorials/kubernetes-basics/ * ja-trans: translate card.title * ja-trans: update setup/minikube.md (kubernetes#13091) (kubernetes#13219) * [ja] Update content of setup/minikube.md, fixing the diff between 551489f 7b07d19. * [ja] Translate the content: content/ja/docs/setup/minikube.md (kubernetes#13091) * Correct Katakana words, using long vowel words Co-Authored-By: yukinagae <[email protected]> * Fix typos Co-Authored-By: yukinagae <[email protected]> * Correct some changes, thanks for the FB Co-Authored-By: yukinagae <[email protected]> * ja-trans: Update k8s.io/ja/docs/setup/pick-right-solution/ (kubernetes#13094) (kubernetes#13328) * ja-trans: Update the content of setup/pick-right-solution.md, only fixing the diff between 551489f and 7b07d19. (Not yet translating the content at the moment to only make sure fixing the diff is ok. Next commit will be actually the translation stuff) * ja-trans: Translate /ja/docs/setup/pick-right-solution.md (kubernetes#13094) * Update content/ja/docs/setup/pick-right-solution.md Correct small changes based on the feedback Co-Authored-By: yukinagae <[email protected]> * Better translation and refer the Japanese document link Co-Authored-By: yukinagae <[email protected]> * Correct Japanese anchors Co-Authored-By: yukinagae <[email protected]> * Correct translation mistakes Co-Authored-By: yukinagae <[email protected]> * ja: Translate /docs/home (kubernetes#13366) * follow to the latest format * review * ja: fix some unnatural translation and formatting (kubernetes#13367) * format * Update content/ja/docs/setup/certificates.md Co-Authored-By: inductor <[email protected]> * ja-trans: Translate heading and subheading of docs/setup/version-skew-policy.md in Japanese (kubernetes#13360) * copy content * remove reviewer block * Translate heading and subheading. * change translation * ja-trans: Translate heading and subheading of docs/setup/turnkey/icp.md in Japanese (kubernetes#13359) * copy content * remove reviewer block * Translate heading and subheading. * ref. kubernetes#13098 (kubernetes#13358) * ref. kubernetes#13096 (kubernetes#13357) * ref. kubernetes#13089 (kubernetes#13353) * ref. kubernetes#13087 (kubernetes#13351) * ref. kubernetes#13082 (kubernetes#13348) * ref. kubernetes#13085 (kubernetes#13349) * ref. kubernetes#13088 (kubernetes#13352) * ref. kubernetes#13090 (kubernetes#13354) * ref. kubernetes#13092 (kubernetes#13355) * ref. kubernetes#13093 (kubernetes#13356) * ref. kubernetes#13099 (kubernetes#13361) * [ja] Translate the content: ja/docs/setup/independent/high-availability/ (kubernetes#13364) * [ja] Translate the content: ja/docs/setup/independent/high-availability/ * remove redundant comma, words * Update content/ja/docs/setup/independent/high-availability.md 余分な文字を削除 Co-Authored-By: TSUDA-Kyosuke <[email protected]> * Update k8s.io/ja/docs/setup/cri/ (kubernetes#13663) * fix content. * Update content/ja/docs/setup/cri.md Co-Authored-By: cstoku <[email protected]> * Update cri.md * Update content/ja/docs/setup/cri.md Co-Authored-By: cstoku <[email protected]> * Update content/ja/docs/setup/cri.md Co-Authored-By: cstoku <[email protected]> * improve translation
jluis · May 23, 2019 · 566055f · 566055f
1 parent 36d93fc
commit 566055f
Show file tree

Hide file tree

Showing 28 changed files with 995 additions and 503 deletions.
diff --git a/content/ja/docs/concepts/overview/what-is-kubernetes.md b/content/ja/docs/concepts/overview/what-is-kubernetes.md
@@ -2,6 +2,9 @@
 title: Kubernetesとは何か？
 content_template: templates/concept
 weight: 10
+card: 
+  name: concepts
+  weight: 10
 ---
 
 {{% capture overview %}}

diff --git a/content/ja/docs/home/_index.md b/content/ja/docs/home/_index.md
@@ -1,11 +1,9 @@
 ---
 title: Kubernetesドキュメント
-layout: docsportal_home
 noedit: true
-cid: userJourneys
-css: /css/style_user_journeys.css
-js: /js/user-journeys/home.js, https://use.fontawesome.com/4bcc658a89.js
-display_browse_numbers: true
+cid: docsHome
+layout: docsportal_home
+class: gridPage
 linkTitle: "ホーム"
 main_menu: true
 weight: 10
@@ -16,4 +14,43 @@ menu:
     weight: 20
     post: >
       <p>チュートリアル、サンプルやドキュメントのリファレンスを使って Kubernetes の利用方法を学んでください。あなたは<a href="/editdocs/" data-auto-burger-exclude>ドキュメントへコントリビュートをする</a>こともできます!</p>
+overview: >
+  Kubernetesは、自動デプロイ、スケーリング、およびコンテナ化されたアプリケーションの管理を行うための、オープンソースのコンテナオーケストレーションエンジンです。本オープンソースプロジェクトは、Cloud Native Computing Foundation (<a href="https://www.cncf.io/about">CNCF</a>).によって管理されています。
+cards:
+- name: concepts
+  title: "基本を理解する"
+  description: "Kubernetesに基本的なコンセプトについて学びます。"
+  button: "コンセプトを学ぶ"
+  button_path: "/ja/docs/concepts"
+- name: tutorials
+  title: "Kubernetesを試用する"
+  description: "チュートリアルに沿って、Kubernetesにアプリケーションをデプロイする方法を学びます。"
+  button: "チュートリアルを見る"
+  button_path: "/ja/docs/tutorials"
+- name: setup
+  title: "クラスターを立ち上げる"
+  description: "ご自身のリソースや要件に合わせたKubernetes環境を動かしてみましょう。"
+  button: "Kubernetesをセットアップする"
+  button_path: "/ja/docs/setup"
+- name: tasks
+  title: "Kubernetesの使い方を学ぶ"
+  description: "一般的な使い方と、それらを実行するための短い手順を調べます。"
+  button: "View Tasks"
+  button_path: "/ja/docs/tasks"
+- name: reference
+  title: 参考情報を探す
+  description: 用語、コマンドラインの構文、APIのリソースタイプ、およびセットアップツールのドキュメントを参照します。
+  button: View Reference
+  button_path: /ja/docs/reference
+- name: contribute
+  title: ドキュメントに貢献する
+  description: 本プロジェクトに不慣れな方でも、久しぶりの方も、どなたでも貢献することができます。
+  button: ドキュメントに貢献する
+  button_path: /ja/docs/contribute
+- name: download
+  title: Kubernetesをダウンロードする
+  description: Kubernetesをインストールする場合や最新バージョンにアップグレードする場合は、現在のリリースノートを参照してください。
+- name: about
+  title: ドキュメントについて
+  description: このWebサイトには、Kubernetesの現在および以前の4つのバージョンに関するドキュメントが含まれています。
 ---
diff --git a/content/ja/docs/home/supported-doc-versions.md b/content/ja/docs/home/supported-doc-versions.md
@@ -1,6 +1,10 @@
 ---
 title: Kubernetesドキュメントがサポートしているバージョン
 content_template: templates/concept
+card:
+  name: about
+  weight: 10
+  title: ドキュメントがサポートしているバージョン
 ---
 
 {{% capture overview %}}

diff --git a/content/ja/docs/setup/certificates.md b/content/ja/docs/setup/certificates.md
@@ -14,7 +14,7 @@ This page explains the certificates that your cluster requires.
 
 {{% capture body %}}
 
-## あなたのクラスタではどのように証明書が使われているのか
+## クラスタではどのように証明書が使われているのか
 
 Kubernetes requires PKI for the following operations:
 
@@ -43,7 +43,7 @@ If you don't want kubeadm to generate the required certificates, you can create
 
 ### 単一ルート認証局
 
-You can create a single root CA, controlled by an administrator. This root CA can then create multiple intermediate CAs, and delegate all further creation to Kubernetes itself. 
+You can create a single root CA, controlled by an administrator. This root CA can then create multiple intermediate CAs, and delegate all further creation to Kubernetes itself.
 
 Required CAs:
 
@@ -55,7 +55,7 @@ Required CAs:
 
 ### 全ての証明書
 
-If you don't wish to copy these private keys to your API servers, you can generate all certificates yourself. 
+If you don't wish to copy these private keys to your API servers, you can generate all certificates yourself.
 
 Required certificates:
 
@@ -85,14 +85,15 @@ Certificates should be placed in a recommended path (as used by [kubeadm][kubead
 | Default CN                   | recommend key path           | recommended cert path       | command        | key argument                 | cert argument                             |
 |------------------------------|------------------------------|-----------------------------|----------------|------------------------------|-------------------------------------------|
 | etcd-ca                      |                              | etcd/ca.crt                 | kube-apiserver |                              | --etcd-cafile                             |
-| etcd-client                  | apiserver-etcd-client.crt    | apiserver-etcd-client.crt   | kube-apiserver | --etcd-certfile              | --etcd-keyfile                            |
-| kubernetes-ca                |                              | ca.crt                      | kube-apiserver | --client-ca-file             |                                           |
-| kube-apiserver               | apiserver.crt                | apiserver.key               | kube-apiserver | --tls-cert-file              | --tls-private-key                         |
-| apiserver-kubelet-client     | apiserver-kubelet-client.crt |                             | kube-apiserver | --kubelet-client-certificate |                                           |
-| front-proxy-client           | front-proxy-client.key       | front-proxy-client.crt      | kube-apiserver | --proxy-client-cert-file     | --proxy-client-key-file                   |
+| etcd-client                  | apiserver-etcd-client.key    | apiserver-etcd-client.crt   | kube-apiserver | --etcd-keyfile               | --etcd-certfile                           |
+| kubernetes-ca                |                              | ca.crt                      | kube-apiserver |                              | --client-ca-file                          |
+| kube-apiserver               | apiserver.key                | apiserver.crt               | kube-apiserver | --tls-private-key-file       | --tls-cert-file                           |
+| apiserver-kubelet-client     |                              | apiserver-kubelet-client.crt| kube-apiserver |                              | --kubelet-client-certificate              |
+| front-proxy-ca               |                              | front-proxy-ca.crt          | kube-apiserver |                              | --requestheader-client-ca-file            |
+| front-proxy-client           | front-proxy-client.key       | front-proxy-client.crt      | kube-apiserver | --proxy-client-key-file      | --proxy-client-cert-file                  |
 |                              |                              |                             |                |                              |                                           |
 | etcd-ca                      |                              | etcd/ca.crt                 | etcd           |                              | --trusted-ca-file, --peer-trusted-ca-file |
-| kube-etcd                    |                              | etcd/server.crt             | etcd           |                              | --cert-file                               |
+| kube-etcd                    | etcd/server.key              | etcd/server.crt             | etcd           | --key-file                   | --cert-file                               |
 | kube-etcd-peer               | etcd/peer.key                | etcd/peer.crt               | etcd           | --peer-key-file              | --peer-cert-file                          |
 | etcd-ca                      |                              | etcd/ca.crt                 | etcdctl[2]     |                              | --cacert                                  |
 | kube-etcd-healthcheck-client | etcd/healthcheck-client.key  | etcd/healthcheck-client.crt | etcdctl[2]     | --key                        | --cert                                    |
@@ -101,15 +102,19 @@ Certificates should be placed in a recommended path (as used by [kubeadm][kubead
 
 ## ユーザアカウント用に証明書を設定する
 
-You must manually configure these administrator account and service accounts: 
+You must manually configure these administrator account and service accounts:
 
 | filename                | credential name            | Default CN                     | O (in Subject) |
 |-------------------------|----------------------------|--------------------------------|----------------|
 | admin.conf              | default-admin              | kubernetes-admin               | system:masters |
-| kubelet.conf            | default-auth               | system:node:`<nodename>`        | system:nodes   |
+| kubelet.conf            | default-auth               | system:node:`<nodeName>` (see note) | system:nodes   |
 | controller-manager.conf | default-controller-manager | system:kube-controller-manager |                |
 | scheduler.conf          | default-manager            | system:kube-scheduler          |                |
 
+{{< note >}}
+The value of `<nodeName>` for `kubelet.conf` **must** match precisely the value of the node name provided by the kubelet as it registers with the apiserver. For further details, read the [Node Authorization](/docs/reference/access-authn-authz/node/).
+{{< /note >}}
+
 1. For each config, generate an x509 cert/key pair with the given CN and O.
 
 1. Run `kubectl` as follows for each config:

diff --git a/content/ja/docs/setup/cri.md b/content/ja/docs/setup/cri.md
@@ -4,48 +4,83 @@ content_template: templates/concept
 weight: 100
 ---
 {{% capture overview %}}
-Kubernetesでは、v1.6.0からデフォルトでCRI(Container Runtime Interface)を利用できます。
-このページでは、様々なCRIのインストール方法について説明します。
+{{< feature-state for_k8s_version="v1.6" state="stable" >}}
+Podのコンテナを実行するために、Kubernetesはコンテナランタイムを使用します。
+様々なランタイムのインストール手順は次のとおりです。
 
 {{% /capture %}}
 
 {{% capture body %}}
 
-手順を進めるにあたっては、下記に示しているコマンドを、ご利用のOSのものに従ってrootユーザとして実行してください。
-環境によっては、それぞれのホストへSSHで接続した後に`sudo -i`を実行することで、rootユーザになることができる場合があります。
+
+{{< caution >}}
+コンテナ実行時にruncがシステムファイルディスクリプターを扱える脆弱性が見つかりました。
+悪意のあるコンテナがこの脆弱性を利用してruncのバイナリを上書きし、
+コンテナホストシステム上で任意のコマンドを実行する可能性があります。
+
+この問題の更なる情報は以下のリンクを参照してください。
+[cve-2019-5736 : runc vulnerability](https://access.redhat.com/security/cve/cve-2019-5736)
+{{< /caution >}}
+
+### 適用性
+
+{{< note >}}
+このドキュメントはLinuxにCRIをインストールするユーザーの為に書かれています。
+他のオペレーティングシステムの場合、プラットフォーム固有のドキュメントを見つけてください。
+{{< /note >}}
+
+このガイドでは全てのコマンドを `root` で実行します。
+例として、コマンドに `sudo` を付けたり、 `root` になってそのユーザーでコマンドを実行します。
+
+### Cgroupドライバー
+
+systemdがLinuxのディストリビューションのinitシステムとして選択されている場合、
+initプロセスが作成され、rootコントロールグループ(`cgroup`)を使い、cgroupマネージャーとして行動します。
+systemdはcgroupと密接に統合されており、プロセスごとにcgroupを割り当てます。
+`cgroupfs` を使うように、あなたのコンテナランライムとkubeletを設定することができます。
+systemdと一緒に `cgroupfs` を使用するということは、2つの異なるcgroupマネージャーがあることを意味します。
+
+コントロールグループはプロセスに割り当てられるリソースを制御するために使用されます。
+単一のcgroupマネージャーは、割り当てられているリソースのビューを単純化し、
+デフォルトでは使用可能なリソースと使用中のリソースについてより一貫性のあるビューになります。
+2つのマネージャーがある場合、それらのリソースについて2つのビューが得られます。
+kubeletとDockerに `cgroupfs` を使用し、ノード上で実行されている残りのプロセスに `systemd` を使用するように設定されたノードが、
+リソース圧迫下で不安定になる場合があります。
+
+あなたのコンテナランタイムとkubeletにcgroupドライバーとしてsystemdを使用するように設定を変更することはシステムを安定させました。
+以下のDocker設定の `native.cgroupdriver=systemd` オプションに注意してください。
 
 ## Docker
 
 それぞれのマシンに対してDockerをインストールします。
-バージョン18.06が推奨されていますが、1.11、1.12、1.13、17.03についても動作が確認されています。
+バージョン18.06.2が推奨されていますが、1.11、1.12、1.13、17.03、18.09についても動作が確認されています。
 Kubernetesのリリースノートにある、Dockerの動作確認済み最新バージョンについてもご確認ください。
 
 システムへDockerをインストールするには、次のコマンドを実行します。
 
 {{< tabs name="tab-cri-docker-installation" >}}
 {{< tab name="Ubuntu 16.04" codelang="bash" >}}
-# UbuntuのリポジトリからDockerをインストールする場合は次を実行します:
-apt-get update
-apt-get install -y docker.io
+# Docker CEのインストール
+## リポジトリをセットアップ
+### aptパッケージインデックスを更新
+    apt-get update
 
-# または、UbuntuやDebian向けのDockerのリポジトリからDocker CE 18.06をインストールする場合は、次を実行します:
+### HTTPS越しのリポジトリの使用をaptに許可するために、パッケージをインストール
+    apt-get update && apt-get install apt-transport-https ca-certificates curl software-properties-common
 
-## 必要なパッケージをインストールします。
-apt-get update && apt-get install apt-transport-https ca-certificates curl software-properties-common
+### Docker公式のGPG鍵を追加
+    curl -fsSL https://download.docker.com/linux/ubuntu/gpg | apt-key add -
 
-## GPGキーをダウンロードします。
-curl -fsSL https://download.docker.com/linux/ubuntu/gpg | apt-key add -
+### dockerのaptリポジトリを追加
+    add-apt-repository \
+    "deb [arch=amd64] https://download.docker.com/linux/ubuntu \
+    $(lsb_release -cs) \
+    stable"
 
-## dockerパッケージ用のaptリポジトリを追加します。
-add-apt-repository \
-   "deb [arch=amd64] https://download.docker.com/linux/ubuntu \
-   $(lsb_release -cs) \
-   stable"
+## docker ceのインストール
+apt-get update && apt-get install docker-ce=18.06.2~ce~3-0~ubuntu
 
-## dockerをインストールします。
-apt-get update && apt-get install docker-ce=18.06.0~ce~3-0~ubuntu
-
-# デーモンをセットアップします。
+# デーモンをセットアップ
 cat > /etc/docker/daemon.json <<EOF
 {
   "exec-opts": ["native.cgroupdriver=systemd"],
@@ -59,32 +94,29 @@ EOF
 
 mkdir -p /etc/systemd/system/docker.service.d
 
-# dockerを再起動します。
+# dockerを再起動
 systemctl daemon-reload
 systemctl restart docker
 {{< /tab >}}
 {{< tab name="CentOS/RHEL 7.4+" codelang="bash" >}}
 
-# CentOSやRHELのリポジトリからDockerをインストールする場合は、次を実行します:
-yum install -y docker
-
-# または、CentOS向けのDockerのリポジトリからDocker CE 18.06をインストールする場合は、次を実行します:
-
-## 必要なパッケージをインストールします。
-yum install yum-utils device-mapper-persistent-data lvm2
+# Docker CEのインストール
+## リポジトリをセットアップ
+### 必要なパッケージのインストール
+    yum install yum-utils device-mapper-persistent-data lvm2
 
-## dockerパッケージ用のyumリポジトリを追加します。
+### dockerパッケージ用のyumリポジトリを追加
 yum-config-manager \
     --add-repo \
     https://download.docker.com/linux/centos/docker-ce.repo
 
-## dockerをインストールします。
-yum update && yum install docker-ce-18.06.1.ce
+## docker ceのインストール
+yum update && yum install docker-ce-18.06.2.ce
 
-## /etc/docker ディレクトリを作成します。
+## /etc/docker ディレクトリを作成
 mkdir /etc/docker
 
-# デーモンをセットアップします。
+# デーモンをセットアップ
 cat > /etc/docker/daemon.json <<EOF
 {
   "exec-opts": ["native.cgroupdriver=systemd"],
@@ -101,7 +133,7 @@ EOF
 
 mkdir -p /etc/systemd/system/docker.service.d
 
-# dockerを再起動します。
+# dockerを再起動
 systemctl daemon-reload
 systemctl restart docker
 {{< /tab >}}
@@ -217,8 +249,8 @@ tar --no-overwrite-dir -C / -xzf cri-containerd-${CONTAINERD_VERSION}.linux-amd6
 systemctl start containerd
 ```
 
-## その他のCRIランタイム(rktletおよびfrakti)について
+## その他のCRIランタイム: frakti
 
-詳細については[Fraktiのクイックスタートガイド](https://github.com/kubernetes/frakti#quickstart)および[Rktletのクイックスタートガイド](https://github.com/kubernetes-incubator/rktlet/blob/master/docs/getting-started-guide.md)を参照してください。
+詳細については[Fraktiのクイックスタートガイド](https://github.com/kubernetes/frakti#quickstart)を参照してください。
 
 {{% /capture %}}
diff --git a/content/ja/docs/setup/independent/control-plane-flags.md b/content/ja/docs/setup/independent/control-plane-flags.md
@@ -6,6 +6,8 @@ weight: 40
 
 {{% capture overview %}}
 
+{{< feature-state for_k8s_version="1.12" state="stable" >}}
+
 kubeadmの`ClusterConfiguration`オブジェクトはAPIServer、ControllerManager、およびSchedulerのようなコントロールプレーンの構成要素に渡されたデフォルトのフラグを上書きすることができる `extraArgs`の項目があります。
 その構成要素は次の項目で定義されています。