カスタムイメージのサンプルをビルドする
この手順では、小さ なアプリケーション、設定ファイル、自動起動するサービスを含む署名済み Modalix イメージを作成します。完全なサンプルが PIB に含まれるため、リポジトリの取得やホストへのビルドツールのインストールは不要です。CI でも同じイメージ定義を x86 と ARM64 で検証しています。
1. PIB をインストールして確認する
sima-cli をインストールし、Linux エンジンの Docker を起動してから実行します。
sima-cli neat install sdk/pib
pib --version
pib doctor
現在のターミナルで pib が見つからない場合は、新しいターミナルを開きます。Bash または Zsh では PATH をすぐに更新することもできます。
export PATH="$HOME/.local/bin:$PATH"
PIB はホストに対応した x86 または ARM64 コンテナを使用します。x86 では ARM64 エミュレーターを自動設定します。この minimal イメージの例には、特権コンテナの許可と、プロジェクトおよび Docker ストレージそれぞれに 10 GiB 以上の空き容量が必要です。
Windows では Linux コンテナモードの Docker とネイティブランチャーを使用します。Windows のインストーラーユニットテストは合格していますが、Docker Desktop/WSL2 での完全なイメージ作成はまだ検証されていません。以下の例は Bash の引用符構文を使用します。
2. サンプルをプロジェクトにコピーする
pib init my-custom-image --example custom-image
cd my-custom-image
主に次のファイルをカスタマイズします。
| ファイル | 用途 |
|---|---|
image.yaml | フレーバー、イメージバージョン、パッケージ、オーバーレイ、フック、署名設定 |
package-root/usr/bin/pib-example-app | サンプル Debian パッケージでインストールするアプリケーション |
package-root/DEBIAN/control | パッケージ名、バージョン、アーキテクチャ |
overlay/etc/pib-example.conf | イメージにコピーするアプリケーション設定 |
overlay/etc/systemd/system/pib-example.service | サービス定義 |
hooks/enable-example.sh | サービスを有効化し、ビルドマーカーを書き込むフック |
コンテナ内の Linux シェルを開くには、次を実行します。
pib shell
プロジェクトは /workspace にマウントされます。exit でホストに戻ります。以降はホストのプロジェクトディレクトリで操作してください。各 pib コマンドがコンテナを自動起動します。
3. 開発用の署名情報を作成する
pib keys init --cn 'My Company Development'
CA、SWU 署名用の証明書と秘密鍵、カスタム Debian パッケージの署名情報が作成されます。設定後は keys/ca.key をプロジェクト外の安全な場所に移動してください。既存ボードを更新する際も同じ CA を維持します。出荷用イメージには組織の本番署名プロセスを使用してください。
4. アプリケーションをパッケージ化して署名する
PIB 内でパッケージを作成し、署名と検証を行います。
pib shell -c 'dpkg-deb --root-owner-group --build package-root custom-debs/pib-example-app_1.0.0_all.deb'
pib sign-debs
pib verify-debs
サンプルはシェルスクリプトなのでアーキテクチャは all です。コンパイル済みの Modalix アプリケーションは、通常 SDK を使って arm64 向けにビルドします。PIB が受け付けるのは ARM64 またはアーキテクチャ非依存のパッケージです。アプリケーションのソースコード自体をクロスコンパイルするツールではありません。