Tableau Server-Helm-Diagramm – Fehlerbehebung


Wichtig: In dieser Dokumentation wird davon ausgegangen, dass Sie sich mit Helm und Helm-Diagrammen auskennen, und es wird nicht versucht, detaillierte, präskriptive Beispiele zu liefern. Die Dokumentation ist für Kunden gedacht, die sowohl mit Tableau Server als auch mit Helm und Helm-Diagrammen vertraut sind.

Einführung

Dieses Thema hilft Ihnen bei der Diagnose und Behebung häufiger Probleme, die beim Bereitstellen von Tableau Server auf Kubernetes mithilfe eines Helm-Diagramms auftreten können. Behandelt werden Installationsprobleme, Laufzeitprobleme und Methoden zur Fehlersuche.

Allgemeine Schritte zur Problembehebung

Bei Problemen mit Tableau Server in Kubernetes:

  1. Prüfen von Pod-Status und -Ereignissen
  2. Überprüfen von Container-Protokollen
  3. Überprüfen der Verfügbarkeit von Ressourcen
  4. Prüfen von Ansprüchen persistenter Volumes
  5. Überprüfen des Status der Helm-Version
  6. Untersuchen der Dienst- und Netzwerkkonnektivität

Pods werden nicht gestartet

  1. Überprüfen Sie den Pod-Status:

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

  2. Überprüfen Sie die Protokolle:

    kubectl logs <pod-name>

  3. Überprüfen Sie Ereignisse:

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

Probleme bei persistenten Volumes (PVs)

  1. Überprüfen Sie den PVC-Status:

    kubectl get pvc
    kubectl describe pvc <pvc-name>

  2. Überprüfen Sie die Speicherklasse:

    kubectl get storageclass

Probleme mit Lizenzschlüsseln

  1. Vergewissern Sie sich, dass der Lizenzschlüssel festgelegt ist:

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

  2. Aktualisieren Sie den Lizenzschlüssel:

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

Fehler bei Integritätsprüfungen

  1. Führen Sie ein Skript zur Integritätsprüfung aus:

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

  2. Passen Sie das Timing der Integritätsprüfung an:

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

Bootstrap-Probleme mit mehreren Knoten

  1. Überprüfen Sie das Bootstrap-Volume:

    kubectl get pvc | grep bootstrap

  2. Überprüfen Sie die Bootstrap-Datei:

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

  3. Überprüfen Sie den ReadWriteMany-Zugriffsmodus:

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

     

  4. Überprüfen Sie die Bootstrap-PV/PVC-Bindung für statische EFS-Bereitstellung:

    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. Wenn das Mounten fehlschlägt, nachdem PVC gebunden wurde, überprüfen Sie, ob EFS CSI/IAM-Fehler vorliegen:

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

  6. Fehler driver name efs.csi.aws.com not found:

    Installieren und überprüfen Sie das EKS-Add-on, wie unter Voraussetzungen für Amazon Elastic Kubernetes Service (EKS)beschrieben.

  7. Beheben Sie DescribeMountTargets-Autorisierungsfehler

    • Bevorzugte Methode:

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

      Starten Sie dann die betroffenen Pods (primären Knoten und alle Worker-Knoten) neu. Worker werden per Beschriftung ausgewählt, sodass jede Anzahl von Replikaten abgedeckt wird.

    • Alternative Methode

      Erzwingen Sie das Mounten der Ziel-IP in der Bootstrap-PV-Konfiguration:

      Legen Sie persistence.bootstrap.pv.csi.volumeAttributes.mounttargetip (oder manuelles PV volumeAttributes.mounttargetip) fest, und übernehmen Sie dann erneut bzw. aktualisieren Sie es.

Zusätzliche Ressourcen

Zurück zum Anfang
Vielen Dank für Ihr Feedback!Ihr Feedback wurde erfolgreich übermittelt. Vielen Dank.