Image Builder ガイド

Blueprint 操作

利用可能なブループリント一覧の表示

# composer-cli blueprints list

Copy to Clipboard Toggle word wrap

TOML 形式でブループリントの内容の表示

# composer-cli blueprints show BLUEPRINT-NAME

Copy to Clipboard Toggle word wrap

TOML 形式のブループリントの内容を BLUEPRINT-NAME.toml ファイルに保存 (エクスポート)

# composer-cli blueprints save BLUEPRINT-NAME

Copy to Clipboard Toggle word wrap

ブループリントの削除

# composer-cli blueprints delete BLUEPRINT-NAME

Copy to Clipboard Toggle word wrap

TOML 形式のブループリントファイルを Image Builder へプッシュ (インポート)

# composer-cli blueprints push BLUEPRINT-NAME

Copy to Clipboard Toggle word wrap

Blueprint でイメージの設定

Compose の起動

# composer-cli compose start BLUEPRINT COMPOSE-TYPE

Copy to Clipboard Toggle word wrap

BLUEPRINT は、構築する Blueprint の名前に、COMPOSE-TYPE は、出力イメージタイプに置き換えます。

Compose の一覧表示

# composer-cli compose list

Copy to Clipboard Toggle word wrap

実行中の Compose のキャンセル

# composer-cli compose cancel COMPOSE-UUID

Copy to Clipboard Toggle word wrap

完了した Compose の削除

# composer-cli compose delete COMPOSE-UUID

Copy to Clipboard Toggle word wrap

Compose の詳細情報の表示

# composer-cli compose info COMPOSE-UUID

Copy to Clipboard Toggle word wrap

Compose のイメージファイルのダウンロード

# composer-cli compose image COMPOSE-UUID

Copy to Clipboard Toggle word wrap

Blueprint のメタデータ

name = "BLUEPRINT-NAME"
description = "LONGER BLUEPRINT DESCRIPTION"
version = "VERSION"
modules = []
groups = []

Copy to Clipboard Toggle word wrap

BLUEPRINT-NAME および LONG FORM DESCRIPTION TEXT は、Blueprint の名前および説明に置き換えます。

Semantic Versioning スキームに従い、VERSION をバージョン番号に置き換えます。

この部分は、Blueprint ファイル全体に対して一度だけ提示します。

modules エントリーは、パッケージ名と、イメージにインストールするバージョンと一致する glob を示し、group では、イメージにインストールされるパッケージのグループを記述します。これらの項目を追加しない場合、Blueprint はそれらを empyt リストとして識別します。

イメージに含まれるパッケージ

[[packages]]
name = "package-name"
version = "package-version"

Copy to Clipboard Toggle word wrap

package-name を、パッケージ名 (httpd、gdb-doc、coreutils など) に置き換えます。

package-version を、使用するバージョンに置き換えます。このフィールドは、dnf バージョンの指定に対応します。

• 特定のバージョンを指定する場合は、7.30 のように、バージョン番号を正確に指定してください。
• 利用可能な最新バージョンを指定する場合は、アスタリスク (*) を使用します。
• 最新のマイナーバージョンを指定する場合の形式は、7.* のようになります。

追加するすべてのパッケージにこのブロックを繰り返します。

イメージのホスト名の設定

[customizations]
hostname = "baseimage"

Copy to Clipboard Toggle word wrap

作成されるシステムイメージに対するユーザー指定

[[customizations.user]]
name = "USER-NAME"
description = "USER-DESCRIPTION"
password = "PASSWORD-HASH"
key = "PUBLIC-SSH-KEY"
home = /home"/USER-NAME/"
shell = "/usr/bin/bash"
groups = ["users", "wheel"]
uid = NUMBER
gid = NUMBER

Copy to Clipboard Toggle word wrap

作成されるシステムイメージに対するグループ指定

[[customizations.group]]
name = "GROUP-NAME"
gid = NUMBER

Copy to Clipboard Toggle word wrap

追加するすべてのグループにこのブロックを繰り返します。

既存ユーザーの SSH キーの設定

[[customizations.sshkey]]
user = "root"
key = "PUBLIC-SSH-KEY"

Copy to Clipboard Toggle word wrap

デフォルトにカーネルの起動パラメーターオプションを追加

[[customizations.kernel]]
append = "KERNEL-OPTION"

Copy to Clipboard Toggle word wrap

イメージのホスト名の設定

[customizations]
hostname = "BASE-IMAGE"

Copy to Clipboard Toggle word wrap

作成されるシステムイメージのグループを追加

[[customizations.group]]
name = "USER-NAME"
gid = NUMBER

Copy to Clipboard Toggle word wrap

名前のみが必要であり、GID は任意です。

作成されたシステムイメージにタイムゾーンおよび Network Time Protocol (NTP) サーバーを設定

[customizations.timezone]
timezone = "TIMEZONE"
ntpservers = NTP-SERVER

Copy to Clipboard Toggle word wrap

タイムゾーンを設定しないと、システムはデフォルトとして Universal Time, Coordinated (UTC) を使用します。NTP サーバーの設定はオプションです。

作成されたシステムイメージのロケール設定

[customizations.locale]
language = "[LANGUAGE]"
keyboard = "KEYBOARD"

Copy to Clipboard Toggle word wrap

言語とキーボードの両方のオプションを設定することが必要です。複数の言語を追加できます。最初に追加する言語はプライマリー言語で、他の言語はセカンダリーになります。

作成されたシステムイメージのファイアウォールを設定

[customizations.firewall]
port = "[PORTS]"

Copy to Clipboard Toggle word wrap

/etc/services ファイルの数値ポートまたは名前を使用して、一覧を有効または無効にすることができます。

システムの起動時に有効にするサービスの設定

[customizations.services]
enabled = "[SERVICES]"
disabled = "[SERVICES]"

Copy to Clipboard Toggle word wrap

システムの起動時に有効にするサービスを制御することができます。イメージタイプによっては、サービスがすでに有効または無効になっているため、イメージが正常に機能し、この設定はオーバーライドできません。