Deploying your gRPC Service in Kubernetes
このページでは、Kubernetes の Quarkus に gRPC サービスをデプロイする方法について説明します。 引き続き gRPC スタートガイド の例を使用します。
Quarkus Kubernetes エクステンションを使用するようにプロジェクトを設定する
Quarkus Kubernetes エクステンションをビルドファイルに追加します。
<dependency>
<groupId>io.quarkus</groupId>
<artifactId>quarkus-kubernetes</artifactId>
</dependency>implementation("io.quarkus:quarkus-kubernetes")次に、Kubernetes Ingress リソースを使用してアプリケーションを公開します。
quarkus.kubernetes.ingress.expose=trueQuarkus Kubernetes は、ポート名 http を使用して HTTP サーバーをバインドし、ポート名 grpc を使用して gRPC サーバーをバインドします。デフォルトでは、Quarkus アプリケーションはポート名 http のみを公開するため、HTTP サーバーのみがパブリックにアクセス可能になります。代わりに gRPC サーバーを公開するには、application.properties で quarkus.kubernetes.ingress.target-port=grpc プロパティーを設定します。
quarkus.kubernetes.ingress.target-port=grpc
If you configure Quarkus to use the same port for both HTTP and gRPC servers with the property quarkus.grpc.server.use-separate-server=false, then you don’t need to change the default target-port.
|
最後に、ターミナルでコマンドを実行して Kubernetes マニフェストを生成する必要があります。
quarkus build./mvnw install./gradlew build生成されたら、 target/kubernetes ディレクトリーを確認します。
target/kubernetes
└── kubernetes.json
└── kubernetes.ymlKubernetes でアプリケーションをデプロイする方法の詳細は、Kubernetes ガイド を参照してください。
gRPC ヘルスプローブの使用
デフォルトでは、Kubernetes リソースに readiness プローブと liveness プローブは含まれていません。これらを追加するには、Smalllye Health エクステンションをビルドファイルにインポートします。
<dependency>
<groupId>io.quarkus</groupId>
<artifactId>quarkus-smallrye-health</artifactId>
</dependency>implementation("io.quarkus:quarkus-smallrye-health")| More information about the health extension can be found in the SmallRye Health guide. |
By the default, this extension will configure the probes to use the HTTP server (which is provided by some extensions like the Quarkus RESTEasy reactive extension). Internally, this probe will also use the generated gRPC Health services.
HTTP サーバーを公開する Quarkus エクステンションをアプリケーションが使用していない場合でも、設定にプロパティー quarkus.kubernetes.readiness-probe.grpc-action-enabled=true を追加することで、プローブが gRPC Health サービスを直接使用するように設定できます。
quarkus.kubernetes.readiness-probe.grpc-action-enabled=true
