10.4. ファイルビルドおよび OpenShift Web コンソールを使用した Red Hat build of Kogito マイクロサービスの OpenShift へのデプロイ

手順

1. Operators Installed Operators に移動し、RHPAM Kogito Operator を選択します。
2. Red Hat build of Kogito ビルド定義を作成するには、Operator ページで Kogito Build タブを選択し、Create KogitoBuild をクリックします。

3. アプリケーションウィンドウで、Form View または YAML View を使用してビルド定義を設定します。

   少なくとも、以下の YAML ファイルのサンプルに示されるようにアプリケーション設定を定義します。

   Red Hat build of Kogito ビルドを使用した Red Hat build of Quarkus アプリケーションの YAML 定義の例

   apiVersion: rhpam.kiegroup.org/v1 # Red Hat build of Kogito API for this service
   kind: KogitoBuild  # Application type
   metadata:
     name: example-quarkus  # Application name
   spec:
     type: LocalSource

   Copy to Clipboard Toggle word wrap

   Red Hat build of Kogito ビルドを使用した Spring Boot アプリケーションの YAML 定義の例

   apiVersion: rhpam.kiegroup.org/v1 # Red Hat build of Kogito API for this service
   kind: KogitoBuild  # Application type
   metadata:
     name: example-springboot  # Application name
   spec:
     runtime: springboot
     type: LocalSource

   Copy to Clipboard Toggle word wrap

   注記

   内部 Maven リポジトリーを設定した場合は、Maven ミラーサービスとして使用でき、Red Hat build of Kogito ビルド定義に Maven ミラー URL を指定して、ビルド時間を大幅に短縮できます。

   spec:
     mavenMirrorURL: http://nexus3-nexus.apps-crc.testing/repository/maven-public/

   Copy to Clipboard Toggle word wrap

   内部 Maven リポジトリーの詳細は、Apache Maven ドキュメントを参照してください。

4. アプリケーションデータを定義したら、Create をクリックして Red Hat build of Kogito ビルドを生成します。

   アプリケーションが Red Hat build of KogitoBuilds ページに一覧表示されます。アプリケーション名を選択して、アプリケーション設定および YAML の詳細を表示または変更できます。

5. 以下のコマンドを使用して、ファイルアセットをアップロードします。

   $ oc start-build example-quarkus-builder --from-file=<file-asset-path> -n namespace

   Copy to Clipboard Toggle word wrap
   • file-asset-path は、アップロードするファイルハンドラーのパスに置き換えます。
   • namespace は、KogitoBuild の作成先の namespace に置き換えます。
6. Red Hat build of Kogito マイクロサービス定義を作成するには、Operator ページで Kogito Runtime タブを選択し、Create KogitoRuntime をクリックします。

7. アプリケーションウィンドウで、Form View または YAML View を使用してマイクロサービス定義を設定します。

   少なくとも、以下の YAML ファイルのサンプルに示されるようにアプリケーション設定を定義します。

   Red Hat build of Kogito マイクロサービスを使用した Red Hat build of Quarkus アプリケーションの YAML 定義の例

   apiVersion: rhpam.kiegroup.org/v1 # Red Hat build of Kogito API for this microservice
   kind: KogitoRuntime  # Application type
   metadata:
     name: example-quarkus  # Application name

   Copy to Clipboard Toggle word wrap

   Red Hat build of Kogito マイクロサービスを使用した Spring Boot アプリケーションの YAML 定義の例

   apiVersion: rhpam.kiegroup.org/v1 # Red Hat build of Kogito API for this microservice
   kind: KogitoRuntime  # Application type
   metadata:
     name: example-springboot  # Application name
   spec:
     runtime: springboot

   Copy to Clipboard Toggle word wrap

   注記

   この場合、アプリケーションはファイルからビルドされ、KogitoRuntime を使用してデプロイされます。アプリケーション名が KogitoBuild および KogitoRuntime で同じである必要があります。

8. アプリケーションデータを定義したら、Create をクリックして Red Hat build of Kogito マイクロサービスを生成します。

   アプリケーションが Red Hat build of Kogito マイクロサービスページに一覧表示されます。アプリケーション名を選択して、アプリケーション設定や YAML ファイルの内容を表示または変更できます。

9. Web コンソールの左側のメニューで Builds Builds に移動して、アプリケーションのビルドのステータスを表示します。

   特定のビルドを選択して、ビルドの詳細を表示できます。

   注記

   OpenShift デプロイメント用に作成するすべての Red Hat build of Kogito マイクロサービスでは、従来のランタイムビルドと S2I (接尾辞 -builder) ビルドの 2 つのビルドが生成され、Web コンソールの Builds ページに一覧表示されます。S2I メカニズムは OpenShift ビルドでアプリケーションを構築し、このアプリケーションを次の OpenShift ビルドに渡してランタイムコンテナーイメージにパッケージ化します。

10. アプリケーションのビルドが完了したら、Workloads Deployments に移動して、アプリケーションのデプロイメント、Pod のステータスなどの情報を表示します。

11. Red Hat build of Kogito マイクロサービスをデプロイしたら、Web コンソールの左側のメニューの Networking Routes に移動し、デプロイされたアプリケーションへのアクセスリンクを表示します。

    アプリケーション名を選択して、ルート設定を表示または変更できます。

    必要に応じてアプリケーションルートを使用すると、Red Hat build of Kogito マイクロサービスはビジネス自動化ソリューションと統合できます。