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 |
--fromImageProperties |
--fromImageを説明するプロパティ。 指定しない場合、docker runを使用して--fromImageイメージが検査されます。 「カスタム・ベース・イメージ」を参照 |
|
--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 |
--fromImageProperties--fromImageを指定してデフォルトのベース・イメージをオーバーライドする場合、Image Toolでは、インストールされているオペレーティング・システムやバージョンなど、提供されているイメージに関する追加情報が必要です。 デフォルトでは、docker runを使用してイメージ・ツールによって追加情報が自動的に収集されます。 追加情報を手動で提供し、docker runステップを回避することが望ましい場合は、Javaプロパティ・ファイルを使用して、--fromImagePropertiesに追加情報を提供する必要があります。 ファイルは、キーと値のペアが=で区切られた行指向の形式である必要があります。 例えば:
packageManager=MICRODNF
__OS__ID="ol"
__OS__VERSION="8.10"
必須プロパティ:
| キー | 説明 | デフォルト |
|---|---|---|
packageManager |
すべてのCAPSのfromImageにインストールされているパッケージ・マネージャの名前。 DNF、MICRODNFおよびYUMと同様です |
YUM |
__OS__ID |
ID値は/etc/os-releaseにあります。 Oracle Linuxの場合は"ol"、BusyBoxの場合は"bb"のようになります。 |
|
__OS__VERSION |
/etc/os-releaseにあるVERSION値。 "8.10"のようになります。 |
追加プロパティ:
| キー | 説明 |
|---|---|
javaHome |
JDKがインストールされているロケーション。 "/u01/jdk"のようになります。 |
__OS__arch |
uname -mの出力。 amd64またはarm64のようになります。 |
--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