ここでは、クイック・スタート・チュートリアルのカバーの下で何が起きているかについて少し説明します。
クイック・スタート・ガイドでは、最初にWebLogic Kubernetes Operatorをインストールし、次にModel in Imageドメイン・ホームのソース・タイプを使用してドメインを作成します。
WebLogicドメイン構成は、別の「補助イメージ」にある「WebLogicデプロイメント・ツール」 (WDT)モデルYAMLファイルを使用して指定されます。
オペレータは、ドメインおよびクラスタ・リソースを検出し、WebLogic Server管理サーバーおよび管理対象サーバー・ポッドをデプロイします。
次のステップでは、WebLogic Image Tool (WIT)を使用してクイック・スタート補助イメージを作成するプロセスを順を追って説明します。 これらのステップは、補助イメージの作成を理解およびカスタマイズするのに役立ちます。 次に、ドメイン作成でのそのイメージの使用方法を確認します。
JAVA_HOME環境変数を設定し、有効なJDK 8または11インストールを参照する必要があります。
最新のWebLogic Deploy Tooling (WDT)およびWebLogic Image Tool (WIT)インストーラZIPファイルを新しいディレクトリにダウンロードします。たとえば、ディレクトリ/tmp/quickstart/toolsを使用します。 Model in Image補助イメージを作成するには、WDTとWITの両方が必要です。
例えば:
$ mkdir -p /tmp/quickstart/tools
$ cd /tmp/quickstart/tools
$ curl -m 120 -fL https://github.com/oracle/weblogic-deploy-tooling/releases/latest/download/weblogic-deploy.zip \
-o /tmp/quickstart/tools/weblogic-deploy.zip
$ curl -m 120 -fL https://github.com/oracle/weblogic-image-tool/releases/latest/download/imagetool.zip \
-o /tmp/quickstart/tools/imagetool.zip
WebLogic Image Toolを設定するには、次のコマンドを実行します。
$ unzip imagetool.zip
$ ./imagetool/bin/imagetool.sh cache deleteEntry --key wdt_latest
$ ./imagetool/bin/imagetool.sh cache addInstaller \
--type wdt \
--version latest \
--path /tmp/quickstart/tools/weblogic-deploy.zip
wdt_latestキーに対応するキャッシュ・エントリがない場合、WebLogic Image Tool cache deleteEntryコマンドは何も実行しません。 WITキャッシュ参照情報はデフォルトで$HOME/cache/.metadataファイルに格納され、キャッシュにその--type wdt --version latestのロケーションにすでにWDTのバージョンがある場合、cache addInstallerコマンドは失敗します。 WITキャッシュの詳細は、「キャッシュ」のドキュメントを参照してください。
これらのステップでは、WITを/tmp/quickstart/tools/imagetoolディレクトリにインストールし、ツールのキャッシュにwdt_latestエントリを配置します。このエントリは、WDT ZIPファイル・インストーラを指します。 WITおよびWDTインストーラへのキャッシュされた参照を、後でモデル・イメージを作成するためのサンプルで使用します。
補助イメージに含めるサンプルWDTモデル、webアプリケーションおよびプロパティ・ファイルをダウンロードし、/tmp/quickstart/modelsディレクトリに配置します。 次に、jarコマンドを使用して、webアプリケーション・ファイルをモデル・アーカイブZIPファイルに格納します。
例えば:
$ mkdir -p /tmp/quickstart/models/archive/wlsdeploy/applications/quickstart/WEB-INF
$ curl -m 120 -fL https://raw.githubusercontent.com/oracle/weblogic-kubernetes-operator/release/4.2/kubernetes/samples/quick-start/model.yaml -o /tmp/quickstart/models/model.yaml
$ curl -m 120 -fL https://raw.githubusercontent.com/oracle/weblogic-kubernetes-operator/release/4.2/kubernetes/samples/quick-start/model.properties -o /tmp/quickstart/models/model.properties
$ curl -m 120 -fL https://raw.githubusercontent.com/oracle/weblogic-kubernetes-operator/release/4.2/kubernetes/samples/quick-start/archive/wlsdeploy/applications/quickstart/index.jsp -o /tmp/quickstart/models/archive/wlsdeploy/applications/quickstart/index.jsp
$ curl -m 120 -fL https://raw.githubusercontent.com/oracle/weblogic-kubernetes-operator/release/4.2/kubernetes/samples/quick-start/archive/wlsdeploy/applications/quickstart/WEB-INF/web.xml -o /tmp/quickstart/models/archive/wlsdeploy/applications/quickstart/WEB-INF/web.xml
$ jar cvf /tmp/quickstart/models/archive.zip -C /tmp/quickstart/models/archive/ wlsdeploy
WDTモデルのYAMLファイル、アプリケーション・アーカイブおよびWDTインストール・ファイルを含む補助イメージを作成するには、次のステップに従います。
補助イメージを作成するには、WebLogic Image Tool (WIT)のcreateAuxImageオプションを使用します。
$ /tmp/quickstart/tools/imagetool/bin/imagetool.sh createAuxImage \
--tag quick-start-aux-image:v1 \
--wdtModel /tmp/quickstart/models/model.yaml \
--wdtVariables /tmp/quickstart/models/model.properties \
--wdtArchive /tmp/quickstart/models/archive.zip
このコマンドを実行すると、イメージ・ツールによって、指定したモデル、変数およびアーカイブ・ファイルを含む補助イメージがイメージの/auxiliary/modelsディレクトリに作成されます。 また、最新バージョンのWDTインストールが/auxiliary/weblogic-deployディレクトリに追加されます。 その他の「イメージ・ツール」オプションについては、「補助イメージの作成」を参照してください。
イメージが正常に作成された場合は、ローカル・マシンのDockerリポジトリに配置されます。 例えば:
$ docker images quick-start-aux-image:v1
REPOSITORY TAG IMAGE ID CREATED SIZE
quick-start-aux-image v1 eac9030a1f41 1 minute ago 4.04MB
イメージが作成されると、/auxiliary/weblogic-deployにWDT実行可能ファイル、および/auxiliary/modelsにWDTモデル、プロパティ、およびアーカイブ・ファイルが含まれます。 Dockerイメージでlsを実行して、これを確認できます。
$ docker run -it --rm quick-start-aux-image:v1 ls -l /auxiliary
total 8
drwxr-xr-x 1 oracle root 4096 Jun 1 21:53 models
drwxr-xr-x 1 oracle root 4096 May 26 22:29 weblogic-deploy
$ docker run -it --rm quick-start-aux-image:v1 ls -l /auxiliary/models
total 16
-rw-rw-r-- 1 oracle root 1663 Jun 1 21:52 archive.zip
-rw-rw-r-- 1 oracle root 173 Jun 1 21:59 model.10.properties
-rw-rw-r-- 1 oracle root 1515 Jun 1 21:59 model.10.yaml
$ docker run -it --rm quick-start-aux-image:v1 ls -l /auxiliary/weblogic-deploy
total 28
-rw-r----- 1 oracle root 4673 Oct 22 2019 LICENSE.txt
-rw-r----- 1 oracle root 30 May 25 11:40 VERSION.txt
drwxr-x--- 1 oracle root 4096 May 26 22:29 bin
drwxr-x--- 1 oracle root 4096 May 25 11:40 etc
drwxr-x--- 1 oracle root 4096 May 25 11:40 lib
drwxr-x--- 1 oracle root 4096 Jan 22 2019 samples
イメージをクラスタ内のすべてのノードにコピーするか、クラスタがアクセスできるコンテナ・レジストリに配置します。
前述のステップに従って補助イメージを作成した場合は、次のステップを使用してドメインを作成します。
ドメイン・リソースを準備します。
a. ドメインおよびクラスタ・リソース「サンプルYAMLファイル」を/tmp/quickstart/domain-resource.yamlなどのファイルにダウンロードします。
b. 作成した補助イメージに別の名前とタグを選択した場合は、spec.configuration.model.auxiliaryImagesセクションのイメージ・フィールドを更新して、その名前とタグを使用します。 たとえば、補助イメージにmy-aux-image:v1という名前を付けた場合は、spec.configuration.model.auxiliaryImagesセクションを次のように更新します。
auxiliaryImages:
- image: "my-aux-image:v1"
c. spec.image, spec.imagePullSecrets, spec.webLogicCredentialsSecret、spec.configuration.model.runtimeEncryptionSecretなどの他のフィールドにデフォルト以外の値を選択した場合は、それに応じてこれらのフィールドを更新します。
ドメイン・リソースを適用してドメインを作成します。
$ kubectl apply -f /tmp/quickstart/domain-resource.yaml
次のコマンドを使用して、ツールおよびモデルの生成されたイメージおよびディレクトリを削除します。
docker rmiコマンドを使用して、生成されたイメージを削除します。 次のコマンドを使用して、quick-start-aux-image:v1でタグ付けされたイメージを削除します。
$ docker rmi quick-start-aux-image:v1
WebLogic Deploy ToolingおよびWebLogic Image Toolがインストールされているディレクトリを削除します。
$ rm -rf /tmp/quickstart/tools/
WDTモデル・ファイル、アーカイブおよび変数ファイルがコピーされるディレクトリを削除します。
$ rm -rf /tmp/quickstart/models/