Merge pull request #22643 from hikkie3110/fix-22359

Update install-kubeadm.md for v1.17

content/ja/docs/setup/production-environment/tools/kubeadm/install-kubeadm.md

@@ -1,7 +1,7 @@
 ---
 title: kubeadmのインストール
 content_type: task
-weight: 20
+weight: 10
 card:
   name: setup
   weight: 20
@@ -18,7 +18,6 @@ card:
 
 ## {{% heading "prerequisites" %}}
 
-
 * 次のいずれかが動作しているマシンが必要です
   - Ubuntu 16.04+
   - Debian 9+
@@ -49,6 +48,22 @@ card:
 
 複数のネットワークアダプターがあり、Kubernetesコンポーネントにデフォルトで到達できない場合、IPルートを追加して、Kubernetesクラスターのアドレスが適切なアダプターを経由するように設定することをお勧めします。
 
+## iptablesがブリッジを通過するトラフィックを処理できるようにする
+
+Linuxノードのiptablesがブリッジを通過するトラフィックを正確に処理する要件として、`net.bridge.bridge-nf-call-iptables`を`sysctl`の設定ファイルで1に設定してください。例えば以下のようにします。
+
+```bash
+cat <<EOF > /etc/sysctl.d/k8s.conf
+net.bridge.bridge-nf-call-ip6tables = 1
+net.bridge.bridge-nf-call-iptables = 1
+EOF
+sysctl --system
+```
+
+この手順の前に`br_netfilter`モジュールがロードされていることを確認してください。`lsmod | grep br_netfilter`を実行することで確認できます。明示的にロードするには`modprobe br_netfilter`を実行してください。
+
+詳細は[ネットワークプラグインの要件](https://kubernetes.io/docs/concepts/extend-kubernetes/compute-storage-net/network-plugins/#network-plugin-requirements)を参照してください。
+
 ## iptablesがnftablesバックエンドを使用しないようにする
 
 Linuxでは、カーネルのiptablesサブシステムの最新の代替品としてnftablesが利用できます。`iptables`ツールは互換性レイヤーとして機能し、iptablesのように動作しますが、実際にはnftablesを設定します。このnftablesバックエンドは現在のkubeadmパッケージと互換性がありません。(ファイアウォールルールが重複し、`kube-proxy`を破壊するためです。)
@@ -61,6 +76,7 @@ Linuxでは、カーネルのiptablesサブシステムの最新の代替品と
 # レガシーバイナリがインストールされていることを確認してください
 sudo apt-get install -y iptables arptables ebtables
 
+# レガシーバージョンに切り替えてください。
 sudo update-alternatives --set iptables /usr/sbin/iptables-legacy
 sudo update-alternatives --set ip6tables /usr/sbin/ip6tables-legacy
 sudo update-alternatives --set arptables /usr/sbin/arptables-legacy
@@ -76,7 +92,7 @@ update-alternatives --set iptables /usr/sbin/iptables-legacy
 
 ## 必須ポートの確認
 
-### マスターノード
+### コントロールプレーンノード
 
 | プロトコル | 通信の向き | ポート範囲  | 目的                    | 使用者                    |
 |-----------|------------|------------|-------------------------|---------------------------|
@@ -103,29 +119,39 @@ etcdポートはコントロールプレーンノードに含まれています
 
 ## ランタイムのインストール {#installing-runtime}
 
-v1.6.0以降、KubernetesはデフォルトでCRI(Container Runtime Interface)の使用を有効にしています。
+Podのコンテナを実行するために、Kubernetesは{{< glossary_tooltip term_id="container-runtime" text="コンテナランタイム" >}}を使用します。
 
-また、v1.14.0以降、kubeadmは既知のドメインソケットのリストをスキャンして、Linuxノード上のコンテナランタイムを自動的に検出しようとします。検出可能なランタイムとソケットパスは、以下の表に記載されています。
+{{< tabs name="container_runtime" >}}
+{{% tab name="Linuxノード" %}}
 
-| ランタイム  | ドメインソケット                  |
+デフォルトでは、Kubernetesは選択されたコンテナランタイムと通信するために{{< glossary_tooltip term_id="cri" text="Container Runtime Interface">}} (CRI)を使用します。
-|------------|----------------------------------|
-| Docker     | /var/run/docker.sock             |
-| containerd | /run/containerd/containerd.sock  |
-| CRI-O      | /var/run/crio/crio.sock          |
 
+ランタイムを指定しない場合、kubeadmはよく知られたUnixドメインソケットのリストをスキャンすることで、インストールされたコンテナランタイムの検出を試みます。
+次の表がコンテナランタイムと関連するソケットのパスリストです。
+
+{{< table caption = "コンテナランタイムとソケットパス" >}}
+| ランタイム  | Unixドメインソケットのパス        |
+|------------|-----------------------------------|
+| Docker     | `/var/run/docker.sock`            |
+| containerd | `/run/containerd/containerd.sock` |
+| CRI-O      | `/var/run/crio/crio.sock`         |
+{{< /table >}}
+
+<br />
 Dockerとcontainerdの両方が同時に検出された場合、Dockerが優先されます。Docker 18.09にはcontainerdが同梱されており、両方が検出可能であるため、この仕様が必要です。他の2つ以上のランタイムが検出された場合、kubeadmは適切なエラーメッセージで終了します。
 
-Linux以外のノードでは、デフォルトで使用されるコンテナランタイムはDockerです。
+kubeletは、組み込まれた`dockershim`CRIを通してDockerと連携します。
 
-もしコンテナランタイムとしてDockerを選択した場合、`kebelet`内に組み込まれた`dockershim` CRIが使用されます。
+詳細は、[コンテナランタイム](/ja/docs/setup/production-environment/container-runtimes/)を参照してください。
+{{% /tab %}}
+{{% tab name="その他のOS" %}}
+デフォルトでは、kubeadmは{{< glossary_tooltip term_id="docker" >}}をコンテナランタイムとして使用します。
+kubeletは、組み込まれた`dockershim`CRIを通してDockerと連携します。
 
-その他のCRIに基づくランタイムでは以下を使用します
+詳細は、[コンテナランタイム](/ja/docs/setup/production-environment/container-runtimes/)を参照してください。
+{{% /tab %}}
+{{< /tabs >}}
 
-- [containerd](https://github.com/containerd/cri) (CRI plugin built into containerd)
-- [cri-o](https://cri-o.io/)
-- [frakti](https://github.com/kubernetes/frakti)
-
-詳細は[CRIのインストール](/ja/docs/setup/production-environment/container-runtimes/)を参照してください。
 
 ## kubeadm、kubelet、kubectlのインストール
 
@@ -143,7 +169,7 @@ kubeadmは`kubelet`や`kubectl`をインストールまたは管理**しない**
 `kubectl`のインストールに関する詳細情報は、[kubectlのインストールおよびセットアップ](/ja/docs/tasks/tools/install-kubectl/)を参照してください。
 
 {{< warning >}}
-これらの手順はシステムアップグレードによるすべてのKubernetesパッケージの更新を除きます。これはkubeadmとKubernetesが[アップグレードにおける特別な注意](docs/tasks/administer-cluster/kubeadm/kubeadm-upgrade/)を必要とするからです。
+これらの手順はシステムアップグレードによるすべてのKubernetesパッケージの更新を除きます。これはkubeadmとKubernetesが[アップグレードにおける特別な注意](/docs/tasks/administer-cluster/kubeadm/kubeadm-upgrade/)を必要とするからです。
 {{</ warning >}}
 
 バージョン差異(version skew)に関しては下記を参照してください。
@@ -176,7 +202,7 @@ repo_gpgcheck=1
 gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
 EOF
 
-# Set SELinux in permissive mode (effectively disabling it)
+# SELinuxをpermissiveモードに設定する(効果的に無効化する)
 setenforce 0
 sed -i 's/^SELINUX=enforcing$/SELINUX=permissive/' /etc/selinux/config
 
@@ -187,23 +213,13 @@ systemctl enable --now kubelet
 
   **Note:**
 
-  - Setting SELinux in permissive mode by running `setenforce 0` and `sed ...` effectively disables it.
+  - `setenforce 0`および`sed ...`を実行することによりSELinuxをpermissiveモードに設定し、効果的に無効化できます。
-    This is required to allow containers to access the host filesystem, which is needed by pod networks for example.
+    これはコンテナがホストのファイルシステムにアクセスするために必要です。例えば、Podのネットワークに必要とされます。
-    You have to do this until SELinux support is improved in the kubelet.
+    kubeletにおけるSELinuxのサポートが改善されるまでは、これを実行しなければなりません。
-  - Some users on RHEL/CentOS 7 have reported issues with traffic being routed incorrectly due to iptables being bypassed. You should ensure
-    `net.bridge.bridge-nf-call-iptables` is set to 1 in your `sysctl` config, e.g.
 
-    ```bash
-    cat <<EOF > /etc/sysctl.d/k8s.conf
-    net.bridge.bridge-nf-call-ip6tables = 1
-    net.bridge.bridge-nf-call-iptables = 1
-    EOF
-    sysctl --system
-    ```
-  - Make sure that the `br_netfilter` module is loaded before this step. This can be done by running `lsmod | grep br_netfilter`. To load it explicitly call `modprobe br_netfilter`.
 {{% /tab %}}
 {{% tab name="Container Linux" %}}
-Install CNI plugins (required for most pod network):
+CNIプラグインをインストールする(ほとんどのPodのネットワークに必要です):
 
 ```bash
 CNI_VERSION="v0.8.2"
@@ -211,7 +227,7 @@ mkdir -p /opt/cni/bin
 curl -L "https://github.com/containernetworking/plugins/releases/download/${CNI_VERSION}/cni-plugins-linux-amd64-${CNI_VERSION}.tgz" | tar -C /opt/cni/bin -xz
 ```
 
-Install crictl (required for kubeadm / Kubelet Container Runtime Interface (CRI))
+crictlをインストールする (kubeadm / Kubelet Container Runtime Interface (CRI)に必要です)
 
 ```bash
 CRICTL_VERSION="v1.16.0"
@@ -219,7 +235,7 @@ mkdir -p /opt/bin
 curl -L "https://github.com/kubernetes-sigs/cri-tools/releases/download/${CRICTL_VERSION}/crictl-${CRICTL_VERSION}-linux-amd64.tar.gz" | tar -C /opt/bin -xz
 ```
 
-Install `kubeadm`, `kubelet`, `kubectl` and add a `kubelet` systemd service:
+`kubeadm`、`kubelet`、`kubectl`をインストールし`kubelet`をsystemd serviceに登録します:
 
 ```bash
 RELEASE="$(curl -sSL https://dl.k8s.io/release/stable.txt)"
@@ -234,7 +250,7 @@ mkdir -p /etc/systemd/system/kubelet.service.d
 curl -sSL "https://raw.githubusercontent.com/kubernetes/kubernetes/${RELEASE}/build/debs/10-kubeadm.conf" | sed "s:/usr/bin:/opt/bin:g" > /etc/systemd/system/kubelet.service.d/10-kubeadm.conf
 ```
 
-Enable and start `kubelet`:
+`kubelet`を有効化し起動します:
 
 ```bash
 systemctl enable --now kubelet
@@ -244,7 +260,7 @@ systemctl enable --now kubelet
 
 kubeadmが何をすべきか指示するまで、kubeletはクラッシュループで数秒ごとに再起動します。
 
-## マスターノードのkubeletによって使用されるcgroupドライバーの設定
+## コントロールプレーンノードのkubeletによって使用されるcgroupドライバーの設定
 
 Dockerを使用した場合、kubeadmは自動的にkubelet向けのcgroupドライバーを検出し、それを実行時に`/var/lib/kubelet/kubeadm-flags.env`ファイルに設定します。
 
@@ -275,4 +291,3 @@ kubeadmで問題が発生した場合は、[トラブルシューティング](/
 
 
 * [kubeadmを使用したシングルコントロールプレーンクラスターの作成](/ja/docs/setup/production-environment/tools/kubeadm/create-cluster-kubeadm/)
-