Instana kubectl 外掛程式

Instana kubectl 外掛程式是二進位檔，可協助您安裝操作器並觸發操作器執行的管理動作。

說明資訊
安裝 Instana kubectl 外掛程式
- 自動安裝
  - Ubuntu 或 Debian
  - Red Hat 或 CentOS
- 手動安裝

說明資訊

說明資訊已整合至外掛程式中，且可以使用 --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
  cleanup     Clean up obsolete services and endpoints
  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

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 操作器及所有 Instana 元件一起版本化。如果您想要更新至 Instana 新版本，則需要下載新版本的外掛程式。

安裝 Instana kubectl 外掛程式

自動安裝

僅當您想要在 Ubuntu、 Debian、 Red Hat及 CentOS 作業系統上安裝 Instana kubectl 外掛程式時，才使用自動安裝方法。

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 -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

若要避免在自動化升級期間取得主要更新項目，請執行下列指令:

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

附註: 變更 <version to pin> 為您要釘選的 Instana kubectl 外掛程式版本。

Red Hat 或 CentOS

以 root 使用者身分執行下列指令，以新增儲存庫:

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

附註: 將 <download_key> 取代為您的下載金鑰。

執行下列指令來安裝 Instana kubectl 外掛程式:

yum clean expire-cache -y
yum update -y
yum install -y instana-kubectl

若要避免在自動更新期間取得主要更新項目，請執行下列指令:
```
yum versionlock add instana-kubectl
```

手動安裝

如果您想要手動安裝 Instana kubectl 外掛程式，請遵循下列步驟:

根據您的作業系統，按下列其中一個鏈結，以下載 Instana kubectl 外掛程式:

所有二進位檔都使用下列 GPG 金鑰來簽署:

解壓縮下載的檔案。您可以看到名為 kubectl-instana的檔案。將檔案放置在系統的 PATH 環境變數中，以便 kubectl 可以將它辨識為外掛程式，但請確保不要變更二進位名稱。

kubectl 會自動探索以 kubectl- 作為字首的二進位檔，作為系統 PATH 環境變數上的外掛程式。
- 若為 Windows ，請將 kubectl-instana.exe 檔案的位置直接新增至系統的 PATH 環境變數。
- 若為 Linux 或 MacOS，請執行下列指令，將 kubectl-instana 二進位檔放到系統的 PATH 環境變數中:
```
export PATH=$PATH:<path_to_binary_directory>
```

檢查 kubectl-instana 外掛程式是否可用:

kubectl instana --version

您可以查看輸出，如下所示：

kubectl-instana version 261-0 (commit=bb5a5d9cf359ed6283260fdc5a80e3b607c3ebb9, date=2023-11-14T02:09:16-06:00)

Minimum required database versions:

cassandra           :	Major: 4 	min. Minor: 0
clickhouse          :	Major: 23.3 	min. Minor: 10
beeinstana          :	Major: 1 	min. Minor: 160
postgres            :	Major: 15 	min. Minor: 0
kafka               :	Major: 3 	min. Minor: 2
elasticsearch       :	Major: 7 	min. Minor: 16