Troubleshooting

• Linux ホストの X11 サーバに接続できない
• Docker Content Trust エラーで起動できない
• QEMU がロゴから先に進まない
• VSCode に A mount config is invalid と怒られる

Linux ホストの X11 サーバに接続できない

このイメージはデフォルトで環境変数 DISPLAY を host.docker.internal:0 に設定するため, Linux ホストの Docker で実行する場合, 追加の設定が必要になります.

host.docker.internal を手動でマップ

Docker Engine 20.10 以降なら, host.docker.internal を手動でホストにマップできます:

$ docker run --privileged -it --user vscode --add-host=host.docker.internal:host-gateway ghcr.io/sarisia/mikanos /bin/bash

DISPLAY を他に向ける

環境変数 DISPLAY を他に向ける方法もあります:

$ docker run --privileged -it --user vscode --network=host -e DISPLAY=$DISPLAY ghcr.io/sarisia/mikanos /bin/bash

Docker Content Trust エラーで起動できない

以下のようなエラーは Docker Content Trust (DCT) エラーです:

$ docker run --rm -it ghcr.io/sarisia/mikanos /bin/bash
docker: Error: remote trust data does not exist for ghcr.io/sarisia/mikanos: ghcr.io does not have trust data for ghcr.io/sarisia/mikanos.

本イメージは DCT 署名を行っていません. 明示的に DCT を無効にしてください:

$ docker run --rm -it --disable-content-trust=true ghcr.io/sarisia/mikanos /bin/bash
root ➜ /home/vscode $

Thank you for reporting @garunitule (sarisia/mikanos-devcontainer#5)

QEMU がロゴから先に進まない

たまに発生しますが, 原因はわかっていません.

Docker コンテナを再作成することで復旧が可能です.

devcontainer (sarisia/mikanos-devcontainer) の場合, VSCode コマンドパレット -> Remote-Containers: Rebuild Container を選択して Docker コンテナを再作成してください.

devcontainer 固有

VSCode に A mount config is invalid と怒られる

Docker Desktop for Mac のファイル共有アローリストにディレクトリが追加されていない可能性があります.

Docker Desktop ユーザマニュアル を参考にディレクトリを追加してください.

Thank you for reporting @nagashimam (sarisia/mikanos-devcontainer#6)