Merge pull request #244 from lxc-jp/update-2023-03-17

Update translation of LXD 5.12 (Closes #243)

.sphinx/.wordlist.txt

@@ -16,6 +16,7 @@ balancers
 benchmarking
 BGP
 bibi
+BitLocker
 bool
 bootable
 Btrfs
@@ -99,6 +100,7 @@ IOV
 IPs
 IPv
 IPVLAN
+JIT
 jq
 JSON
 kB
@@ -185,6 +187,7 @@ rST
 runtime
 SATA
 scalable
+scriptlet
 SDN
 Seccomp
 SFTP
@@ -202,6 +205,7 @@ SquashFS
 SSDs
 SSL
 stateful
+Starlark
 stderr
 stdin
 stdout
@@ -271,6 +275,7 @@ WebSockets
 XFS
 XHR
 YAML
+YAML's
 Zettabyte
 ZFS
 zpool

.sphinx/requirements.txt

@@ -35,3 +35,4 @@ furo
 sphinxext-opengraph>=0.6.1
 lxd-sphinx-extensions
 pyspelling
+sphinx-copybutton

doc/api-extensions.md

@@ -2076,7 +2076,6 @@ ACME サポートを追加します。これにより [Let's Encrypt](https://le
 これは `StorageVolume` と `StorageVolumeSnapshot` API タイプに `CreatedAt` フィールドを追加します。
 
 ## `cpu_hotplug`
-
 これは VM に CPU ホットプラグを追加します。
 CPU ピンニング使用時はホットプラグは無効になります。CPU ピンニングには NUMA デバイスのホットプラグも必要ですが、これはできないためです。
 
@@ -2108,3 +2107,25 @@ NICデバイスの`txqueuelen`パラメータを制御する`txqueuelen`キー
 StarlarkスクリプトレットをLXDに提供し、クラスタ内の新規インスタンスの配置を制御するカスタムロジックを使えるようにします。
 
 Starlarkスクリプトレットは新しいグローバル設定オプション`instances.placement.scriptlet`によりLXDに提供されます。
+
+## `storage_pool_source_wipe`
+ストレージプールに`source.wipe`ブール値を追加し、LXDは要求されたディスクのパーティションヘッダーを消去する必要があることを示します。これにより、既存のファイルシステムがあることによる潜在的な失敗を回避できるようになります。
+
+## `zfs_block_mode`
+
+これにより、ZFSブロック`filesystem`ボリュームを使用して、ZFSの上に異なるファイルシステムを使用することができるようになります。
+
+これにより、ZFSストレージプールに以下の新しい設定オプションが追加されます：
+
+* `volume.zfs.block_mode`
+* `volume.block.mount_options`
+* `volume.block.filesystem`
+
+## `instance_generation_id`
+
+インスタンスの generation ID のサポートが追加されます。VMまたはコンテナの generation ID は、インスタンスの時間的な世代が後ろに移動するたびに変更されます。現時点では、 generation ID はVMタイプのインスタンスを通じてのみ公開されています。これにより、VMゲストOSは、既に発生した可能性のある状態の複製を回避するために必要な状態を再初期化できます：
+
+* `volatile.uuid.generation`
+
+## `disk_io_cache`
+これは、ディスクデバイスに新しい`io.cache`プロパティを導入し、VMのキャッシング動作を上書きするために使用できます。

doc/authentication.md

@@ -118,8 +118,8 @@ PKIモードを有効にするには、以下の手順を実行します。
 
 1. すべてのマシンに{abbr}`CA（認証局）`の証明書を追加します。
 
-   - クライアントの設定ディレクトリ（`~/.config/lxc`）に`client.ca`ファイルを配置する。
-   - `server.ca`ファイルをサーバの設定ディレクトリ（`/var/lib/lxd`またはsnapユーザの場合は`/var/snap/lxd/common/lxd`）に置く。
+   - クライアントの設定ディレクトリ(`~/.config/lxc`またはSnapユーザーの場合は`~/snap/lxd/common/config`)に`client.ca`ファイルを配置する。
+   - `server.ca`ファイルをサーバの設定ディレクトリ(`/var/lib/lxd`またはSnapユーザーの場合は`/var/snap/lxd/common/lxd`)に置く。
 1. CAから発行された証明書をクライアントとサーバーに配置し、自動生成された証明書を置き換える。
 1. サーバーを再起動します。
 

doc/clustering.md

@@ -1,5 +1,5 @@
 ---
-discourse: 9076
+discourse: 9076,15871
 ---
 
 (clustering)=

doc/conf.py

@@ -22,7 +22,11 @@
     "youtube-links",
     "related-links",
     "custom-rst-roles",
-    "sphinxcontrib.jquery"
+    "sphinxcontrib.jquery",
+    "sphinx_copybutton",
+    "sphinx.ext.intersphinx",
+    "terminal-output",
+    "config-options"
 ]
 
 myst_enable_extensions = [
@@ -38,6 +42,10 @@
     with open("../doc/substitutions.yaml", "r") as fd:
         myst_substitutions = yaml.safe_load(fd.read())
 
+intersphinx_mapping = {
+    'cloud-init': ('https://cloudinit.readthedocs.io/en/latest/', None)
+}
+
 # Setup theme.
 templates_path = ["_templates"]
 

doc/config_options_cheat_sheet.md

@@ -0,0 +1,135 @@
+---
+orphan: true
+---
+
+# 設定オプション
+
+いくつかのインスタンスオプション:
+
+```{config:option} agent.nic_config instance
+:shortdesc: インスタンスデバイスと同じ名前とMTUを設定する
+:default: "`false`"
+:type: bool
+:liveupdate: "`no`"
+:condition: 仮想マシン
+
+デフォルトのネットワークインターフェイスの名前とMTUをインスタンスデバイスと同じに設定するかどうかを制御します（コンテナでは自動的に行われます）
+```
+
+```{config:option} migration.incremental.memory.iterations instance
+:shortdesc: 最大転送操作回数
+:condition: コンテナ
+:default: 10
+:type: integer
+:liveupdate: "yes"
+
+インスタンスを停止する前に通過させる転送操作の最大回数
+```
+
+```{config:option} cluster.evacuate instance
+:shortdesc: インスタンスの避難時の操作方法
+:default: "`auto`"
+:type: string
+:liveupdate: "no"
+
+インスタンスの避難時に行う操作を制御します（`auto`、`migrate`、`live-migrate`、または`stop`）
+```
+
+これらは、第二引数として `instance` スコープを指定する必要があります。
+デフォルトのスコープは `server` なので、この引数は必須ではありません。
+
+いくつかのサーバーオプション:
+
+```{config:option} backups.compression_algorithm server
+:shortdesc: イメージの圧縮アルゴリズム
+:type: string
+:scope: global
+:default: "`gzip`"
+
+新しいイメージに使用する圧縮アルゴリズム（`bzip2`、`gzip`、`lzma`、`xz`、または`none`）
+```
+
+```{config:option} instances.nic.host_name
+:shortdesc: ホスト名の生成方法
+:type: string
+:scope: global
+:default: "`random`"
+
+`random`に設定されている場合、ランダムなホストインターフェイス名をホスト名として使用します。`mac`に設定されている場合、`lxd<mac_address>`（最初の2桁を省略したMAC）の形式でホスト名を生成します。
+```
+
+```{config:option} instances.placement.scriptlet
+:shortdesc: カスタムで設定するインスタンスの自動配置ロジック
+:type: string
+:scope: global
+
+カスタムで設定するインスタンスの自動配置ロジックの {ref}`clustering-instance-placement-scriptlet` を格納します
+```
+
+```{config:option} maas.api.key
+:shortdesc: MAASを管理するためのAPIキー
+:type: string
+:scope: global
+
+MAASを管理するためのAPIキー
+```
+
+他のスコープも可能です。
+このスコープは、主に短い説明や説明で、利用可能なオプションでフォーマットを使用できることを示しています。
+
+```{config:option} test1 something
+:shortdesc: テスト
+
+テスト。
+```
+
+```{config:option} test2 something
+:shortdesc: こんにちは！ **太字** と `コード`
+
+これが実際のテキストです。
+
+2つの段落で構成されています。
+
+そしてリスト:
+
+- 項目
+- 項目
+- 項目
+
+そして表:
+
+キー                                 | タイプ      | スコープ     | デフォルト                                          | 説明
+:--                                 | :---      | :----     | :------                                          | :----------
+`acme.agree_tos`                    | bool      | global    | `false`                                          | ACME利用規約に同意する
+`acme.ca_url`                       | string    | global    | `https://acme-v02.api.letsencrypt.org/directory` | ACMEサービスのディレクトリリソースへのURL
+`acme.domain`                       | string    | global    | -                                                | 証明書が発行されるドメイン
+`acme.email`                        | string    | global    | -                                                | アカウント登録に使用されるメールアドレス
+```
+
+```{config:option} test3 something
+:shortdesc: テスト
+:default: "`false`"
+:type: タイプ
+:liveupdate: Pythonはオプションを解析するため、"no"は"False"に変換されます - これを防ぐためにテキストの周りに引用符を付けてください（"no"または"`no`"）
+:condition: "yes"
+:readonly: "`maybe` - オプションがコードで始まる場合も引用符を追加してください"
+:resource: リソース,
+:managed: 管理された
+:required: 必須
+:scope: （これは「global」や「local」のようなもので、オプションのスコープ（`server`、`instance`など）では**ありません）
+
+内容
+```
+
+オプションを参照するには、{config:option}を使用してください。
+リンクテキストを上書きすることはできません。
+サーバーオプション（デフォルト）を除いて、スコープを指定する必要があります。
+
+{config:option}instance:migration.incremental.memory.iterations
+
+{config:option}something:test1
+
+{config:option}maas.api.key
+
+索引はこちらです：
+{ref}config-options

doc/debugging.md

@@ -1,5 +1,5 @@
 # デバッグ
-インスタンスの問題をデバッグする際の情報については、[FAQ](faq.md) を参照してください。
+インスタンスの問題をデバッグする際の情報については、{ref}`instances-troubleshoot`を参照してください。
 
 ## `lxc` と `lxd` のデバッグ
 
@@ -18,18 +18,6 @@
 
 このコマンドはメッセージがリモートのサーバに現れるのをモニターします。
 
-### `lxd --debug`
-
-`lxd` サーバを停止して `--debug` フラグでフォアグラウンドで実行することで
-たくさんの（願わくは）有用な情報が出力されます。
-
-```bash
-systemctl stop lxd lxd.socket
-lxd --debug --group lxd
-```
-
-上記の `--group lxd` は非特権ユーザーにアクセス権限を与えるために必要です。
-
 ## ローカルソケット経由でのREST API
 
 サーバサイドでLXDとやりとりするのに最も簡単な方法はローカルソケットを
@@ -51,18 +39,18 @@ curl --unix-socket /var/snap/lxd/common/lxd/unix.socket lxd/1.0 | jq .
 
 ## HTTPS経由でのREST API
 
-[LXDへのHTTPS接続](security.md)には有効なクライアント証明書が
-必要です。証明書は初回に `lxc remote add` を実行したときに
-`~/.config/lxc/client.crt` に生成されます。この証明書は
-認証と暗号化のために接続ツールに渡す必要があります。
+[LXDへのHTTPS接続](security.md)には、有効な
+クライアント証明書が必要で、最初の`lxc remote add`で生成されます。この
+証明書は、認証と暗号化のための接続ツールに渡す必要があります。
 
-証明書の中身に興味がある場合は以下のコマンドで確認できます。
+必要に応じて、`openssl`を使って証明書（`~/.config/lxc/client.crt`
+またはSnapユーザーの場合 `~/snap/lxd/common/config/client.crt`）を調べることができます：
 
 ```bash
-openssl x509 -in client.crt -purpose
+openssl x509 -text -noout -in client.crt
 ```
 
-コマンドの出力の中に以下の情報を読み取ることが出来るはずです。
+表示される行の中に以下のようなものがあるはずです：
 
     Certificate purposes:
     SSL client : Yes
@@ -71,7 +59,10 @@ openssl x509 -in client.crt -purpose
 ### コマンドラインツールを使う
 
 ```bash
-wget --no-check-certificate https://127.0.0.1:8443/1.0 --certificate=$HOME/.config/lxc/client.crt --private-key=$HOME/.config/lxc/client.key -O - -q
+wget --no-check-certificate --certificate=$HOME/.config/lxc/client.crt --private-key=$HOME/.config/lxc/client.key -qO - https://127.0.0.1:8443/1.0
+
+# または snap ユーザーの場合
+wget --no-check-certificate --certificate=$HOME/snap/lxd/common/config/client.crt --private-key=$HOME/snap/lxd/common/config/client.key -qO - https://127.0.0.1:8443/1.0
 ```
 
 ### ブラウザを使う

doc/doc-cheat-sheet.md

@@ -208,7 +208,7 @@ URL をテキストとして表示し、リンクされないようにするに
 
 以下のような規約を守ってください。
 
-- 中心となるセクションにはターゲットを追加し、「典型的な」リンク先であることから、頻繁にリンクされることが予想されます。単発的なリンクには、自動生成されたアンカーを使用する。
+- セクションの中心的な部分や、頻繁にリンクされることが予想される「典型的な」場所にターゲットを追加してください。一度きりのリンクには、自動生成されるアンカーを使用できます。
 - 必要な場合のみリンクテキストを上書きする。セクションのタイトルをリンクテキストとして使用できる場合は、そうしてください。タイトルが変更された場合、テキストは自動的に更新されます。
 - リンクテキストを、自動生成されるテキストと同じもので「上書き」してはいけません。
 
@@ -244,8 +244,8 @@ URL をテキストとして表示し、リンクされないようにするに
 
 ##### 自動生成アンカーの使用
 
-MyST構文を使用する場合、リンク先が同じファイル内のセクションを指している場合でも、必ずファイル名を指定する必要があります。
-Markdownの構文を使用している場合、同じファイル内でリンクするときはファイル名を省略することができます。
+自動生成されたアンカーを使用するには、Markdownの構文を使用する必要があります。
+同じファイル内でリンクする場合は、ファイル名を省略できます。
 
 ``{list-table}.
    :header-rows: 1
@@ -254,10 +254,6 @@ Markdownの構文を使用している場合、同じファイル内でリンク
   - 出力
   - GitHubでの出力
   - 説明
-* - `` {ref}`doc-cheat-sheet.md#referencing-a-section` ``
-  - {ref}`doc-cheat-sheet.md#referencing-a-section`
-  - \{ref\}`doc-heat-sheet.md#referencing-a-section`
-  - 自動生成されたアンカーを参照します。
 * - `[](#referencing-a-section)`
   - [](#referencing-a-section)
   -
@@ -266,10 +262,6 @@ Markdownの構文を使用している場合、同じファイル内でリンク
   - [リンクテキスト](#referencing-a-section)
   - [リンクテキスト](#referencing-a-section)
   - リンクテキストをオーバーライドする場合に好ましい。
-* - `` {ref}`リンクテキスト <doc-cheat-sheet.md#referencing-a-section>` ``
-  - {ref}`リンクテキスト <doc-heat-sheet.md#referencing-a-section>`
-  - \{ref\}`リンクテキスト <doc-heat-sheet.md#referencing-a-section>`
-  - リンクテキストを上書きする場合の代替手段です。
 ```
 
 ## ナビゲーション