Azure Kubernetes Service (AKS) クラスターに WebLogic Server を使用する Java アプリケーションをデプロイする

[アーティクル]
11/05/2024

この記事では、次の方法を示します。

Oracle WebLogic Server (WLS) で Java アプリケーションを実行する。
Azure Marketplace プランを使用して AKS で WebLogic Server クラスターを立ち上げる。
WebLogic Deploy Tooling (WDT) モデルを含むアプリケーション Docker イメージをビルドする。
Microsoft Azure SQL に接続して、コンテナー化されたアプリケーションを AKS 上の WebLogic Server クラスターにデプロイする。

この記事では、WebLogic Server 向けの Azure Marketplace プランを使用して、AKS への移行を加速させます。このオファーでは、次のリソースを含む複数の Azure リソースが自動的にプロビジョニングされます。

Azure Container Registry インスタンス
AKS クラスター
Azure App Gateway イングレスコントローラー (AGIC) インスタンス
The WebLogic Kubernetes Operator
WebLogic ランタイムを含むコンテナーイメージ
アプリケーションのない WebLogic Server クラスター

次に、この記事では、WebLogic Server クラスターを更新するためのイメージのビルドについて説明します。このイメージは、アプリケーションモデルと WDT モデルを提供します。

自動化をあまり使用しない手法で AKS に WebLogic をデプロイする場合は、Azure Kubernetes Service に関する Oracle の公式ドキュメントに記載されている手順を追った詳しいガイダンスを参照してください。

フィードバックの提供や、WebLogic Server on AKS ソリューションを開発しているエンジニアリングチームと共に密接に自身の移行シナリオに取り組むことに関心がある場合は、こちらの WebLogic の移行に関する短いアンケートに記入し、連絡先情報を含めてください。プログラムマネージャー、アーキテクト、エンジニアのチームからすぐに連絡があり、緊密なコラボレーションが開始されます。

前提条件

Azure サブスクリプションをお持ちでない場合は、開始する前に Azure 無料アカウントを作成してください。
サインインしてこの記事を完了するために使用する Azure ID に、現在のサブスクリプションの所有者ロールか、現在のサブスクリプションの共同作成者ロールとユーザーアクセス管理者ロールがあることを確認します。 Azure ロールの概要については、「Azure ロールベースのアクセス制御 (Azure RBAC) とは」を参照してください。AKS 上の WLS で必要な特定のロールの詳細については、「Azure 組み込みロール」を参照してください。
Oracle シングルサインオン (SSO) アカウントの資格情報を持っている。作成するには、Oracle アカウントの作成ページを参照してください。
WebLogic Server のライセンス条項に同意します。
- Oracle Container Registry にアクセスしてサインインします。
- サポートエンタイトルメントをお持ちの場合は、[ミドルウェア] を選択してから、weblogic_cpu を検索して選択します。
- Oracle のサポートエンタイトルメントを持っていない場合は、[ミドルウェア] を選択してから、weblogic を検索して選択します。
- 使用許諾契約書に同意します。
Note

運用環境に移行する前に、Oracle からサポートエンタイトルメントを取得してください。これを行わないと、セキュリティ上のクリティカルな欠陥に対してパッチが適用されていない安全でないイメージを実行することになります。 Oracle のクリティカルなパッチ更新プログラムの詳細については、Oracle の「Critical Patch Updates, Security Alerts and Bulletins」(クリティカルパッチ更新プログラム、セキュリティアラートおよび掲示板) を参照してください。
Unix のようなオペレーティングシステム (Ubuntu、Azure Linux、macOS、Linux 用 Windows サブシステムなど) がインストールされているローカルマシンを準備します。
- Azure CLI。 az --version を使用して、az が機能するかどうかをテストします。このドキュメントは、バージョン 2.55.1 でテストされました。
- kubectl。 kubectl version を使用して、kubectl が機能するかどうかをテストします。このドキュメントは、バージョン v1.21.2 でテストされました。
- A Java Development Kit (JDK)。この記事では、Microsoft Build of OpenJDK 11 のインストール方法について説明しています。コマンドを実行するシェルで JAVA_HOME 環境変数が正しく設定されていることを確認します。
- Maven 3.5.0 以降。
- zip/ファイル解凍ユーティリティがインストールされていることを確認します。 zip/unzip -v を使用して zip/unzip が正常に機能するかをテストします。

このセクションでは、マネージド ID 接続が有効な Microsoft Entra 認証を使用して Azure SQL Database を作成します。

リソースグループを作成する

az group create を使用して、リソースグループを作成します。リソースグループはサブスクリプション内で一意である必要があるため、一意の名前を選択します。一意の名前を付ける簡単な方法は、自分の名前のイニシャル、今日の日付、何らかの識別子を組み合わせて使用することです。たとえば、abc1228rg のようにします。この例では、 eastus の場所に abc1228rg という名前のリソースグループを作成します。

export RESOURCE_GROUP_NAME="abc1228rg"
az group create \
    --name ${RESOURCE_GROUP_NAME} \
    --location eastus

データベースサーバーとデータベースの作成

az sql server create コマンドを使用してサーバーを作成します。この例では、管理者ユーザー azureuser と管理者パスワードを使用して、myazuresql20130213 という名前のサーバーを作成します。 <your-password> を、ご利用のパスワードに置き換えます。詳しくは、「クイックスタート: 単一データベースを作成する - Azure SQL Database」をご覧ください。

Note

ここでユーザー名とパスワードを使用している場合でも、これらの資格情報はデータベースの外部には公開されません。アプリケーション層とデータベース間の接続は、マネージド ID で保護されています。

export AZURESQL_SERVER_NAME="myazuresql20130213"
export AZURESQL_ADMIN_USER="azureuser"
export AZURESQL_ADMIN_PASSWORD="<your-password>"
export DATABASE_NAME="mysingledatabase20230213"

az sql server create \
    --resource-group $RESOURCE_GROUP_NAME \
    --name $AZURESQL_SERVER_NAME \
    --location westus \
    --admin-user $AZURESQL_ADMIN_USER \
    --admin-password $AZURESQL_ADMIN_PASSWORD

az sql db create コマンドでサーバーレスコンピューティングレベルにデータベースを作成します。

az sql db create \
    --resource-group $RESOURCE_GROUP_NAME \
    --server $AZURESQL_SERVER_NAME \
    --name $DATABASE_NAME \
    --sample-name AdventureWorksLT \
    --edition GeneralPurpose \
    --compute-model Serverless \
    --family Gen5 \
    --capacity 2

Microsoft Entra 管理者を構成する

Azure SQL Server がマネージド ID を使用する方法については、Microsoft Entra 認証を使用した接続に関するページをご覧ください。

Azure portal から Azure SQL Server への Microsoft Entra 管理者アカウントを構成するには、次の手順に従います。

Azure portal で、Azure SQL Server インスタンス myazuresql20130213 を開きます。
[設定] を選択し、[Microsoft Entra ID] を選択します。 Microsoft Entra ID ページで、[管理者の設定] を選択します。
管理者の追加ページで、ユーザーを検索し、管理者にするユーザーまたはグループを選択してから [選択] を選択します。
Microsoft Entra ID ページの上部にある [保存] を選択します。 Microsoft Entra ユーザーとグループの場合は、管理者名の横にオブジェクト IDが表示されます。
管理者を変更する処理には数分かかる場合があります。その後、新しい管理者が [Microsoft Entra ID] ボックスに表示されます。

ユーザー割り当てマネージド ID を作成する

次に、Azure CLI で az identity create コマンドを使って、サブスクリプションの ID を作成します。このマネージド ID を使って、データベースに接続します。

az identity create \
    --resource-group ${RESOURCE_GROUP_NAME} \
    --name myManagedIdentity

マネージド ID のデータベースユーザーの作成

ここでは、Microsoft Entra 管理者ユーザーとして Azure portal から Azure SQL データベースに接続し、マネージド ID のユーザーを作成します。

まず、次の手順に示すように、ポータルから Azure SQL Server にアクセスするためのファイアウォール規則を作成します。

Azure portal で、Azure SQL Server インスタンス myazuresql20130213 を開きます。
[セキュリティ] を選択し、[ネットワーク] を選択します。
[ファイアウォール規則] で [クライアント IPV4 IP アドレスの追加] を選択します。
[例外] で、[Azure サービスおよびリソースにこのサーバーへのアクセスを許可する] をオンにします。
[保存] を選択します。

ファイアウォール規則が作成されると、ポータルから Azure SQL Server にアクセスできます。次の手順に従って、データベースユーザーを作成します。

[設定] を選択し、[SQL データベース] を選択します。 [mysingledatabase20230213] を選択します。
[クエリエディター] を選択します。 SQL Database クエリエディターへようこそページの [Active Directory 認証] で、Logged in as user@contoso.com のようなメッセージを見つけます。
[user@contoso.com として続行] を選択します。ここで、user は AD 管理者アカウント名です。

サインインしたら、[クエリ 1] エディターで以下のコマンドを実行して、マネージド ID myManagedIdentity 用のデータベースユーザーを作成します。

CREATE USER "myManagedIdentity" FROM EXTERNAL PROVIDER
ALTER ROLE db_datareader ADD MEMBER "myManagedIdentity";
ALTER ROLE db_datawriter ADD MEMBER "myManagedIdentity";
ALTER ROLE db_ddladmin ADD MEMBER "myManagedIdentity";
GO

[クエリ 1] エディターで、[実行] を選択して SQL コマンドを実行します。
コマンドが正常に完了すると、Query succeeded: Affected rows: 0 というメッセージが表示されます。

以下のコマンドを使用して、次のセクションで使用する接続文字列を取得します。

export CONNECTION_STRING="jdbc:sqlserver://${AZURESQL_SERVER_NAME}.database.windows.net:1433;database=${DATABASE_NAME};encrypt=true;trustServerCertificate=false;hostNameInCertificate=*.database.windows.net;loginTimeout=30;"
echo ${CONNECTION_STRING}

アプリで使用する Azure SQL Database の単一データベースを作成するには、「クイックスタート: Azure SQL Database で単一データベースを作成する」の手順に従います。以下の相違点に特に注意してください。

[基本] の手順の [リソースグループ]、[データベース名]、<サーバー名>.database.windows.net、[サーバー管理者ログイン]、[パスワード] の値をメモします。この記事では、データベース リソースグループ値を <db-resource-group> とします。
[ネットワーク] の手順の [接続方法] を [パブリックエンドポイント] に、[Azure サービスおよびリソースにこのサーバーへのアクセスを許可する] を [はい] に、[現在のクライアント IP アドレスを追加する] を [はい] に設定します。

Note

このデータベースに対して選んだサーバーレスコンピューティングレベルでは、非アクティブな期間中にデータベースをスリープ状態にすることでコストを節約できます。アプリの起動時にデータベースがスリープ状態になると、サンプルアプリは失敗します。

データベースを強制的にウェイクアップするには、クエリエディターを使用してクエリを実行します。データベースのクエリに関する記事の手順に従います。クエリの例を次に示します: SELECT * FROM COFFEE;。

「クイックスタート: 単一データベースを作成する - Azure SQL Database」の「データベースのクエリを実行する」セクションの手順に従って [クエリエディター] ペインを開きます。

サンプルアプリケーションのスキーマを作成する

[新しいクエリ] を選択し、クエリエディターで次のクエリを実行します。

CREATE TABLE COFFEE (ID NUMERIC(19) NOT NULL, NAME VARCHAR(255) NULL, PRICE FLOAT(32) NULL, PRIMARY KEY (ID));
CREATE TABLE SEQUENCE (SEQ_NAME VARCHAR(50) NOT NULL, SEQ_COUNT NUMERIC(28) NULL, PRIMARY KEY (SEQ_NAME));
INSERT INTO SEQUENCE VALUES ('SEQ_GEN',0);

正常に実行されると、"クエリが成功しました: 影響を受ける行: 1" というメッセージが表示されます。このメッセージが表示されない場合は、先に進む前に問題のトラブルシューティングと解決を行ってください。

AKS プランへの WLS のデプロイに進むことができます。

WebLogic Server on AKS をデプロイする

次の手順に従って、WebLogic Server on AKS プランを見つけて、[基本] ペインに入力します。

Azure portal の上部にある検索バーに「weblogic」と入力します。自動提案された検索結果の [Marketplace] セクションにある [WebLogic Server on AKS] を選びます。

WebLogic Server on AKS に直接アクセスすることもできます。
オファーページで、[作成] を選択します。
[基本] ペインで、[サブスクリプション] フィールドに表示される値が Azure へのサインインに使用したものと同じであることを確認します。サブスクリプションについて、前提条件セクションに記載されているロールを持っていることを確認します。
このオファーを空のリソースグループにデプロイする必要があります。 [リソースグループ] フィールドで、[新規作成] を選択し、リソースグループの値を入力します。リソースグループはサブスクリプション内で一意である必要があるため、一意の名前を選択します。一意の名前を付ける簡単な方法は、自分の名前のイニシャル、今日の日付、何らかの識別子を組み合わせて使用することです (ejb0723wls など)。
[インスタンスの詳細] で、デプロイのリージョンを選択します。 AKS が利用可能な Azure リージョンの一覧については、AKS リージョンの可用性に関するページを参照してください。
[WebLogic の資格情報] の [WebLogic 管理者のユーザー名] は、既定値のままにします。
[WebLogic 管理者のパスワード] には「wlsAksCluster2022」を入力します。同じ値を、確認フィールドと [WebLogic モデルの暗号化のパスワード] フィールドに使用します。
[次へ] を選択します。

次の手順に従って、デプロイプロセスを開始します。

[Provide an Oracle Single Sign-On (SSO) account](Oracle シングルサインオン (SSO) アカウントの指定) というラベルが付いたセクションまでスクロールします。前提条件から Oracle SSO 資格情報を入力します。
情報ボックスの "先に進む前に、Oracle 標準の使用条件と制限に同意する必要があります" から始まる手順に従います。
Oracle SSO アカウントに Oracle サポート資格があるかどうかに応じて、[WebLogic Server イメージの種類の選択] で適切なオプションを選択します。アカウントにサポート資格がある場合は、[パッチ適用済みの WebLogic Server イメージ] を選択します。それ以外の場合は、[一般的な WebLogic Server イメージ] を選択します。
[WebLogic Server の目的の組み合わせを選択...] の値は既定値のままにします。 WebLogic Server、JDK、OS のバージョンには幅広い選択肢があります。
[アプリケーション] セクションの [アプリケーションをデプロイしますか?] の横にある [いいえ] を選択します。

次の手順では、WebLogic Server 管理コンソールとサンプルアプリが組み込みの Application Gateway イングレスアドオンを使用してパブリックインターネットに公開されるようにします。詳細については、「Application Gateway イングレスコントローラーとは」をご覧ください。

[次へ] を選択して、[TLS/SSL]ペインを選択します。
[次へ] を選択すると、[負荷分散] ペインが表示されます。
[負荷分散のオプション] の横にある [Application Gateway イングレスコントローラー] を選択します。
[Application Gateway イングレスコントローラー] で、すべてのフィールドが事前に設定され、[仮想ネットワーク] と [サブネット] には既定値が設定されているのが表示されます。既定値のままにします。
[管理コンソールのイングレスを作成する] には [はい] を選択します。
[次へ] を選択して、[DNS] ペインを表示します。
[次へ] を選択して、[データベース] ペインを表示します。

パスワードレス (推奨)
パスワード

マネージド ID を使用してデータベース接続を構成するには、次の手順に従います。

[データベースに接続しますか?] で [はい] を選択します。
[接続設定] の [データベースの種類の選択] でドロップダウンメニューを開き、[Microsoft SQL Server (パスワードレス接続をサポート)] を選択します。
[JNDI 名] には、jdbc/WebLogicCafeDB と入力します。
[DataSource 接続文字列] に、前回のセクションで取得した接続文字列を入力します。
[パスワードレスデータソース接続を使用する] を選択します。
[ユーザーが割り当てたマネージド ID] で、前の手順で作成したマネージド ID を選択します。この例では、その名前は myManagedIdentity です。
[追加] を選択します。

[接続設定] セクションは、次のスクリーンショットのようになります。

次の手順に従って、デプロイを完了します。

[Review + create](レビュー + 作成) を選択します。検証が失敗しないことを確認します。失敗した場合は、検証の問題を修正してから、[確認および作成] をもう一度選択します。
［作成］ を選択します
[デプロイが進行中です] ページで、デプロイの進行状況を追跡します。

選択したリージョンのネットワーク条件やその他のアクティビティによっては、デプロイが完了するまでに最大 50 分かかる場合があります。

Note

組織がパブリック IP を許可しない企業の仮想ネットワーク内にワークロードをデプロイする必要がある場合は、内部 Load Balancer サービスを選択できます。内部 Load Balancer サービスを構成するには、[負荷分散] タブで次の手順を使用します。

[負荷分散オプション] の横にある [Standard Load Balancer サービス] を選択します。
[内部 Load Balancer を使用] を選択します。
テーブルに次の行を追加します:

サービス名プレフィックス移行先 Port

wls-admin-internal admin-server 7001

wls-cluster-internal cluster-1 8001

サービス名プレフィックス	移行先	Port
`wls-admin-internal`	`admin-server`	7001
`wls-cluster-internal`	`cluster-1`	8001

[負荷分散] タブは、次のスクリーンショットのようになります。

デプロイ後、出力から adminConsoleExternalUrl と clusterExternalUrl というラベルの付いた管理サーバーとクラスターのアクセス URL 見つけることができます。

デプロイの出力を調べる

このセクションの手順を使用して、デプロイが正常に完了したことを確認します。

[デプロイが進行中です] ページから移動した場合は、次の手順でそのページに戻る方法について説明します。 "デプロイが完了しました" と表示されたページのままの場合は、次のスクリーンショットの後の手順 5 にスキップできます。

Azure portal ページの隅にあるハンバーガーメニューを選択し、[リソースグループ] を選択します。
[任意のフィールドのフィルター] というテキストが表示されているボックスに、前に作成したリソースグループの最初の数文字を入力します。推奨される方法に従った場合は、名前のイニシャルを入力してから、適切なリソースグループを選択します。
ナビゲーションウィンドウの [設定] セクションで、[デプロイ] を選択します。このリソースグループへのデプロイの順序指定済みリストが表示され、最新のデプロイが最初に表示されます。
このリストの一番古いエントリまでスクロールします。このエントリは、前のセクションで開始したデプロイに対応します。次のスクリーンショットに示すように、一番古いデプロイを選択します。
ナビゲーションウィンドウで、[出力] を選択します。このリストには、そのデプロイの出力値が表示されます。出力には有用な情報が含まれています。
adminConsoleExternalUrl 値は、この AKS クラスターの WebLogic Server 管理コンソールへの完全修飾パブリックインターネット表示リンクです。このフィールド値の横にあるコピーアイコンを選択して、クリップボードにリンクをコピーします。この値は、後で使用するために保存しておきます。
clusterExternalUrl 値は、この AKS クラスター上の WebLogic Server にデプロイされたサンプルアプリへの完全修飾パブリックインターネット表示リンクです。このフィールド値の横にあるコピーアイコンを選択して、クリップボードにリンクをコピーします。この値は、後で使用するために保存しておきます。
shellCmdtoOutputWlsImageModelYaml 値は、コンテナーイメージのビルドに使用される WDT モデルの base64 文字列です。この値は、後で使用するために保存しておきます。
shellCmdtoOutputWlsImageProperties 値は、コンテナーイメージのビルドに使用される WDT モデルプロパティの base64 文字列です。この値は、後で使用するために保存しておきます。
shellCmdtoConnectAks 値は、この特定の AKS クラスターに接続するための Azure CLI コマンドです。

出力に含まれるその他の値についてはこの記事の対象外ですが、AKS 上の WebLogic に関するユーザーガイドで詳しく説明されています。

サンプルアプリケーションを構成してデプロイする

このプランでは、イメージ内のモデルを使用して WebLogic Server クラスターをプロビジョニングします。現在、WebLogic Server クラスターにはアプリケーションがデプロイされていません。

このセクションでは、補助イメージを使用してサンプルアプリケーションをデプロイすることで、WebLogic Server クラスターを更新します。

アプリケーションをチェックアウトする

このセクションでは、このガイドのサンプルコードをクローンします。サンプルは、GitHub の javaee/weblogic-cafe/ フォルダーにある weblogic-on-azure リポジトリにあります。アプリケーションのファイル構造を次に示します。

weblogic-cafe
├── pom.xml
└── src
    └── main
        ├── java
        │   └── cafe
        │       ├── model
        │       │   ├── CafeRepository.java
        │       │   └── entity
        │       │       └── Coffee.java
        │       └── web
        │           ├── rest
        │           │   └── CafeResource.java
        │           └── view
        │               └── Cafe.java
        ├── resources
        │   ├── META-INF
        │   │   └── persistence.xml
        │   └── cafe
        │       └── web
        │           ├── messages.properties
        │           └── messages_es.properties
        └── webapp
            ├── WEB-INF
            │   ├── beans.xml
            │   ├── faces-config.xml
            │   └── web.xml
            ├── index.xhtml
            └── resources
                └── components
                    └── inputPrice.xhtml

次のコマンドを使用して、リポジトリをクローンします。

# cd <parent-directory-to-check-out-sample-code>
export BASE_DIR=$PWD

git clone --single-branch https://github.com/microsoft/weblogic-on-azure.git --branch 20240201 $BASE_DIR/weblogic-on-azure

HEAD がデタッチされた状態であることを示すメッセージが表示された場合、このメッセージは無視しても問題ありません。これは、タグをチェックアウトしたという意味です。

次のコマンドを使用して、javaee/weblogic-cafe/ をビルドします。

mvn clean package --file $BASE_DIR/weblogic-on-azure/javaee/weblogic-cafe/pom.xml

パッケージは正常に生成され、$BASE_DIR/weblogic-on-azure/javaee/weblogic-cafe/target/weblogic-cafe.war にあります。パッケージが表示されない場合は、続行する前に問題のトラブルシューティングと解決を行う必要があります。

Azure Container Registry を使用して補助イメージを作成する

このセクションの手順では、補助イメージをビルドする方法について説明します。このイメージには、次のコンポーネントが含まれます。

"イメージ内のモデル" モデルファイル
アプリケーション
Java Database Connectivity (JDBC) ドライバーアーカイブファイル
WebLogic Deploy Tooling のインストール

補助イメージは、アプリと構成を含む Docker コンテナーイメージです。 WebLogic Kubernetes Operator は、補助イメージを、WebLogic Server、JDK、オペレーティングシステムを含む AKS クラスター内の domain.spec.image と結合させます。補助イメージの詳細については、Oracle ドキュメントの「補助イメージ」をご覧ください。

このセクションでは、Azure CLI と kubectl がインストールされた Linux ターミナルが必要です。

次の手順に従って、イメージをビルドします。

次のコマンドを使用して、モデルとアプリケーションをステージングするディレクトリを作成します。
```
mkdir -p ${BASE_DIR}/mystaging/models
cd ${BASE_DIR}/mystaging/models
```

デプロイ出力から保存した shellCmdtoOutputWlsImageModelYaml 値をコピーして Bash ウィンドウに貼り付け、コマンドを実行します。コマンドは次の例のようになります。

echo -e IyBDb3B5cmlna...Cgo= | base64 -d > model.yaml

このコマンドにより、次の例のような内容の ${BASE_DIR}/mystaging/models/model.yaml ファイルが生成されます。

# Copyright (c) 2020, 2021, Oracle and/or its affiliates.
# Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl.

# Based on ./kubernetes/samples/scripts/create-weblogic-domain/model-in-image/model-images/model-in-image__WLS-v1/model.10.yaml
# in https://github.com/oracle/weblogic-kubernetes-operator.

domainInfo:
  AdminUserName: "@@SECRET:__weblogic-credentials__:username@@"
  AdminPassword: "@@SECRET:__weblogic-credentials__:password@@"
  ServerStartMode: "prod"

topology:
  Name: "@@ENV:CUSTOM_DOMAIN_NAME@@"
  ProductionModeEnabled: true
  AdminServerName: "admin-server"
  Cluster:
    "cluster-1":
      DynamicServers:
        ServerTemplate: "cluster-1-template"
        ServerNamePrefix: "@@ENV:MANAGED_SERVER_PREFIX@@"
        DynamicClusterSize: "@@PROP:CLUSTER_SIZE@@"
        MaxDynamicClusterSize: "@@PROP:CLUSTER_SIZE@@"
        MinDynamicClusterSize: "0"
        CalculatedListenPorts: false
  Server:
    "admin-server":
      ListenPort: 7001
  ServerTemplate:
    "cluster-1-template":
      Cluster: "cluster-1"
      ListenPort: 8001
  SecurityConfiguration:
    NodeManagerUsername: "@@SECRET:__weblogic-credentials__:username@@"
    NodeManagerPasswordEncrypted: "@@SECRET:__weblogic-credentials__:password@@"

resources:
  SelfTuning:
    MinThreadsConstraint:
      SampleMinThreads:
        Target: "cluster-1"
        Count: 1
    MaxThreadsConstraint:
      SampleMaxThreads:
        Target: "cluster-1"
        Count: 10
    WorkManager:
      SampleWM:
        Target: "cluster-1"
        MinThreadsConstraint: "SampleMinThreads"
        MaxThreadsConstraint: "SampleMaxThreads"

同様に、shellCmdtoOutputWlsImageProperties 値をコピーして Bash ウィンドウに貼り付け、コマンドを実行します。コマンドは次の例のようになります。

echo -e IyBDb3B5cml...pFPTUK | base64 -d > model.properties

このコマンドにより、次の例のような内容の ${BASE_DIR}/mystaging/models/model.properties ファイルが生成されます。

# Copyright (c) 2021, Oracle Corporation and/or its affiliates.
# Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl.

# Based on ./kubernetes/samples/scripts/create-weblogic-domain/model-in-image/model-images/model-in-image__WLS-v1/model.10.properties
# in https://github.com/oracle/weblogic-kubernetes-operator.

CLUSTER_SIZE=5

次の手順に従って、アプリケーションモデルを作成します。
1. 次のコマンドを使用して weblogic-cafe.war をコピーし、wlsdeploy/applications に保存します。
```
mkdir -p ${BASE_DIR}/mystaging/models/wlsdeploy/applications
cp $BASE_DIR/weblogic-on-azure/javaee/weblogic-cafe/target/weblogic-cafe.war ${BASE_DIR}/mystaging/models/wlsdeploy/applications/weblogic-cafe.war
```
2. 次のコマンドを使用して、示されている内容を含むアプリケーションモデルを作成します。モデルファイルを ${BASE_DIR}/mystaging/models/appmodel.yaml に保存します。
```
cat <<EOF >appmodel.yaml
appDeployments:
  Application:
    weblogic-cafe:
      SourcePath: 'wlsdeploy/applications/weblogic-cafe.war'
      ModuleType: ear
      Target: 'cluster-1'
EOF
```

次の手順に従って、データソース接続を構成します。

パスワードレス (推奨)
パスワード

次の手順に従って、Azure マネージド ID を使用してデータベース接続を有効にする Microsoft SQL Server JDBC ドライバーと Azure Identity Extension をダウンロードしてインストールします。

次のコマンドを使用して、Microsoft SQL Server JDBC ドライバーを wlsdeploy/externalJDBCLibraries にダウンロードし、インストールします。

export DRIVER_VERSION="10.2.1.jre8"
export MSSQL_DRIVER_URL="https://repo.maven.apache.org/maven2/com/microsoft/sqlserver/mssql-jdbc/${DRIVER_VERSION}/mssql-jdbc-${DRIVER_VERSION}.jar"

mkdir ${BASE_DIR}/mystaging/models/wlsdeploy/externalJDBCLibraries
curl -m 120 -fL ${MSSQL_DRIVER_URL} -o ${BASE_DIR}/mystaging/models/wlsdeploy/externalJDBCLibraries/mssql-jdbc-${DRIVER_VERSION}.jar

次のコマンドを使用して、Azure ID 拡張機能を wlsdeploy/classpathLibraries にインストールします。

curl -LO https://github.com/oracle/weblogic-azure/raw/refs/heads/main/weblogic-azure-aks/src/main/resources/azure-identity-extensions.xml

mvn dependency:copy-dependencies -f azure-identity-extensions.xml

mkdir -p ${BASE_DIR}/mystaging/models/wlsdeploy/classpathLibraries/azureLibraries
mkdir ${BASE_DIR}/mystaging/models/wlsdeploy/classpathLibraries/jackson
# fix JARs conflict issue in GA images, put jackson libraries to PRE_CLASSPATH to upgrade the existing libs.
mv target/dependency/jackson-annotations-*.jar ${BASE_DIR}/mystaging/models/wlsdeploy/classpathLibraries/jackson/
mv target/dependency/jackson-core-*.jar ${BASE_DIR}/mystaging/models/wlsdeploy/classpathLibraries/jackson/
mv target/dependency/jackson-databind-*.jar ${BASE_DIR}/mystaging/models/wlsdeploy/classpathLibraries/jackson/
mv target/dependency/jackson-dataformat-xml-*.jar ${BASE_DIR}/mystaging/models/wlsdeploy/classpathLibraries/jackson/
# Thoes jars will be appended to CLASSPATH
mv target/dependency/*.jar ${BASE_DIR}/mystaging/models/wlsdeploy/classpathLibraries/azureLibraries/

リソースをクリーンアップするには、次のコマンドを使用します。
```
rm target -f -r
rm azure-identity-extensions.xml
```

AKS クラスターに接続します。これを行うには、前に保存した shellCmdtoConnectAks 値をコピーして Bash ウィンドウに貼り付け、コマンドを実行します。コマンドは次の例のようになります。
```
az account set --subscription <subscription>;
az aks get-credentials \
    --resource-group <resource-group> \
    --name <name>
```
次の例のような出力が表示されます。この出力が表示されない場合は、続行する前にトラブルシューティングを行って問題を解決してください。
```
Merged "<name>" as current context in /Users/<username>/.kube/config
```

データベース接続モデルをエクスポートし、${BASE_DIR}/mystaging/models/dbmodel.yaml に保存します。次の手順では、ConfigMap sample-domain1-wdt-config-map からデータベース構成モデルを抽出します。名前は形式 <domain-uid>-wdt-config-map に従います。プランのデプロイ中に <domain-uid> が設定されます。既定値を変更した場合は、独自のドメイン UID に置き換えてください。

データキーは <db-secret-name>.yaml です。次のコマンドを使用して、データベースシークレット名を取得します。

export WLS_DOMAIN_UID=sample-domain1
export WLS_DOMAIN_NS=${WLS_DOMAIN_UID}-ns
export DB_K8S_SECRET_NAME=$(kubectl get secret -n ${WLS_DOMAIN_NS} | grep "ds-secret" | awk '{print $1}')

次に、このコマンドを使用してデータベースモデルを抽出します。

kubectl get configmap sample-domain1-wdt-config-map -n ${WLS_DOMAIN_NS} -o=jsonpath="{['data']['${DB_K8S_SECRET_NAME}\.yaml']}" >${BASE_DIR}/mystaging/models/dbmodel.yaml

最後に、次のコマンドを使用して、dbmodel.yaml の内容を確認します。

cat ${BASE_DIR}/mystaging/models/dbmodel.yaml

このコマンドの出力は、次のような構造になります。

# Copyright (c) 2020, 2021, Oracle and/or its affiliates.
# Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl.

resources:
  JDBCSystemResource:
    jdbc/WebLogicCafeDB:
      Target: 'cluster-1'
      JdbcResource:
      JDBCDataSourceParams:
         JNDIName: [
            jdbc/WebLogicCafeDB
         ]
         GlobalTransactionsProtocol: OnePhaseCommit
      JDBCDriverParams:
         DriverName: com.microsoft.sqlserver.jdbc.SQLServerDriver
         URL: '@@SECRET:ds-secret-sqlserver-1727147748:url@@'
         PasswordEncrypted: '@@SECRET:ds-secret-sqlserver-1727147748:password@@'
         Properties:
            user:
            Value: '@@SECRET:ds-secret-sqlserver-1727147748:user@@'
      JDBCConnectionPoolParams:
            TestTableName: SQL SELECT 1
            TestConnectionsOnReserve: true

次のコマンドを使用して、Microsoft SQL Server JDBC ドライバーを wlsdeploy/externalJDBCLibraries にダウンロードし、インストールします。

export DRIVER_VERSION="10.2.1.jre8"
export MSSQL_DRIVER_URL="https://repo.maven.apache.org/maven2/com/microsoft/sqlserver/mssql-jdbc/${DRIVER_VERSION}/mssql-jdbc-${DRIVER_VERSION}.jar"

mkdir ${BASE_DIR}/mystaging/models/wlsdeploy/externalJDBCLibraries
curl -m 120 -fL ${MSSQL_DRIVER_URL} -o ${BASE_DIR}/mystaging/models/wlsdeploy/externalJDBCLibraries/mssql-jdbc-${DRIVER_VERSION}.jar

次に、次のコマンドを使用して、示されている内容を含むデータベース接続モデルを作成します。モデルファイルを ${BASE_DIR}/mystaging/models/dbmodel.yaml に保存します。このモデルでは、データベースのユーザー名、パスワード、URL にプレースホルダーシークレット sqlserver-secret を使用しています。次のフィールドが正しく設定されていることを確認します。次のモデルでは、リソースに jdbc/WebLogicCafeDB という名前を付けます。

Item Name	フィールド	値
JNDI 名	`resources.JDBCSystemResource.<resource-name>.JdbcResource.JDBCDataSourceParams.JNDIName`	`jdbc/WebLogicCafeDB`
ドライバー名	`resources.JDBCSystemResource.<resource-name>.JDBCDriverParams.DriverName`	`com.microsoft.sqlserver.jdbc.SQLServerDriver`
データベース URL	`resources.JDBCSystemResource.<resource-name>.JDBCDriverParams.URL`	`@@SECRET:sqlserver-secret:url@@`
データベースパスワード	`resources.JDBCSystemResource.<resource-name>.JDBCDriverParams.PasswordEncrypted`	`@@SECRET:sqlserver-secret:password@@`
データベースユーザー名	`resources.JDBCSystemResource.<resource-name>.JDBCDriverParams.Properties.user.Value`	`'@@SECRET:sqlserver-secret:user@@'`

cat <<EOF >dbmodel.yaml
resources:
  JDBCSystemResource:
    jdbc/WebLogicCafeDB:
      Target: 'cluster-1'
      JdbcResource:
        JDBCDataSourceParams:
          JNDIName: [
            jdbc/WebLogicCafeDB
          ]
          GlobalTransactionsProtocol: None
        JDBCDriverParams:
          DriverName: com.microsoft.sqlserver.jdbc.SQLServerDriver
          URL: '@@SECRET:sqlserver-secret:url@@'
          PasswordEncrypted: '@@SECRET:sqlserver-secret:password@@'
          Properties:
            user:
              Value: '@@SECRET:sqlserver-secret:user@@'
        JDBCConnectionPoolParams:
          TestTableName: SQL SELECT 1
          TestConnectionsOnReserve: true
EOF

次のコマンドを使用して、アーカイブファイルを作成し、その後、不要になった wlsdeploy フォルダーを削除します。
```
cd ${BASE_DIR}/mystaging/models
zip -r archive.zip wlsdeploy

rm -f -r wlsdeploy
```
次のコマンドを使用して、ステージングディレクトリに WebLogic Deploy Tooling (WDT) をダウンロードしてインストールし、UNIX 環境で使用されていない weblogic-deploy/bin/*.cmd ファイルを削除します。
```
cd ${BASE_DIR}/mystaging
curl -m 120 -fL https://github.com/oracle/weblogic-deploy-tooling/releases/latest/download/weblogic-deploy.zip -o weblogic-deploy.zip

unzip weblogic-deploy.zip -d .
rm ./weblogic-deploy/bin/*.cmd
```
WDT インストーラーをクリーンアップするには、次のコマンドを使用します。
```
rm weblogic-deploy.zip
```

Docker ファイルを作成するには、次のコマンドを使用します。

cd ${BASE_DIR}/mystaging
cat <<EOF >Dockerfile
FROM busybox
ARG AUXILIARY_IMAGE_PATH=/auxiliary
ARG USER=oracle
ARG USERID=1000
ARG GROUP=root
ENV AUXILIARY_IMAGE_PATH=\${AUXILIARY_IMAGE_PATH}
RUN adduser -D -u \${USERID} -G \$GROUP \$USER
COPY --chown=\$USER:\$GROUP ./ \${AUXILIARY_IMAGE_PATH}/
USER \$USER
EOF

次の例に示すように、${BASE_DIR}/mystaging/Dockerfile を使用して az acr build コマンドを実行します。
```
export ACR_NAME=<value-from-clipboard>
export IMAGE="wlsaks-auxiliary-image:1.0"
```

ステージングファイルを再確認するには、次のコマンドを使用します。

cd ${BASE_DIR}/mystaging
find -maxdepth 2 -type f -print

これらのコマンドは、次の例のような出力を生成します。

./models/model.properties
./models/model.yaml
./models/appmodel.yaml
./models/dbmodel.yaml
./models/archive.zip
./Dockerfile
./weblogic-deploy/VERSION.txt
./weblogic-deploy/LICENSE.txt

次の例に示すように、az acr build を使用してイメージをビルドします。

az acr build -t ${IMAGE} --build-arg AUXILIARY_IMAGE_PATH=/auxiliary -r ${ACR_NAME} --platform linux/amd64 .

イメージを正常にビルドすると、出力は次の例のようになります。

...
Step 1/9 : FROM busybox
latest: Pulling from library/busybox
Digest: sha256:9ae97d36d26566ff84e8893c64a6dc4fe8ca6d1144bf5b87b2b85a32def253c7
Status: Image is up to date for busybox:latest
---> 65ad0d468eb1
Step 2/9 : ARG AUXILIARY_IMAGE_PATH=/auxiliary
---> Running in 1f8f4e82ccb6
Removing intermediate container 1f8f4e82ccb6
---> 947fde618be9
Step 3/9 : ARG USER=oracle
---> Running in dda021591e41
Removing intermediate container dda021591e41
---> f43d84be4517
Step 4/9 : ARG USERID=1000
---> Running in cac4df6dfd13
Removing intermediate container cac4df6dfd13
---> e5513f426c74
Step 5/9 : ARG GROUP=root
---> Running in 8fec1763270c
Removing intermediate container 8fec1763270c
---> 9ef233dbe279
Step 6/9 : ENV AUXILIARY_IMAGE_PATH=${AUXILIARY_IMAGE_PATH}
---> Running in b7754f58157a
Removing intermediate container b7754f58157a
---> 4a26a97eb572
Step 7/9 : RUN adduser -D -u ${USERID} -G $GROUP $USER
---> Running in b6c1f1a81af1
Removing intermediate container b6c1f1a81af1
---> 97d3e5ad7540
Step 8/9 : COPY --chown=$USER:$GROUP ./ ${AUXILIARY_IMAGE_PATH}/
---> 21088171876f
Step 9/9 : USER $USER
---> Running in 825e0abc9f6a
Removing intermediate container 825e0abc9f6a
---> b81d6430fcda
Successfully built b81d6430fcda
Successfully tagged wlsaksacru6jyly7kztoqu.azurecr.io/wlsaks-auxiliary-image:1.0
2024/08/28 03:06:19 Successfully executed container: build
2024/08/28 03:06:19 Executing step ID: push. Timeout(sec): 3600, Working directory: '', Network: ''
2024/08/28 03:06:19 Pushing image: wlsaksacru6jyly7kztoqu.azurecr.io/wlsaks-auxiliary-image:1.0, attempt 1
The push refers to repository [wlsaksacru6jyly7kztoqu.azurecr.io/wlsaks-auxiliary-image]
ee589b3cda86: Preparing
c1fd1adab3b9: Preparing
d51af96cf93e: Preparing
c1fd1adab3b9: Pushed
d51af96cf93e: Pushed
ee589b3cda86: Pushed
1.0: digest: sha256:c813eb75576eb07a179c3cb4e70106ca7dd280f933ab33a2f6858de673b12eac size: 946
2024/08/28 03:06:21 Successfully pushed image: wlsaksacru6jyly7kztoqu.azurecr.io/wlsaks-auxiliary-image:1.0
2024/08/28 03:06:21 Step ID: build marked as successful (elapsed time in seconds: 8.780235)
2024/08/28 03:06:21 Populating digests for step ID: build...
2024/08/28 03:06:22 Successfully populated digests for step ID: build
2024/08/28 03:06:22 Step ID: push marked as successful (elapsed time in seconds: 1.980158)
2024/08/28 03:06:22 The following dependencies were found:
2024/08/28 03:06:22
- image:
   registry: wlsaksacru6jyly7kztoqu.azurecr.io
   repository: wlsaks-auxiliary-image
   tag: "1.0"
   digest: sha256:c813eb75576eb07a179c3cb4e70106ca7dd280f933ab33a2f6858de673b12eac
runtime-dependency:
   registry: registry.hub.docker.com
   repository: library/busybox
   tag: latest
   digest: sha256:9ae97d36d26566ff84e8893c64a6dc4fe8ca6d1144bf5b87b2b85a32def253c7
git: {}

Run ID: ca1 was successful after 14s

ビルドが成功すると、イメージが ACR にプッシュされます。

次の例に示すように、az acr repository show を実行して、イメージがリモートリポジトリに正常にプッシュされたかどうかをテストできます。

az acr repository show --name ${ACR_NAME} --image ${IMAGE}

このコマンドで、次の例のような出力が生成されるはずです。

{
   "changeableAttributes": {
      "deleteEnabled": true,
      "listEnabled": true,
      "readEnabled": true,
      "writeEnabled": true
   },
   "createdTime": "2024-01-24T06:14:19.4546321Z",
   "digest": "sha256:a1befbefd0181a06c6fe00848e76f1743c1fecba2b42a975e9504ba2aaae51ea",
   "lastUpdateTime": "2024-01-24T06:14:19.4546321Z",
   "name": "1.0",
   "quarantineState": "Passed",
   "signed": false
}

補助イメージを適用する

前の手順では、モデルと WDT を含む補助イメージを作成しました。次の手順で、補助イメージを WebLogic Server クラスターに適用します。

パスワードレス (推奨)
パスワード

kubectl patch コマンドを使用してドメインカスタムリソース定義 (CRD) にパッチを適用して、補助イメージを適用します。

補助イメージは、次の例に示すように、spec.configuration.model.auxiliaryImages で定義されます。

spec:
  clusters:
  - name: sample-domain1-cluster-1
  configuration:
    model:
      auxiliaryImages:
      - image: wlsaksacrafvzeyyswhxek.azurecr.io/wlsaks-auxiliary-image:1.0
        imagePullPolicy: IfNotPresent
        sourceModelHome: /auxiliary/models
        sourceWDTInstallHome: /auxiliary/weblogic-deploy

次のコマンドを使用して、restartVersion 値を増やし、kubectl patch を使用します。これにより、次の定義を使用して、補助イメージをドメイン CRD に適用します。

export VERSION=$(kubectl -n ${WLS_DOMAIN_NS} get domain ${WLS_DOMAIN_UID} -o=jsonpath='{.spec.restartVersion}' | tr -d "\"")
export VERSION=$((VERSION+1))

export ACR_LOGIN_SERVER=$(az acr show --name ${ACR_NAME} --query "loginServer" --output tsv)

cat <<EOF >patch-file.json
[
  {
    "op": "replace",
    "path": "/spec/restartVersion",
    "value": "${VERSION}"
  },
  {
    "op": "add",
    "path": "/spec/configuration/model/auxiliaryImages",
    "value": [{"image": "$ACR_LOGIN_SERVER/$IMAGE", "imagePullPolicy": "IfNotPresent", "sourceModelHome": "/auxiliary/models", "sourceWDTInstallHome": "/auxiliary/weblogic-deploy"}]
  },
  {
   "op": "remove",
   "path": "/spec/configuration/model/configMap"
  }
]
EOF

kubectl -n ${WLS_DOMAIN_NS} patch domain ${WLS_DOMAIN_UID} \
    --type=json \
    --patch-file patch-file.json

補助イメージでデータベース接続が構成されているため、次のコマンドを実行して ConfigMap を削除します。
```
kubectl delete configmap sample-domain1-wdt-config-map -n ${WLS_DOMAIN_NS}
```

AKS クラスターに接続します。これを行うには、前に保存した shellCmdtoConnectAks 値をコピーして Bash ウィンドウに貼り付け、コマンドを実行します。コマンドは次の例のようになります。
```
az account set --subscription <subscription>;
az aks get-credentials \
    --resource-group <resource-group> \
    --name <name>
```
次の例のような出力が表示されます。この出力が表示されない場合は、続行する前にトラブルシューティングを行って問題を解決してください。
```
Merged "<name>" as current context in /Users/<username>/.kube/config
```

次の手順を実行して、次の表に示す変数の値を取得します。これらの値は、データソース接続のシークレットを作成するために使用します。

変数	説明	例
`DB_CONNECTION_STRING`	SQL Server の接続文字列。	`jdbc:sqlserver://server-name.database.windows.net:1433;database=wlsaksquickstart0125`
`DB_USER`	SQL Server にサインインするためのユーザー名。	`welogic@sqlserverforwlsaks`
`DB_PASSWORD`	SQL Server にサインインするためのパスワード。	`Secret123456`

Azure portal の SQL データベースリソースにアクセスします。
ナビゲーションウィンドウで、[設定] の [接続文字列] を選択します。
[JDBC] タブを選択します。
コピーアイコンを選択して、接続文字列をクリップボードにコピーします。
DB_CONNECTION_STRING には、接続文字列全体を使用しますが、プレースホルダー {your_password_here} をデータベースのパスワードに置き換えます。
DB_USER には、接続文字列の azureuser から ;password={your_password_here} の前までの部分を使用します。
DB_PASSWORD には、データベースの作成時に入力した値を使用します。

次のコマンドを使用して、Kubernetes シークレットを作成します。この記事では、データソース接続のシークレットにシークレット名 sqlserver-secret を使用します。別の名前を使用する場合は、dbmodel.yaml の値と同じ値であることを確認します。

次のコマンドでは、プレースホルダーの例を前の手順で説明した値に置き換えることで、必ず変数 DB_CONNECTION_STRING、DB_USER、DB_PASSWORD を正しく設定してください。シェルが値に影響を与えることを防ぐために、DB_ 変数の値を一重引用符で囲んでください。
```
export DB_CONNECTION_STRING='<example-jdbc:sqlserver://server-name.database.windows.net:1433;database=wlsaksquickstart0125>'
export DB_USER='<example-welogic@sqlserverforwlsaks>'
export DB_PASSWORD='<example-Secret123456>'
export WLS_DOMAIN_NS=sample-domain1-ns
export WLS_DOMAIN_UID=sample-domain1
export SECRET_NAME=sqlserver-secret

kubectl -n ${WLS_DOMAIN_NS} create secret generic \
    ${SECRET_NAME} \
    --from-literal=password="${DB_PASSWORD}" \
    --from-literal=url="${DB_CONNECTION_STRING}" \
    --from-literal=user="${DB_USER}"

kubectl -n ${WLS_DOMAIN_NS} label secret \
    ${SECRET_NAME} \
    weblogic.domainUID=${WLS_DOMAIN_UID}
```
続行する前に、次の出力が表示される必要があります。この出力が表示されない場合は、続行する前に問題のトラブルシューティングと解決を行ってください。
```
secret/sqlserver-secret created
secret/sqlserver-secret labeled
```

kubectl patch コマンドを使用してドメインカスタムリソース定義 (CRD) にパッチを適用して、補助イメージを適用します。

補助イメージは、次の例に示すように、spec.configuration.model.auxiliaryImages で定義されます。

spec:
  clusters:
  - name: sample-domain1-cluster-1
  configuration:
    model:
      auxiliaryImages:
      - image: wlsaksacrafvzeyyswhxek.azurecr.io/wlsaks-auxiliary-image:1.0
        imagePullPolicy: IfNotPresent
        sourceModelHome: /auxiliary/models
        sourceWDTInstallHome: /auxiliary/weblogic-deploy

export VERSION=$(kubectl -n ${WLS_DOMAIN_NS} get domain ${WLS_DOMAIN_UID} -o=jsonpath='{.spec.restartVersion}' | tr -d "\"")
export VERSION=$((VERSION+1))
export ACR_LOGIN_SERVER=$(az acr show --name ${ACR_NAME} --query "loginServer" --output tsv)

cat <<EOF >patch-file.json
[
  {
    "op": "replace",
    "path": "/spec/restartVersion",
    "value": "${VERSION}"
  },
  {
    "op": "add",
    "path": "/spec/configuration/model/auxiliaryImages",
    "value": [{"image": "$ACR_LOGIN_SERVER/$IMAGE", "imagePullPolicy": "IfNotPresent", "sourceModelHome": "/auxiliary/models", "sourceWDTInstallHome": "/auxiliary/weblogic-deploy"}]
  },
  {
    "op": "add",
    "path": "/spec/configuration/secrets",
    "value": ["${SECRET_NAME}"]
  }
]
EOF

kubectl -n ${WLS_DOMAIN_NS} patch domain ${WLS_DOMAIN_UID} \
    --type=json \
    --patch-file patch-file.json

続行する前に、次のコマンドが管理サーバーとマネージドサーバーに対して次の出力を生成するまで待ちます。

kubectl get pod -n ${WLS_DOMAIN_NS} -w

NAME                             READY   STATUS    RESTARTS   AGE
sample-domain1-admin-server      1/1     Running   0          20m
sample-domain1-managed-server1   1/1     Running   0          19m
sample-domain1-managed-server2   1/1     Running   0          18m

システムがこの状態になるまでに 5 - 10 分かかる場合があります。次の一覧は、待機中に実行される内容の概要を示しています。

まず、sample-domain1-introspector が実行されていることが表示されます。このソフトウェアは、Kubernetes クラスターで必要なアクションを実行できるように、ドメインカスタムリソースへの変更を検索します。
変更が検出されると、ドメインイントロスペクターが強制終了し、新しいポッドを開始して変更をロールアウトします。
次に、sample-domain1-admin-server ポッドが終了して再起動することがわかります。
その後、2 つのマネージドサーバーが終了して再起動することがわかります。
3 つのポッドすべてが 1/1 Running 状態を示す場合にのみ、続行しても問題ありません。

デプロイの機能を確認する

次の手順に従って WebLogic Server 管理コンソールとサンプルアプリを表示し、デプロイの機能を確認します。

インターネットに接続された Web ブラウザーのアドレスバーに adminConsoleExternalUrl の値を貼り付けます。見慣れた WebLogic Server 管理コンソールのサインイン画面が表示されるはずです。
Azure portal から WebLogic Server をデプロイするときに入力したユーザー名 weblogic とパスワードを使用してサインインします。この値が wlsAksCluster2022 であることにご注意ください。
[ドメインの構造] ボックスで、[サービス] を選択します。
[サービス] で、[データソース] を選択します。
[JDBC データソースの概要] パネルで、[監視] を選択します。画面は次の例のようになります。データソースの状態がマネージドサーバーで実行中となっていることがわかります。
[ドメインの構造] ボックスで、[デプロイ] を選択します。
[デプロイ] テーブルには、1 つの行が表示されるはずです。名前は、appmodel.yaml ファイル内の Application 値と同じ値であるはずです。名前を選択します。
[テスト] タブを選択します。
[weblogic-cafe] を選択します。
[weblogic-cafe の設定] パネルで、[テスト] タブを選択します。
[weblogic-cafe] の隣にある + アイコンを展開します。画面は次の例のようになります。特に、[テストポイント] 列に、http://sample-domain1-managed-server1:8001/weblogic-cafe/index.xhtml に似た値が表示されます。

Note

[テストポイント] 列のハイパーリンクは、実行されている外部 URL で管理コンソールを構成していないため、選択できません。この記事では、単にデモンストレーションとして WebLogic Server 管理コンソールを表示しています。 WebLogic Server on AKS を実行している場合、永続的な構成の変更には WebLogic Server 管理コンソールを使用しないでください。 WebLogic Server on AKS のクラウドネイティブ設計では、Oracle のドキュメントで説明されているように、永続的な構成は、最初の Docker イメージで表すか、モデルの更新などの CI/CD 手法を使用して実行中の AKS クラスターに適用する必要があります。
デプロイしたサンプルアプリの context-path 値を確認します。推奨されているサンプルアプリをデプロイした場合、context-path は weblogic-cafe になります。
context-path を clusterExternalUrl 値に追加して、サンプルアプリの完全修飾 URL を作成します。推奨されているサンプルアプリをデプロイした場合、完全修飾 URL は http://wlsgw202401-wls-aks-domain1.eastus.cloudapp.azure.com/weblogic-cafe/ のようになります。
この完全修飾 URL を、インターネットに接続された Web ブラウザーに貼り付けます。推奨されているサンプルアプリをデプロイした場合、次のスクリーンショットのような結果が表示されます。

リソースをクリーンアップする

Azure の課金を回避するには、不要なリソースをクリーンアップする必要があります。クラスターが不要になったら、az group delete コマンドを使用します。次のコマンドを実行すると、リソースグループ、コンテナーサービス、コンテナーレジストリ、データベース、関連するすべてのリソースが削除されます。

az group delete --name <resource-group-name> --yes --no-wait
az group delete --name <db-resource-group-name> --yes --no-wait

次のステップ

WebLogic Server on AKS または Virtual Machines を実行する方法の詳細については、次のリンクを参照してください。

Azure Marketplace の Oracle WebLogic プランの詳細については、Oracle WebLogic Server on Azure に関するページを参照してください。これらのプランはすべて "ライセンス持ち込み" です。また、Oracle で既に適切なライセンスを取得していること、かつ Azure でプランを実行できる適切なライセンスをお持ちであることを前提としています。

次の方法で共有

Azure Kubernetes Service (AKS) クラスターに WebLogic Server を使用する Java アプリケーションをデプロイする

前提条件

Azure SQL Database の作成

リソースグループを作成する

データベースサーバーとデータベースの作成

Microsoft Entra 管理者を構成する

ユーザー割り当てマネージド ID を作成する

マネージド ID のデータベースユーザーの作成

サンプルアプリケーションのスキーマを作成する

WebLogic Server on AKS をデプロイする

デプロイの出力を調べる

サンプルアプリケーションを構成してデプロイする

アプリケーションをチェックアウトする

Azure Container Registry を使用して補助イメージを作成する

補助イメージを適用する

デプロイの機能を確認する

リソースをクリーンアップする

次のステップ

その他のリソース

次の方法で共有

Azure Kubernetes Service (AKS) クラスターに WebLogic Server を使用する Java アプリケーションをデプロイする

前提条件

Azure SQL Database の作成

リソース グループを作成する

データベース サーバーとデータベースの作成

Microsoft Entra 管理者を構成する

ユーザー割り当てマネージド ID を作成する

マネージド ID のデータベース ユーザーの作成

サンプル アプリケーションのスキーマを作成する

WebLogic Server on AKS をデプロイする

デプロイの出力を調べる

サンプル アプリケーションを構成してデプロイする

アプリケーションをチェックアウトする

Azure Container Registry を使用して補助イメージを作成する

補助イメージを適用する

デプロイの機能を確認する

リソースをクリーンアップする

次のステップ

その他のリソース

リソースグループを作成する

データベースサーバーとデータベースの作成

マネージド ID のデータベースユーザーの作成

サンプルアプリケーションのスキーマを作成する

サンプルアプリケーションを構成してデプロイする