---
schema_version: "1"
id: 374f1ab56e6c55efcf51ce8ee65ec93514df41b0657aaafe943e56ea04e53f4d
title: Helm Chart 疑難排解
collection: tableau
version: current
locale: zh-tw
portal_url: https://docs.salesforce.com/tableau/current/zh-tw/server/server-helm-troubleshooting.md
canonical_url: https://help.tableau.com/current/server/zh-tw/server-helm-troubleshooting.htm
source_site: help.tableau.com
content_type: documentation
content_hash: a54946adaacae2159ccfd020828580f452ac94af9c9061d3312f6262e57df46d
description: 重要提示：本文件假設您瞭解 Helm 和 Helm Chart，並且不嘗試提供詳細的規範性範例。它是為熟悉 Tableau Server 以及 Helm 和 Helm Chart的客戶設計的。
---
[跳至主要內容](#main-content)

# 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) 必要條件](https://help.tableau.com/current/server/zh-tw/server-helm-prerequisites.htm#EKS-Prereq-storageclass)中所述。
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`），並重新套用/升級。

## 其他資源

- [Tableau Server 文件](https://help.tableau.com/current/server-linux/zh-tw/)
- [Tableau Server 記錄檔參考](https://help.tableau.com/current/server-linux/zh-tw/logs.htm)
- [Kubernetes 疑難排解](https://kubernetes.io/docs/tasks/debug/)
- [Helm 疑難排解](https://helm.sh/docs/faq/troubleshooting/)
- [Helm 文件](https://helm.sh/docs/)