Skip to content

Commit 7c4e591

Browse files
committed
README.ja.md: sync (2022-Dec-12)
Signed-off-by: Akihiro Suda <[email protected]>
1 parent c1368f4 commit 7c4e591

File tree

1 file changed

+37
-48
lines changed

1 file changed

+37
-48
lines changed

README.ja.md

Lines changed: 37 additions & 48 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
1-
This is an *informal* translation of [`README.md` (revision b65049d4, 2022-Oct-23)](https://github.com/lima-vm/lima/blob/b65049d4b89421fca5c73f494bb35e23b3c576c0/README.md) in Japanese.
1+
This is an *informal* translation of [`README.md` (revision c1368f45, 2022-Dec-12)](https://github.com/lima-vm/lima/blob/c1368f45d908947dd0828bc5caa00baa4a46be5c/README.md) in Japanese.
22
This translation might be out of sync with the English version.
33
Please refer to the [English `README.md`](README.md) for the latest information.
44

5-
[`README.md` (リビジョン b65049d4, 2022年10月23日)](https://github.com/lima-vm/lima/blob/b65049d4b89421fca5c73f494bb35e23b3c576c0/README.md)*非正式* な日本語訳です。
5+
[`README.md` (リビジョン c1368f45, 2022年12月12日)](https://github.com/lima-vm/lima/blob/c1368f45d908947dd0828bc5caa00baa4a46be5c/README.md)*非正式* な日本語訳です。
66
英語版からの翻訳が遅れていることがあります。
77
最新の情報については[英語版 `README.md`](README.md)をご覧ください。
88

@@ -53,7 +53,7 @@ Limaの目的は、Macユーザに[nerdctl (contaiNERDctl)](https://github.com/c
5353
コンテナ環境:
5454
- [Rancher Desktop](https://rancherdesktop.io/): デスクトップで管理できるKubernetesとコンテナ
5555
- [Colima](https://github.com/abiosoft/colima): macOSで小さく始めるDocker(とKubernetes)
56-
56+
- [Finch](https://github.com/runfinch/finch): Finchはローカルでのコンテナ開発用のコマンドラインクライアント
5757

5858
GUI:
5959
- [Lima xbar plugin](https://github.com/unixorn/lima-xbar-plugin): [xbar](https://xbarapp.com/) メニューバーから仮想マシンを開始・終了でき、稼働状態を確認できるプラグイン
@@ -126,15 +126,7 @@ brew install lima
126126

127127
#### QEMU をインストールする
128128

129-
最近のバージョンのQEMUをインストールしてください。
130-
131-
M1のmacOSでは、[Homebrew版のQEMU `6.2.0_1`](https://github.com/Homebrew/homebrew-core/pull/96743) 以降が望ましいです。
132-
133-
もしHomebrewを使っていないなら、最近のLinuxゲストを起動するには以下のコミットを含めてください:
134-
- https://github.com/qemu/qemu/commit/ad99f64f `hvf: arm: Use macros for sysreg shift/masking`
135-
- https://github.com/qemu/qemu/commit/7f6c295c `hvf: arm: Handle unknown ID registers as RES0`
136-
137-
これらのコミットはQEMU 7.0には含まれていますが、 [QEMU 7.0はM1で3 GiB以上のメモリを使うのにmacOS 12.4以降を要する点に注意が必要です](https://github.com/lima-vm/lima/pull/796)
129+
QEMU 7.0 以降をインストールしてください。
138130

139131
#### Lima をインストールする
140132

@@ -234,6 +226,14 @@ $ limactl start --name=default https://raw.githubusercontent.com/lima-vm/lima/ma
234226
#### `limactl edit`
235227
`limactl edit <INSTANCE>`: インスタンスを編集します
236228

229+
#### `limactl disk`
230+
231+
`limactl disk create <DISK> --size <SIZE>`: 新しい外部ディスクを作成しインスタンスに取り付けます
232+
233+
`limactl disk delete <DISK>`: 既存のディスクを削除します
234+
235+
`limactl disk list`: 既存のディスクの一覧を表示します
236+
237237
#### `limactl completion`
238238
- bash補完を有効にするには、`~/.bash_profile``source <(limactl completion bash)`を追加します。
239239

@@ -262,8 +262,8 @@ Limaにはデータの喪失を引き起こすバグが含まれているかも
262262

263263
## 動作する仕組み
264264

265-
- ハイパーバイザ: HVFアクセラレータを搭載したQEMU
266-
- ファイルシステム共有: [リバースsshfs (デフォルト)、もしくは virtio-9p-pci またの名を virtfs](./docs/mount.md)
265+
- ハイパーバイザ: [QEMU + HVFアクセラレータ(デフォルト)、もしくはVirtualization.framework](./docs/vmtype.md)
266+
- ファイルシステム共有: [リバースsshfs (デフォルト)、もしくは virtio-9p-pci またの名を virtfs、もしくはvirtiofs](./docs/mount.md)
267267
- ポートフォワーディング: ゲストの`/proc/net/tcp``iptables`を自動的に見つつ`ssh -L`
268268

269269
## 開発者ガイド
@@ -275,10 +275,10 @@ Limaにはデータの喪失を引き起こすバグが含まれているかも
275275

276276
### 助けを求めています
277277
:pray:
278+
- ドキュメント
279+
- CLIのユーザエクスペリエンス
278280
- パフォーマンス最適化
279-
- より多くのゲストディストリビューション
280281
- Windows ホスト
281-
- virtio-fs で、virtio-9p-pci またの名を virtfs を置き換える (QEMU側リポジトリで作業をする必要があります)
282282
- SSHを置き換える[vsock](https://github.com/apple/darwin-xnu/blob/xnu-7195.81.3/bsd/man/man4/vsock.4)(QEMU側リポジトリで作業をする必要があります)
283283

284284
## FAQとトラブルシューティング
@@ -300,13 +300,12 @@ Limaにはデータの喪失を引き起こすバグが含まれているかも
300300
- ["QEMUが遅いです"](#qemu%E3%81%8C%E9%81%85%E3%81%84%E3%81%A7%E3%81%99)
301301
- ["killed -9" エラー](#killed--9-%E3%82%A8%E3%83%A9%E3%83%BC)
302302
- ["`vmx_write_mem: mmu_gva_to_gpa XXXXXXXXXXXXXXXX failed`でQEMUがクラッシュします"](#vmx_write_mem-mmu_gva_to_gpa-xxxxxxxxxxxxxxxx-failed%E3%81%A7qemu%E3%81%8C%E3%82%AF%E3%83%A9%E3%83%83%E3%82%B7%E3%83%A5%E3%81%97%E3%81%BE%E3%81%99)
303-
- [SSH](#ssh)
304-
- ["ポートフォワーディングが動きません"](#%E3%83%9D%E3%83%BC%E3%83%88%E3%83%95%E3%82%A9%E3%83%AF%E3%83%BC%E3%83%87%E3%82%A3%E3%83%B3%E3%82%B0%E3%81%8C%E5%8B%95%E3%81%8D%E3%81%BE%E3%81%9B%E3%82%93)
305-
- ["Waiting for the essential requirement 1 of X: "ssh" で固まります"](#waiting-for-the-essential-requirement-1-of-x-ssh-%E3%81%A7%E5%9B%BA%E3%81%BE%E3%82%8A%E3%81%BE%E3%81%99)
306-
- [`limactl cp`コマンドで"Permission denied"](#limactl-cp%E3%82%B3%E3%83%9E%E3%83%B3%E3%83%89%E3%81%A7permission-denied)
307303
- [ネットワーク](#%E3%83%8D%E3%83%83%E3%83%88%E3%83%AF%E3%83%BC%E3%82%AF)
308304
- ["ホストからゲストのIP 192.168.5.15にアクセスできない"](#%E3%83%9B%E3%82%B9%E3%83%88%E3%81%8B%E3%82%89%E3%82%B2%E3%82%B9%E3%83%88%E3%81%AEip-192168515%E3%81%AB%E3%82%A2%E3%82%AF%E3%82%BB%E3%82%B9%E3%81%A7%E3%81%8D%E3%81%AA%E3%81%84)
309-
- [Pingのパケットが重複してたり応答が極めて遅かったりする](#ping%E3%81%AE%E3%83%91%E3%82%B1%E3%83%83%E3%83%88%E3%81%8C%E9%87%8D%E8%A4%87%E3%81%97%E3%81%A6%E3%81%9F%E3%82%8A%E5%BF%9C%E7%AD%94%E3%81%8C%E6%A5%B5%E3%82%81%E3%81%A6%E9%81%85%E3%81%8B%E3%81%A3%E3%81%9F%E3%82%8A%E3%81%99%E3%82%8B)
305+
- ["Pingのパケットが重複してたり応答が極めて遅かったりする"](#ping%E3%81%AE%E3%83%91%E3%82%B1%E3%83%83%E3%83%88%E3%81%8C%E9%87%8D%E8%A4%87%E3%81%97%E3%81%A6%E3%81%9F%E3%82%8A%E5%BF%9C%E7%AD%94%E3%81%8C%E6%A5%B5%E3%82%81%E3%81%A6%E9%81%85%E3%81%8B%E3%81%A3%E3%81%9F%E3%82%8A%E3%81%99%E3%82%8B)
306+
- [ファイルシステム共有](#%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%82%B7%E3%82%B9%E3%83%86%E3%83%A0%E5%85%B1%E6%9C%89)
307+
- ["ファイルシステムが遅い"](#%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%82%B7%E3%82%B9%E3%83%86%E3%83%A0%E3%81%8C%E9%81%85%E3%81%84)
308+
- ["ファイルシステムに書き込めない"](#%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%82%B7%E3%82%B9%E3%83%86%E3%83%A0%E3%81%AB%E6%9B%B8%E3%81%8D%E8%BE%BC%E3%82%81%E3%81%AA%E3%81%84)
310309
- [外部プロジェクト](#%E5%A4%96%E9%83%A8%E3%83%97%E3%83%AD%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88)
311310
- ["Rancher Desktopを使っています。内蔵されているLimaを弄るにはどうすればよいですか。"](#rancher-desktop%E3%82%92%E4%BD%BF%E3%81%A3%E3%81%A6%E3%81%84%E3%81%BE%E3%81%99%E5%86%85%E8%94%B5%E3%81%95%E3%82%8C%E3%81%A6%E3%81%84%E3%82%8Blima%E3%82%92%E5%BC%84%E3%82%8B%E3%81%AB%E3%81%AF%E3%81%A9%E3%81%86%E3%81%99%E3%82%8C%E3%81%B0%E3%82%88%E3%81%84%E3%81%A7%E3%81%99%E3%81%8B)
312311
- ["ほかの問題をデバッグするためのヒントは?"](#%E3%81%BB%E3%81%8B%E3%81%AE%E5%95%8F%E9%A1%8C%E3%82%92%E3%83%87%E3%83%90%E3%83%83%E3%82%B0%E3%81%99%E3%82%8B%E3%81%9F%E3%82%81%E3%81%AE%E3%83%92%E3%83%B3%E3%83%88%E3%81%AF)
@@ -412,32 +411,6 @@ codesign -s - --entitlements entitlements.xml --force /usr/local/bin/qemu-system
412411

413412
https://bugs.launchpad.net/qemu/+bug/1838390
414413

415-
### SSH
416-
#### "ポートフォワーディングが動きません"
417-
Lima v0.7.0以前では、Limaは特権ポート(1-1023)のフォワーディングはサポートしていませんでした。例: 80番ではなく8080番を使わなければなりませんでした。
418-
419-
macOSホストのLima v0.7.0 とそれ以降のバージョンでは、特権ポートのフォワーディングをサポートしています。
420-
421-
Linuxホストでは、sysctlの値`net.ipv4.ip_unprivileged_port_start=0`をセットする必要があるかもしれません。
422-
423-
#### "Waiting for the essential requirement 1 of X: "ssh" で固まります"
424-
425-
426-
M1のmacOSでは、最近のLinuxゲストを実行するには[Homebrew版のQEMU `6.2.0_1`](https://github.com/Homebrew/homebrew-core/pull/96743) 以降が必要です。
427-
`brew upgrade` を実行してQEMUを更新してください。
428-
429-
もしHomebrewを使っていないならば、[インストール](#インストール)の節の「手動でのインストール方法」をご覧ください。
430-
431-
デバッグするには、`~/.lima/<インスタンス>` にある `serial.log` もご覧ください。
432-
433-
#### `limactl cp`コマンドで"Permission denied"
434-
435-
`copy`コマンドはLima 0.5.0かそれ以降で作成されたインスタンスでのみ動作します。`INSTANCE`を実際のインスタンス名に置き換えることで古いインスタンスでの手動で必要なアイデンティティをインストールすることができます。
436-
437-
```console
438-
< ~/.lima/_config/user.pub limactl shell INSTANCE sh -c 'tee -a ~/.ssh/authorized_keys'
439-
```
440-
441414
### ネットワーク
442415
#### "ホストからゲストのIP 192.168.5.15にアクセスできない"
443416

@@ -448,7 +421,7 @@ M1のmacOSでは、最近のLinuxゲストを実行するには[Homebrew版のQE
448421

449422
[`./docs/network.md`](./docs/network.md)を参照してください。
450423

451-
#### Pingのパケットが重複してたり応答が極めて遅かったりする
424+
#### "Pingのパケットが重複してたり応答が極めて遅かったりする"
452425

453426
LimaはQEMUのSLIRPネットワークを使うので`ping`はそのままでは動きません:
454427

@@ -461,6 +434,22 @@ PING google.com (172.217.165.14): 56 data bytes
461434

462435
詳しくは, [Documentation/Networking](https://wiki.qemu.org/Documentation/Networking#User_Networking_.28SLIRP.29)をご覧ください。
463436

437+
### ファイルシステム共有
438+
#### "ファイルシステムが遅い"
439+
virtiofsを試してください。 [`docs/mount.md`](./docs/mount.md)をご覧ください。
440+
441+
#### "ファイルシステムに書き込めない"
442+
ホームディレクトリはデフォルトでは読み込み専用でマウントされます。
443+
書き込みを有効化するには、YAMLに `writable: true` を指定してください:
444+
445+
```yaml
446+
mounts:
447+
- location: "~"
448+
writable: true
449+
```
450+
451+
既存のインスタンスのYAMLを編集するには `limactl edit <インスタンス>` を実行してください。
452+
464453
### 外部プロジェクト
465454
#### "Rancher Desktopを使っています。内蔵されているLimaを弄るにはどうすればよいですか。"
466455

0 commit comments

Comments
 (0)