第9章 カスタム Maven ミラーの設定


OpenShift Serverless Logic は、ワークフロービルド中に Maven アーティファクトを解決するために、デフォルトで Maven Central を使用します。提供されているビルダーおよび開発イメージには、ワークフローの実行に必要なすべての Java ライブラリーが含まれていますが、カスタムの Quarkus エクステンションを追加する場合など、特定のシナリオでは、Maven Central から追加の依存関係をダウンロードする必要があります。

ネットワークアクセスが制限されている環境やファイアウォールで保護されている環境では、Maven Central への直接アクセスが利用できない場合があります。このような場合、社内レジストリーやリポジトリーマネージャーなどのカスタム Maven ミラーを使用するようにワークフローコンテナーを設定できます。

次のように、さまざまなレベルでカスタム Maven ミラーを設定できます。

  • ワークフローごとのビルド。SonataFlowBuild カスタムリソースを更新します。
  • プラットフォームレベル。SonataFlowPlatform カスタムリソースを更新します。
  • 開発モードのデプロイメント。SonataFlow カスタムリソースを編集します。
  • ビルダーイメージを使用した外部でのカスタムイメージのビルド。

9.1. ワークフロー構築時に Maven ミラーを追加する

SonataFlowBuild または SonataFlowPlatform カスタムリソース (CR) で MAVEN_MIRROR_URL 環境変数を設定することで、Maven ミラーを設定できます。

注記

推奨の方法は、SonataFlowPlatform CR を更新することです。これにより、ミラー設定がプラットフォームスコープ内のすべてのワークフロービルドに自動的に伝播されるようになります。

前提条件

  • OpenShift Serverless Logic Operator がクラスターにインストールされている。
  • OpenShift Serverless Logic プロジェクトを作成している。
  • OpenShift Container Platform でアプリケーションやその他のワークロードを作成するための適切なロールと権限を持つ OpenShift Serverless Logic プロジェクトにアクセスできる。
  • カスタム Maven ミラーまたは内部リポジトリーにアクセスできます。

手順

  1. 次の例に示すように、SonataFlowPlatform CR を編集して、namespace 内のすべてのワークフロービルドの Maven ミラーを設定します。

    SonataFlowPlatform CR での Maven ミラー設定の例

    apiVersion: sonataflow.org/v1alpha08
    kind: SonataFlowPlatform
    metadata:
      name: my-platform
    spec:
      build:
        template:
          envs:
            - name: MAVEN_MIRROR_URL
              value: http://my.company.registry.local
    Copy to Clipboard Toggle word wrap

    この設定は、preview プロファイルを使用する同じ namespace 内のすべてのワークフロービルドに適用されます。ワークフロービルダーインスタンスが実行されると、内部 Maven 設定ファイルが更新され、指定されたミラーが Maven Central などの外部ロケーションのデフォルトとして使用されるようになります。

  2. オプション: 単一のワークフロービルドに特定の設定が必要な場合は、対応する SonataFlow CR を作成する前に、SonataFlowBuild CR を作成します。SonataFlowBuildSonataFlow CR の名前は同じである必要があります。

    SonataFlowBuild CR での Maven ミラー設定の例

    apiVersion: sonataflow.org/v1alpha08
    kind: SonataFlowBuild
    metadata:
      name: my-workflow 
    1
    
      annotations:
        sonataflow.org/restartBuild: "true" 
    2
    
    spec:
      # suppressed for brevity
      envs:
        - name: MAVEN_MIRROR_URL 
    3
    
          value: http://my.company.registry.local
    Copy to Clipboard Toggle word wrap

    1
    SonataFlowBuild CR は、対応する SonataFlow CR と同じ名前である必要があります。
    2
    sonataflow.org/restartBuild: "true" アノテーションは、既存のビルドを新しい設定で強制的に再起動します。
    3
    MAVEN_MIRROR_URL 環境変数は、カスタム Maven ミラーを指定します。
    注記

    デバッグなど、ワークフロー固有の動作が必要な場合にのみ、SonataFlowBuild CR 設定を使用できます。一般的な使用の場合は、代わりに SonataFlowPlatform CR を設定します。

トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat