Tableau Server Helm Chart - Solução de problemas


Importante: esta documentação pressupõe um conhecimento do Helm e de Helm Charts e não tenta fornecer exemplos prescritivos detalhados. Ele foi criado para clientes que estão familiarizados com o Tableau Server e com o Helm e Helm Charts.

Introdução

Este tópico fornece ajuda para você diagnosticar e resolver problemas comuns ao implantar o Tableau Server no Kubernetes usando um Helm Chart. Ele aborda problemas de instalação, problemas de tempo de execução e técnicas de depuração.

Etapas de solução de problemas gerais

Ao encontrar problemas com o Tableau Server no Kubernetes:

  1. Verificar status e eventos do pod
  2. Consultar registros de contêiner
  3. Verificar a disponibilidade de recursos
  4. Verificar reivindicações de volume persistentes
  5. Rever o status de versão do Helm
  6. Examinar conectividade de serviço e rede

Pods que não iniciam

  1. Verifique o status do pod:

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

  2. Verifique os logs:

    kubectl logs <pod-name>

  3. Verifique os eventos:

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

Problemas com volumes persistentes

  1. Verifique o status do PVC:

    kubectl get pvc
    kubectl describe pvc <pvc-name>

  2. Verifique a classe de armazenamento:

    kubectl get storageclass

Problemas com a chave de ativação de licença

  1. Verifique se a chave de ativação de licença está definida:

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

  2. Atualize a chave de ativação de licença:

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

Falhas na verificação de integridade

  1. Verifique o script de verificação de integridade:

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

  2. Ajuste o tempo da verificação de integridade:

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

Problemas no bootstrap com múltiplos nós

  1. Verifique o volume do bootstrap:

    kubectl get pvc | grep bootstrap

  2. Verificação de arquivo de bootstrap:

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

  3. Verifique o modo de acesso ReadWrateMany:

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

     

  4. Verifique o vínculo PV/PVC de bootstrap para provisionamento de EFS estático:

    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. Se a montagem falhar após o vínculo do VPN, verifique os erros do CSI/IAM do EFS:

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

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

    Instale e verifique o complemento EKS conforme descrito em Pré-requisitos do Amazon Elastic Kubernetes Service (EKS).

  7. Corrigir falhas de autorização de DescribeMountTargets

    • Método preferido:

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

      Em seguida, reinicie os pods afetados (o nó principal e todos os nós trabalhadores. Os trabalhadores são selecionados por rótulo, para que qualquer contagem de réplicas seja incluída.

    • Método alternativo

      Forçar a montagem do IP de destino na configuração de PV de bootstrap:

      Defina persistence.bootstrap.pv.csi.volumeAttributes.mounttargetip (ou o PV manual volumeAttributes.mounttargetip) e reaplique/atualize.

Recursos adicionais

Voltar para o topo
Agradecemos seu feedback!Seu feedback foi enviado. Obrigado!