Hello World Helidon

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

始める前に

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

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

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

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

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

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

    $ kubectl apply -f https://raw.githubusercontent.com/verrazzano/verrazzano/v1.1.2/examples/hello-helidon/hello-helidon-comp.yaml
$ kubectl apply -f https://raw.githubusercontent.com/verrazzano/verrazzano/v1.1.2/examples/hello-helidon/hello-helidon-app.yaml

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

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

アプリケーションの探索

Hello World Helidonマイクロサービス・アプリケーションは、REST APIエンドポイント/greetを実装し、起動されると、メッセージ{"message":"Hello World!"}を返します。

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

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

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

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

# Sample output
hello-helidon-appconf.hello-helidon.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}/greet \
   --resolve ${HOST}:443:${ADDRESS}

# Expected response output
{"message":"Hello World!"}

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

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

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

      11.22.33.44 hello-helidon.example.com

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

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

    • 独自のDNS名の使用

      • 独自のDNS名をイングレス・ゲートウェイのEXTERNAL-IPアドレスにポイントします。
      • この場合、hello-helidonアプリケーションをデプロイする前に、hello-helidon-app.yamlファイルを編集してhostsセクション(yourhost.your.domainなど)に適切な値を使用する必要があります。
      • その後、ブラウザを使用してhttps://<yourhost.your.doman>/greetでアプリケーションにアクセスできます。

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

トラブルシューティング

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

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

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

     $ kubectl get pods -n hello-helidon

 # Sample output
 NAME                                      READY   STATUS    RESTARTS   AGE
 hello-helidon-workload-676d97c7d4-wkrj2   2/2     Running   0          5m39s

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

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

    $ kubectl delete -f https://raw.githubusercontent.com/verrazzano/verrazzano/v1.1.2/examples/hello-helidon/hello-helidon-app.yaml
$ kubectl delete -f https://raw.githubusercontent.com/verrazzano/verrazzano/v1.1.2/examples/hello-helidon/hello-helidon-comp.yaml

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

    $ kubectl delete namespace hello-helidon