WDTモデル・ファイル

WDTメタデータ・モデル・ファイルは、WebLogic Serverドメイン構成の説明です。これらのモデルは、実行中のWebLogic Serverドメインに接続されていません。モデル・ファイルを編集してから、WebLogic Deploy Tooling (WDT)を使用してライブ・ドメインを構築または変更します。

WDTモデル・ファイルは、ドメインの単純な表現です。通常、これらはYAMLで記述されますが、WebLogic Remote ConsoleはJSON形式のモデルも受け入れます。簡潔にするために、WDTモデル・ファイルではデフォルト構成からの離脱のみが記述されます。

ノート

WebLogic Remote Consoleでは、WDTモデル・ファイルに挿入したデータはバリデートされません。これは、無効な変更または値を受け入れ、モデル・ファイルを使用してドメインを構築または更新するときに問題が発生します。

WDTモデル

topology:
    Server:
        AdminServer:
        ManagedServer1:
            Cluster: Cluster2
        ManagedServer2:
            Cluster: Cluster2
        ManagedServer3:
    ServerTemplate:
        ServerTemplate1:
    Cluster:
        Cluster1:
            DynamicServers:
                ServerTemplate: ServerTemplate1
                DynamicClusterSize: 3
        Cluster2:
resources:
    JDBCSystemResource:
        DataSource1:
            JdbcResource:
                JDBCDriverParams:
                    DriverName: oracle.jdbc.replay.OracleXADataSourceImpl
                    URL: 'jdbc:oracle:thin:@//dbhost:1521/Database1'
                JDBCDataSourceParams:
                    JNDIName: [
                        jdbc/myDS
                    ]
                    GlobalTransactionsProtocol: TwoPhaseCommit
                DatasourceType: GENERIC
            Target: [
                Cluster2
            ]
            
appDeployments:
    Application:
        Application1:
            Target: [
                Cluster1
            ]
            SourcePath: /apps/benefits/benefits.war
            StagingMode: default

WDTモデル・トークン

WDTモデル・トークンを使用して、固定値を動的ファイルに置き換えることで、WDTモデル・ファイルの柔軟性を高めます。

WDTモデル・トークンを使用すると、適用可能なWDTトークンに基づいて適応するWDTモデル・ファイルを作成できます。唯一の差異がいくつかの固定値である複数のWDTモデル・ファイルを作成するのではなく、1つのファイルを作成して、必要に応じてトークンを更新できます。

WebLogic Remote Consoleは、複数のタイプのWDTモデル・トークンをサポートします。すべてのトークンがこの形式に従います: @@TYPE:KEY@@。TYPEはモデル・トークン・タイプ、KEYは変数値です。様々なタイプのWDTモデル・トークンとその構文の詳細は、WebLogic Deploy Toolingのモデル・トークンを参照してください。

WebLogic Remote Consoleでは、WDTモデル・トークンを次の2つの方法で挿入できます:

スタンドアロンWDTモデル・トークン
WDT変数

スタンドアロンWDTモデル・トークン

スタンドアロンWDTモデル・トークンは、WDTモデル・ファイルがWebLogic Deploy Toolingまたは別の外部プロセスを通過したときに置換されるトークンです。 WebLogic Remote Consoleは、トークンの値について何も認識せず、更新できません。

WDT変数

WDT変数を使用すると、WebLogic Remote Console内からWDTモデル・トークンとその値を管理できます。最初に、トークンとその値のセットを含むプロパティ・リストを作成し、次にプロパティ・リストをWDTモデル・ファイルに割り当てます。リンクされると、プロパティ・リストで作成したプロパティが、関連付けられたWDTモデル・ファイルに挿入できるようになります。プロパティ・リストでモデル・トークンを一元化することで、その値を簡単に更新し、使用可能なトークンを確認できます。

詳細については、「プロパティ・リスト」を参照してください。

各WDTモデル・ファイルは、1つのプロパティ・リストからのみプルできますが、複数のWDTモデル・ファイルに対して同じプロパティ・リストを使用できます。

ノート

スタンドアロンのWDTモデル・トークンとWDT変数の両方を同じWDTモデル・ファイルで使用できます。これは、特定の値を同期し、他の値を少し静的なままにする場合や、後のプロセスで変更する場合に便利です。

WDTモデル・ファイルの作成

WebLogic Deploy Toolingで使用するWDTモデル・ファイルを作成するには:

プロバイダ・ドロワーを開き、プロジェクト名の横にある「その他」をクリックします。 「新規WDTモデル・ファイルのプロバイダの作成」を選択します。
WDTモデル・ファイル・プロバイダの名前を入力します。
「WDTモデル・ファイル名」フィールドに、WDTモデル・ファイルの名前を入力します。ファイル名の末尾に.yamlまたは.jsonを含めます。
「ディレクトリを選択」をクリックして、新しいWDTモデル・ファイルを保存するディレクトリを参照します。
「スパース・テンプレートの使用」を有効にして、管理サーバーへの参照を含まないWDTモデル・ファイルを作成します。
このWDTモデル・ファイルでWDT変数を使用する場合は、「WDT変数」ドロップダウン・リストからプロパティ・リスト・プロバイダを選択します。まだプロパティ・リスト・プロバイダがない場合は、後で追加できます。
OKをクリックして、WDTモデル・ファイルを作成します。

WDTモデル・ファイルのアップロード

WDTモデル・ファイルを別の場所に作成した場合は、それをWebLogic Remote Consoleにアップロードして編集を続行できます。

プロバイダ・ドロワーを開き、プロジェクト名の横にある「その他」をクリックします。 「WDTモデル・ファイル・プロバイダの追加」を選択します。
WDTモデル・ファイル・プロバイダの名前を入力します。
「ファイルのアップロード」をクリックして、WDTモデル・ファイルを保存したディレクトリを参照します。

WDTモデル・ファイルは、YAMLまたはJSON形式である必要があります。
このWDTモデル・ファイルでWDT変数を使用する場合は、「WDT変数」ドロップダウン・リストからプロパティ・リスト・プロバイダを選択します。まだプロパティ・リスト・プロバイダがない場合は、このプロバイダの設定を後で編集して追加できます。
OKをクリックして、WDTモデル・ファイルをアップロードします。

WDTモデル・ファイルの編集

WDTモデル・ファイルを変更するには:

ノート

特定のドメイン構成オプションの場所とその適用方法のガイダンスについては、「管理サーバー」にあるタスクを確認してください。 WDTモデル・ツリーのパースペクティブは、管理サーバー・プロバイダの「ツリーの編集」パースペクティブとよく似ています。

編集するWDTモデル・ファイルを開きます。
「WDTモデル・ツリー」をクリックして、変更を行うノードに移動します。
変更するドメイン構成の横にある「WDT設定」をクリックして、「WDT設定」ダイアログ・ボックスを開きます。
次のいずれかのオプションを使用して、フィールドに新しい値を設定します:

フィールドの値を設定するための様々な方法について説明します。

オプション	説明
デフォルト(設定解除)	フィールドをデフォルト値にリストアします。
Select Value	現在のWDTモデル・ファイルに存在するコンポーネントへの参照を選択します。
値の入力	固定値を入力します。
モデル・トークンの入力	WDTモデル・トークンを入力します。
未解決の参照の入力	現在のWDTモデル・ファイルには存在しないが後で存在するコンポーネントへの参照を入力します。
モデル・トークン変数の選択	使用可能なオプションのリストからWDTモデル・トークン変数を選択します。このオプションを表示するには、WDTモデル・ファイルをプロパティ・リストに接続する必要があります。
モデル・トークン変数の作成	新しいWDTモデル・トークン変数を作成するには、変数名と変数値を入力します。新しいモデル・トークン変数が接続されたプロパティ・リストに追加されます。このオプションを表示するには、WDTモデル・ファイルをプロパティ・リストに接続する必要があります。

「今すぐ保存」をクリックして、変更内容でYAMLファイルを更新します。

フィールドをデフォルト値に戻す場合は、フィールドを右クリックして「デフォルトに戻す」をクリックします。

WebLogic Serverドメインの作成

WDTモデル・ファイルのプロパティに問題がなければ、WebLogic Deploy Tooling (WDT)を使用してライブのWebLogic Serverドメインに変換できます。

WDTモデル・ファイルをWebLogic Remote Consoleに保存します。コンピュータ上のYAMLファイルのロケーションをノートにとります。
「WDT GitHubリポジトリ」から最新バージョンのWDTをダウンロードします。
「WDTドキュメント」の指示に従って、WDTモデル・ファイルからドメインを作成します。