マルチクラスタToDo List
ToDo Listは、WebLogicコンポーネントを含むサンプル・アプリケーションです。このアプリケーションの詳細およびソース・コードについては、Verrazzanoの例を参照してください。
始める前に
- インストール手順に従って、マルチクラスタVerrazzano環境を設定します。
- この例では、マルチクラスタ環境に関連付けられている
managed1
という名前の管理対象クラスタがあることを前提としています。環境にその名前のクラスタがない場合、デプロイメント・ファイルを編集し、placement
セクションにリストされているクラスタ名を変更する必要があります。 - サンプル・アプリケーション・イメージをダウンロードするには、まずライセンス契約に同意する必要があります。
- ブラウザで、https://container-registry.oracle.com/に移動してサインインします。
example-todo
およびweblogic
を検索します。- それぞれに対して、次を行います:
- 結果の中でイメージ名を選択します。
- ドロップダウン・メニューから、ご使用の言語を選択し、「続行」をクリックします。
- 次に、ライセンス契約を読み、同意してください。
管理クラスタおよび管理対象クラスタのkubeconfigファイルを指すように、次の環境変数を設定します。
$ export KUBECONFIG_ADMIN=/path/to/your/adminclusterkubeconfig
$ export KUBECONFIG_MANAGED1=/path/to/your/managedclusterkubeconfig
ノート: ToDo Listアプリケーションのデプロイメント・ファイルは、<VERRAZZANO_HOME>/examples/multicluster/todo-list
にあるVerrazzanoプロジェクトに含まれています(<VERRAZZANO_HOME>
は、Verrazzanoプロジェクトのルートです)。
アプリケーションのデプロイ
-
Verrazzanoプロジェクト・ファイルを適用して、マルチクラスタのToDo Listサンプル用のネームスペースを作成します。
$ kubectl --kubeconfig $KUBECONFIG_ADMIN apply \ -f https://raw.githubusercontent.com/verrazzano/verrazzano/v1.6.11/examples/multicluster/todo-list/verrazzano-project.yaml
-
docker-registry
シークレットを作成して、レジストリからToDo Listサンプル・イメージを取得できるようにします。$ kubectl --kubeconfig $KUBECONFIG_ADMIN create secret docker-registry tododomain-repo-credentials \ --docker-server=container-registry.oracle.com \ --docker-username=YOUR_REGISTRY_USERNAME \ --docker-password=YOUR_REGISTRY_PASSWORD \ --docker-email=YOUR_REGISTRY_EMAIL \ -n mc-todo-list
YOUR_REGISTRY_USERNAME
、YOUR_REGISTRY_PASSWORD
およびYOUR_REGISTRY_EMAIL
を、レジストリへのアクセスに使用する値に置き換えます。 -
WebLogicドメインのシークレットを作成およびラベル付けします:
# Replace the values of the WLS_USERNAME and WLS_PASSWORD environment variables as appropriate. $ export WLS_USERNAME=<username> $ export WLS_PASSWORD=<password> $ kubectl --kubeconfig $KUBECONFIG_ADMIN create secret generic tododomain-weblogic-credentials \ --from-literal=password=$WLS_PASSWORD \ --from-literal=username=$WLS_USERNAME \ -n mc-todo-list $ kubectl --kubeconfig $KUBECONFIG_ADMIN create secret generic tododomain-jdbc-tododb \ --from-literal=username=$WLS_USERNAME \ --from-literal=password=$WLS_PASSWORD \ -n mc-todo-list $ kubectl --kubeconfig $KUBECONFIG_ADMIN -n mc-todo-list label secret tododomain-jdbc-tododb weblogic.domainUID=tododomain
ToDo Listサンプル・アプリケーションは、特定のシークレット名を使用するように事前構成されています。このアプリケーションのソース・コードについては、Verrazzanoの例を参照してください。
-
コンポーネントとマルチクラスタ・アプリケーション・リソースを適用して、ToDo Listアプリケーションをデプロイします。
$ kubectl --kubeconfig $KUBECONFIG_ADMIN apply \ -f https://raw.githubusercontent.com/verrazzano/verrazzano/v1.6.11/examples/multicluster/todo-list/todo-list-components.yaml $ kubectl --kubeconfig $KUBECONFIG_ADMIN apply \ -f https://raw.githubusercontent.com/verrazzano/verrazzano/v1.6.11/examples/multicluster/todo-list/mc-todo-list-application.yaml
-
ToDo Listサンプル・アプリケーションの準備ができるまで待ちます。
tododomain-adminserver
ポッドが作成されてReady
になるまで数分かかる場合があります。$ kubectl --kubeconfig $KUBECONFIG_MANAGED1 wait pod \ --for=condition=Ready tododomain-adminserver \ -n mc-todo-list \ --timeout=300s
-
アプリケーション用に生成されたホスト名を取得します。
$ HOST=$(kubectl --kubeconfig $KUBECONFIG_MANAGED1 get gateway \ -n mc-todo-list \ -o jsonpath='{.items[0].spec.servers[0].hosts[0]}') $ echo $HOST # Sample output todo-appconf.mc-todo-list.11.22.33.44.nip.io
-
istio-ingressgateway
サービスのEXTERNAL_IP
アドレスを取得します。$ ADDRESS=$(kubectl --kubeconfig $KUBECONFIG_MANAGED1 get service \ -n istio-system istio-ingressgateway \ -o jsonpath='{.status.loadBalancer.ingress[0].ip}') $ echo $ADDRESS # Sample output 11.22.33.44
-
ToDo Listサンプル・アプリケーションにアクセスします
-
コマンドラインの使用
# The expected response of this query is the HTML of a web page $ curl -sk https://${HOST}/todo/ \ --resolve ${HOST}:443:${ADDRESS}
nip.io
を使用している場合は、--resolve
を含める必要はありません。 -
ブラウザによるローカル・テスト
一時的に、
/etc/hosts
ファイル(MacまたはLinuxの場合)またはc:\Windows\System32\Drivers\etc\hosts
ファイル(Windows 10の場合)を変更して、ホスト名をイングレス・ゲートウェイのEXTERNAL-IP
アドレスにマップするエントリを追加します。たとえば:11.22.33.44 todo.example.com
その後、ブラウザで
https://todo.example.com/todo
からアプリケーションにアクセスできます。 -
独自のDNS名の使用
独自のDNS名をイングレス・ゲートウェイの
EXTERNAL-IP
アドレスにポイントします。- この場合、ToDo Listアプリケーションをデプロイする前に、
todo-list-application.yaml
ファイルを編集してhosts
セクション(yourhost.your.domain
など)で適切な値を使用する必要があります。 - その後、ブラウザを使用して
https://<yourhost.your.domain>/todo/
でアプリケーションにアクセスできます。
ブラウザでアプリケーションにアクセスすると、「Derek's ToDo List」ページが開き、編集フィールドと「Add」ボタンでタスクを追加できます。
- この場合、ToDo Listアプリケーションをデプロイする前に、
-
-
デプロイしたToDo Listアプリケーションに関連付けられた様々なエンドポイントを使用して、ログやメトリックなどをさらに調査できます。ここの指示に従ってアクセスできます。
デプロイされたアプリケーションの確認
-
アプリケーション構成、ドメインおよびイングレス・トレイトがすべて存在することを確認します。
$ kubectl --kubeconfig $KUBECONFIG_MANAGED1 get ApplicationConfiguration -n mc-todo-list # Sample output NAME AGE todo-appconf 19h $ kubectl --kubeconfig $KUBECONFIG_MANAGED1 get Domain -n mc-todo-list # Sample output NAME AGE todo-domain 19h $ kubectl --kubeconfig $KUBECONFIG_MANAGED1 get IngressTrait -n mc-todo-list # Sample output NAME AGE todo-domain-trait-7cbd798c96 19h
-
WebLogic管理サーバーおよびMySQLポッドが作成され、実行中であることを確認します。これには数分かかります。
$ kubectl --kubeconfig $KUBECONFIG_MANAGED1 get pods -n mc-todo-list # Sample output NAME READY STATUS RESTARTS AGE mysql-5c75c8b7f-vlhck 2/2 Running 0 19h tododomain-adminserver 4/4 Running 0 19h
アプリケーションのアンデプロイ
場所に関係なく、アプリケーションをアンデプロイするには、アプリケーション・リソースとプロジェクトを管理クラスタから削除します。アンデプロイは、アプリケーションが配置されているすべてのクラスタに影響します。
-
アプリケーションをアンデプロイするには、ToDo List OAMリソースを削除します。
$ kubectl --kubeconfig $KUBECONFIG_ADMIN delete \ -f https://raw.githubusercontent.com/verrazzano/verrazzano/v1.6.11/examples/multicluster/todo-list/mc-todo-list-application.yaml $ kubectl --kubeconfig $KUBECONFIG_ADMIN delete \ -f https://raw.githubusercontent.com/verrazzano/verrazzano/v1.6.11/examples/multicluster/todo-list/todo-list-components.yaml
-
プロジェクトを削除します。
$ kubectl --kubeconfig $KUBECONFIG_ADMIN delete \ -f https://raw.githubusercontent.com/verrazzano/verrazzano/v1.6.11/examples/multicluster/todo-list/verrazzano-project.yaml
-
アプリケーション・ポッドの終了後にネームスペース
mc-todo-list
を削除します。WebLogicドメイン用に作成されたシークレットも削除されます。$ kubectl --kubeconfig $KUBECONFIG_ADMIN delete namespace mc-todo-list $ kubectl --kubeconfig $KUBECONFIG_MANAGED1 delete namespace mc-todo-list