diff options
Diffstat (limited to 'docs/ja/getting_started_docker.md')
| -rw-r--r-- | docs/ja/getting_started_docker.md | 18 |
1 files changed, 13 insertions, 5 deletions
diff --git a/docs/ja/getting_started_docker.md b/docs/ja/getting_started_docker.md index 6498d727b..ceaebb017 100644 --- a/docs/ja/getting_started_docker.md +++ b/docs/ja/getting_started_docker.md | |||
| @@ -1,16 +1,17 @@ | |||
| 1 | # Docker クイックスタート | 1 | # Docker クイックスタート |
| 2 | 2 | ||
| 3 | <!--- | 3 | <!--- |
| 4 | original document: 0.9.32:docs/getting_started_docker.md | 4 | original document: 0.12.43:docs/getting_started_docker.md |
| 5 | git diff 0.9.32 HEAD -- docs/getting_started_docker.md | cat | 5 | git diff 0.12.43 HEAD -- docs/getting_started_docker.md | cat |
| 6 | --> | 6 | --> |
| 7 | 7 | ||
| 8 | このプロジェクトは、プライマリオペレーティングシステムに大きな変更を加えることなくキーボードの新しいファームウェアを非常に簡単に構築することができる Docker ワークフローを含みます。これは、あなたがプロジェクトをクローンしビルドを実行した時に、他の人とまったく同じ環境と QMK ビルド基盤を持つことも保証します。これにより、人々はあなたが遭遇した問題の解決をより簡単に行えるようになります。 | 8 | このプロジェクトは、プライマリオペレーティングシステムに大きな変更を加えることなくキーボードの新しいファームウェアを非常に簡単に構築することができる Docker ワークフローを含みます。これは、あなたがプロジェクトをクローンしビルドを実行した時に、他の人とまったく同じ環境と QMK ビルド基盤を持つことも保証します。これにより、人々はあなたが遭遇した問題の解決をより簡単に行えるようになります。 |
| 9 | 9 | ||
| 10 | ## 必要事項 | 10 | ## 必要事項 |
| 11 | 11 | ||
| 12 | 主な前提条件は動作する `docker` がインストールされていることです。 | 12 | 主な前提条件は動作する `docker` たは `podman` インストールされていることです。 |
| 13 | * [Docker CE](https://docs.docker.com/install/#supported-platforms) | 13 | * [Docker CE](https://docs.docker.com/install/#supported-platforms) |
| 14 | * [Podman](https://podman.io/getting-started/installation) | ||
| 14 | 15 | ||
| 15 | ## 使い方 | 16 | ## 使い方 |
| 16 | 17 | ||
| @@ -29,7 +30,7 @@ util/docker_build.sh <keyboard>:<keymap> | |||
| 29 | 30 | ||
| 30 | これは目的のキーボード/キーマップをコンパイルし、結果として書き込み用に `.hex` あるいは `.bin` ファイルを QMK ディレクトリの中に残します。`:keymap` が省略された場合は全てのキーマップが使われます。パラメータの形式は、`make` を使ってビルドする時と同じであることに注意してください。 | 31 | これは目的のキーボード/キーマップをコンパイルし、結果として書き込み用に `.hex` あるいは `.bin` ファイルを QMK ディレクトリの中に残します。`:keymap` が省略された場合は全てのキーマップが使われます。パラメータの形式は、`make` を使ってビルドする時と同じであることに注意してください。 |
| 31 | 32 | ||
| 32 | `target` を指定して Docker から直接キーボードをビルドし、_かつ_書き込むためのサポートもあります。 | 33 | `target` を指定して Docker から直接キーボードをビルドし、_かつ_ 書き込むためのサポートもあります。 |
| 33 | 34 | ||
| 34 | ```bash | 35 | ```bash |
| 35 | util/docker_build.sh keyboard:keymap:target | 36 | util/docker_build.sh keyboard:keymap:target |
| @@ -43,10 +44,17 @@ util/docker_build.sh | |||
| 43 | # パラメータを入力として読み込みます (空白にすると全てのキーボード/キーマップ) | 44 | # パラメータを入力として読み込みます (空白にすると全てのキーボード/キーマップ) |
| 44 | ``` | 45 | ``` |
| 45 | 46 | ||
| 47 | `RUNTIME` 環境変数にコンテナランタイム名やパスを設定することで、使用したいコンテナランタイムを手動で設定できます。 | ||
| 48 | デフォルトでは docker や podman は自動的に検出され、podman より docker が優先されます。 | ||
| 49 | |||
| 50 | ```bash | ||
| 51 | RUNTIME="podman" util/docker_build.sh keyboard:keymap:target | ||
| 52 | ``` | ||
| 53 | |||
| 46 | ## FAQ | 54 | ## FAQ |
| 47 | 55 | ||
| 48 | ### なぜ Windows/macOS 上で書き込めないのですか? | 56 | ### なぜ Windows/macOS 上で書き込めないのですか? |
| 49 | 57 | ||
| 50 | Windows と macOS では、実行するために [Docker Machine](http://gw.tnode.com/docker/docker-machine-with-usb-support-on-windows-macos/) が必要です。これはセットアップが面倒なので、お勧めではありません: 代わりに [QMK Toolbox](https://github.com/qmk/qmk_toolbox) を使ってください。 | 58 | Windows と macOS では、実行するために [Docker Machine](http://gw.tnode.com/docker/docker-machine-with-usb-support-on-windows-macos/) が必要です。これはセットアップが面倒なので、お勧めではありません: 代わりに [QMK Toolbox](https://github.com/qmk/qmk_toolbox) を使ってください。 |
| 51 | 59 | ||
| 52 | !> Docker for Windows は[Hyper-V](https://docs.microsoft.com/en-us/virtualization/hyper-v-on-windows/quick-start/enable-hyper-v) を有効にする必要があります。これは、Windows 7、Windows 8 および **Windows 10 Home** のような Hyper-V を搭載していない Windows のバージョンでは機能しないことを意味します。 | 60 | !> Docker for Windows は [Hyper-V](https://docs.microsoft.com/en-us/virtualization/hyper-v-on-windows/quick-start/enable-hyper-v) を有効にする必要があります。これは、Windows 7、Windows 8 および **Windows 10 Home** のような Hyper-V を搭載していない Windows のバージョンでは機能しないことを意味します。 |
