機械翻訳について

モデル

目次

モデル

Modelセクションは、WebLogicドメインのWebLogic Deploy Toolingモデルの操作に役立ちます。 ドメインのWebLogic Deploy Toolingモデルには、次のファイル・タイプを含めることができます:

  • モデル・ファイル - ドメイン構成の宣言的な定義。
  • 変数ファイル - 名前を値にマップするプロパティ・ファイル。 これらの名前はモデル・ファイルから参照でき、特定の環境の変数ファイルをモデルに適用することで、モデルを環境全体で使用できます。
  • アーカイブ・ファイル - ドメインの実行に必要なアプリケーション・バイナリおよびその他のファイルおよびディレクトリを含むZIPファイル。

WebLogic Deploy Toolingモデルの詳細は、WebLogic Deploy Toolingドキュメントの「Metadataモデル」および「アーカイブ・ファイル」を参照してください。

設計ビュー

Design Viewは、WebLogic Remote Consoleとの統合によって提供されます。 バージョンの詳細は、「前提条件」を参照してください。 初回アクセス時に、リモート・コンソールのインストール・ディレクトリのロケーションを指定し、「WebLogic Remote Consoleの起動」をクリックします。

モデルDesign Viewページを使用して、WDTモデル・ファイルを作成または編集します。 参照方法については、リモート・コンソールのドキュメントにある「WDTモデル・ファイル」を参照してください。 また、各フィールドの左側にあるヘルプ(?)アイコンを使用して、フィールドのサマリーと詳細ヘルプにアクセスします。 または、コンテンツ・ペインの右上にある?アイコンをクリックして、ページに表示されるすべてのフィールドの参照情報の表示を切り替えます。

構成するWDTモデル・ファイルは、Code Viewに反映されます。 モデルDesign Viewページを使用すると、フィールドの横の円/矢印アイコンを選択すると、フィールドを変数に設定するオプションを含むダイアログが表示されます。 変数は、Code Viewページのモデル・エディタと変数エディタの両方に表示されます。 同様に、アプリケーションを追加する場合、EAR、WARまたはJARファイル(またはディレクトリ)へのパスを指定します。そのパスは、Code Viewページのアーカイブ・エディタに配置されます。

Design Viewページを使用して新しいモデルを作成する場合、Design ViewはモデルのdomainInfoセクションにAdminUserNameおよびAdminPasswordフィールドを挿入し、その値が値を指定する必要がある変数に設定されます。 これは、すべての必須フィールドを含むドメインを作成するのに役立ちます。

コード・ビュー

IDEに似たレイアウトを使用すると、Code Viewには、モデル、変数およびアーカイブ・ファイルを編集するためのエディタ・ペインが用意されています。これらの各ペインでは、ドメインのWDTファイルの作成および編集がサポートされています。 エディタを操作するときは、次の点に注意してください:

  • データを格納するためのWDTファイルが関連付けられていないWKTプロジェクトで作業する場合、エディタにデータを入力すると、エディタの現在のコンテンツが作成され、プロジェクトに関連付けられます。
  • エディタで行われた変更は、WKTプロジェクトが保存されるまでメモリーにバッファされます。
  • 変数エディタまたはアーカイブ・エディタでデータを追加、削除または変更しても、モデル参照は変更されません。 モデル参照が正確で最新であることを確認する必要があります。

WKT UIアプリケーションを使用してファイルを最初から作成することは可能ですが、File > Add Modelメニューでは、既存のファイルの追加、またはWebLogic Deploy ToolingのDiscover Domain Toolを使用した既存のドメインのモデルの作成がサポートされています。

WebLogic Deploy Toolingでは単一のドメインを記述するために複数のモデル、変数またはアーカイブ・ファイルの使用がサポートされていますが、現在のリリースのWKTでは、1つのWDTモデル・ファイル、1つのWDT変数ファイル、およびドメインを記述するための1つのWDTアーカイブ・ファイル「のみ」がサポートされます。

モデル・エディタ

Code Viewでは、モデル・エディタはナビゲーション・ペインのすぐ右にあります。 このエディタには、WKTプロジェクト・ファイルに関連付けられた現在のモデル・ファイルが表示されます。 モデル・コンテンツをエディタに入力すると、次回プロジェクトが保存されたときに、新しいモデル・ファイルがプロジェクトに追加されます。

現在のリリースには、次の制限があります:

  • モデル・ファイルはYAML形式である必要があります。
  • モデル・ファイルはファイル・システムに直接存在し、アーカイブ内(ZIPファイル内など)には存在する必要があります。アーカイブ内のモデル・ファイルはアプリケーションによって無視されます。

変数エディタ

WDT変数エディタは、Code Viewページの右上ペインにあります。 既存の名前と値のペアの編集、および名前と値のペアの追加または削除がサポートされています。

モデルから変数を参照するには、目的のモデル・ファイルの値を変数参照に設定する必要があります。 たとえば、ここに示すモデル・スニペットは、httpPortという名前の変数を参照します。 

topology:
    Name: tododomain
    ProductionModeEnabled: true
    Cluster:
        mycluster:
            DynamicServers:
                ServerNamePrefix: Server_
                DynamicClusterSize: 10
                ServerTemplate: mysrvtemplate
    ServerTemplate:
        mysrvtemplate:
            ListenPort: '@@PROP:httpPort@@'
            Cluster: mycluster

このモデル・ファイルを操作する場合、WebLogic Deploy Toolingでは、次に示すように、モデルの変数ファイルにhttpPort変数が定義されていることが想定されます:

httpPort = 7001

アーカイブ・エディタ

WDTアーカイブ・エディタは、Code Viewページの右下ペインにあります。 アーカイブ・ファイルに対するコンテンツの追加および削除をサポートします。 アーカイブ内のコンテンツの更新はアーカイブ・エディタによって直接サポートされませんが、アーカイブ・エディタは、同じエントリに対する複数の操作を安全にサポートします。 そのため、remove操作の後に対応するadd操作を組み合せると、エントリは効果的に置き換えられます。

アーカイブ・ファイルにコンテンツを追加するには、アーカイブ・エディタのタイトル・バーのプラス(+)ボタンを使用し、プロンプトに従って、追加するコンテンツのタイプを選択し、対応するファイルまたはディレクトリを選択します。 たとえば、todo.warというWARファイルをアーカイブに追加するには、次を実行します:

  1. アーカイブ・エディタのタイトル・バーで、+をクリックします。
  2. 表示されるダイアログで、リストからApplication Fileを選択し、OKをクリックします。
  3. 表示されるファイル・チューザ・ダイアログで、todo.warファイルを選択し、Selectをクリックします。

これにより、ファイル構造wlsdeploy/applications/todo.warがアーカイブ・エディタ・ペインに追加されます。 この時点で、アプリケーションはアーカイブ・ファイルを作成または変更していません。単に、追加したエントリへのアーカイブ・パスおよびコンテンツが検出されるファイル・パスに必要なデータを格納します。 WKTプロジェクトを保存すると、エディタで実行されたバッファ処理を反映するようにアーカイブが更新されます。

次のモデル・ファイル・スニペットに示すように、モデルにアプリケーションを追加し、そのSourcePath属性をアーカイブ内のパスに設定することを忘れないでください。

appDeployments:
    Application:
        todo:
            SourcePath: wlsdeploy/applications/todo.war
            ModuleType: war
            Target: mycluster

アーカイブ・ファイルからコンテンツを削除するには、削除するコンテンツをアーカイブ・エディタ・ペインで選択し、アーカイブ・エディタのタイトル・バーのマイナス(-)ボタンをクリックします。 モデル・ファイルからこのコンテンツへの参照を削除することを忘れないでください。

モデルの検証

Validate Modelは、WDT Validate Model Toolを起動します。これは、モデルとその関連アーティファクトが整形式であることをバリデートし、特定のモデルのロケーションの有効な属性およびサブフォルダに関するヘルプを提供します。 このアクションを使用するには、ModelページのValidate Modelボタンを使用し、Go > Validate Model Filesを選択します。

モデルの準備

Prepare Modelは、WebLogic Kubernetes OperatorまたはVerrazzanoがインストールされたKubernetesクラスタで動作するようにモデルを変更するために、WDT Prepare Model Toolを起動します。 このアクションを使用するには、ModelおよびKubernetes WebLogic DomainページのPrepare Modelボタンを使用し、Go > Prepare Model for Kubernetesを選択します。 Create Imageアクション中にPrepare Modelを実行することもできますが、通常、Imageセクションに移動する前にPrepare Modelを明示的に実行することをお薦めします。

Prepare Modelは次のことを行います:

  1. ターゲット環境と互換性がないモデル・セクションおよびフィールドを削除します。
  2. エンドポイント値を、変数を参照するモデル・トークンに置き換えます。
  3. 資格証明値を、Kubernetesシークレットまたは変数のフィールドを参照するモデル・トークンに置き換えます。
  4. アプリケーションの変数、変数のオーバーライドおよびシークレット・エディタに表示されるフィールドのデフォルト値を指定します。
  5. ドメインのデプロイに使用されるリソース・ファイルの生成に使用するアプリケーションにトポロジ情報を抽出します。

詳細は、WDT 「モデル・トークン」のドキュメントを参照してください。

資格証明値を置換する場合、Prepare Modelは、"Domain in Image"および"Model in Image" ドメインのロケーションの置換を別の方法で処理する必要があります:

  • "Domain in Image"では、イメージの作成時にWebLogic Image Toolによってドメインが作成されます。 そのため、Kubernetesの知識がないため、トークン置換では変数トークンが使用され、ドメイン作成で実際の資格証明値にアクセスできるようになります。 Create Primary Imageを実行する前に、すべての変数に有効な値があることを確認する必要があります。

  • "Model in Image"の場合、ドメインは、Kubernetesクラスタで実行されているWebLogic Kubernetes Operatorによって実行時に作成されます。 そのため、トークン置換では、すべての資格証明フィールドにシークレット・トークンが使用されます。 必要なシークレットがドメイン・デプロイメント中に正しく移入されるように、WebLogic DomainセクションのSecretsペインを使用して、すべてのシークレット参照フィールドに値を指定する必要があります。 詳細については、「WebLogicドメイン」を参照してください。

アプリケーションは、Prepare Modelがシークレット・トークンに置き換わるモデルおよび変数ファイルの値を保持しようとします。 現在のリリースは、すべてのパスワードが保持されず、適切なロケーションに再入力する必要があるという、基礎となるWDT Prepare Model Toolの動作によって制限されます。