Skip to content

Commit

Permalink
Add Japanese translation (k3s-io#307)
Browse files Browse the repository at this point in the history
* add locale ja

Signed-off-by: YANO Tetsurou <tetsurou.yano@stylez.co.jp>

* add docs translated into Japanese

Signed-off-by: YANO Tetsurou <tetsurou.yano@stylez.co.jp>

* fix wording from フランネル to flannel

Signed-off-by: YANO Tetsurou <tetsurou.yano@stylez.co.jp>

* fix wording from 秘密 to secret

Signed-off-by: YANO Tetsurou <tetsurou.yano@stylez.co.jp>

* Removed unnecessary debugging file used during development

Signed-off-by: YANO Tetsurou <tetsurou.yano@stylez.co.jp>

* fix Release version missing

Signed-off-by: YANO Tetsurou <tetsurou.yano@stylez.co.jp>

* Translate the untranslated parts

Signed-off-by: YANO Tetsurou <tetsurou.yano@stylez.co.jp>

* fix to translate the untranslated parts

Signed-off-by: YANO Tetsurou <tetsurou.yano@stylez.co.jp>

* Fixed the CI build failure caused by <ca-string>

https://github.com/k3s-io/docs/actions/runs/9949694541/job/27523328173?pr=307

Signed-off-by: YANO Tetsurou <tetsurou.yano@stylez.co.jp>

---------

Signed-off-by: YANO Tetsurou <tetsurou.yano@stylez.co.jp>
  • Loading branch information
ynott authored Aug 27, 2024
1 parent 34175a1 commit 1f576d2
Show file tree
Hide file tree
Showing 59 changed files with 17,441 additions and 1 deletion.
5 changes: 4 additions & 1 deletion docusaurus.config.js
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ module.exports = {
],
i18n: {
defaultLocale: "en",
locales: ["en", "zh", "kr"],
locales: ["en", "zh", "kr", "ja"],
localeConfigs: {
en: {
label: "English",
Expand All @@ -41,6 +41,9 @@ module.exports = {
kr: {
label: "한국어",
},
ja: {
label: "日本語"
}
},
},
themeConfig: {
Expand Down
464 changes: 464 additions & 0 deletions i18n/ja/docusaurus-plugin-content-docs/current/advanced.md

Large diffs are not rendered by default.

85 changes: 85 additions & 0 deletions i18n/ja/docusaurus-plugin-content-docs/current/architecture.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,85 @@
---
title: アーキテクチャ
---

import ThemedImage from '@theme/ThemedImage';
import useBaseUrl from '@docusaurus/useBaseUrl';

### サーバーとエージェント

* サーバーノードは、`k3s server` コマンドを実行しているホストとして定義され、K3sによって管理されるコントロールプレーンとデータストアコンポーネントを持ちます。
* エージェントノードは、`k3s agent` コマンドを実行しているホストとして定義され、データストアやコントロールプレーンコンポーネントは持ちません。
* サーバーとエージェントの両方がkubelet、コンテナランタイム、およびCNIを実行します。エージェントレスサーバーの実行に関する詳細は、[高度なオプション](./advanced.md#running-agentless-servers-experimental)のドキュメントを参照してください。

![](/img/how-it-works-k3s-revised.svg)

### 埋め込みDBを使用したシングルサーバーセットアップ

以下の図は、埋め込みSQLiteデータベースを持つシングルノードK3sサーバーを含むクラスターの例を示しています。

この構成では、各エージェントノードは同じサーバーノードに登録されます。K3sユーザーは、サーバーノード上のK3s APIを呼び出すことでKubernetesリソースを操作できます。

<ThemedImage
alt="シングルサーバーを持つK3sアーキテクチャ"
sources={{
light: useBaseUrl('/img/k3s-architecture-single-server.svg'),
dark: useBaseUrl('/img/k3s-architecture-single-server-dark.svg'),
}}
/>

### 高可用性K3s

シングルサーバークラスターはさまざまなユースケースに対応できますが、Kubernetesコントロールプレーンの稼働時間が重要な環境では、K3sをHA構成で実行できます。HA K3sクラスターは以下を含みます:

<Tabs>
<TabItem value="埋め込みDB">

* Kubernetes APIを提供し、他のコントロールプレーンサービスを実行する**3つ以上のサーバーノード**
* シングルサーバーセットアップで使用される埋め込みSQLiteデータストアとは対照的に、**埋め込みetcdデータストア**

<ThemedImage
alt="高可用性サーバーを持つK3sアーキテクチャ"
sources={{
light: useBaseUrl('/img/k3s-architecture-ha-embedded.svg'),
dark: useBaseUrl('/img/k3s-architecture-ha-embedded-dark.svg'),
}} />

</TabItem>
<TabItem value="外部DB">

* Kubernetes APIを提供し、他のコントロールプレーンサービスを実行する**2つ以上のサーバーノード**
* **外部データストア**(MySQL、PostgreSQL、またはetcdなど)

<ThemedImage
alt="高可用性サーバーと外部DBを持つK3sアーキテクチャ"
sources={{
light: useBaseUrl('/img/k3s-architecture-ha-external.svg'),
dark: useBaseUrl('/img/k3s-architecture-ha-external-dark.svg'),
}} />

</TabItem>
</Tabs>

### エージェントノードの固定登録アドレス

高可用性サーバー構成では、各ノードは以下の図に示すように、固定登録アドレスを使用してKubernetes APIに登録することもできます。

登録後、エージェントノードはサーバーノードの1つに直接接続を確立します。

<ThemedImage
alt="エージェント登録HA"
sources={{
light: useBaseUrl('/img/k3s-production-setup.svg'),
dark: useBaseUrl('/img/k3s-production-setup-dark.svg'),
}}
/>

### エージェントノードの登録方法

エージェントノードは、`k3s agent` プロセスによって開始されるWebSocket接続で登録され、その接続はエージェントプロセスの一部として実行されるクライアントサイドのロードバランサーによって維持されます。最初に、エージェントはポート6443のローカルロードバランサーを介してスーパーバイザー(およびkube-apiserver)に接続します。ロードバランサーは接続可能なエンドポイントのリストを維持します。デフォルト(および最初の)エンドポイントは、`--server` アドレスからのホスト名によってシードされます。クラスターに接続すると、エージェントはデフォルトのネームスペース内のKubernetesサービスエンドポイントリストからkube-apiserverアドレスのリストを取得します。これらのエンドポイントはロードバランサーに追加され、クラスター内のすべてのサーバーに安定した接続を維持し、個々のサーバーの停止に耐えるkube-apiserverへの接続を提供します。

エージェントは、ノードクラスターシークレットと、`/etc/rancher/node/password` に保存されるランダムに生成されたパスワードを使用してサーバーに登録されます。サーバーは個々のノードのパスワードをKubernetesシークレットとして保存し、後続の試行では同じパスワードを使用する必要があります。ノードパスワードシークレットは、`<host>.node-password.k3s` テンプレートを使用した名前で`kube-system`ネームスペースに保存されます。これはノードIDの整合性を保護するために行われます。

エージェントの`/etc/rancher/node`ディレクトリが削除された場合、または既存の名前を使用してノードを再参加させたい場合は、クラスターからノードを削除する必要があります。これにより、古いノードエントリとノードパスワードシークレットの両方がクリーンアップされ、ノードがクラスターに再参加できるようになります。

ホスト名を頻繁に再利用するが、ノードパスワードシークレットを削除できない場合は、`--with-node-id` フラグを使用してK3sサーバーまたはエージェントを起動することで、ホスト名に一意のノードIDを自動的に追加できます。有効にすると、ノードIDも`/etc/rancher/node/`に保存されます。
152 changes: 152 additions & 0 deletions i18n/ja/docusaurus-plugin-content-docs/current/cli/agent.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,152 @@
---
title: エージェント
---

# k3s エージェント

このセクションでは、K3sエージェントの設定方法を学びます。

サーバーもエージェントを実行するため、このページに記載されているすべてのフラグはサーバーでも使用可能です。

オプションはCLIフラグとしてこのページに記載されていますが、設定ファイルオプションとしても渡すことができます。YAML設定ファイルの使用方法については、[設定ファイル](../installation/configuration.md#configuration-file)のドキュメントを参照してください。

### ロギング

| フラグ | デフォルト | 説明 |
| ----------------------- | ------- | -------------------------------------------------------------------- |
| `-v`| 0 | ログレベルの冗長度の数値 |
| `--vmodule`| N/A | ファイルフィルタリングされたログのためのFILE_PATTERN=LOG_LEVEL設定のカンマ区切りリスト |
| `--log 値, -l`| N/A | ファイルにログを記録 |
| `--alsologtostderr` | N/A | ファイルに設定されている場合、標準エラーにもログを記録 |

### クラスターオプション

| フラグ | 環境変数 | 説明 |
| -------------------------- | -------------------- | ------------------------------------ |
| `--token 値, -t`| `K3S_TOKEN` | 認証に使用するトークン |
| `--token-file`| `K3S_TOKEN_FILE` | 認証に使用するトークンファイル |
| `--server 値, -s`| `K3S_URL` | 接続するサーバー |

### データ

| フラグ | デフォルト | 説明 |
| ---------------------------- | ---------------------- | -------------------- |
| `--data-dir 値, -d`| "/var/lib/rancher/k3s" | 状態を保持するフォルダー |

### ノード

| フラグ | 環境変数 | 説明 |
| --------------------------- | -------------------- | --------------------------------------------------------------------------------------------- |
| `--node-name`| `K3S_NODE_NAME` | ノード名 |
| `--with-node-id` | N/A | ノード名にIDを追加 |
| `--node-label`| N/A | ラベルのセットでkubeletを登録および開始 |
| `--node-taint`| N/A | taintsのセットでkubeletを登録 |
| `--protect-kernel-defaults` | N/A | カーネルのチューニング動作。設定されている場合、カーネルのチューナブルがkubeletのデフォルトと異なる場合にエラーを発生させます。 |
| `--selinux` | `K3S_SELINUX` | containerdでSELinuxを有効にする |
| `--lb-server-port`| `K3S_LB_SERVER_PORT` | スーパーバイザークライアントのロードバランサーのローカルポート。スーパーバイザーとapiserverが同じ場所にない場合、このポートの1つ少ない追加ポートもapiserverクライアントのロードバランサーに使用されます。(デフォルト: 6444) |

### ランタイム

| フラグ | デフォルト | 説明 |
| ------------------------------------ | ---------------------------------- | ------------------------------------------------------------------ |
| `--container-runtime-endpoint`| N/A | 組み込みのcontainerdを無効にし、指定されたパスのCRIソケットを使用します。--dockerと一緒に使用する場合、cri-dockerソケットパスを設定します |
| `--pause-image`| "docker.io/rancher/pause:3.1" | containerdまたはdockerサンドボックス用のカスタマイズされたpauseイメージ |
| `--private-registry`| "/etc/rancher/k3s/registries.yaml" | プライベートレジストリの設定ファイル |

### ネットワーキング

| フラグ | 環境変数 | 説明 |
| --------------------------- | -------------------- | ----------------------------------------- |
| `--node-ip 値, -i`| N/A | ノードの広告用IPアドレス |
| `--node-external-ip`| N/A | ノードの広告用外部IPアドレス |
| `--resolv-conf`| `K3S_RESOLV_CONF` | Kubeletのresolv.confファイル |
| `--flannel-iface`| N/A | デフォルトのflannelインターフェースを上書き |
| `--flannel-conf`| N/A | デフォルトのflannel設定ファイルを上書き |
| `--flannel-cni-conf`| N/A | デフォルトのflannel cni設定ファイルを上書き |

### カスタマイズされたフラグ

| フラグ | 説明 |
| ------------------------ | -------------------------------------- |
| `--kubelet-arg`| kubeletプロセス用のカスタマイズされたフラグ |
| `--kube-proxy-arg`| kube-proxyプロセス用のカスタマイズされたフラグ |

### 実験的

| フラグ | 説明 |
| ------------ | ------------------------------------- |
| `--rootless` | ルートレスで実行 |
| `--docker` | containerdの代わりにcri-dockerdを使用 |
| `--prefer-bundled-bin` | ホストバイナリよりもバンドルされたユーザースペースバイナリを優先 |
| `--disable-default-registry-endpoint` | "[デフォルトエンドポイントフォールバック](../installation/private-registry.md#default-endpoint-fallback)"を参照 |

### 廃止予定

| フラグ | 環境変数 | 説明 |
| ------------------------ | -------------------- | ---------------------------- |
| `--no-flannel` | N/A | `--flannel-backend=none`を使用 |
| `--cluster-secret`| `K3S_CLUSTER_SECRET` | `--token`を使用 |

### エージェントのノードラベルとtaints

K3sエージェントは、`--node-label`および`--node-taint`オプションを使用して設定でき、これによりkubeletにラベルとtaintが追加されます。これらのオプションは登録時にのみラベルおよび/またはtaintを追加するため、一度だけ追加され、その後K3sコマンドを実行しても変更できません。

以下は、ラベルとtaintを追加する方法を示す例です:

```bash
--node-label foo=bar \
--node-label hello=world \
--node-taint key1=value1:NoExecute
```

ノード登録後にノードラベルとtaintを変更したい場合は、`kubectl`を使用する必要があります。taintsの追加方法については公式のKubernetesドキュメントを参照してください。[taints](https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/)および[ノードラベル](https://kubernetes.io/docs/tasks/configure-pod-container/assign-pods-nodes/#add-a-label-to-a-node)の追加方法についての詳細を参照してください。

### K3sエージェントCLIヘルプ

> 以下にオプションが角括弧で表示されている場合、例えば`[$K3S_URL]`、そのオプションはその名前の環境変数として渡すことができることを意味します。
```bash
NAME:
k3s agent - ノードエージェントを実行

USAGE:
k3s agent [OPTIONS]

OPTIONS:
--config FILE, -c FILE (config) FILEから設定を読み込む (デフォルト: "/etc/rancher/k3s/config.yaml") [$K3S_CONFIG_FILE]
--debug (logging) デバッグログを有効にする [$K3S_DEBUG]
-v 値 (logging) ログレベルの冗長度の数値 (デフォルト: 0)
--vmodule 値 (logging) ファイルフィルタリングされたログのためのFILE_PATTERN=LOG_LEVEL設定のカンマ区切りリスト
--log 値, -l 値 (logging) ファイルにログを記録
--alsologtostderr (logging) ファイルに設定されている場合、標準エラーにもログを記録
--token 値, -t 値 (cluster) 認証に使用するトークン [$K3S_TOKEN]
--token-file 値 (cluster) 認証に使用するトークンファイル [$K3S_TOKEN_FILE]
--server 値, -s 値 (cluster) 接続するサーバー [$K3S_URL]
--data-dir 値, -d 値 (agent/data) 状態を保持するフォルダー (デフォルト: "/var/lib/rancher/k3s")
--node-name 値 (agent/node) ノード名 [$K3S_NODE_NAME]
--with-node-id (agent/node) ノード名にIDを追加
--node-label 値 (agent/node) ラベルのセットでkubeletを登録および開始
--node-taint 値 (agent/node) taintsのセットでkubeletを登録
--image-credential-provider-bin-dir 値 (agent/node) クレデンシャルプロバイダープラグインバイナリが配置されているディレクトリのパス (デフォルト: "/var/lib/rancher/credentialprovider/bin")
--image-credential-provider-config 値 (agent/node) クレデンシャルプロバイダープラグイン設定ファイルのパス (デフォルト: "/var/lib/rancher/credentialprovider/config.yaml")
--selinux (agent/node) containerdでSELinuxを有効にする [$K3S_SELINUX]
--lb-server-port 値 (agent/node) スーパーバイザークライアントのロードバランサーのローカルポート。スーパーバイザーとapiserverが同じ場所にない場合、このポートの1つ少ない追加ポートもapiserverクライアントのロードバランサーに使用されます。(デフォルト: 6444) [$K3S_LB_SERVER_PORT]
--protect-kernel-defaults (agent/node) カーネルのチューニング動作。設定されている場合、カーネルのチューナブルがkubeletのデフォルトと異なる場合にエラーを発生させます。
--container-runtime-endpoint 値 (agent/runtime) 組み込みのcontainerdを無効にし、指定されたパスのCRIソケットを使用します。--dockerと一緒に使用する場合、dockerソケットパスを設定します
--pause-image 値 (agent/runtime) containerdまたはdockerサンドボックス用のカスタマイズされたpauseイメージ (デフォルト: "rancher/mirrored-pause:3.6")
--snapshotter 値 (agent/runtime) デフォルトのcontainerdスナップショッターを上書き (デフォルト: "overlayfs")
--private-registry 値 (agent/runtime) プライベートレジストリの設定ファイル (デフォルト: "/etc/rancher/k3s/registries.yaml")
--node-ip 値, -i 値 (agent/networking) ノードの広告用IPv4/IPv6アドレス
```
```markdown
--node-external-ip value (agent/networking) ノードの広告用IPv4/IPv6外部IPアドレス
--resolv-conf value (agent/networking) Kubeletのresolv.confファイル [$K3S_RESOLV_CONF]
--flannel-iface value (agent/networking) デフォルトのflannelインターフェースを上書き
--flannel-conf value (agent/networking) デフォルトのflannel設定ファイルを上書き
--flannel-cni-conf value (agent/networking) デフォルトのflannel cni設定ファイルを上書き
--kubelet-arg value (agent/flags) kubeletプロセスのカスタマイズフラグ
--kube-proxy-arg value (agent/flags) kube-proxyプロセスのカスタマイズフラグ
--rootless (experimental) ルートレスで実行
--prefer-bundled-bin (experimental) ホストのバイナリよりもバンドルされたユーザースペースバイナリを優先
--docker (agent/runtime) (experimental) containerdの代わりにcri-dockerdを使用
```
Loading

0 comments on commit 1f576d2

Please sign in to comment.