6.2. Quarkus アプリケーションの OpenShift へのデプロイ

手順

1. REST API を実装します。

   <dependency>
       <groupId>io.quarkus</groupId>
       <artifactId>quarkus-resteasy</artifactId>
   </dependency>
   <dependency>
       <groupId>io.quarkus</groupId>
       <artifactId>quarkus-micrometer-registry-prometheus</artifactId>
   </dependency>

2. micrometer レジストリーファサードを追加します。

   import javax.inject.Inject;
   import javax.ws.rs.GET;
   import javax.ws.rs.Path;
   
   import io.micrometer.core.instrument.MeterRegistry;
   
   @Path("/hello")
   public class GreetingsResource {
   
       @Inject
       MeterRegistry registry;
   
       @GET
       public String sayHello() {
           registry.counter("greeting_counter").increment();
   
           return "Hello!";
       }
   }

   この Micrometer ファサードは、サービスを呼び出すたびにインクリメントされるカウンターを作成します。レジストリーは、カスタムメトリクスの作成またはメトリクスの手動での使用に役立ちます。また、以下のようにメソッドにアノテーションを付けることもできます。

   @GET
   @Counted(value = "greeting_counter")
   public String sayHello() {
       return "Hello!";
   }

3. アプリケーションを実行します。

   mvn compile quarkus:dev

4. サービスを呼び出します。

   curl http://localhost:8080/hello

   サービスは Hello! を返すはずです。

5. http://localhost:8080/q/metrics を参照します。(完了したばかりの) カウント 1.0 の greeting_counter が表示されるはずです。

   # HELP greeting_counter_total
   #TYPE greeting_counter_total counter
   greeting_counter_total 1.0

6. エクステンション quarkus-openshift を pom.xml に入力して、Quarkus アプリケーションを OpenShift にデプロイします。

   <dependency>
       <groupId>io.quarkus</groupId>
       <artifactId>quarkus-openshift</artifactId>
   </dependency>

7. アプリケーションを OpenShift の my-project という名前の新規作成されたプロジェクトにデプロイします。

   oc new-project my-project
   
   mvn clean package -Dquarkus.kubernetes.deploy=true -Dquarkus.openshift.expose=true -Dquarkus.openshift.labels.app-with-metrics=quarkus-app