機械翻訳について

3 コマンド・リファレンス

ock-forgeユーティリティのコマンド・リファレンス。

ock-forgeユーティリティは、rpm-ostreeツリー・ファイル構成に基づいて、OCKのブート可能メディアおよびOSTreeコンテナ・イメージを構築します。

ock-forge
[{-s|--source} URI]
[{-b|--branch} branch-name]
[{-d|--device} block-device]
[{-D|--disk} image-path]
[{-f|--filesystem} filesystem]
[{-i|--image} container-image]
[{-s|--source} URI]
[{-b|--branch}]
[{-C|--configs-dir} path]
[{-c|--config-dir} path]
[{-o|--os-name} name]
[{-O|--ostree-image-path} path]
[{-n|--no-clean}]
[{-P|--partition}]
[{-p|--provider} ignition-provider]
[{-I|--ignition} path]
[{-B|--build-image} container-image]
[[--karg key=value]...]
[[--karg-append key=value]...]
[[--karg-delete key=value]...]

説明:

{-s|--source} URI

Gitリポジトリまたはディレクトリへのパス。 ロケーションの内容がビルド・ディレクトリにコピーされます。 このオプションを省略すると、デフォルトの構成が使用されます。

{-b|--branch} branch-name

Gitブランチの名前。 このオプションを指定すると、指定されたブランチがクローニングされます。 このオプションを指定しないと、デフォルトのブランチがクローニングされます。

{-d|--device} block-device

既存のブロック・デバイスへのパス。 このデバイスはインストール先です。 OCK Image Builderによって実行されるすべての操作は、このデバイスに対して実行されます。

{-D|--disk} image-path

ディスク・イメージ・ファイルへのパス。 この値は、インストール先がrawデバイスではなくファイルである場合にのみ必要です。 ディスク・イメージ・ファイルは、--deviceオプションで指定したデバイスに接続されます。

{-f|--filesystem} filesystem

ルート・パーティションのフォーマット時に使用するファイルシステム。 これはxfsである必要があります。

{-i|--image} container-image

タグを含む完全修飾コンテナ・イメージ名。 この引数はいくつかの方法で使用されます。 単独で指定した場合、このコンテナ・イメージがOSをデプロイするためのベース・イメージとして使用されます。 この場合、OSTreeの構築は完全にスキップされます。 --config-dirオプションおよび--ostree-image-pathオプションを指定した場合、OSTreeコンテナ・イメージが生成されます。このイメージは、後のインストールまたはアップグレードに使用できます。

{-s|--source} URI

OCK構成のURI。 構成は、このロケーションから--configs-dir引数の値にコピーされます。 URIが.gitで終わる場合、それがGitリポジトリを参照していると想定されます。 それ以外の場合、URIはローカル・ファイル・システム上のディレクトリとみなされます。

{-b|--branch}

--sourceがGitリポジトリを参照している場合、指定したブランチはクローニング後にチェックアウトされます。

{-C|--configs-dir} path

rpm-ostree構成のセットを含むディレクトリ。

{-c|--config-dir} path

ビルドするrpm-ostree構成を含むディレクトリ。 これは、すべてのシンボリック・リンクを解決するために必要な深さで、--configs-dirのサブディレクトリである必要があります。 このオプションを指定すると、完全なrpm-ostreeビルドが実行され、オプションでOpen Container Initiative (OCI)アーカイブにパッケージ化されます。

{-o|--os-name} name

OSTreeデプロイメントの名前。

{-O|--ostree-image-path} path

インストール・プロセスによって生成されたOpen Container Initiative (OCI)アーカイブの書込みパス。 この値を指定しない場合、アーカイブは生成されません。 --config-dirオプションが指定されていない場合、このオプションは無視されます。 --imageオプションが指定され、有効なOSTreeコンテナ・イメージを指している場合は、チャンク・イメージを生成するための参照として使用されます。

{-n|--no-clean}

このオプションを指定した場合、パーティションのアンマウントや仮想ブロック・デバイスのデタッチなど、インストール後のクリーン・アップ・ステップは実行しないでください。

{-P|--partition}

このオプションを指定すると、--deviceオプションを使用して指定されたブロック・デバイスは、そのパーティション表を消去し、デフォルトのジオメトリで再移入します。

{-p|--provider} ignition-provider

点火プロバイダを設定します。 デフォルト値はqemuです。ただし、--ignitionオプションが使用されている場合を除きます。この場合、デフォルト値はfileです。

これは、OCIのイメージを作成するときにociに設定することもできます。 ociプロバイダは、コンピュート・インスタンスの作成時に、「インスタンス・メタデータ・サービス」のmetadata user_dataキー/バリュー・ペアからイグニッション情報を読み取ります。

{-I|--ignition} path

ock-forgeがブート・ディスクに直接インストールできる点火ファイルへのパス。 これは、ocne cluster startまたはocne cluster joinコマンドの出力からの完全な点火ファイルです。 ファイルは、デプロイメントのinitramfsに埋め込まれます。 --providerオプションが指定されていない場合、--providerオプションはfileに設定されます。

{-B|--build-image} container-image

OCKブート・メディアの構築時に使用するコンテナ・イメージの名前。 デフォルト値はock-builder:latestです。

--karg key=value

ostreeコマンドに渡すカーネル引数を設定します。 これによって、同じ「キー」を持つ既存の引数がオーバーライドされます。 使用法については、ostree-admin-deploy(1)のマニュアル・ページを参照してください。 各カーネル引数には、個別の--kargオプションが必要です。

--karg-append key=value

ostreeコマンドに渡すカーネル引数を追加します。 使用法については、ostree-admin-deploy(1)のマニュアル・ページを参照してください。 追加される各カーネル引数には、個別の--karg-appendオプションが必要です。

--karg-delete key=value

ostreeコマンドの既存のカーネル引数を削除します。 使用法については、ostree-admin-deploy(1)のマニュアル・ページを参照してください。 削除される各カーネル引数には、個別の--karg-deleteオプションが必要です。