在 OpenShift 上安裝主機代理程式

支援的版本

Instana 支援 生命週期階段 文件中說明的 Red Hat OpenShift 版本。

Instana 主機代理程式支援受管理 OpenShift on IBM Cloud OpenShift (ROKS)、 Microsoft Azure Red Hat® OpenShift® (ARO)及 Red Hat® OpenShift® Service on AWS (ROSA)。 遵循此安裝手冊，在這些受管理 OpenShift 供應項目上安裝 Instana 主機代理程式。

安裝方法

在 OpenShift 上安裝 Instana 代理程式類似於 Kubernetes，但您需要完成一些額外的安全步驟。

您可以使用 操作器、 Helm Chart或 YAML 檔案 (DaemonSet)，在 OpenShift 叢集裡安裝 instana-agent 。

使用操作器安裝

在 OpenShift 上安裝操作器類似於 Kubernetes，但您需要完成其他安裝方法選項及部分 必要條件 步驟。

在繼續安裝操作器之前，請先完成 必要條件 步驟。

您可以使用下列一種方式來安裝操作器:

• 使用 Operator Lifecycle Manager (OLM) (在 OpenShift上偏好使用)。

• 手動建立必要的資源，如 Kubernetes中所概述。

oc login -u system:admin
oc new-project instana-agent
oc adm policy add-scc-to-user privileged -z instana-agent -n instana-agent

使用 Helm 圖表安裝

Instana 代理程式 Helm Chart 1.2.0 版及更高版本支援 OpenShift 4.x。

1. 登入 Instana 使用者介面，然後按一下 其他 > 代理程式 > 安裝 Instana 代理程式 > Kubernetes。

   從這個頁面中，您需要 主機代理程式端點 及 代理程式金鑰。

2. 從 技術 清單中，選取 Helm 圖表。

3. 輸入 叢集 名稱及 代理程式區域 (選擇性地)。

   叢集名稱 (INSTANA_KUBERNETES_CLUSTER_NAME) 是此 DaemonSet 所監視叢集的自訂名稱。

   代理程式區域 (INSTANA_ZONE) 用來 自訂顯示在基礎架構地圖上的區域分組 。 它也會設定叢集的預設名稱。

   所有其他必要參數都會預先移入。

4. 執行下列指令來安裝 Instana 代理程式。 若要配置安裝，請使用 --set 旗標在指令行上指定值，或使用 -f 旗標向 yaml 檔案提供您的值。

   附註: 如果您想要部署靜態主機代理程式，請在 helm 安裝指令中設定旗標 —set agent.image.name=containers.instana.io/instana/release/agent/static 。

   kubectl create namespace instana-agent && \
   helm install instana-agent --namespace instana-agent \
   --repo https://agents.instana.io/helm \
   --set agent.key='<your agent key - as described above>' \
   --set agent.endpointHost='<your host agent endpoint - as described above>' \
   --set cluster.name='<your-cluster-name>' \
   --set zone.name='<your-cluster-name>' \
   --set openshift=true \
   instana-agent
   

   如需所有配置參數的詳細清單，請參閱 Instana Helm 圖表。

helm uninstall instana-agent

使用 OpenShift 指令行來安裝

您可以遵循下列步驟，將 Instana 代理程式安裝至 OpenShift :

您可以從公用 GitHub 儲存庫下載一般 instana-agent-openshift.yaml 檔案。 它會以一般預設值從 Helm 圖表 呈現。 個別內容定義為下一個步驟中佈置的空懸錨點。

下載此檔案 ，並檢視最新的 變更日誌。

在 YAML 檔案中，您可以看到下列空懸錨點，這些錨點需要取代為實際值:

• *agentKey: base64-encoded Instana 金鑰，用於將產生的資料傳送至其中的叢集。

  echo YOUR_INSTANA_AGENT_KEY | base64
  

• *endpointHost: 與安裝相關聯的 IP 位址或主機名稱。

• *endpointPort: 與安裝相關聯的網路埠。

• *clusterName: 要指派給 Instana 中叢集的名稱。

• *zoneName: 要與叢集的節點相關聯的 代理程式區域 。

如需代理程式端點的其他詳細資料，請參閱 主機代理程式配置。

自訂

視您的 OpenShift 環境而定，您可能需要執行一些自訂作業。

如果您無法從 IBM Cloud Container Registry (icr.io) 取回映像檔，則需要新增兩個映像檔串流。 開啟 OpenShift Container Registry，移至 instana-agent 名稱空間，並新增下列映像檔串流:

Name: instana-agent
Image: icr.io/instana/agent

產生的影像串流是 docker-registry.default.svc:5000/instana-agent/instana-agent。

Name: leader-elector
Image: icr.io/instana/leader-elector

產生的影像串流是 docker-registry.default.svc:5000/instana-agent/leader-elector:0.5.4。

在 YAML 中使用個別的新映像檔串流。

透過使用 node-selector ，您可以指定 instana-agent DaemonSet 的部署位置。 請注意，每個工作者主機都需要有 Instana 代理程式。 如果您配置節點選取元，請檢查您是否可以看到與 instana-agent.yaml中定義的專案 nodeSelector 和 nodeSelector 有任何衝突。

透過使用 ConfigMap，您可以設定適當監視所需的代理程式配置。

檢查主機代理程式的狀態

安裝主機代理程式之後，您可以在 Instana 使用者介面或主機上檢查主機代理程式的狀態。 如需相關資訊，請參閱 檢查主機代理程式的狀態。

常見問題 (FAQ)

Normal   SuccessfulCreate  1m    daemonset-controller  Created pod: instana-agent-m6lwr
Normal   SuccessfulCreate  1m    daemonset-controller  Created pod: instana-agent-vchgg
Warning  FailedDaemonPod   1m    daemonset-controller  Found failed daemon pod instana-agent/instana-agent-vchgg on node node-1, will try to kill it
Warning  FailedDaemonPod   1m    daemonset-controller  Found failed daemon pod instana-agent/instana-agent-m6lwr on node node-2, will try to kill it
Normal   SuccessfulDelete  1m    daemonset-controller  Deleted pod: instana-agent-m6lwr
Normal   SuccessfulDelete  1m    daemonset-controller  Deleted pod: instana-agent-vchgg

oc annotate namespace instana-agent openshift.io/node-selector=""