動的エージェントの Maven リポジトリ

オンラインで編集する

Dynamic Instana エージェントは、機能、センサー、および更新プログラムをダウンロードするために、 Maven リポジトリへのアクセスが必要です。

デフォルトでは、動的エージェントは次のリポジトリを使用するように設定されています：

  • リポジトリ名： shared
  • URL: https://artifact-public.instana.io/artifactory/shared
  • 認証:
    • ユーザー名： _
    • パスワード：Instana のダウンロードキー

リポジトリに shared アクセスできない環境（エアギャップ環境など）で動的エージェントを使用するには、エージェントのカスタム設定と、 Maven リポジトリへのアクセス可能なミラーが必要です。 この要件は動的エージェントにのみ適用されます。静的エージェントは Maven リポジトリへのアクセスを必要としないためです。 エージェントの更新に関する詳細については、 「動的ホストエージェントの更新」 を参照してください。

注： 2026年5月以前は、ダイナミックエージェントは次の2つの Maven リポジトリで構成されていました： shared および features。 必要なアーティファクトはすべてリポジトリ shared で入手可能になったため、この features リポジトリはもはや必要ありません。 ただし、以前のバージョンとの互換性を確保するため、リポジトリ features の設定機能は引き続きサポートされています。 詳細については、 「 Maven のレガシーリポジトリ設定」 を参照してください。

Maven のリポジトリミラーの作成

オンラインで編集する

Maven 2 Wagon に対応したリポジトリであればどれでも使用して、 Instana の Maven リポジトリのミラーを作成できます。

以下のセクションでは、リポジトリ管理ツールであるSonatype Nexus（推奨）およびJFrog Artifactory のリポジトリミラー設定について説明します。

リポジトリミラーは、ネットワーク経由で Instana Maven のリポジトリにアクセスできる必要があります。

Sonatype Nexus

まず、 Nexus のドキュメントに従って、セルフホスト型のNexusインスタンスを準備します。

次に、Nexusで以下の設定を使用して新しいリポジトリを作成します ：

  • レシピ：maven2 (プロキシ)
  • 名前： instana-shared
  • バージョンの取り扱い方針： 混在
  • レイアウト方針： 寛容
  • リモートストレージ： https://artifact-public.instana.io/artifactory/shared
  • 認証： 有効
    • 認証方式： ユーザー名
    • ユーザー名： _
    • パスワード：Instana のダウンロードキー

JFrog Artifactory

まず、『 Artifactory 』のドキュメントに従って、セルフホスト型の Artifactory インスタンスを準備します。

次に、 Artifactory に以下の設定で新しいリモートリポジトリを作成します ：

  • パッケージの種類：Maven
  • リポジトリキー： instana-shared
  • URL: https://artifact-public.instana.io/artifactory/shared
  • ユーザー名： _
  • パスワード：Instana のダウンロードキー
  • リポジトリの構成: maven-2-default

エージェントの構成

オンラインで編集する

Maven のリポジトリミラーを設定したら、ダイナミックエージェントがそのミラーを使用するように設定してください。 Instana エージェントは、 Maven リポジトリへのアクセスを管理するために、以下の設定ファイルを使用します：

  • org.ops4j.pax.url.mvn.cfg メインのリポジトリを設定します。
  • org.ops4j.pax.url.mvn.repositoriesmvn-settings.xml . に定義されているリポジトリのミラーを設定します。 このファイルでは、リポジトリとそのミラーの両方に対する認証情報も設定されます。

コンテナ化されたエージェントは、コンテナの環境変数および Kubernetes または Helm の設定パラメータを提供し、設定ファイル内の関連する設定を調整します。 これらの仕組みにより、コンテナ内の設定ファイルを手動で編集する必要がなくなります。

ダイナミックエージェントの Maven 設定は、次の2つの方法でカスタマイズできます：

Maven リポジトリのミラー設定

オンラインで編集する

コンテナ化されていないエージェント

コンテナ化されていないエージェントで、ミラー化された Maven リポジトリを使用するように設定するには、ファイル <instana-agent-dir>/etc/mvn-settings.xml を開き、セクションの <mirrors> コメントを外して設定を調整します：
<mirrors>
  <mirror>
    <id>instana-shared</id>
    <url>https://repo.example.com/artifactory/instana-shared</url>
    <mirrorOf>shared</mirrorOf>
  </mirror>
</mirrors>

例にある URL を、ご自身のリポジトリミラーの実際の URL に置き換えてください。

ミラーに認証が必要な場合は、ファイル mvn-settings.xml の セクションに <servers> 認証情報を追加してください：
<servers>
  <server>
    <id>instana-shared</id>
    <username>myuser</username>
    <password>mypassword</password>
  </server>
</servers>

Kubernetes 環境

「operator」または「 Helm 」チャートを使用して Kubernetes にデプロイされたエージェントについては、以下の設定パラメータを使用してください：

  • agent.instanaSharedRepoMirrorUrl - 共有リポジトリのミラー: URL
  • agent.instanaSharedRepoMirrorUsername - ミラー認証用のユーザー名
  • agent.instanaSharedRepoMirrorPassword - ミラー認証用のパスワード

Docker コンテナー

Docker ベースのエージェントでは、以下のコンテナ環境変数を使用してください：

  • INSTANA_SHARED_REPOSITORY_MIRROR_URL - 共有リポジトリのミラー: URL
  • INSTANA_SHARED_REPOSITORY_MIRROR_USERNAME - ミラー認証用のユーザー名
  • INSTANA_SHARED_REPOSITORY_MIRROR_PASSWORD - ミラー認証用のパスワード

デフォルトの Maven リポジトリを上書きする

オンラインで編集する

エージェントをリポジトリのミラーを使用するように設定する代わりに、デフォルトのメインリポジトリの場所を上書きすることもできます。

コンテナ化されていないエージェント

コンテナ化されていないエージェントの Maven リポジトリの場所を設定するには、ファイルを <instana-agent-dir>/etc/org.ops4j.pax.url.mvn.cfg 編集し、設定 org.ops4j.pax.url.mvn.repositories を変更します：

org.ops4j.pax.url.mvn.repositories=https://repo.example.com/artifactory/instana-shared@id=shared@snapshots@snapshotsUpdate=always

URL パラメータ：

  • @id=shared - リポジトリ識別子。
  • @snapshots - スナップショット・アーティファクトの使用を有効にします。
  • @snapshotsUpdate=always - エージェントが更新されるたびに、スナップショットのアートファクトを更新します。 このパラメータが設定されていない場合、スナップショットは24時間に1回のみ更新されます。

複数のリポジトリを設定するには、リポジトリのURLをカンマ区切りで指定してください。

リポジトリで org.ops4j.pax.url.mvn.repositories 認証が必要な場合は、ファイル <instana-agent-dir>/etc/mvn-settings.xml のセクション <servers> に認証情報を追加してください：
<servers>
  <server>
    <id>shared</id>
    <username>myuser</username>
    <password>mypassword</password>
  </server>
</servers>
コンテナ化されたエージェント

コンテナ化されたエージェントの Maven リポジトリの場所を設定するには、以下のコンテナ環境変数を使用してください：

  1. INSTANA_MVN_REPOSITORY_URL - Maven リポジトリのベースとなる ` URL `。 以下の例を参照してください。
    INSTANA_MVN_REPOSITORY_URL=https://artifact-public.instana.io/artifactory
  2. INSTANA_MVN_REPOSITORY_SHARED_PATH - リポジトリ shared へのパス。 以下の例を参照してください。
    INSTANA_MVN_REPOSITORY_SHARED_PATH=instana-shared@id=shared@snapshots@snapshotsUpdate=always

これらのコンテナ環境変数は、設定 org.ops4j.pax.url.mvn.cfg ファイル内の設定を org.ops4j.pax.url.mvn.repositories 構成します：

org.ops4j.pax.url.mvn.repositories=${INSTANA_MVN_REPOSITORY_URL}/${INSTANA_MVN_REPOSITORY_SHARED_PATH}

Maven のレガシーリポジトリ設定

オンラインで編集する

2026年5月以前は、動的エージェントは2つの Maven リポジトリ（ shared と features）で構成されていました。 必要なアーティファクトはすべてリポジトリ shared で入手可能になったため、この features リポジトリはもはや必要ありません。

リリース日にかかわらず、すべての動的エージェントのリリースは、リポジトリ shared のみを使用する新しい構成と互換性があります。 2026年5月以降のリリースを含むすべての動的エージェントは、レガシーリポジトリ features の設定メカニズムも引き続きサポートします。

レガシーミラー構成

コンテナ化されていないエージェントの場合でも、ファイル <instana-agent-dir>/etc/mvn-settings.xml 内でリポジトリの features ミラーを設定することができます：
<mirror>
  <id>instana-features</id>
  <url>https://repo.example.com/artifactory/instana-features</url>
  <mirrorOf>features</mirrorOf>
</mirror>
ミラーに認証が必要な場合は、ファイル mvn-settings.xml の セクションに <servers> 認証情報を追加してください：
<server>
  <id>instana-features</id>
  <username>myuser</username>
  <password>mypassword</password>
</server>

Kubernetes の旧設定

Kubernetes のデプロイでは、以下の設定パラメータを使用して、レガシーリポジトリ features のミラーを設定してください：

  • agent.agentReleaseRepoMirrorUrl
  • agent.agentReleaseRepoMirrorUsername
  • agent.agentReleaseRepoMirrorPassword

Docker の旧設定

Docker ベースのエージェントでは、レガシーリポジトリ features のミラーを設定するために、以下のコンテナ環境変数を使用してください：

  • AGENT_RELEASE_REPOSITORY_MIRROR_URL
  • AGENT_RELEASE_REPOSITORY_MIRROR_USERNAME
  • AGENT_RELEASE_REPOSITORY_MIRROR_PASSWORD

レガシーリポジトリのオーバーライド

org.ops4j.pax.url.mvn.repositoriesコンテナ化されたエージェントの場合、オプションで ` INSTANA_MVN_REPOSITORY_FEATURES_PATH container` 環境変数を使用して、リポジトリ features を追加することができます：

INSTANA_MVN_REPOSITORY_FEATURES_PATH=features-public@id=features@snapshots@snapshotsUpdate=always

このコンテナ環境変数が設定されている場合、2つ目のリポジトリ ` URL ` がコンテナ内の設定に追加されます：

org.ops4j.pax.url.mvn.repositories=${INSTANA_MVN_REPOSITORY_URL}/${INSTANA_MVN_REPOSITORY_SHARED_PATH},${INSTANA_MVN_REPOSITORY_URL}/${INSTANA_MVN_REPOSITORY_FEATURES_PATH}