Instana kubectl module

Modifier en ligne

Le plug-in Instana kubectl est un fichier binaire. Vous pouvez utiliser le plug-in pour installer l'opérateur et déclencher les actions administratives qu'il effectue.

Installation du plug-in « Instana » kubectl

Modifier en ligne

Vous pouvez installer le plug-in automatiquement ou manuellement.

Remarque : pour les systèmes « Linux® on Power® » ( ppc64le ), vous devez installer le plug-in manuellement.

Installation automatique

Modifier en ligne

N'utilisez la méthode d'installation automatique que si vous souhaitez installer le plug-in Instana kubectl sur les systèmes d'exploitation Ubuntu, Debian, Red Hat Enterprise Linux et CentOS.

Ubuntu ou Debian

Modifier en ligne

En tant qu'utilisateur root, exécutez la commande suivante pour ajouter le référentiel :

export DOWNLOAD_KEY="<download_key>"

echo 'deb [signed-by=/usr/share/keyrings/instana-archive-keyring.gpg] https://artifact-public.instana.io/artifactory/rel-debian-public-virtual generic main' > /etc/apt/sources.list.d/instana-product.list

cat << EOF > /etc/apt/auth.conf
machine artifact-public.instana.io
  login _
  password $DOWNLOAD_KEY
EOF

wget -nv -O- --user=_ --password="$DOWNLOAD_KEY" https://artifact-public.instana.io/artifactory/api/security/keypair/public/repositories/rel-debian-public-virtual | gpg --dearmor > /usr/share/keyrings/instana-archive-keyring.gpg

Remarque : vous devez remplacer <download_key> par votre clé de téléchargement.

Pour installer le plug-in Instana kubectl, exécutez la commande suivante :

apt update -y
apt install -y instana-kubectl-plugin

Pour éviter d'obtenir des mises à jour majeures lors des mises à niveau automatisées, exécutez les commandes suivantes:

cat > /etc/apt/preferences.d/instana-kubectl <<EOF
Package: instana-kubectl-plugin
Pin: version <version to pin>
Pin-Priority: 1000
EOF

Remarque : remplacez <version to pin> par la version du plug-in Instana kubectl que vous souhaitez épingler.

Red Hat Enterprise Linux ou CentOS

Modifier en ligne

Ajoutez le référentiel en exécutant la commande suivante en tant qu'utilisateur root. Remplacez <download_key> par votre clé de téléchargement.

export DOWNLOAD_KEY="<download_key>"

cat << EOF > /etc/yum.repos.d/Instana-Product.repo
[instana-product]
name=Instana-Product
baseurl=https://_:$DOWNLOAD_KEY@artifact-public.instana.io/artifactory/rel-rpm-public-virtual/
enabled=1
gpgcheck=0
gpgkey=https://_:$DOWNLOAD_KEY@artifact-public.instana.io/artifactory/api/security/keypair/public/repositories/rel-rpm-public-virtual
repo_gpgcheck=1
EOF

Installez le module complémentaire Instana kubectl en exécutant la commande suivante :
```
yum clean expire-cache -y
yum update -y
yum install -y instana-kubectl-plugin
 
```
Si le plug-in versionlock n'est pas installé sur votre hôte, exécutez la commande suivante pour l'installer.
```
yum install python3-dnf-plugin-versionlock
 
```
Pour éviter les mises à jour automatiques, exécutez la commande suivante :
```
yum versionlock add instana-kubectl-plugin
 
```

Installation manuelle

Modifier en ligne

Si vous souhaitez installer manuellement le plugin Instana kubectl, procédez comme suit :

Installez kubectl. Pour plus d'informations, consultez la section « Installation d' kubectl ».

Téléchargez le plug-in Instana kubectl en cliquant sur l'un des liens suivants en fonction de votre système d'exploitation :

Tous les fichiers binaires sont signés à l'aide de la clé GPG suivante:

Extrayez le fichier tar.gz que vous avez téléchargé à l'étape précédente. Vous voyez un fichier nommé instana-kubectl-plugin. Ajoutez le chemin d'accès au fichier à la variable d'environnement PATH de votre système afin qu' kubectl puisse reconnaître ce fichier comme un plug-in. Veillez à ne pas modifier le nom binaire.

Remarque : « kubectl » détecte automatiquement les fichiers binaires dont le nom commence par « kubectl- » comme plug-ins dans la variable d'environnement PATH « » du système.
- Pour l' Windows e, ajoutez directement le chemin d'accès au instana-kubectl-plugin.exe fichier à la variable d'environnement PATH du système.
- Pour Linux et MacOS, ajoutez le chemin du fichier binaire instana-kubectl-plugin à la variable d'environnement PATH du système en exécutant la commande suivante :
```
export PATH=$PATH:<path_to_binary_directory>
 
```

Vérifiez si le plug-in instana-kubectl-plugin est disponible:

kubectl-instana --version

La sortie est similaire à la sortie suivante :

kubectl-instana version 1.11.0 (commit=6af02f0291b838a8f9d33c90845d8c90b5d556a5, date=2026-06-02T12:21:58Z, defaultInstanaVersion=3.319.443-0)

Obtenir de l'aide sur le plug-in « kubectl »

Modifier en ligne

Les informations d'aide sont intégrées au plug-in et peuvent être affichées pour n'importe quelle commande à l'aide de l'indicateur --help . Consultez la documentation par défaut suivante du plug-in Instana kubectl :

kubectl-instana --help
Commands for managing Instana

Usage:
  kubectl-instana [command]

Available Commands:
  action      Run a utility action on a Core or a Unit
  completion  Generate the autocompletion script for the specified shell
  help        Help about any command
  images      Print a list of all required images
  license     Download the license
  migrate     Migrate a 'settings.hcl' file
  operator    Install the operator or generate manifests
  template    Create YAML templates for namespaces and custom resources
  versions    Manage the Instana backend version, sub-commands: `identify`, `list-images`, `update`

Flags:
  -h, --help      help for kubectl-instana
  -v, --version   version for kubectl-instana

Use "kubectl-instana [command] --help" for more information about a command.

Remarque : la version du plug-in Instana kubectl est gérée conjointement avec celle de l'opérateur Instana Enterprise et de tous les composants Instana. Pour installer l' Instana, téléchargez le plug-in compatible avec votre version d' Instana Enterprise.