Mise à jour du webhook AutoTrace

Modifier en ligne

Instana AutoTrace Le webhook ne peut pas mettre à jour automatiquement l'instrumentation. Par conséquent, vous devez le mettre à jour manuellement en désinstallant l'instrumentation précédente, puis en réinstallant le webhook à l'aide du déploiement Helm.

Remarque : l'instrumentation est livrée sur icr.io/instana/instrumentation l'image. Instana spécifie une balise de version dans le values.yaml fichier afin de s'assurer que le graphique instana-autotrace-webhookHelm est régulièrement mis à jour pour utiliser la dernière icr.io/instana/instrumentation image.

Pour mettre à jour le webhook et l'instrumentation d' InstanaAutoTrace, procédez comme suit :

Supprimez l'installation actuelle du webhook en exécutant la commande suivante :
```
helm uninstall --namespace instana-autotrace-webhook instana-autotrace-webhook
```
Mettez à jour le référentiel de graphiques Helm sur votre installation locale d' Helm en exécutant la commande suivante :
```
helm repo update
```

Réinstallez le déploiement instana-autotrace-webhook du graphique Helm en exécutant la commande suivante :

helm install --create-namespace --namespace instana-autotrace-webhook instana-autotrace-webhook \
  --repo https://agents.instana.io/helm instana-autotrace-webhook \
  --set webhook.imagePullCredentials.password=<download_key> --set <initial-custom-flags>

Relancez le déploiement pour déclencher le démarrage des nouveaux pods d'application qui intègrent la nouvelle transformation et l'instrumentation.

Redémarrez les ressources de niveau supérieur en exécutant la commande suivante :
```
kubectl rollout restart deployment <deployment-name> -n <deployment-ns>
```
À partir de la version 1.304.6 de Webhook, le processus de mise à jour a été simplifié. Par défaut, le webhook modifie désormais directement les pods plutôt que les ressources de niveau supérieur. Vous pouvez relancer les déploiements pour appliquer les mises à jour.

Si vous utilisez une version de webhook antérieure à 1.304.6, ou si vous activez manuellement --set autotrace.enableHigherLevelResourceMutation=true, le webhook modifie les ressources au niveau du déploiement. Dans ce cas, un simple redémarrage du déploiement ne suffit pas. Réaffectez les ressources de niveau supérieur pour vous assurer que les transformations sont bien appliquées.

Important : passez à la version « webhook 1.304.6 » ou à une version ultérieure afin de simplifier votre processus de mise à niveau et de pouvoir utiliser l'approche par redémarrage.

Mise à niveau sans redéploiement des ressources de niveau supérieur

Si vous utilisez une version de webhook antérieure à 1.304.6, la modification des ressources de niveau supérieur est activée par défaut. Le webhook intègre des éléments d'instrumentation dans les spécifications de déploiement. Pour passer à une nouvelle version de l'instrumentation, vous devez redéployer ces ressources de niveau supérieur. Il ne suffit pas de redémarrer les pods.

Si vous ne pouvez pas redéployer les ressources de niveau supérieur, utilisez le script de maintenance pour supprimer l'instrumentation intégrée des ressources concernées : script de maintenance « autotrace-mutating-webhook ».

Avant d'exécuter ce script, effectuez les étapes suivantes :

Mettez à jour le webhook vers la version 1.304.6 ou une version ultérieure.
Vérifiez que la modification des ressources de niveau supérieur est désactivée. À partir de la version 1.304.6 , cette fonctionnalité est désactivée par défaut.

Veuillez suivre ces étapes avant d'exécuter le script. Si le webhook est toujours configuré pour modifier des ressources de niveau supérieur, il réintroduit des éléments d'instrumentation dans les ressources que le script supprime.

Important : une fois que vous avez mis à jour le webhook et désactivé la modification des ressources de niveau supérieur, le webhook ne modifie plus que les pods individuels. Vous pouvez appliquer les futures mises à jour en redémarrant le déploiement. Il n'est pas nécessaire de redéployer les ressources de niveau supérieur.