Instana kubectl プラグイン

「 Instana 」 kubectl プラグインはバイナリファイルです。プラグインを使用して、オペレータをインストールし、オペレータが実行する管理アクションをトリガーすることができます。

Instana 用「 kubectl 」プラグインのインストール

プラグインは自動または手動でインストールできます。

注： Linux® on Power® （ ppc64le ）システムでは、プラグインを手動でインストールする必要があります。

自動インストール

「 Instana 」の「 kubectl 」プラグインを、 Ubuntu、 Debian、 Red Hat Enterprise Linux、および CentOS の各オペレーティングシステムにインストールする場合は、自動インストール方法を使用してください。

Ubuntu または Debian

オンラインで編集する

rootユーザーで以下のコマンドを実行して、リポジトリを追加する：

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

注： <download_key> を、ご自身のダウンロードキーに置き換えてください。

Instana の kubectl プラグインをインストールするには、次のコマンドを実行してください：

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

自動アップグレード中に大幅な更新が行われないようにするには、以下のコマンドを実行します。

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

注： <version to pin> を、固定したい「 Instana 」の「 kubectl 」プラグインのバージョンに置き換えてください。

Red Hat Enterprise Linux または CentOS

オンラインで編集する

rootユーザーとして以下のコマンドを実行して、リポジトリを追加します。 <download_key>をあなたのダウンロードキーに置き換えてください。

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

次のコマンドを実行して、 Instana 用 kubectl プラグインをインストールします：
```
yum clean expire-cache -y
yum update -y
yum install -y instana-kubectl-plugin
 
```
versionlockプラグインがホストにインストールされていない場合は、以下のコマンドを実行してプラグインをインストールしてください。
```
yum install python3-dnf-plugin-versionlock
 
```
自動アップデートを避けるには、以下のコマンドを実行する：
```
yum versionlock add instana-kubectl-plugin
 
```

手動インストール

オンラインで編集する

Instana の「 kubectl 」プラグインを手動でインストールする場合は、以下の手順に従ってください：

kubectlをインストールします。詳細については、「 kubectl のインストール」を参照してください。

お使いのオペレーティングシステムに合わせて、以下のリンクのいずれかをクリックして、「 Instana kubectl 」プラグインをダウンロードしてください：

すべてのバイナリー・ファイルは、以下の GPG キーを使用して署名されます。

前のステップでダウンロードしたtar.gzファイルを展開します。 instana-kubectl-pluginという名前のファイルが見えます。 kubectl がそのファイルをプラグインとして認識できるように、ファイルのパスをシステムの PATH 環境変数に追加してください。バイナリ名は変更しないこと。

注： kubectl は、システム PATH 環境変数に「」で始まるバイナリファイルを kubectl- 自動的にプラグインとして検出します。
- Windows を使用する場合は、ファイル instana-kubectl-plugin.exe のパスをシステムの PATH 環境変数に直接追加してください。
- LinuxとMacOS,の場合は、以下のコマンドを実行して、システムのPATH環境変数にinstana-kubectl-pluginバイナリファイルのパスを追加します：
```
export PATH=$PATH:<path_to_binary_directory>
 
```

instana-kubectl-plugin プラグインが使用可能かどうかを確認します。

kubectl-instana --version

以下のような出力を見ることができる：

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

kubectl プラグインに関するサポート

オンラインで編集する

ヘルプ情報はプラグインに組み込まれており、 --help フラグを使用することにより、どのコマンドについても表示できます。 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.

注：Instana （ kubectl ）プラグインは、 Instana Enterpriseオペレーターおよびすべての Instana コンポーネントと連動してバージョン管理されています。「 Instana 」をインストールするには、お使いの「 Instana Enterprise」オペレーター版に対応したプラグインをダウンロードしてください。