Hello Config World Helidon

この例は、起動されると、"HelloConfig World"レスポンスを返すHelidonベースのサービスです。アプリケーション構成では、デフォルトのマイクロプロファイル・プロパティ・ファイルではなく、Kubernetes ConfigMapを使用します。

始める前に

インストールの手順に従って、Verrazzanoをインストールします。

ノート: Hello World Helidon構成サンプル・アプリケーションのデプロイメント・ファイルは、<VERRAZZANO_HOME>/examples/helidon-configにあるVerrazzanoプロジェクトに含まれています(<VERRAZZANO_HOME>はVerrazzanoプロジェクトのルートです)。

Hello Config World Helidonアプリケーションのデプロイ

$ kubectl label namespace default verrazzano-managed=true istio-injection=enabled

1. アプリケーションのネームスペースを作成し、ネームスペースがVerrazzanoによって管理されることを示すラベルを追加します。

   $ kubectl create namespace helidon-config
   $ kubectl label namespace helidon-config verrazzano-managed=true istio-injection=enabled
   

2. アプリケーションをデプロイするには、helidon-config OAMリソースを適用します。

   $ kubectl apply -f https://raw.githubusercontent.com/verrazzano/verrazzano/v1.4.8/examples/helidon-config/helidon-config-comp.yaml -n helidon-config
   $ kubectl apply -f https://raw.githubusercontent.com/verrazzano/verrazzano/v1.4.8/examples/helidon-config/helidon-config-app.yaml -n helidon-config
   

3. アプリケーションの準備ができるまで待ちます。

   $ kubectl wait \
      --for=condition=Ready pods \
      --all -n helidon-config \
      --timeout=300s
   

アプリケーションの探索

Hello World Helidon構成の例は、REST APIエンドポイント/configを実装し、起動されると、メッセージ{"message":"HelloConfig World!"}を返します。

ノート: 次の手順では、OKEなどのKubernetes環境を使用していることを前提としています。その他の環境やデプロイメントでは、アドレス、ポートなどを取得するための代替メカニズムが必要になる場合があります。

次のステップに従い、エンドポイントをテストします

1. アプリケーション用に生成されたホスト名を取得します。

   $ HOST=$(kubectl get gateways.networking.istio.io helidon-config-helidon-config-appconf-gw \
        -n helidon-config \
        -o jsonpath='{.spec.servers[0].hosts[0]}')
   $ echo $HOST
   
   # Sample output
   helidon-config-appconf.helidon-config.11.22.33.44.nip.io
   

2. istio-ingressgatewayサービスのEXTERNAL_IPアドレスを取得します。

   $ ADDRESS=$(kubectl get service \
        -n istio-system istio-ingressgateway \
        -o jsonpath='{.status.loadBalancer.ingress[0].ip}')
   $ echo $ADDRESS
   
   # Sample output
   11.22.33.44
   

3. アプリケーションにアクセスします。

   • コマンドラインの使用

     $ curl -sk \
        -X GET \
        https://${HOST}/config \
        --resolve ${HOST}:443:${ADDRESS}
     
     # Expected response output
     {"message":"HelloConfig World!"}
     

     nip.ioを使用している場合は、--resolveを含める必要はありません。

   • ブラウザによるローカル・テスト

     一時的に、/etc/hostsファイル(MacまたはLinuxの場合)またはc:\Windows\System32\Drivers\etc\hostsファイル(Windows 10の場合)を変更して、ホスト名をイングレス・ゲートウェイのEXTERNAL-IPアドレスにマップするエントリを追加します。たとえば:

     11.22.33.44 helidon-config.example.com
     

     その後、ブラウザでhttps://<host>/configからアプリケーションにアクセスできます。

     • nip.ioを使用している場合は、HOST変数(https://${HOST}/configなど)を使用してブラウザでアプリケーションにアクセスできます。
     • プロキシを使用する場合は、*.nip.ioをNO_PROXYリストに追加する必要がある場合があります。

   • 独自のDNS名の使用

     独自のDNS名をイングレス・ゲートウェイのEXTERNAL-IPアドレスにポイントします。

     • この場合、helidon-configアプリケーションをデプロイする前に、helidon-config-app.yamlファイルを編集してhostsセクション(yourhost.your.domainなど)に適切な値を使用する必要があります。
     • その後、ブラウザを使用してhttps://<yourhost.your.domain>/configでアプリケーションにアクセスできます。

4. デプロイされたアプリケーションに関連付けられた様々なエンドポイントを使用して、ログやメトリックなどをさらに探索できます。ここの指示に従ってアクセスできます。

トラブルシューティング

1. アプリケーション構成、ドメインおよびイングレス・トレイトがすべて存在することを確認します。

   $ kubectl get ApplicationConfiguration -n helidon-config
   $ kubectl get IngressTrait -n helidon-config
   

2. helidon-configサービス・ポッドが正常に作成され、READY状態に移行されていることを確認します。これには数分かかる場合があり、一部のサービスが終了して再起動する場合があります。

    $ kubectl get pods -n helidon-config
   
    # Sample output
    NAME                                         READY   STATUS    RESTARTS   AGE
    helidon-config-deployment-676d97c7d4-wkrj2   3/3     Running   0          5m39s
   

アプリケーションのアンデプロイ

1. アプリケーションをアンデプロイするには、Hello Config World Helidon OAMリソースを削除します。

   $ kubectl delete -f https://raw.githubusercontent.com/verrazzano/verrazzano/v1.4.8/examples/helidon-config/helidon-config-app.yaml -n helidon-config
   $ kubectl delete -f https://raw.githubusercontent.com/verrazzano/verrazzano/v1.4.8/examples/helidon-config/helidon-config-comp.yaml -n helidon-config
   

2. アプリケーション・ポッドの終了後にネームスペースhelidon-configを削除します。

   $ kubectl delete namespace helidon-config