機械翻訳について

WebLogic Deploy Toolingモデルの作成

WebLogic Deploy Toolingプロジェクトは、WebLogic Serverドメインのライフサイクル操作を実行するための単一目的ツールのセットを提供します。 これらのツールは、ドメインのモデルで動作します。 モデルには、次の3つのタイプのファイルが含まれています:

  • モデル・ファイル - WebLogic Scripting Tool (WLST)のオフライン・フォルダおよび属性に合せたドメインのYAMLの説明。
  • 変数ファイル - キー/バリューのペアを含むオプションのJavaプロパティ・ファイル。キーは、モデル・ファイルに配置されたトークンと一致します。
  • アーカイブ・ファイル - ドメインに存在する必要があるファイル・アーティファクトを含むオプションのZIPファイル。たとえば、Webアプリケーションのバイナリを含むWARファイルなどです。

WDTの詳細は、WebLogic Deploy Tooling 「ドキュメント」を参照してください。

WKTUIには、WDTモデルを簡単に作成および編集できるツールが用意されています。 このイメージは、WebLogic Remote Console画面を使用してモデルを視覚的に編集できるModelページのDesign Viewタブを示しています。

モデル設計ビュー

次のイメージは、モデルを構成する3つの異なるファイル・タイプのそれぞれを直接編集できるModelページのCode Viewタブを示しています。 画面の中央に、モデル・ファイル用のYAMLエディタがあります。 右側には、変数ファイル・エディタとアーカイブ・ファイル・エディタがあります。 この時点では、すべてのセクションが空白です。

モデル・コード・ビュー

WKTUIでは、既存のドメインの検出もサポートして、そのドメインのモデルを抽出します。 これを行うには、WDT Discover Domainツールを使用します。 この機能を使用するには、FileメニューのAdd Modelサブメニューを使用します。 次の2つのメニュー・アイテムがあります:

  • Discover Model (offline) - このオプションを使用すると、WDTはローカル・ファイル・システムからドメイン・ディレクトリを読み取り、モデル・ファイルを抽出します。
  • Discover Model (online) - このオプションを使用すると、WDTはドメインの実行中の管理サーバーに接続して、モデル・ファイルを抽出します。 すべてのアーカイブ・ファイルの内容を自動的に収集するには、そのドメインがローカル・マシンで実行中であり、そのドメインがドメインのファイル・システムにアクセスできるようにする必要があります。

別のマシンで実行されているドメインからモデルを収集するには、「リモート検出」オプションを使用できます。 このオプションを使用すると、Discover Domain (online)アクションの最後に、WDTによって、収集してアーカイブ・ファイルに追加する必要があるファイルが示されます。

ToDoリスト・アプリケーションにはドメインからの要件が最小限であるため、モデルを手動で作成します。 ローカル・ドメインを作成し、モデルの検出機能を使用する場合は、詳細セクションの「ToDoリスト・ドメインの作成」を参照してください。

ToDoリスト・ドメインの作成

モデルの「設計ビュー」タブで開始します。このタブは、デフォルトで「ドメイン」要素のGeneralタブに設定されます。 次の図に示すように、Nameフィールドをtodolist_domainに設定し、Production Modeを有効にします。

ドメイン設定

次に、動的クラスタで使用するサーバー・テンプレートを作成する必要があります。 「サーバー・テンプレート」要素を選択し、todo-srv-templateという名前の新しいサーバー・テンプレートを追加して、「作成」をクリックします。 テンプレートを作成したら、画面が次のイメージのようになるようにListen Port Enabledを有効にします。

サーバー・テンプレート

次に、Clusterフィールドの右側にある3つのドット(ドロップダウン・メニュー)を選択し、Create New Clusterメニュー・アイテムを選択します。 myclusterという名前の新しいクラスタを作成します。 次に、ドロップダウン・メニューで、サーバー・テンプレートのクラスタ属性として選択します。

新しいクラスタClusters > myclusterに移動し、Dynamicタブを選択します。 次の表に示す値にフィールドを設定します。

フィールド名 値
Server Template todo-srv-template
Server Name Prefix ToDoServer-
Dynamic Cluster Size 10
Max Dynamic Cluster Size 10
Enable Calculated Listen Ports Off

データ・ソースの作成

次のステップでは、MySQLデータベースと通信するためのデータ・ソースを作成します。 これを行う前に、Code Viewタブに切り替えて、これまでのWDTモデルの外観を確認します。

部分モデル・コード・ビュー

前のイメージに示すように、入力した設定はYAMLエディタに表示されます。 モデル・エディタがドメインの管理ユーザー名およびパスワードのフィールドを挿入し、値を@@PROP:<property-name>@@という形式のトークンに設定することに注意してください。 これらのトークンは変数を参照します。変数名が変数エディタに追加されたことがわかります。 先に進み、使用する値を入力します。たとえば、ユーザー名にはweblogic、パスワードには強力なパスワード値を入力します。 ここで、Design Viewタブに戻ります。

Services > Data Sources領域に移動し、次の表の値を使用して新しいデータ・ソースを追加し、「作成」をクリックします。 次のデータベース・ユーザー名とパスワードを選択できます。 後でMySQLデータベースをデプロイするときは、必ず同じ資格証明を使用してください。

フィールド名 値
Name myDataSource
JNDI Names jdbc/ToDoDB
Targets mycluster (Chosen列に移動)
Datasource Type Generic Data Source
Database Type MySQL
Database Driver MySQL’s Driver (Type 4) Versions: using com.mysql.cj.jdbc.Driver
Global Transactions Protocol OnePhaseCommit
Database Name tododb
Host Name mysql
Port 3306
Database User Name データベース・ユーザー名の選択
Password データベース・ユーザーのデータベース・パスワードの選択

myDataSourceデータ・ソースが作成されたら、Connection Pool > Advancedタブに移動し、次の変更を行います:

  1. Test Connection On Reserveを有効にします。
  2. テスト表名をToDosに設定します。

ここで、アプリケーションを追加する必要があります。 Deployments > App Deploymentsに移動し、次の表の値を使用して新しいアプリケーションを追加し、「作成」をクリックします。 コードのダウンロード時に、表内の$QS_HOME値をQuick Startディレクトリを格納したパスに置き換える必要があります。 実際のファイル・システムのロケーションを入力すると、値はアーカイブ・ファイル(wlsdeploy/applications/todo.war)のパスを反映するように変更されることに注意してください。

フィールド名 値
Name todo
Targets mycluster (Chosen列に移動)
Add Source to Archive ON
Source $QS_HOME/app/target/todo.war

ローカル・ドメインを作成するのに十分なモデルが完成している場合でも、WebLogic Kubernetes Operatorがモデルを使用できるように、いくつかのフィールドを追加する必要があります。 Code Viewタブに戻ります。 今回はモデルを直接編集します。 モデルのトポロジ・セクションを次のようにします。 

topology:
    Name: todolist_domain
    ProductionModeEnabled: true
    AdminServerName: AdminServer
    Server:
        AdminServer:
    Cluster:
        mycluster:
            DynamicServers:
                ServerTemplate: 'todo-srv-template'
                ServerNamePrefix: 'ToDoServer-'
                DynamicClusterSize: 10
                MaxDynamicClusterSize: 10
                CalculatedListenPorts: false
                MinDynamicClusterSize: 0
    ServerTemplate:
        'todo-srv-template':
            ListenPortEnabled: true
            Cluster: mycluster

モデルのバリデートと準備

ドメイン・モデルが完了しました。 Validate Modelをクリックするか、GoメニューのValidate Model Filesメニュー・アイテムを使用して、モデルをバリデートします。 これを行うと、次の図に示すように、WDT Validate Model Toolが起動し、画面下部のコンソール・ウィンドウにツールの出力が表示されます。 コンソール・ウィンドウはいつでもクローズできます。

Validate Modelコード・ビュー

Kubernetesにドメインをデプロイする場合は、その環境に対してドメインを準備する必要があります。 WDT Prepare Model Toolでは、これを実行するために必要なものが提供されます。 WKTUIには、Kubernetes環境のモデルを調整するだけでなく、WKTUIに必要なモデルから抽出されたデータを戻すという点で、Prepare Modelとの特別な統合があります。 たとえば、Prepare Modelは、アプリケーションの他の部分がこのドメインの環境を調整するために使用するWebLogicクラスタおよび非クラスタ化された管理対象サーバーのリストを返します。 Prepare Modelをクリックして、WDT Prepare Model Toolを起動します。

クイック・スタート演習でイメージ内のモデルを使用することを選択したため、Prepare Modelによってモデルに複数の変更が加えられました。

  • 資格証明を、Kubernetesシークレットを参照するトークンに置き換えます。
  • Data Source URLなどのフィールドを、変数を参照するトークンに置き換えます。

次のイメージは、イメージに入れる準備ができた完成モデルを示しています。したがって、次のセクションに移動する前にプロジェクトを保存してください。

Prepare Modelコード・ビュー