rebase
コマンドは、新しいコンテナ・イメージを作成し、既存のWebLogicドメインをその新しいイメージにコピーします。
新しいコンテナ・イメージは、リポジトリ内の既存のイメージに基づいて作成するか、create
コマンドのようなリベース操作の一部として作成できます。
Usage: imagetool rebase [OPTIONS]
パラメータ | 定義 | デフォルト |
---|---|---|
--sourceImage |
(必須) WebLogicドメインを含むソース・イメージ。 | |
--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 |
--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 よりも優先されます。 |
|
--skipcleanup |
ビルド・コンテキスト・フォルダ、中間イメージおよび失敗したビルド・コンテナは削除しないでください。 デバッグを目的としています。 | |
--strictPatchOrdering |
パッチを一度に1つ適用するようにOPatchに指示します(napply ではなくapply を使用します)。 |
|
--target |
作成されたイメージを使用するターゲット環境を選択します。 サポートされる値: Default (Docker/Kubernetes)、OpenShift 。 「追加情報」を参照してください。 |
Default |
--targetImage |
ドメインの新しいイメージ用に拡張するコンテナ・イメージ。 | |
--type |
インストーラのタイプ。 サポートされる値: WLS , WLSDEV , WLSSLIM , FMW , IDM , OHS , OHS_DB19 , OSB , OUD_WLS , SOA_OSB , SOA_OSB_B2B , MFT , WCP , OAM , OIG , OUD , OID , ODI , SOA , WCC , WCS , WCP |
WLS |
--user |
Oracleサポートの電子メールID。 user を指定する場合は、--passwordEnv を使用して環境変数として、または--passwordFile を使用するファイルとして、または--password を使用するコマンド行で対話形式でパスワードを指定する必要があります。 |
|
--version |
インストーラのバージョン | 12.2.1.3.0 |
--additionalBuildCommands
これは、Dockerビルド・ステップに追加のコマンドを提供するための拡張オプションです。
このパラメータの入力は、1つ以上の有効なセクションを含む単純なテキスト・ファイルです。 リベースに有効なセクション:
セクション | 使用可能変数 | ビルド・ステージ | タイミング |
---|---|---|---|
initial-build-commands |
なし | すべて | ルートとして、およびイメージ・ツール・アクションの前に。 |
before-jdk-install |
JAVA_HOME DOMAIN_HOME |
中間(JDK_BUILD) | JDKがインストールされる前。 |
after-jdk-install |
JAVA_HOME DOMAIN_HOME |
中間(JDK_BUILD) | JDKのインストール後。 |
before-fmw-install |
JAVA_HOME ORACLE_HOME DOMAIN_HOME |
中間(WLS_BUILD) | Oracle Homeが作成される前。 |
after-fmw-install |
JAVA_HOME ORACLE_HOME DOMAIN_HOME |
中間(WLS_BUILD) | すべてのOracleミドルウェア・インストーラが終了した後。 |
final-build-commands |
JAVA_HOME ORACLE_HOME DOMAIN_HOME |
最終イメージ | すべてのイメージ・ツール・アクションが完了した後、コンテナ・イメージが確定される直前。 |
ノート: 中間ステージで行われた変更は、手動でコピーしないかぎり最終イメージに繰り越されない場合があります。
イメージ・ツールは、JavaホームおよびOracle Homeディレクトリを最終イメージにコピーします。
これらのディレクトリ内に完全に含まれる変更は、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 |
イメージ・ツールに渡されたすべての引数をファイルに保存し、そのファイルをパラメータとして使用できます。
たとえば、build_args
というファイルを作成します:
rebase
--tag wls:122140
--sourceImage wls:122130
--version 12.2.1.4.0
--jdkVersion 8u221
これは、次のようにコマンドラインで使用します:
$ imagetool @/path/to/build_args
ノート: --password
のかわりに--passwordEnv
または--passwordFile
を使用します。
次のコマンドは、必要なすべてのJDK、WLSまたはFMW (WebLogicインフラストラクチャ)インストーラがキャッシュ・ディレクトリにダウンロードされていることを前提としています。 cacheコマンドを使用して設定します。
既存のドメインのJDKを更新します。 JDKが8u202であったsample:v1
からsample:v2
という新しいイメージに既存のドメインをコピーし、WebLogic Server 12.2.1.3.0を使用して新しいJDK 8u221をインストールします。
$ imagetool rebase --tag sample:v2 --sourceImage sample:v1 --version 12.2.1.3.0 --jdkVersion 8u221
既存のドメインのOracle Homeを新しいバージョンのWebLogicで更新します。 WebLogic Server 12.2.1.4.0の新しいインストールを使用して、既存のイメージから新しいイメージにドメインをコピーします。 sample:v1
からドメインをコピーし、--version
引数を使用して目的のWebLogicインストーラを選択します。
$ imagetool rebase --tag sample:v2 --sourceImage sample:v1 --version 12.2.1.4.0 --jdkVersion 8u221
インストール済みのバイナリを含む別のイメージを使用して、既存のドメインのJDKまたはOracle Home(あるいはその両方)を更新します。 sample:v1
という名前のソース・イメージから、fmw:12214
という名前のターゲット・イメージに基づいてsample:v2
という新しいイメージにドメインをコピーします。 ノート: Oracle HomeおよびJDKは、各イメージの同じフォルダにインストールする必要があります。
$ imagetool rebase --tag sample:v2 --sourceImage sample:v1 --targetImage fmw:12214