DuDuClaw OS imageのビルド

移動しました（2026-09）。 OS imageはこのリポジトリからはビルドされなくなりました。このページがかつて説明していたYocto layer、リリースパイプライン、そして凍結済みのDebian/mkosiアプライアンスrecipeは、すべて独立したDuDuClaw-OSリポジトリに移っています。このページはプラットフォーム文書からの安定した入口として残り、行き先を案内します。

DuDuClaw OSは、小型のx86-64 PCをヘッドレスなDuDuClawアプライアンスに変える起動用imageです（完成品がユーザー側からどう見えるかはアプライアンス機能の概要を参照してください）。いま読んでいるこのプラットフォームリポジトリには、 OSがトリミング済みスナップショットとしてvendorするRust workspaceが入っています。OS自体は独自のリポジトリ、独自のリリースライン、独自の changelogを持っています。

1. imageを入手する

方法は2通りあります。

署名済みリリースをダウンロードする。 DuDuClaw-OS Releases では、マシンごとにディスク全体のimage （duduclaw-os-<machine>-v<ver>.wic.zst）と、2種類のliveインストーラー ISO——ベースイメージ（duduclaw-os-installer-<machine>-v<ver>.iso）とデスクトップ版（duduclaw-os-installer-desktop-<machine>-v<ver>.iso） ——が公開されており、それぞれに.sha256とminisignの.minisigが付いています。書き込む前に必ず検証してください。公開鍵と具体的なコマンドはドキュメントサイトのOS READMEとSECURITY （「快速開始」／“Quick start”）にあります。
ソースからビルドする。 DuDuClaw-OSをこのリポジトリの隣にcloneし、そのREADME（「從原始碼建置」／“Build from source”）と meta-duduclaw/README.md（“Usage”）に従います。Dockerビルダーコンテナ、 kas build、そしてscripts/release-os.sh build → smoke → package → publishというパイプラインです。このプラットフォームリポジトリの sibling checkoutが必要になるのは、vendorされているRustスナップショットを更新したいときだけです。

2. ビルドしているものは何か

出荷されるimageは、meta-duduclaw/のYocto layer（Yocto 6.0 “wrynose”、kernel 6.18）から作られるduduclaw-image-appliance——デスクトップ版です。A/Bデュアルスロット構成でアトミックな更新とロールバックに対応し、読み取り専用ルート、DuDuClaw自身のデスクトップ（compositor＋ shell）とgateway＋dashboard、プリロード済みアプリ、アプリ互換レイヤーを備えます。Secure Boot署名、dm-verityによるルート検証、TPM2鍵封印は、このlayerの中ではビルド時のオーバーレイオプション（kas/sb-signing.yml、kas/tpm-luks.yml）として存在しますが、現行の v0.4.0（プラットフォームv1.73.4を同梱）時点でもまだ有効化されていません。公開されているimageは今もSecure Bootをオフにした状態で起動します。release-os.shはビルドごとにreleaseオーバーレイを1つだけ重ね（既定はserial1.yml、v0.3.0ではrelease-linux-builder.yml）、どちらも署名、verity、TPMを有効にしません。v0.4.0から、gatewayは非rootユーザーで動き、コンテナはrootless Podmanで動き、SSHは既定でオフです。v0.4.0で一度起動に成功したデバイスはv0.3.0以前に戻れません。インストーラーISOはベースイメージduduclaw-image-ab（同じ構成とデスクトップシェル、v0.4.0からはファイアウォールも持つが、アプリ層なし）を書き込みます。デスクトップ版専用のインストーラーISO（duduclaw-os-installer-desktop-…）は v0.1.0（2026-09-04）以降、これと並んで出荷されています。定義されているマシンは2つです。duduclaw-qemux86-64（QEMUのbring-upターゲットで、起動を検証済み）とduduclaw-genericx86-64（実機x86-64ハードウェアで、設定は監査済み。実機での起動検証は今も未解決の項目です）。imageごとの役割分担とパーティション／起動チェーンの詳細はOSリポジトリ側に記載されており、ここでは重複させません。

3. Debian/mkosiのライン

このページが元々説明していたappliance/のrecipe（Debian 13＋mkosi、自己インストール型USB image）は凍結されています。DuDuClaw-OSリポジトリのappliance/配下に、参照用および移行期の成果物として保管されており、出荷対象ではなく、修正も受けません。そこにある独自のREADMEには、経緯を確認したい人のために完全な起動シーケンスと未解決の論点がそのまま残されています。

DuDuClaw OS imageのビルド

1. imageを入手する

2. ビルドしているものは何か

3. Debian/mkosiのライン

関連ページ