Tableau Server Helm Chart - 疑難排解


重要提示：本文件假設您瞭解 Helm 和 Helm Chart，並且不嘗試提供詳細的規範性範例。它是為熟悉 Tableau Server 以及 Helm 和 Helm Chart的客戶設計的。

簡介

本主題會為您提供使用 Helm Chart 在 Kubernetes 上部署 Tableau Server 時診斷和解決常見問題的說明。內容涵蓋安裝問題、執行階段問題和偵錯技巧。

一般疑難排解步驟

在 Kubernetes 中遇到 Tableau Server 問題時：

  1. 檢查 Pod 狀態和事件
  2. 檢閱容器記錄檔
  3. 驗證資源可用性
  4. 檢查永續性磁碟區宣告
  5. 檢閱 Helm Release 狀態
  6. 檢查服務和網路連線

Pod 未啟動

  1. 檢查 Pod 狀態：

    kubectl get pods -l app.kubernetes.io/instance=tableau-server
    kubectl describe pod <pod-name>

  2. 檢查記錄檔：

    kubectl logs <pod-name>

  3. 檢查事件：

    kubectl get events --sort-by='.lastTimestamp'

永續性磁碟區問題

  1. 檢查 PVC 狀態：

    kubectl get pvc
    kubectl describe pvc <pvc-name>

  2. 驗證儲存類別：

    kubectl get storageclass

產品金鑰問題

  1. 驗證是否已設定產品金鑰：

    kubectl get secret tableau-server-secrets -o 
jsonpath='{.data.LICENSE_KEY}' | base64 -d

  2. 更新產品金鑰：

    # Edit values.yaml and upgrade
    helm upgrade tableau-server ./helm/tableau-server -f ./helm/tableau-server/values.yaml

健康情況檢查失敗

  1. 檢查健康情況檢查指令碼：

    kubectl exec <pod-name> -- /docker/alive-check
    kubectl exec <pod-name> -- /docker/server-ready-check

  2. 調整健康情況檢查時間：

    healthChecks:
      liveness:
        initialDelaySeconds: 600  # Increase if server takes longer to start

多節點啟動程序問題

  1. 驗證啟動程序磁碟區：

    kubectl get pvc | grep bootstrap

  2. 檢查啟動程序檔案:

    kubectl exec <primary-pod> -- ls -la /docker/config/bootstrap

  3. 驗證 ReadWriteMany 存取模式：

    persistence:
      bootstrap:
        accessMode: ReadWriteMany  # Required for multi-node

     

  4. 驗證 EFS 靜態佈建的啟動程序 PV/PVC 繫結：

    kubectl get pv tableau-bootstrap-pv
    kubectl get pvc -n default tableau-server-bootstrap
    kubectl describe pv tableau-bootstrap-pv
    kubectl describe pvc -n default tableau-server-bootstrap

  5. 若在繫結 PVC 後掛接失敗，請檢查 EFS CSI/IAM 錯誤：

    kubectl describe pod -n default tableau-server-primary-0
    kubectl get events -n default --sort-by='.lastTimestamp'

  6. driver name efs.csi.aws.com not found 錯誤：

    安裝並驗證 EKS 附加元件，如 Amazon Elastic Kubernetes Service (EKS) 必要條件中所述。

  7. 修正 DescribeMountTargets 授權失敗

    • 慣用方法：

      aws iam attach-role-policy \
        --role-name <your-node-instance-role> \
        --policy-arn 
      arn:aws:iam::aws:policy/AmazonElasticFileSystemClientReadWriteAccess

      然後重新啟動受影響的 Pod（主要節點和所有背景工作節點。背景工作按標籤選取，因此會涵蓋任何復本計數。

    • 備用方法

      在啟動程序 PV 設定中強制掛接目標 IP：

      設定 persistence.bootstrap.pv.csi.volumeAttributes.mounttargetip（或手動 PV volumeAttributes.mounttargetip），並重新套用/升級。

其他資源

返回頂端
感謝您的意見反應！已成功提交您的意見回饋。謝謝！