Instana kubectl Plugin

Das Plug-in „ Instana® “ kubectl ist eine Binärdatei. Sie können das Plug-in verwenden, um den Operator zu installieren und administrative Aktionen auszulösen, die der Operator durchführt.

Installation des Plug-ins „ Instana “ kubectl

Sie können das Plug-in entweder automatisch oder manuell installieren.

Hinweis:

Bei Systemen mit „ Linux® on Power® “ ( ppc64le ) müssen Sie das Plug-in manuell installieren.

Automatische Installation

Verwenden Sie die automatische Installationsmethode nur, wenn Sie das Plug-in „ Instana “ ( kubectl ) auf den Betriebssystemen Ubuntu, Debian, Red Hat Enterprise Linux und CentOS installieren möchten.

Ubuntu oder Debian

Führen Sie als root-Benutzer den folgenden Befehl aus, um das Repository hinzuzufügen:

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

Hinweis:

Sie müssen <download_key> durch Ihren Download-Schlüssel ersetzen.

Um das Plug-in „ Instana “ ( kubectl ) zu installieren, führen Sie den folgenden Befehl aus:

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

Führen Sie die folgenden Befehle aus, um größere Aktualisierungen während automatisierter Upgrades zu vermeiden:

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

Hinweis:

Ersetzen Sie <version to pin> durch die Version des Plug-ins „ Instana “ ( kubectl ), die Sie festlegen möchten.

Red Hat Enterprise Linux oder CentOS

Fügen Sie das Repository hinzu, indem Sie den folgenden Befehl als Benutzer root ausführen. Ersetzen Sie <download_key> durch Ihren Download-Schlüssel.

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

Installieren Sie das Plugin „ Instana “ unter kubectl, indem Sie den folgenden Befehl ausführen:
```
yum clean expire-cache -y
yum update -y
yum install -y instana-kubectl-plugin
 
```
Falls Sie das Versionlock-Plugin noch nicht auf Ihrem Host installiert haben, führen Sie den folgenden Befehl aus, um es zu installieren.
```
yum install python3-dnf-plugin-versionlock
 
```
Um automatische Aktualisierungen zu vermeiden, führen Sie den folgenden Befehl aus:
```
yum versionlock add instana-kubectl-plugin
 
```

Manuelle Installation

Wenn Sie das Plugin „ Instana “ ( kubectl ) manuell installieren möchten, gehen Sie wie folgt vor:

Installieren Sie 'kubectl'. Weitere Informationen finden Sie unter „ kubectl installieren “.

Laden Sie das Plug-in „ Instana “ unter kubectl herunter, indem Sie je nach Betriebssystem auf einen der folgenden Links klicken:

Die Binärdateien werden mit dem folgenden GPG-Schlüssel signiert:

Extrahieren Sie die tar.gz-Datei, die Sie im vorherigen Schritt heruntergeladen haben. Sie sehen eine Datei mit dem Namen instana-kubectl-plugin. Fügen Sie den Dateipfad zur Umgebungsvariable PATH Ihres Systems hinzu, damit „ kubectl “ die Datei als Plug-in erkennt. Achten Sie darauf, dass der Binärname nicht geändert wird.

Hinweis:
kubectl Erkennt automatisch Binärdateien, deren Namen mit beginnen, kubectl- als Plug-ins in der PATH Umgebungsvariable des Systems.
- Für „ Windows “ fügen Sie den Pfad der instana-kubectl-plugin.exe Datei direkt zur PATH Umgebungsvariable des Systems hinzu.
- Für Linux und MacOS, fügen Sie den instana-kubectl-pluginBinärdateipfad zur Umgebungsvariablen PATH des Systems hinzu, indem Sie den folgenden Befehl ausführen:
```
export PATH=$PATH:<path_to_binary_directory>
 
```

Überprüfen Sie, ob das instana-kubectl-plugin -Plug-in verfügbar ist:

kubectl instana --version

Die Ausgabe sieht etwa wie im folgenden Beispiel aus:

kubectl-instana version 1.11.2 (commit=36e82eacaeee67d83c0d7e163707e6f745a29a6d, date=2026-07-29T14:50:59Z, defaultInstanaVersion=3.319.488-0)

Hilfe zum Plug-in „ kubectl “

Mit dem Flag --help können Sie die integrierten Hilfeinformationen zu jedem Befehl anzeigen. Sehen Sie sich die folgende Standard-Hilfeausgabe des Plug-ins „ Instana “ unter kubectl an:

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.

Hinweis:

Das Plug-in „ Instana “ ( kubectl ) wird gemeinsam mit dem Operator „ Instana Enterprise“ und allen Komponenten von „ Instana “ versioniert. Um „ Instana “ zu installieren, laden Sie das Plug-in herunter, das mit Ihrer „ Instana Enterprise“-Betreiberversion kompatibel ist.