create
コマンドは、特定のベースOSイメージからWebLogicコンテナ・イメージをビルドするのに役立ちます。 この機能には、多数のオプションのパラメータがあります。 コマンドに必要なオプションはマークされます。
ノート: WebLogic Image Toolは、スタック・パッチ・バンドル(SPB; Doc ID 2764636.1を参照)をサポートしません。これは、SPBはパッチではなく、すべてのPSUおよび推奨CPUおよびSPUパッチをWebLogic Serverインストールに適用するメカニズムであり、--recommendedPatches
オプションを指定してImage Tool create
コマンドを起動するのと同様です。
Usage: imagetool create [OPTIONS]
パラメータ | 定義 | デフォルト |
---|---|---|
--tag |
(必須)最終ビルド・イメージのタグ。 例: store/oracle/weblogic:12.2.1.3.0 |
|
--additionalBuildCommands |
追加のビルド・コマンドを使用したファイルへのパス。 詳細については、「追加情報」を参照してください。 | |
--additionalBuildFiles |
additionalBuildCommands で必要な追加ファイル。 ビルド・コンテキストにコピーする必要があるファイルのカンマ区切りリスト。 「追加情報」を参照してください。 |
|
--builder , -b |
Dockerfileを処理する実行ファイル。 パスにない場合は、実行可能ファイルのフルパスを使用します。 | デフォルトはdocker で、設定する場合は環境変数WLSIMG_BUILDER の値に設定されます。 |
--buildNetwork |
イメージ・ビルド時のRUN命令のネットワーク・モード。 Docker build については、--network を参照してください。 |
|
--chown |
JDK、FMW/WLSインストールなど、イメージ内のファイルの作成に使用されるuserid:groupid 。ユーザーまたはグループがイメージに存在しない場合は、useradd/groupaddで追加されます。 |
oracle:oracle |
--docker |
(非推奨) Docker実行可能ファイルへのパス。 かわりに--builder を使用します。 |
docker |
--dryRun |
Dockerビルド実行をスキップし、Dockerfileをstdoutに出力します。 | |
--fromImage |
新しいイメージの作成時にベース・イメージとして使用するコンテナ・イメージ。 | ghcr.io/oracle/oraclelinux:8-slim |
--httpProxyUrl |
HTTPプロトコルのプロキシ。 例: http://myproxy:80 またはhttp:user:passwd@myproxy:8080 |
|
--httpsProxyUrl |
HTTPSプロトコルのプロキシ。 例: https://myproxy:80 またはhttps:user:passwd@myproxy:8080 |
|
--installerResponseFile |
1つ以上のカスタム・レスポンス・ファイル。 インストーラのレスポンス・ファイルへのパスのカンマ区切りのリスト。 Oracleサイレント・インストーラのデフォルトのレスポンスをオーバーライドします。 | |
--inventoryPointerFile |
カスタム・インベントリ・ポインタ・ファイルへのパス。 | |
--inventoryPointerInstallLoc |
インベントリ・ポインタ・ファイルのターゲットのロケーション。 | |
--jdkVersion |
インストールするサーバーJDKのバージョン。 | 8u202 |
--latestPSU |
最新のPatchSet Updateを検索して適用します。 | |
--opatchBugNumber |
OPatchのパッチ番号(OPatchへのパッチ適用)。 | 28186730 |
--packageManager |
ベース・イメージのオペレーティング・システムのデフォルトのパッケージ・マネージャをオーバーライドします。 サポートされる値: APK , APTGET , NONE , OS_DEFAULT , YUM , ZYPPER |
OS_DEFAULT |
--password |
STDINのOracle Support --user のパスワードをリクエストします。--user を参照してください。 |
|
--passwordEnv |
Oracle Supportパスワードを含む環境変数。--user を参照してください。 |
|
--passwordFile |
Oracle Supportパスワードのみを含むファイルへのパス。--user を参照してください。 |
|
--patches |
パッチIDのカンマ区切りリスト。 例: 12345678,87654321 |
|
--platform |
ビルドするターゲット・プラットフォームを設定します。 サポートされる値: linux/amd64 またはlinux/arm64 。 |
|
--pull |
ビルド中、常に新しいバージョンのベース・イメージをプルしようとします。 | |
--recommendedPatches |
最新のPatchSet Updateおよび推奨パッチを検索して適用します。 これは、--latestPSU よりも優先されます。 |
|
--resourceTemplates |
イメージ・ツールで解決する必要があるプレースホルダーを含む1つ以上のファイル。 「リソース・テンプレート・ファイル」を参照してください。 | |
--skipcleanup |
ビルド・コンテキスト・フォルダ、中間イメージおよび失敗したビルド・コンテナは削除しないでください。 デバッグを目的としています。 | |
--strictPatchOrdering |
パッチを一度に1つ適用するようにOPatchに指示します(napply ではなくapply を使用します)。 |
|
--target |
作成されたイメージを使用するターゲット環境を選択します。 サポートされる値: Default (Docker/Kubernetes)、OpenShift 。 「追加情報」を参照してください。 |
Default |
--type |
インストーラのタイプ。 サポートされる値: WLS , WLSDEV , WLSSLIM , FMW , IDM , MFT , OAM , ODI , OHS , OIG , OUD , OUD_WLS , OID , OSB , SOA , SOA_OSB , SOA_OSB_B2B , WCC , WCP , WCS |
WLS |
--useBuildx |
コンテナ・イメージを構築するには、BuildKitを使用します。 | |
--user |
Oracleサポート電子メールID。 user を指定する場合は、--passwordEnv を使用して環境変数として、または--passwordFile を使用するファイルとして、または--password を使用するコマンド行で対話形式でパスワードを指定する必要があります。 |
|
--version |
インストーラのバージョン | 12.2.1.3.0 |
--wdtArchive |
WDTアーカイブZIPファイルまたはカンマ区切りファイルのリスト。 | |
--wdtDomainHome |
WDTの-domain_home へのパス。 |
/u01/domains/base_domain |
--wdtDomainType |
WDTドメイン・タイプ。 サポートされる値: WLS , JRF , RestrictedJRF |
WLS |
--wdtEncryptionKey |
STDINでリクエストされるWDT -use_encryption のパスフレーズ。 |
|
--wdtEncryptionKeyEnv |
環境変数として提供されるWDT -use_encryption のパスフレーズ。 |
|
--wdtEncryptionKeyFile |
ファイルとして提供されるWDT -use_encryption のパスフレーズ。 |
|
--wdtHome |
WDTインストールおよびモデルのイメージ内のターゲット・フォルダ。 | /u01/wdt |
--wdtJavaOptions |
WDTのJavaコマンドライン・オプション。 | |
--wdtModel |
WDTモデル・ファイルまたはファイルのカンマ区切りリスト。 | |
--wdtModelHome |
WDTモデル、変数およびアーカイブ・ファイルをコピーするイメージ内のターゲットのロケーション。 | {wdtHome}/models |
--wdtModelOnly |
WDTをインストールし、モデルをイメージにコピーしますが、ドメインは作成しません。 | false |
--wdtRunRCU |
ドメインの作成時にRCUを実行するようにWDTに指示します。 | |
--wdtStrictValidation |
WDTバリデーション・メソッドには厳密なバリデーションを使用します。 モデルのみを使用している場合にのみ適用されます。 | false |
--wdtVariables |
WDT変数ファイルまたはファイルのカンマ区切りリスト。 | |
--wdtVersion |
使用するWDTバージョン。 | latest |
--additionalBuildCommands
これは、Dockerビルド・ステップに追加のコマンドを提供するための拡張オプションです。
このパラメータの入力は、1つ以上の有効なセクションを含む単純なテキスト・ファイルです。 作成の有効なセクションは次のとおりです:
セクション | 使用可能変数 | ビルド・ステージ | タイミング |
---|---|---|---|
initial-build-commands |
なし | すべて | ルートとして、およびイメージ・ツール・アクションの前に。 |
package-manager-packages |
なし | すべて | ftp gzip などのOSパッケージのリスト。行またはスペースで区切られます。 |
before-jdk-install |
JAVA_HOME |
中間(JDK_BUILD) | JDKがインストールされる前。 |
after-jdk-install |
JAVA_HOME |
中間(JDK_BUILD) | JDKのインストール後。 |
before-fmw-install |
JAVA_HOME ORACLE_HOME |
中間(WLS_BUILD) | Oracle Homeが作成される前。 |
after-fmw-install |
JAVA_HOME ORACLE_HOME |
中間(WLS_BUILD) | すべてのOracleミドルウェア・インストーラが終了した後。 |
before-wdt-command |
DOMAIN_HOME |
中間(WDT_BUILD) | WDTがインストールされる前。 |
after-wdt-command |
DOMAIN_HOME |
中間(WDT_BUILD) | WDTドメインの作成/更新が完了した後。 |
final-build-commands |
JAVA_HOME ORACLE_HOME DOMAIN_HOME |
最終イメージ | すべてのイメージ・ツール・アクションが完了した後、コンテナ・イメージが確定される直前。 DOMAIN_HOME は、ビルド中にWDTが使用された場合にのみ使用できます。 |
ノート: 中間ステージで行われた変更は、手動でコピーしないかぎり最終イメージに繰り越されない場合があります。
イメージ・ツールは、Javaホーム、Oracle Home、ドメイン・ホームおよびWDTホーム・ディレクトリを最終イメージにコピーします。
これらのディレクトリ内に完全に含まれる変更は、final-build-commands
セクションに追加のCOPY
コマンドを必要としません。
各セクションには、1つ以上の有効なDockerfileコマンドが含まれており、次のようになります:
[after-fmw-install]
RUN rm /some/dir/unnecessary-file
COPY --chown=oracle:oracle files/my_additional_file.txt /u01
[final-build-commands]
LABEL owner="middleware team"
--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
コマンドが発生するようにします。 または、ドメインの作成前にファイルがOracle Homeを変更する必要がある場合は、after-fmw-install
またはbefore-wdt-command
セクションを使用します。
--target
デフォルトでは、イメージ内に生成されたWLSドメインは、Oracle WebLogic Serverで定義されているベスト・プラクティスを使用します。 target
オプションを使用すると、生成されたドメインがターゲット環境で簡単に使用できるように、デフォルトを切り替えることができます。 たとえば、--target OpenShift
オプションは、グループ・アクセス権がユーザー・アクセス権と一致するように、ドメイン・ディレクトリ内のファイル・アクセス権を変更します。
ターゲット | デフォルト・ファイル権限 | デフォルトのファイル所有権 |
---|---|---|
Default |
rwxr-x--- |
oracle:oracle |
OpenShift |
rwxrwx--- |
oracle:root |
指定すると、--resourceTemplates
で指定されたファイルが上書きされます。 既知のトークンの場合、プレースホルダーは次の表に従って値に置き換えられます。
ノート: プレースホルダーは、{{imageName}}
や{{{imageName}}}
などのMustache構文に従う必要があります。
トークン名 | 値の説明 |
---|---|
domainHome |
--wdtDomainHome を使用してイメージ・ツールに提供される値。 |
domainHomeSourceType |
PersistentVolume (デフォルト)、--wdtModelOnly の場合はFromModel 、またはWDTを使用してイメージにドメインが作成されている場合はImage 。 |
imageName |
--tag を使用してイメージ・ツールに提供される値。 |
modelHome |
--wdtModelHome を使用してイメージ・ツールに提供される値。 |
イメージ・ツールに渡されたすべての引数をファイルに保存し、そのファイルをパラメータとして使用できます。
たとえば、build_args
というファイルを作成します:
create
--type wls
--version 12.2.1.3.0
--tag wls:122130
--user acmeuser@mycompany.com
--httpProxyUrl http://mycompany-proxy:80
--httpsProxyUrl http://mycompany-proxy:80
--passwordEnv MYPWD
これは、次のようにコマンドラインで使用します:
$ imagetool @/path/to/build_args
ノート: --password
のかわりに--passwordEnv
または--passwordFile
を使用します。
次のコマンドは、必要なすべてのJDK、WLSまたはFMW (WebLogicインフラストラクチャ)インストーラがキャッシュ・ディレクトリにダウンロードされていることを前提としています。 cacheコマンドを使用して設定します。
WebLogicインストーラ12.2.1.3.0、サーバーJDK 8u202および最新のPSUを適用して、sample:wls
という名前のイメージを作成します。
$ imagetool create --tag sample:wls --latestPSU --user testuser@xyz.com --password hello
前述のものと同じオプションを使用してsample:wdt
という名前のイメージを作成し、WebLogic Deploy Toolingを使用してドメインを作成します。
$ imagetool create --tag sample:wdt --latestPSU --user testuser@xyz.com --password hello --wdtModel /path/to/model.json --wdtVariables /path/to/variables.json --wdtVersion 0.16
wdtVersion
が指定されていない場合、ツールは最新リリースを使用します。
選択したパッチが適用されたsample:patch
という名前のイメージを作成します。
$ imagetool create --tag sample:patch --user testuser@xyz.com --password hello --patches 12345678,p87654321
パッチ番号は'p
'で始まる場合とされない場合があります。