WebLogic Image Tool (WIT)を使用して、独自のWebLogic ServerまたはFusion Middleware Infrastructureイメージ(最新のOracle Linuxイメージ、Java更新およびWebLogic Serverパッチを使用)、1回限りのパッチを既存のOCRイメージに適用するか、独自のファイルとアプリケーションをOCRイメージの上にオーバーレイできます。
WIT Setupの手順に従って、WebLogic Image Tool (WIT)をダウンロードしてインストールします。 WIT 「クイック・スタート」 Guideも参照してください。 このドキュメントのサンプルでは、WITが/tmp/imagetoolにインストールされていることを前提としています。任意のロケーションにインストールすることもできます。
WebLogic Image Tool create、update、またはrebaseコマンドは、ベースOSイメージからカスタムWebLogic Serverインストール・イメージを生成するための3つの異なる方法を提供します(オプションで、WebLogicパッチを使用)。 また、WIT createAuxImageコマンドは、WebLogic Serverインストールを含ま「ない」補助イメージの作成をサポートし、代わりにWebLogic Deploy Tooling (WDT)インストールおよびモデル・ファイルのみを含みます。このオプションはModel in Image 「ドメイン・ホーム・ソース・タイプ」用に設計されています。
最後に、WIT inspectコマンドを「イメージの検査」に使用できます。
次に詳細を示します。
WIT createコマンド:
createコマンドは、更新が実行中のドメインを対象としている場合、既存のDomain in Imageイメージ内の既存のドメイン・ホームの更新には適して「いません」。 新しいイメージを適用する前に、かわりにrebaseを使用するか、実行中のドメインを完全に停止します。 詳細は、「イメージ内にドメインを含むカスタム・イメージを作成」を参照してください。 WIT rebaseコマンド:
rebaseコマンドは、Domain in Imageドメインに使用されます。
新しいイメージは、次のいずれかの方法で作成できます:
--recommendedPatchesオプションを適用して最新のセキュリティ・パッチでイメージをリベースすることをお薦めします。 WIT updateコマンド:
--fromImageパラメータで指定)にレイヤー化された新しいWebLogicイメージを作成します。
--pullパラメータを指定し、--fromImageパラメータがリポジトリ内のイメージを参照し、リポジトリ・イメージがローカルにキャッシュされたバージョンのイメージよりも新しい場合、コマンドはリポジトリ・イメージをローカルのDockerキャッシュにダウンロードし、古いローカル・イメージを使用するかわりにそれを使用します。updateコマンドを使用してOracle Homeにパッチを適用すると、コンテナ・イメージに不変のレイヤー化があるため、WebLogic Serverイメージが大きくなります。 個別パッチなどの小規模な更新では、イメージ・サイズの増加が無視できる場合があります。 ただし、更新が大きい場合、サイズの増加は「顕著」になります。 rebaseまたはcreateを使用して、パッチの適用によるサイズの影響を減らすことを検討してください。 updateコマンドは、既存のDomain in Imageイメージ内の既存のドメイン・ホームの更新には適しません。 WIT rebaseコマンドを使用するか、新しいイメージを適用する前に実行中のドメインを完全にシャットダウンします。 詳細は、「実行中のドメインへのパッチ適用済イメージの適用」を参照してください。 WIT createAuxImageコマンド:
WIT inspectコマンド:
すべてのドメイン・ホーム・ソース・タイプには、JDKおよびWebLogic Serverバイナリを含むベース・イメージが必要です。 通常、このベース・イメージはOracle Container Registryから「直接取得」ですが、必要に応じて「独自のカスタム・ベース・イメージの作成」することもできます。
Domain in Imageドメイン・ホーム・ソース・タイプを使用している場合は、ベース・イメージを「イメージ内にドメインを含むカスタム・イメージを作成」する必要があります。
または、Model in Imageドメイン・ホーム・ソース・タイプ「なしで」補助イメージを使用している場合は、さらにベース・イメージを「イメージ内のモデルを使用してカスタム・イメージを作成」に使用する必要があります。
この項では、WebLogic Image Tool (WIT) createコマンドを使用してカスタム・ベースWebLogic Serverイメージをビルドする方法について説明します。 これは、特定のパッチを使用してイメージをビルドする必要がある場合もありますが、ほとんどのユースケースでは、Oracle Container Registryから直接事前ビルドされたパッチ・イメージを取得できます。 「Oracle Container Registryからのイメージの取得」を参照してください。
WIT createコマンドを使用して、ベースOracle Linuxイメージ、WebLogicインストーラ・ダウンロードおよびJREインストーラ・ダウンロードからベースWebLogic Serverイメージを作成する例を次に示します:
まず、WebLogic Image Toolを「インストール」します。 このサンプルでは、/tmp/imagetool内にWITがインストールされていることを前提としています。任意のロケーションにWITをインストールすることもできます。
Oracle Technology Network 「Javaのダウンロード」ページまたはOracle Software Delivery Cloud (OSDC)から目的のJREインストーラをダウンロードします。
Oracle Technology Network 「WebLogic Serverインストーラ」ページまたはOracle Software Delivery Cloud (OSDC)から目的のWebLogic Serverインストーラをダウンロードします。
ノート: WebLogic Serverインストーラには完全にはパッチが適用されません。 後続のステップでは、WIT --patchesまたは--recommendedPatchesオプションを使用して、1回かぎりの推奨Oracleパッチを適用します。
cacheコマンドを使用して、インストーラをWITキャッシュに追加します。 たとえば、インストーラを/home/acmeuser/wls-installersディレクトリにダウンロードするとします:
$ /tmp/imagetool/bin/imagetool.sh cache addInstaller \
--type=jdk \
--version=8u291 \
--path=/home/acmeuser/wls-installers/jre-8u291-linux-x64.tar.gz
$ /tmp/imagetool/bin/imagetool.sh cache addInstaller \
--type=wls \
--version=12.2.1.4.0 \
--path=/home/acmeuser/wls-installers/fmw_12.2.1.4.0_wls_Disk1_1of1.zip
詳細については、WIT 「クイック・スタート」ガイドを参照してください。
createコマンドを使用して、デフォルトのOracle Linuxイメージをベースとして使用してイメージをビルドし、パッチをダウンロードして適用します。
たとえば、次のコマンドを使用して、latest_weblogic:12.2.1.4という名前のWebLogic Serverイメージを作成します:
$ /tmp/imagetool/bin/imagetool.sh create \
--tag latest_weblogic:12.2.1.4 \
--pull \
--jdkVersion=8u291 \
--type=wls \
--version=12.2.1.4.0 \
--recommendedPatches \
--user myusername@mycompany.com \
--passwordEnv=MYPWD
2023年6月現在、Oracle WebLogic Server 12.2.1.3はサポートされなくなりました。 WebLogic Server 12.2.1.3の最後のCritical Patch Updates (CPU)イメージは、2023年4月に公開されました。 2022年12月現在、Fusion Middleware 12.2.1.3はサポートされなくなりました。 FMW Infrastructure 12.2.1.3の最後のCPUイメージは、2022年10月に公開されました。
NOTES:
--userおよび--passwordEnvパラメータ(またはその他のパスワードCLAオプションのいずれか)を使用して、My Oracle Support (Oracle Single Sign-On)資格証明を指定する必要があります。 この例では、MYPWDシェル環境変数にパスワードが含まれていることを前提としています。 --typeパラメータは、生成されたイメージに含めるOracle製品のインストール(WebLogic Server、Fusion Middleware (FMW)インフラストラクチャなど)を指定します。 たとえば、wlsタイプは、WebLogic Server (WLS)汎用インストール、WLSスリム・インストールへのwlsslimタイプ、WLS開発者インストールへのwlsdevタイプに対応します。 各インストール・タイプの詳細は、「WebLogicディストリビューション・インストーラ・タイプ」を参照してください。 --recommendedPatchesパラメータは、インストーラに含まれる各製品の最新のPatchSet更新(PSU)および推奨パッチを検索して適用します。 たとえば、WebLogic Serverの場合、CoherenceおよびTopLinkの推奨パッチが含まれます。 docker imagesを使用してイメージ・キャッシュを表示できます。 --pullパラメータは、新しいイメージのビルド実行前にリモート・リポジトリにチェックを強制するコンテナ・ビルド・エンジンに渡され、ビルド中に使用されるイメージが更新されます(依存関係が更新されます)。ツールによってイメージが作成された後、イメージがローカル・リポジトリにあることを確認します:
$ docker images
イメージの内容を「検査」することもできます。
Oracleでは、プライベート・レジストリにDomain in Imageイメージを格納することを強くお薦めします。 WebLogicドメイン・ホームを含むコンテナ・イメージには、外部リソースへのアクセスに使用される資格証明(データ・ソース・パスワードなど)、復号化キー(DOMAIN_HOME/security/SerializedSystemIni.datドメイン・シークレット・ファイルなど)などの機密情報が含まれます。 詳細は、「コンテナ・イメージ保護」を参照してください。
この項のサンプル・スクリプトは、ベース・イメージcontainer-registry.oracle.com/middleware/weblogic:12.2.1.4を参照します。 これは、WebLogic Serverの最新のセキュリティ・パッチを「含まない」OCR一般提供 (GA)イメージです。 GAイメージは、単一のデスクトップ・デモンストレーションおよび開発「のみ」を目的としています。 それ以外のすべての目的のために、Oracleでは、OCR Critical Patch Updates (CPU)イメージやカスタム生成イメージなど、最新の推奨パッチ・セットが適用されたイメージのみを使用することを強くお薦めします。 「最近パッチが適用されたイメージを使用していることを確認」を参照してください。
この項では、新しいDomain in Imageイメージを作成するためのガイダンスを提供します。 このタイプのイメージは、すでに実行中のドメインのポッドに参加する必要があるポッドでは使用できません。 すでに実行中のドメインを更新するためのDomain in Imageイメージを作成する必要がある場合は、「実行中のドメインへのパッチ適用済イメージの適用」を参照してください。
ノート: Domain in Image ドメイン・ホーム・ソース・タイプは、WebLogic Kubernetes Operatorバージョン4.0では非推奨です。 Oracleでは、必要に応じてDomain on PVまたはModel in Imageを選択することをお薦めします。
Domain in Imageドメインの場合、イメージ内にWebLogicドメインを使用してイメージを作成する必要があります。 ドメインを定義するためにWLSTまたはドメインを定義するためのWebLogic Deploy Toolingモデルを使用してイメージを作成する方法を示す「サンプル」が提供されています。 これらのサンプルでは、ベース・イメージまたは--fromImageイメージへの参照が示されています。 推奨されるセキュリティ・パッチがこのベース・イメージとしてインストールされているイメージを使用する必要があります。このイメージは、OCRイメージまたはカスタム・イメージです。 「Oracle Container Registryからのイメージの取得」および「パッチを適用したカスタム・イメージの作成」を参照してください。
サンプルは、1つの提供スクリプトを使用して複数のステップを実行するため、本番での使用を目的としていません。 個々のステップを理解するには、WLSTまたはWDTを使用してドメイン・ホームをDomain in Imageに作成するための次のステップ・バイ・ステップ・ガイダンスを使用します。
WDTを使用したDomain in Image:
ここでは、WebLogic Deploy Toolingモデルを使用してドメイン・ホームを作成するDomain in Imageのステップ・バイ・ステップのアプローチについて説明します。 これらのステップでは、/tmp/dii-wdt-stageにファイルをステージングし、オペレータ・ソースが/tmp/weblogic-kubernetes-operatorにあると仮定し、WITを/tmp/imagetoolにインストールし、my-dii-wdt:v1という名前のDomain in Imageイメージを生成します。
WLSTを使用したDomain in Image:
WLSTを使用したDomain in Imageイメージのステップ・バイ・ステップ・アプローチを次に示します。 これらのステップでは、ファイルをdii-wlst-stageにステージングし、ドメイン・ホームをイメージ内に/u01/oracle/user_projects/domains/dii-wlstに配置し、オペレータ・ソースが/tmp/weblogic-kubernetes-operatorにあると仮定し、WITを/tmp/imagetoolにインストールし、最終イメージにmy-dii-wlst:v1という名前を付けます。
NOTES:
domain.propertiesファイルには、サンプルのWebLogic管理パスワードが含まれています。 これらのファイルは保護する必要があり、サンプル・パスワードを変更する必要があります。 --additionalBuildCommandsおよび--additionalBuildFilesパラメータで提供されるファイル、またはWDTアプローチで提供されるサンプルWDTモデル・ファイルは、本番での使用を目的として「いません」。 これらのファイルはすべて新しいバージョンのオペレータで大幅に変更でき、特定のユースケースに合わせてコピー、保存、カスタマイズする必要があります。 ノート: 補助イメージのないModel in Image (WDTモデルおよびインストール・ファイルは、WebLogic Serverインストールと同じイメージに含まれています)は、WebLogic Kubernetes Operatorバージョン4.0.7では非推奨です。 Oracleでは、Model in Imageを補助イメージと「一緒に」 「補助イメージ」を参照してください。
この項の例では、ベース・イメージcontainer-registry.oracle.com/middleware/weblogic:12.2.1.4を参照します。 これは、WebLogic Serverの最新のセキュリティ・パッチを「含まない」OCR一般提供 (GA)イメージです。 GAイメージは、単一のデスクトップ・デモンストレーションおよび開発「のみ」を目的としています。 それ以外のすべての目的のために、Oracleでは、OCR Critical Patch Updates (CPU)イメージやカスタム生成イメージなど、最新の推奨パッチ・セットが適用されたイメージのみを使用することを強くお薦めします。 「最近パッチが適用されたイメージを使用していることを確認」を参照してください。
Model in Imageファイル・レイヤーを使用してカスタムWebLogicイメージを作成するステップの例(Model in Imageサンプルからのファイルを使用):
Model in Imageドメインの全体的な理解を得るには、「Model in Imageユーザー・ガイド」および「Model in Imageサンプル」を参照してください。 サンプルでは、この例で使用されている代替アプローチではなく、推奨される最善のアプローチである補助イメージが使用されています。
「Model in Imageサンプル」の前提条件ステップに従って、次の方法について説明します:
/tmp/sampleへのサンプルのコピーを含む)。/tmp/sample/wdt-artifactsディレクトリにダウンロードします。 Model in Imageコンテナ・イメージを作成するには、WDTとWITの両方が必要です。 ベースWebLogicイメージを検索または作成します。
「Oracle Container Registryからのイメージの取得」または「パッチを適用したカスタム・イメージの作成」を参照してください。
次のステップでは、container-registry.oracle.com/middleware/weblogic:12.2.1.4 GAイメージを使用します。
ベース・イメージ、ターゲット・イメージ・タグ、WDTインストールのロケーション、およびWDTモデル・ファイルのロケーションを指定しながら、WITを使用して最終的なイメージを作成します。 例えば:
最初に、モデルZIPファイル・アプリケーション・アーカイブを作成し、サンプル・モデルYAMLファイルおよびモデル・プロパティ・ファイルがすでにステージングされているのと同じディレクトリに配置します:
$ rm -f /tmp/sample/wdt-artifacts/wdt-model-files/WLS-LEGACY-v1/archive.zip
$ cd /tmp/sample/wdt-artifacts/archives/archive-v1
$ zip -r /tmp/sample/wdt-artifacts/wdt-model-files/WLS-LEGACY-v1/archive.zip wlsdeploy
(このサンプルの前回の実行から古いバージョンのアーカイブZIPファイルがある場合、rm -fコマンドが含まれています。)
次に、次のWITコマンドを実行します:
$ cd /tmp/sample/wdt-artifacts/wdt-model-files/WLS-LEGACY-v1
$ ./imagetool/bin/imagetool.sh update \
--tag wdt-domain-image:WLS-LEGACY-v1 \
--fromImage container-registry.oracle.com/middleware/weblogic:12.2.1.4 \
--wdtModel ./model.10.yaml \
--wdtVariables ./model.10.properties \
--wdtArchive ./archive.zip \
--wdtModelOnly \
--wdtDomainType WLS \
--chown oracle:root
NOTE Model in ImageドメインでのJRFサポートは、オペレータ・バージョン4.1.0では非推奨です。JRFドメインの場合は、かわりにDomain on PVドメイン・ホーム・ソース・タイプを使用してください。
イメージを参照するためにModel in Imageを設定するドメインYAMLファイルの例は、/tmp/sample/domain-resources/WLS-LEGACY/mii-initial-d1-WLS-LEGACY-v1.yamlを参照してください
NOTES:
domain.spec.configuration.model.wdtInstallHomeおよび.modelHomeのデフォルト値は、WITがイメージにコピーしたWDTインストールおよびモデル・ファイルのロケーションを参照します。
domain.spec.configuration.model.domainTypeに指定するドメイン・タイプは、イメージの作成時にWITコマンドラインで指定された--wdtDomainTypeに対応している必要があります。