最終更新:
genpack-install は genpack で生成した SquashFS システムイメージを物理ディスク、ISO イメージ、ZIP アーカイブにデプロイするためのツールです。
genpack-install [オプション] [system_image]root 権限が必要です。
| 引数 | 必須 | 説明 |
|---|---|---|
system_image | 動作モードによる | システムイメージファイル（SquashFS） |
セルフアップデートモードでは必須です。--disk、--cdrom、--zip モードでは省略可能で、省略時は現在インストールされているシステムイメージが使用されます。
| オプション | 型 | デフォルト | 説明 |
|---|---|---|---|
--disk <PATH> | 文字列 | (なし) | ディスクデバイスパス。list を指定するとインストール可能なディスクの一覧を表示 |
--cdrom <PATH> | 文字列 | (なし) | 作成する ISO9660 イメージのパス |
--zip <PATH> | 文字列 | (なし) | 作成する ZIP アーカイブのパス |
--system-cfg <PATH> | パス | (なし) | 指定した system.cfg ファイルをインストール |
--system-ini <PATH> | パス | (なし) | 指定した system.ini ファイルをインストール |
--label <NAME> | 文字列 | (なし) | ブートパーティションまたは ISO イメージのボリュームラベル |
--gpt | フラグ | false | MBR の代わりに常に GPT を使用 |
--superfloppy | フラグ | false | パーティショニングせずディスク全体を使用 |
--no-esp | フラグ | false | ブートパーティションを ESP としてマークしない |
--additional-boot-files <PATH> | パス | (なし) | 追加のブートファイルを含む ZIP アーカイブ |
-y | フラグ | false | 確認プロンプトをスキップ |
--debug | フラグ | false | デバッグメッセージを表示 |
genpack-install は引数の組み合わせにより 4 つの動作モードを持ちます。
genpack-install <system_image>稼働中のシステムのシステムイメージをアトミックに更新します。--disk、--cdrom、--zip のいずれも指定しない場合にこのモードで動作します。
更新手順:
system.img またはデータパーティションの system）system.old を削除（存在する場合）system.new としてコピーsystem.cur にリネーム（ロールバック用に保持）system.new を本来のイメージパスにリネームsync を実行失敗時は system.cur から自動復旧を試みます。
genpack-install --disk=<デバイスパス> [オプション] [system_image]
genpack-install --disk=list物理ディスクにシステムイメージをインストールします。
--disk=list を指定すると、インストール可能なディスクの一覧を表示します。読み取り専用デバイス、マウント済みデバイス、4GiB 未満のデバイスは除外されます。
パーティショニング:
--gpt: 条件に関わらず GPT を強制使用--superfloppy: パーティションテーブルを作成せず、ディスク全体を FAT32 としてフォーマット（4GiB 未満のイメージのみ）通常モード（パーティショニングあり）のレイアウト:
data-{ブートパーティションUUID}--no-esp を指定すると、ブートパーティションに ESP（EFI System Partition）フラグを付与しません。一部のブートローダーが ESP フラグを嫌う場合に使用します（MBR 時のみ有効）。
インストール前に確認プロンプトが表示されます。-y で確認をスキップできます。
genpack-install --cdrom=<出力パス> [--label=<ラベル>] [system_image]ブータブル ISO9660 イメージを作成します。xorriso（libisoburn）がインストールされている必要があります。
eltorito-bios.img が存在する場合）eltorito-efi.img が存在する場合）--label を省略した場合、ボリュームラベルは GENPACK になります。
genpack-install --zip=<出力パス> [system_image]システムイメージとブートファイルを含む ZIP アーカイブを作成します。
ZIP に含まれるファイル:
system.img — システムイメージsystem.cfg — システム設定（--system-cfg 指定時）system.ini — システム設定（--system-ini 指定時）genpack-install は GRUB をブートローダーとして使用します。ブートローダーファイルは以下の順序で検索されます:
/usr/lib/genpack-install//usr/local/lib/genpack-install//usr/lib/genpack-install/インストールされるファイル:
boot*.efi ファイルが efi/boot/ にコピーされますboot.img、core.img、grub.cfg が存在し grub-bios-setup が利用可能な場合にインストールされます対応アーキテクチャ:
| アーキテクチャ | BIOS | UEFI |
|---|---|---|
| x86_64 | boot.img + core.img | bootx64.efi |
| i386 | boot.img + core.img | bootia32.efi |
| aarch64 | — | bootaa64.efi |
| riscv64 | — | bootriscv64.efi |
Raspberry Pi のサポート:
システムイメージに boot/bootcode.bin が含まれる場合、Raspberry Pi イメージとして扱われます。boot/ ディレクトリの全ファイルがブートパーティションにコピーされ、cmdline.txt の root= パラメータが root=systemimg:auto に書き換えられます。
grub.cfg の system.img 検索ロジック:
system.img が存在すればそれを使用data-{ブートパーティションUUID} ラベルのパーティションを検索d-{ブートパーティションUUID} ラベルを検索boot/kernel）と initramfs（boot/initramfs）grub.cfgsystem.cfg / system.ini（指定時）system.img として格納ブートパーティションサイズは、システムイメージが 4GiB 未満の場合は max(4, image_size_gib * 3 + 1) GiB、4GiB 以上の場合は 1 GiB です。
--superfloppy 使用時は作成されませんdata-{ブートパーティションUUID}system として格納genpack-install はインストール前にシステムイメージの検証を行います:
.genpack/ ディレクトリが存在することboot/kernel と boot/initramfs が存在する（通常のイメージ）boot/bootcode.bin が存在する（Raspberry Pi イメージ）検証に通過すると、.genpack/artifact と .genpack/variant の内容が表示されます。
このドキュメントは以下のリポジトリのスナップショットに基づいて作成されました: