Répertoires dynamiques d' Maven s sur les agents

Modifier en ligne

Les agents d' Instana dynamique doivent pouvoir accéder à un référentiel d' Maven s pour télécharger des fonctionnalités, des capteurs et des mises à jour.

Par défaut, les agents dynamiques sont configurés pour utiliser le référentiel suivant :

  • Nom du référentiel : shared
  • URL: https://artifact-public.instana.io/artifactory/shared
  • Authentification :
    • Nom d'utilisateur : _
    • Mot de passe : votre clé de téléchargement d' Instana

L'utilisation d'agents dynamiques dans des environnements où le shared référentiel n'est pas accessible (par exemple, dans des environnements isolés) nécessite une configuration personnalisée de l'agent ainsi qu'un miroir accessible du référentiel Maven. Cette exigence s'applique uniquement aux agents dynamiques, car les agents statiques n'ont pas besoin d'accéder aux référentiels d' Maven. Pour plus d'informations sur les mises à jour des agents, consultez la section Mises à jour des agents hôtes dynamiques.

Remarque : avant mai 2026, les agents dynamiques étaient configurés avec deux référentiels d' Maven s : shared et features. Le features référentiel n'est plus nécessaire, car tous les artefacts requis sont désormais disponibles dans le shared référentiel. Toutefois, les mécanismes de configuration du features référentiel sont toujours pris en charge pour assurer la compatibilité avec les versions antérieures. Pour plus d'informations, consultez la section « Configuration du référentiel Legacy Maven ».

Création d'un miroir du dépôt Maven

Modifier en ligne

Vous pouvez utiliser n'importe quel dépôt compatible avec Maven 2 Wagon pour créer un miroir du dépôt Instana Maven.

Les sections suivantes décrivent les configurations de miroirs de référentiels pour les gestionnaires de référentiels : Sonatype Nexus (recommandé) et JFrog Artifactory.

Le miroir du référentiel doit pouvoir accéder au référentiel Instana Maven via le réseau.

Sonatype Nexus

Commencez par configurer une instance Nexus auto-hébergée, comme indiqué dans la documentation Nexus.

Ensuite, créez un nouveau référentiel dans Nexus avec la configuration suivante :

  • Recette : maven2 (proxy)
  • Nom : instana-shared
  • Politique en matière de versions : mixte
  • Politique de mise en page : souple
  • Stockage à distance : https://artifact-public.instana.io/artifactory/shared
  • Authentification : activée
    • Type d'authentification : Nom d'utilisateur
    • Nom d'utilisateur : _
    • Mot de passe : votre clé de téléchargement d' Instana

Artifactory JFrog

Commencez par configurer une instance auto-hébergée d' Artifactory, comme indiqué dans la documentation disponible à l'adresse Artifactory.

Ensuite, créez un nouveau dépôt distant sur Artifactory avec la configuration suivante :

  • Type de paquet : Maven
  • Clé du référentiel : instana-shared
  • URL: https://artifact-public.instana.io/artifactory/shared
  • Nom d'utilisateur : _
  • Mot de passe : votre clé de téléchargement d' Instana
  • Structure du référentiel : maven-2-default

Configuration de l'agent

Modifier en ligne

Une fois que vous avez configuré un miroir du référentiel Maven, configurez vos agents dynamiques pour qu'ils utilisent ce miroir. L'agent d' Instana utilise les fichiers de configuration suivants pour gérer l'accès au référentiel d' Maven :

  • org.ops4j.pax.url.mvn.cfg configure les dépôts principaux.
  • mvn-settings.xml configure des miroirs pour les dépôts définis dans org.ops4j.pax.url.mvn.repositories. Ce fichier permet également de configurer les identifiants d'accès aux dépôts et à leurs miroirs.

Les agents en conteneur fournissent des variables d'environnement de conteneur ainsi que des paramètres de configuration disponibles à l'adresse Kubernetes ou Helm afin de modifier les paramètres concernés dans les fichiers de configuration. Ces mécanismes évitent d'avoir à modifier manuellement les fichiers de configuration dans les conteneurs.

Vous pouvez personnaliser la configuration de l' Maven dynamique des agents de deux manières :

Configuration des miroirs du référentiel Maven

Modifier en ligne

Agents non conteneurisés

Pour configurer un agent non conteneurisé afin qu'il utilise un référentiel d' Maven s en miroir, ouvrez le <instana-agent-dir>/etc/mvn-settings.xml fichier, puis décommentez et modifiez la <mirrors> section :
<mirrors>
  <mirror>
    <id>instana-shared</id>
    <url>https://repo.example.com/artifactory/instana-shared</url>
    <mirrorOf>shared</mirrorOf>
  </mirror>
</mirrors>

Remplacez l'exemple URL par l'adresse URL de votre miroir de dépôt.

Si votre miroir nécessite une authentification, ajoutez les identifiants dans la <servers> section du mvn-settings.xml fichier :
<servers>
  <server>
    <id>instana-shared</id>
    <username>myuser</username>
    <password>mypassword</password>
  </server>
</servers>

Kubernetes environnements

Pour les agents déployés dans Kubernetes à l'aide du graphique « operator » ou « Helm », utilisez les paramètres de configuration suivants :

  • agent.instanaSharedRepoMirrorUrl - URL de miroir pour le référentiel partagé
  • agent.instanaSharedRepoMirrorUsername - Nom d'utilisateur pour l'authentification du miroir
  • agent.instanaSharedRepoMirrorPassword - Mot de passe pour l'authentification du miroir

Conteneurs Docker

Pour les agents basés sur l' Docker, utilisez les variables d'environnement de conteneur suivantes :

  • INSTANA_SHARED_REPOSITORY_MIRROR_URL - URL de miroir pour le référentiel partagé
  • INSTANA_SHARED_REPOSITORY_MIRROR_USERNAME - Nom d'utilisateur pour l'authentification du miroir
  • INSTANA_SHARED_REPOSITORY_MIRROR_PASSWORD - Mot de passe pour l'authentification du miroir

Remplacer le référentiel par défaut d' Maven

Modifier en ligne

Au lieu de configurer l'agent pour qu'il utilise un miroir du référentiel, vous pouvez également remplacer l'emplacement par défaut du référentiel principal.

Agents non conteneurisés

Pour définir l'emplacement du référentiel d' Maven s d'un agent non conteneurisé, modifiez le <instana-agent-dir>/etc/org.ops4j.pax.url.mvn.cfg fichier et modifiez le org.ops4j.pax.url.mvn.repositories paramètre :

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

URL paramètres :

  • @id=shared - Identifiant du référentiel.
  • @snapshots - Permet l'utilisation d'artefacts de snapshot.
  • @snapshotsUpdate=always - Met à jour les artefacts d'instantané à chaque mise à jour de l'agent. Si ce paramètre n'est pas défini, les instantanés ne sont mis à jour qu'une fois toutes les 24 heures.

Pour configurer plusieurs référentiels, indiquez une liste d'URL de référentiels séparées par des virgules.

org.ops4j.pax.url.mvn.repositories Si un référentiel nécessite une authentification, ajoutez les identifiants dans la <servers> section du <instana-agent-dir>/etc/mvn-settings.xml fichier :
<servers>
  <server>
    <id>shared</id>
    <username>myuser</username>
    <password>mypassword</password>
  </server>
</servers>
Agents en conteneurs

Utilisez les variables d'environnement de conteneur suivantes pour définir l'emplacement du référentiel Maven pour un agent en conteneur :

  1. INSTANA_MVN_REPOSITORY_URL - L' URL de base de votre référentiel Maven. Voir l'exemple suivant :
    INSTANA_MVN_REPOSITORY_URL=https://artifact-public.instana.io/artifactory
  2. INSTANA_MVN_REPOSITORY_SHARED_PATH - Chemin d'accès au shared référentiel. Voir l'exemple suivant :
    INSTANA_MVN_REPOSITORY_SHARED_PATH=instana-shared@id=shared@snapshots@snapshotsUpdate=always

Ces variables d'environnement du conteneur configurent le org.ops4j.pax.url.mvn.repositories paramètre dans le org.ops4j.pax.url.mvn.cfg fichier de configuration :

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

Configuration du référentiel d' Maven s hérité

Modifier en ligne

Avant mai 2026, les agents dynamiques étaient configurés avec deux référentiels d' Maven s : shared et features. Le features référentiel n'est plus nécessaire, car tous les artefacts requis sont désormais disponibles dans le shared référentiel.

Toutes les versions d'agents dynamiques, quelle que soit leur date de publication, sont compatibles avec la nouvelle configuration qui utilise uniquement le shared référentiel. Tous les agents dynamiques, y compris les versions publiées à partir de mai 2026, continuent également de prendre en charge les mécanismes de configuration du référentiel hérité features .

Configuration du miroir hérité

Pour les agents non conteneurisés, vous pouvez toujours configurer un miroir pour le features référentiel dans le <instana-agent-dir>/etc/mvn-settings.xml fichier :
<mirror>
  <id>instana-features</id>
  <url>https://repo.example.com/artifactory/instana-features</url>
  <mirrorOf>features</mirrorOf>
</mirror>
Si votre miroir nécessite une authentification, ajoutez les identifiants dans la <servers> section du mvn-settings.xml fichier :
<server>
  <id>instana-features</id>
  <username>myuser</username>
  <password>mypassword</password>
</server>

Configuration de l' Kubernetes héritée

Pour les déploiements d' Kubernetes, utilisez les paramètres de configuration suivants pour configurer un miroir pour l'ancien features référentiel :

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

Configuration de l' Docker héritée

Pour les agents basés sur Docker, utilisez les variables d'environnement de conteneur suivantes pour configurer un miroir pour l'ancien features référentiel :

  • AGENT_RELEASE_REPOSITORY_MIRROR_URL
  • AGENT_RELEASE_REPOSITORY_MIRROR_USERNAME
  • AGENT_RELEASE_REPOSITORY_MIRROR_PASSWORD

Remplacement du référentiel hérité

Pour les agents en conteneur, vous pouvez, si vous le souhaitez, utiliser la INSTANA_MVN_REPOSITORY_FEATURES_PATH variable d'environnement `container` pour ajouter le features référentiel à org.ops4j.pax.url.mvn.repositories:

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

Si cette variable d'environnement du conteneur est définie, une deuxième adresse de référentiel URL est ajoutée à la configuration du conteneur :

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