createAuxImage
コマンドは、特定のベースOSイメージからのコンテナ・イメージの作成に役立ちます。 補助イメージは、WDTモデル、アーカイブおよび「WebLogic Kubernetes Operator - 補助イメージ」の変数を含むWDTインストール・ファイルを提供する非常に小さいイメージです。 これらのイメージは、モデル・イン・イメージ・モデル・ファイル、アプリケーション・アーカイブ・ファイル、WebLogicツール・インストール・ファイル、またはその他のタイプのファイルをWebLogic Server Kubernetes Operator環境に含める代替アプローチです。
この機能には、多数のオプションのパラメータがあります。 コマンドに必要なオプションはマークされます。
Usage: imagetool createAuxImage [OPTIONS]
パラメータ | 定義 | デフォルト |
---|---|---|
--tag |
(必須)最終ビルド・イメージのタグ。 例: store/oracle/mydomain:1 |
|
--additionalBuildCommands |
追加のビルド・コマンドを使用したファイルへのパス。 詳細については、「追加情報」を参照してください。 | |
--additionalBuildFiles |
additionalBuildCommands で必要な追加ファイル。 ビルド・コンテキストにコピーする必要があるファイルのカンマ区切りリスト。 「追加情報」を参照してください。 |
|
--builder , -b |
Dockerfileを処理する実行ファイル。 パスにない場合は、実行可能ファイルのフルパスを使用します。 | デフォルトはdocker で、設定する場合は環境変数WLSIMG_BUILDER の値に設定されます。 |
--buildNetwork |
イメージ・ビルド時のRUN命令のネットワーク・モード。 Docker build については、--network を参照してください。 |
|
--chown |
WDTインストーラ、WDTモデル、WDTアーカイブなど、イメージ内のファイルの作成に使用されるuserid:groupid 。 ユーザーまたはグループがイメージに存在しない場合は、useradd/groupaddで追加されます。 |
oracle:oracle |
--dryRun |
Dockerビルド実行をスキップし、Dockerfileをstdoutに出力します。 | |
--fromImage |
新しいイメージの作成時にベース・イメージとして使用するコンテナ・イメージ。 | busybox |
--httpProxyUrl |
HTTPプロトコルのプロキシ。 例: http://myproxy:80 またはhttp:user:passwd@myproxy:8080 |
|
--httpsProxyUrl |
HTTPSプロトコルのプロキシ。 例: https://myproxy:80 またはhttps:user:passwd@myproxy:8080 |
|
--packageManager |
ベース・イメージのオペレーティング・システムのデフォルトのパッケージ・マネージャをオーバーライドします。 サポートされる値: APK , APTGET , NONE , YUM , ZYPPER |
|
--platform |
ビルドするターゲット・プラットフォームを設定します。 サポートされる値: linux/amd64 またはlinux/arm64 。 |
|
--pull |
ビルド中、常に新しいバージョンのベース・イメージをプルしようとします。 | |
--skipcleanup |
ビルド・コンテキスト・フォルダ、中間イメージおよび失敗したビルド・コンテナは削除しないでください。 デバッグを目的としています。 | |
--target |
作成されたイメージを使用するターゲット環境を選択します。 サポートされる値: Default (Docker/Kubernetes)、OpenShift 。 「追加情報」を参照してください。 |
Default |
--wdtArchive |
WDTアーカイブZIPファイルまたはカンマ区切りファイルのリスト。 | |
--wdtHome |
WDTインストールおよびモデルのイメージ内のターゲット・フォルダ。 | /auxiliary |
--wdtModel |
WDTモデル・ファイルまたはファイルのカンマ区切りリスト。 | |
--wdtModelHome |
WDTモデル、変数およびアーカイブ・ファイルをコピーするイメージ内のターゲットのロケーション。 | {wdtHome}/models |
--wdtVariables |
WDT変数ファイルまたはファイルのカンマ区切りリスト。 | |
--wdtVersion |
{wdtHome}/weblogic-deploy のコンテナ・イメージにインストールされるWDTバージョン。 詳細については、「追加情報」を参照してください。 |
latest |
--additionalBuildCommands
これは、Dockerビルド・ステップに追加のコマンドを提供するための拡張オプションです。
このパラメータの入力は、1つ以上の有効なセクションを含む単純なテキスト・ファイルです。 createAuxImage
の有効なセクションは次のとおりです:
セクション | 使用可能変数 | ビルド・ステージ | タイミング |
---|---|---|---|
initial-build-commands |
なし | すべて | ルートとして、およびイメージ・ツール・アクションの前に。 |
package-manager-packages |
なし | すべて | ftp gzip などのOSパッケージのリスト。行またはスペースで区切られます。 |
final-build-commands |
AUXILIARY_IMAGE_PATH WDT_HOME WDT_MODEL_HOME |
最終イメージ | すべてのイメージ・ツール・アクションが完了した後、コンテナ・イメージが確定される直前。 |
各セクションには、1つ以上の有効なDockerfileコマンドが含まれており、次のようになります:
[final-build-commands]
LABEL owner="middleware team"
COPY --chown=oracle:oracle files/my_additional_file.txt /auxiliary
--additionalBuildFiles
このオプションは、イメージ・ビルド・コマンドに追加のファイルを提供する方法を提供します。 提供されたすべてのファイルおよびディレクトリは、ビルド・コンテキストのfiles
サブフォルダに直接コピーされます。
これらのファイルをイメージに取り込むには、additionalBuildCommands
オプションを使用して追加のビルド・コマンドを指定する必要があります。 COPY
やADD
などのビルド・コマンドを使用してこれらのファイルにアクセスするには、フォルダ・プレフィクスfiles/
で元のファイル名を使用する必要があります。 たとえば、元のファイルが--additionalBuildFiles /scratch/test1/convenience.sh
として提供された場合、--additionalBuildCommands
で提供されているDockerビルド・コマンドCOPY
はCOPY --chown=oracle:oracle files/convenience.sh /my/internal/image/location
のようになります。
Image Toolはマルチ・ステージ・ビルドを使用するため、ビルド・コマンド(COPY
など)をDockerfile
の適切なセクションに配置することが重要です。このセクションは、ビルドでファイル)。 たとえば、ファイルが最終イメージで必要であり、インストールまたはドメインの作成のステップでは必要ない場合は、final-build-commands
セクションを使用して、イメージ・ビルドの最終段階でCOPY
コマンドが発生するようにします。
--target
補助イメージのファイル権限は、WebLogic Serverがインストールされているコンテナ・イメージと一致する必要があります。 ターゲット・オプションは、同じowner:groupファイル権限を持つイメージの作成を簡素化する便利な補助イメージに提供されます。 create
およびcreateAuxImage
を使用してイメージを作成する場合、--target
に同じ値を使用します。
ターゲット | デフォルト・ファイル権限 | デフォルトのファイル所有権 |
---|---|---|
Default |
rwxr-x--- |
oracle:oracle |
OpenShift |
rwxrwx--- |
oracle:root |
--wdtVersion
バージョン1.11.0では、WDTとモデル・ファイルを別々のイメージにインストールすることもできます。 デフォルトでは、キャッシュされたWDTのwdt_latest
バージョンが、選択したモデル、アーカイブおよび変数ファイルとともに補助イメージにインストールされます。 --wdtVersion=none
(大/小文字を区別しない)を使用すると、WDTをインストールせずに補助イメージが作成されます。
イメージ・ツールに渡されたすべての引数をファイルに保存し、そのファイルをパラメータとして使用できます。
たとえば、build_args
というファイルを作成します:
createAuxImage
--tag mydomain:1
--wdtModel ./my_domain.yaml
--wdtArchive ./my_domain.zip
これは、次のようにコマンドラインで使用します:
$ imagetool @/path/to/build_args
次のコマンドは、必要なWDTインストーラがダウンロードされ、ImageToolキャッシュに追加されていることを前提としています。 cacheコマンドを使用して設定します。
最新のWebLogic Deploy Toolingバージョンでwdt:1.10
という名前のイメージを作成します。
$ imagetool createAuxImage --tag wdt:1.10
前述のものと同じオプションを使用してmydomain:1
という名前のイメージを作成し、WDTモデルおよびアーカイブを追加します。
$ imagetool create --tag mydomain:1 --wdtModel /path/to/my_domain.yaml --wdtArchive /path/to/my_domain.zip