機械翻訳について

WebLogic Image Toolを使用したイメージの作成

WKTUIでは、WebLogic Image Tool (WIT)を使用してコンテナ・イメージをビルドします。 Oracle Fusion Middleware (「FMW)ドメイン・ターゲットのロケーション」オプションはそれぞれ独自のイメージ要件を持ちます。

  • Model-in-Image - MIIには2つのアプローチがあります:
    • 単一イメージ - このアプローチでは、Java、FMW、WDTおよびWDTモデル・ファイルを含む単一のイメージがすべて単一のイメージに組み込まれています。 WKTUIでは、Primary Imageタブを使用してこのようなイメージをビルドします。
    • 二重イメージ - このアプローチでは、JavaおよびFMWを1つのイメージに配置し、WKTUIはプライマリ・イメージをコールし、WDTおよびWDTモデル・ファイルを別のイメージ(補助イメージ)に配置します。 このドキュメントでは、これを補助イメージを使用したMIIと呼びます。
  • Domain-in-Image - DIIは単一のイメージ・アプローチを使用しますが、WDTおよびWDTモデル・ファイルを使用してイメージ内にドメインを作成します。
  • Domain-on-PV - DoPVは、JavaおよびFMWを含む単一のイメージを使用します。 ドメインは、外部手段で永続ボリュームに作成されます。

補助イメージのあるMIIとDomain-on-PVの両方に、構成のないソフトウェア(JavaおよびFMW)のみを含むイメージがあります。 これにより、操作上の重要ないくつかの利点が得られます:

  • ドメイン固有の構成は含まれないため、複数のドメインが同じソフトウェア専用イメージを共有できます。 すべてのドメインが同じイメージを共有する何百ものドメインの更新は、WebLogic Kubernetes Operatorドメインのカスタム・リソース指定を更新してイメージを変更するのと同じくらい簡単です。 WKOはこの変更を検出し、管理サーバーから開始してドメインのローリング更新を実行します。
  • Oracle Container Registry (OCR)は、ログインして使用条件に同意した後、直接使用できる事前作成済のイメージを配布します。 アクティブなサポート契約を結んでいるOracleのお客様は、推奨パッチの最新セットを使用して、事前構築済みのイメージにアクセスできます。 事前構築済のイメージの詳細、および目的のリポジトリの条件を受け入れるには、https://container-registry.oracle.comを参照してください。

DIIおよびMII (補助イメージなし)では、ドメイン・セット全体でセキュリティ修正をロールアウトするために、すべてのドメインに新しいイメージをビルドする必要があります。 ドメイン数が多い場合、この負荷が大きくなり、環境のセキュリティが低下します。 これらの操作上の利点を利用するには、ToDoリスト・ドメインに補助イメージとともにMIIを使用します。

次のイメージに示すように、Imageページに移動します。

イメージ・ページ

独自のプライマリ・イメージをビルドするには、デフォルトでオフになっているCreate New Primary Imageを有効にします。 これを行うには、Java 11 JDKおよびWebLogic Server 14.1.1インストーラをダウンロードし、フォームに入力して、Create Primary Imageを実行する必要があります。 その後、イメージ・レジストリ内の任意の場所にイメージ・リポジトリを作成し、新しく作成したイメージをそこでプッシュする必要があります。 Oracleが次のパッチ・セットをリリースしたら、再度実行する必要があります。

幸いなことに、OCRでは事前作成済のイメージのみを使用できます。 OCRにログインし、「ミドルウェア」カテゴリを選択します。 Oracle Support資格証明を持たないユーザーの場合は、weblogicリポジトリの使用条件に同意していることを確認してください。 次のイメージでは、weblogicリポジトリ行の末尾にある緑色のチェックマークに注意してください。 Oracle Support資格証明を持つユーザーは、かわりにページの下部にあるweblogic_cpuリポジトリを使用することを強くお薦めします。

OCR

この練習では、新しい補助イメージを作成します。 これはデフォルト設定で、Auxiliary Imageタブがアクティブです。 次のイメージに示すように、Auxiliary Imageタブを選択します。

Auxイメージ・タブ

最初に決定する必要があるのは、補助イメージに使用するイメージ・レジストリです。 この演習では、Oracle Cloud (OCIR)のコンテナ・レジストリを使用しますが、別のイメージ・レジストリを自由に置換できます。 ここでは、イメージ・レジストリの選択が残りの例に影響する箇所を示します。

Oracle Cloudアカウントにログインした後、次のイメージに示すように、「開発者サービス」カテゴリの下の「コンテナ・レジストリ」オプションを選択します。

OCIRのロケーション

選択したレジストリで、wktui-qs/todolist-auxという新しいプライベート・リポジトリを作成します。 新しいリポジトリへのアクセスに必要なURLに注意してください。 OCIRリポジトリの場合、URLの形式は<region-abbreviation>.ocir.io/<tenancy-name>/wktui-qs/todolist-auxです。region-abbreviationはphx (フェニックス・リージョンの場合)のようなもので、tenancy nameはhttps://cloud.oracle.comへのログインに使用されるテナンシの名前です。 使用可能なすべてのリージョンのリストは、この「表」を参照してください。

このOCIRリポジトリにDockerおよびKubernetesからアクセスするには、パスワードのかわりにアカウントに関連付けられた認証トークンを使用する必要があります。 認証トークンを作成するには、ユーザー設定に移動し、リソースの下の「認証トークン」オプションを選択し、次のイメージに示すように「トークンの生成」をクリックします。 生成されたトークンのコピーは必ず保持してください。なぜならば、あなたがクリア・テキストでみることができるのはこの機会「のみ」だからです。

OCI認証トークンの作成

イメージ・レジストリの準備ができたので、WKTUIのAuxiliary Imageタブに入力します。 フォームに入力する前に、いくつかの注意事項があります。

  • ほとんどのイメージ・レジストリでは、イメージをプッシュするために認証が必要です。 OCIRを使用している場合は、補助イメージ・レジストリのプッシュ・ユーザー名および補助イメージ・レジストリのプッシュ・パスワードで次の操作を実行する必要があります:
    • ユーザー名: <tenancy-name>/<username>の形式である必要があります。
    • パスワード: ユーザー・アカウントに関連付けられた認証トークンの値である必要があります。
  • デフォルトでは、WIT (したがってWKTUI)は、補助イメージのベース・イメージとしてBusyBoxを使用します。 通常、BusyBoxはDocker Hubから来ており、Docker Hubは匿名のプル・リクエスト・スロットルを実装しているため、イメージのビルド中にスロットル関連エラーの変更を最小限に抑えるために、有効なDocker Hubユーザー名およびDocker Hubパスワードを入力することをお薦めします。
  • ベース・イメージは、Use Custom Base Imageを有効にしてフォームに入力するだけで変更できます。
  • ターゲット・プラットフォームがOpenShiftの場合は、ページの「拡張」セクションでMake Image Compatible with OpenShiftを有効にします。

これらを念頭に置いて、次の表のデータを使用してフォームに入力します。 フィールドの値を指定しない場合は、環境に特に必要な場合を除き、デフォルトに設定したままにします。

フィールド名 値
Auxiliary Image Tag <image-repository-url>:1.0 ;例: phx.ocir.io/mytenancy/wktui-qs/todolist-aux:1.0
Specify Auxiliary Image Push Credentials ON
Auxiliary Image Registry Push Username <tenancy>/<username> ;例: mytenancy/fred.jones@mycompany.com
Auxiliary Image Registry Push Password <auth-token-value> ;例: z+M3C2UqRraHG73Z+.X8
Use Custom Base Image OFF
Docker Hub Username Docker Hubアカウントのユーザー名
Docker Hub Password Docker Hubアカウントのパスワード
Download and Use Latest WebLogic Deploy Tooling Installer ON
Make Image Compatible with Open Shift OFF (環境に必要な場合を除く)

フォームを完了すると、補助イメージを作成する準備が整います。 「補助イメージの作成」をクリックすると、指定した一連の引数を指定してアプリケーションがWITを起動し、補助イメージをビルドできます。 WITのcreateAuxImageコマンドを実行する前に、次の2回プロンプトが表示されます:

  • 補助イメージを作成する前に、常にPrepare Modelを実行する必要があります。 すでに完了しているため、Prepare Modelを実行せずに続行するには、Noを選択します。
  • ダウンロードしたWDTインストーラを保存するロケーションを選択する必要があります。 ロケーションを選択し、「選択」をクリックします。

次の図は、補助イメージが正常に作成された後のアプリケーションを示しています。

AUXイメージの作成

これで、補助イメージをイメージ・レジストリにプッシュする準備ができました。 macOSで実行する場合は、Docker (またはPodman)の実行可能ディレクトリ(たとえば、Rancher Desktopを使用している場合は$HOME/.rd/bin)がProject SettingsページのExtra Path Directories表に追加されていることを確認する必要があります。 これを行うと、Dockerは、資格証明を格納するためにmacOSキー・チェーンと対話するために使用する実行可能ファイルを検索できます。

「Push Auxiliary Image」をクリックします。 この時点で、フォーカスをKubernetesクラスタにシフトする準備ができました。 モデル・ファイルを変更する場合は、新しい補助イメージを作成する必要があります。モデルのYAMLファイルにフィールドが追加された場合は、Prepare Modelを再実行する必要がある場合があります。 新しいイメージを作成してプッシュする前に、必ずAuxiliary Image Tagフィールドのバージョン番号を増やすことを強くお薦めします。 これにより、どのイメージが使用されているかがわかります。