https://blogs.oracle.com/weblogicserver/make-weblogic-domain-provisioning-and-deployment-easy
Oracle WebLogic Deploy Tooling(WDT)を使うと、WebLogic Serverドメインのプロビジョニングとアプリケーションのデプロイ自動化が容易になります。WDTでは、メンテナンスが必要なWLSTスクリプトを作成するのではなく、ドメインやアプリケーション、そしてアプリケーションが使用するリソースを記述する宣言的なメタデータモデルを作成します。このメタデータモデルを使って、プロビジョニング、デプロイメント、およびドメインライフサイクル操作の実行を繰り返し実行することができ、アプリケーションのContinuous Deliveryに最適です。
Oracle WebLogic Server Deploy ToolingWDTは10.3.6から12.2.1.3までの幅広いWebLogic ServerのバージョンならびにWindowsとUNIXの両方のOSをサポートするという柔軟性を有しており、次の利点があります。
https://github.com/oracle/weblogic-deploy-tooling
- WebLogicドメインを観察してメタデータモデル(JSONまたはYAML)に抽出する
- 新規WebLogic Serverドメインをメタデータモデルを使って作成、ドメイン構成のバージョン管理が可能
- 既存のWebLogic Serverドメインの構成を更新し、アプリケーションやリソースをドメインに展開
- ランタイムへの変更を実施する前に、メタデータモデル(モデルとも呼ばれる)へのランタイム変更が可能
- 別のプロパティファイルで値を提供できるようプレースホルダを設定でき、同じモデルを複数の環境に適用可能
- モデルやプロパティファイルで直接パスワードを暗号化可能
- スパースモデル(疎性モデル)をサポート、他のアーティファクトを記述しなくてもモデルは特定の操作に必要なものを記述するだけでよい
- モデルの内容を簡単に検証し、関連する成果物がフォーマット上問題ないことを検証
- 自動化とデプロイのContinuous Deliveryが可能
- DockerイメージやKubernetesのような環境へのドメインのLift & Shiftを容易に
現在、このプロジェクトでは5個の専用ツールを提供しており、全てシェルスクリプトとして公開しています。
- Create Domain Tool(ドメイン作成ツール、createDomain)ドメインの作成方法と、モデルに指定されているすべてのリソースとアプリケーションをドメインに移入する
- Update Domain Tool(ドメイン更新ツール、updateDomain)
既存のドメインを更新し、モデルに指定されているすべてのリソースとアプリケーションをオフラインモードまたはオンラインモードでドメインに移入する - Deploy Applications Tool(アプリケーション展開ツール、deployApps)オフラインまたはオンラインモードのいずれかで、既存ドメインにリソースとアプリケーションを追加する
- Discover Domain Tool(ドメイン探索ツール、discoverDomain)既存のドメインを観察し、ドメインとそのドメインにデプロイされたバイナリのアーカイブファイルを記述したモデルファイルを作成する
- Encrypt Model Tool(モデル暗号化ツール、encryptModel)ユーザーが入力したパスフレーズを使用して、モデル(またはその変数ファイル)のパスワードを暗号化する
- Validate Model Tool(モデル検証ツール、validateModel)モデル作成や編集に役立つよう、モデルのスタンドアロン検証とモデル使用情報を提供
Dockerイメージ内にWebLogic Server 12.2.1.3のドメインをプロビジョニングする方法を説明するために、GitHub WebLogic Dockerプロジェクトでサンプルを作成しました。
Example Image with a WLS DomainWebLogicドメインは、WebLogic動的クラスタ、1個のシンプルなアプリケーションがデプロイ済みで、コンテナ内で実行されるOracle Databaseに接続するデータソースで構成されます。このサンプルには、基本的なWDTモデルのsimple-topology.yamlが含まれており、このモデルにはDockerイメージ内のドメイン構成が記述されています。GitHubのWDTプロジェクトのREADMEファイルに記載の形式と規則に従って、WDTモデルをテキストエディタで作成および変更できます。また、WDTのDiscover Domain Toolを使用して既存のWebLogicドメインからモデルを作成することもできます。
https://github.com/oracle/docker-images/tree/master/OracleWebLogic/samples/12213-domain-wdt
Oracle WebLogic Server Deploy Tooling READMEドメイン作成には、アプリケーションとライブラリのデプロイメントが必要になることがありますが、これは、特定の構造を持つZIPアーカイブを作成し、モデル内でそれらのアイテムを参照することによって実現できます。このサンプルでは、小さなアプリケーションWARを含むシンプルなZIPアーカイブを作成してデプロイします。アーカイブは、Dockerイメージを作成する前にサンプルディレクトリに作成されています。
https://github.com/oracle/weblogic-deploy-tooling/blob/master/README.md
How to Build and Run
イメージはdocker-imagesリポジトリのWebLogic Server 12.2.1.3イメージをベースにしています。以下のREADMEに従って、ローカルリポジトリにWebLogic Serverインストールイメージをビルドします。Oracle WebLogic Server on Docker(訳注)
https://github.com/oracle/docker-images/tree/master/OracleWebLogic/dockerfiles/12.2.1.3
Dockerfile(https://github.com/oracle/docker-images/tree/master/OracleWebLogic/dockerfiles/<WLSのバージョン>のDockerfile.developerもしくはDockerfile.generic)の30行目でPullしているServer JREイメージを変更しないとうまく動作しない場合があります。
Docker Storeの場合WDTインストーラを使って、このサンプルのWebLogicドメインイメージをビルドします。
oracle/serverjre:8 --> store/oracle/serverjre:8Oracle Container Registryの場合
oracle/serverjre:8 --> container-registry.oracle.com/java/serverjre:8
このサンプルでは、Zipアーカイブ(archive.zip)に含まれているシンプルな1ページのWebアプリケーションをデプロイします。このアーカイブを、ドメインのDockerイメージを構築する前に作成する必要があります。
ドメインイメージを作成する前に、WDTモデル(simple-topology.yaml)も必要です。 このWebLogicドメインサンプルをカスタマイズする場合は、エディタでモデル(simple-topology.yaml)を変更するか、WDT Discover Domain Toolを使用して既存のWebLogicドメインから構成を取得できます。$ ./build-archive.sh
以下のイメージは、サンプルのWDTモデル(simple-topology.yaml)のスニペットです。ここで、データベースパスワードが暗号化され、WebLogicドメインコンテナ実行前に,提供されるプロパティファイルの値で置換されます。
このサンプルをビルドするには以下のコマンドを実行します。
ローカルリポジトリにWebLogicドメインができあがっているはずです。$ docker build \ --build-arg WDT_MODEL=simple-topology.yaml \ --build-arg WDT_ARCHIVE=archive.zip \ --force-rm=true \ -t 12213-domain-wdt .
How to Run
このサンプルでは、WebLogicドメインの各管理対象サーバにデータソースがデプロイされています。コンテナ内で実行されているOracle Databaseにデータソースを接続する必要があるため、Oracle DatabaseイメージをDocker StoreもしくはOracle Container RegistryからローカルリポジトリにPullします。WebLogic ServerとOracle Databaseのコンテナが動作するよう、Dockerネットワークを作成します。$ docker pull container-registry.oracle.com/database/enterprise:12.2.0.1
$ docker network create -d bridge SampleNET
Run the Database Container
データベースコンテナを作成するには、以下の環境ファイルを使用して、データベース名、ドメイン、および機能バンドルを設定します。以下は環境ファイル(properties/env.txt)の例です。以下のDockerコマンドを実行してデータベースコンテナを実行します。DB_SID=InfraDB DB_PDB=InfraPDB1 DB_DOMAIN=us.oracle.com DB_BUNDLE=basic
データベースが問題なく動作していることを確認します。docker psコマンドの出力にあるSTATUSフィールドに(healthy)と表示されていればOKです。$ docker run -d --name InfraDB --network=SampleNET \ -p 1521:1521 -p 5500:5500 \ --env-file /Users/mriccell/Docker/docker-images/OracleWebLogic/samples/12213-domain-wdt/properties/env.txt \ -it --shm-size="8g" \ container-registry.oracle.com/database/enterprise:12.2.0.1
データベースはデフォルトのパスワード(Oradoc_db1)で作成していますが、パスワードを変更するには、SQL*Plusを使う必要があります。SQL*Plusを実行するには、Oracle Instance ClientをOracle Container RegistryもしくはDocker StoreからPullし、以下のコマンドを使ってsqlplusコンテナを実行します。
新たなデータベースパスワード(dbpasswd)をプロパティファイル(properties/domain.properties)のDB_PASSWORDに追加して、データベースに接続できることを確認してください。$ docker run -ti --network=SampleNET --rm \ store/oracle/database-instantclient:12.2.0.1 \ sqlplus sys/Oradoc_db1@InfraDB:1521/InfraDB.us.oracle.com AS SYSDBA SQL> alter user system identified by dbpasswd container=all;
$ docker exec -ti InfraDB \ /u01/app/oracle/product/12.2.0/dbhome_1/bin/sqlplus \ system/dbpasswd@InfraDB:1521/InfraPDB1.us.oracle.com SQL> select * from Dual;
Run the WebLogic Domain
domain.properties (properties/domain.properties)ファイルを編集し、データベースのパスワードを含む、WebLogicドメイン実行に必要な全てのパラメータを設定する必要があります。コンテナ化された管理サーバを開始するには、以下のコマンドを実行します。
コンテナ化された管理対象サーバ(ms-1)を起動して上記の管理サーバに自動登録する場合、以下のコマンドを実行します。$ docker run -d --name wlsadmin --hostname wlsadmin \ --network=SampleNET -p 7001:7001 \ -v /Users/mriccell/Docker/docker-images/OracleWebLogic/samples/12213-domain-wdt/properties:/u01/oracle/properties \ 12213-domain-wdt
追加の管理対象サーバ(この例ではms-2)を起動する場合、以下のコマンドを実行します。$ docker run -d --name ms-1 --link wlsadmin:wlsadmin \ --network=SampleNET -p 9001:9001 \ -v /Users/mriccell/Docker/docker-images/OracleWebLogic/samples/12213-domain-wdt/properties:/u01/oracle/properties \ -e MS_NAME=ms-1 12213-domain-wdt startManagedServer.sh
上記のシナリオでは、単一のホスト環境に動的クラスタを設定したWebLogicドメインを作成します。サーバーが実行中で、データソースがコンテナ内で実行されているOracle Databaseに接続していることを確認しましょう。ブラウザでhttp://localhost:7001/console にアクセスしてWebLogic Server管理コンソールを起動します。このとき、domain.propertiesファイルで指定した資格情報を使用してログインします。$ docker run -d --name ms-2 --link wlsadmin:wlsadmin \ --network=SampleNET -p 9002:9001 \ -v /Users/mriccell/Docker/docker-images/OracleWebLogic/samples/12213-domain-wdt/properties:/u01/oracle/properties \ -e MS_NAME=ms-2 12213-domain-wdt startManagedServer.sh
WebLogic Deploy Toolingを使うと、WebLogicドメインのプロビジョニング、アプリケーションやアプリケーションに必要なリソースのデプロイが簡単になります。WebLogic on Docker/Kubernetesプロジェクトでは、これらのツールを利用して、イメージ内のドメインのプロビジョニングを簡素化したり、Kubernetes永続ボリュームに永続化したりしています。 我々は、KubernetesでのWebLogicドメインの管理を簡素化するWebLogic Kubernetes Operatorの一般提供しましたが、WebLogicドメインの管理機能を強化したWebLogic Kubernetes Operator ver 2.0をまもなくリリースする予定です。幅広い場所でこれらのドメインが動作可能になるよう、WebLogicドメインのプロビジョニング、デプロイ、および管理を容易にするためのツールを引き続き提供していきます。このサンプルが、WebLogic Deploy Toolingを使ってWebLogic Serverドメインのプロビジョニングとデプロイメントを行いたい全ての方々にお役に立つことを願っています。皆さんのご意見をお待ちしております。
0 件のコメント:
コメントを投稿