Aide de Tableau Cloud

Bridge pour Linux offre l’évolutivité et les capacités de gestion rationalisées des charges de travail conteneurisées. Les instructions suivantes décrivent une manière légère d’exécuter Bridge pour Linux et supposent que vous possédez une connaissance de base de Docker et des termes clés utilisés dans l’écosystème.

Installer et exécuter Bridge à partir d’un conteneur Docker

Pour utiliser Bridge sous Linux, vous devez créer une image Docker personnalisée, installer le package RPM, puis exécuter Bridge à partir de l’image du conteneur.

• Les anciennes programmations Bridge ne sont pas prises en charge. Voir Migrer des (anciennes) programmations Bridge vers les programmations Online pour plus d’informations.
• Si vous souhaitez vous connecter à SAP HANA à l’aide de connexions en direct, les paramètres et les variables doivent être désactivés.

Conditions préalables

• Moteur Docker installé. Pour l’image de base du conteneur Docker, Bridge sur Linux est pris en charge sur :
  • Red Hat 7.3.x et supérieur, 8.3 et supérieur
  • Centos 7. Pour plus d’informations, voir Installer le moteur Docker sur CentOS
• Package Tableau Bridge RPM.
• Expérience avec le système d’exploitation Linux.
• Scripts shell de base et expérience Docker.
• Jeton d’accès personnel (PAT) de l’administrateur du site Tableau.

Étape 1 : Créer une image de conteneur Bridge

Vous trouverez ci-après les instructions de base pour créer une image de base de Bridge sous Linux. Pour en savoir plus, consultez la rubrique Présentation de Docker.

Lorsque Docker est installé, le seul utilisateur autorisé à exécuter des commandes est root. Vous pouvez exécuter des commandes Docker avec sudo ou via un utilisateur membre du groupe Docker.

1. Téléchargez le package .rpm de Bridge depuis la page Téléchargements(Le lien s’ouvre dans une nouvelle fenêtre) sur le site Web de Tableau.
2. (Facultatif) Vous pouvez modifier les paramètres de configuration pour changer la manière dont le client s’exécutera. Consultez la section Paramètres du client Bridge pour plus d’informations.
3. Créez un répertoire de travail et déplacez-y le package .rpm.

   cd ~

   $ mkdir Docker

   $ cd Docker

   $ mv <RPM_location>.rpm .

4. Créez un fichier Docker dans le répertoire de travail. Par exemple :

   $ touch Dockerfile

5. Modifiez le fichier Docker et ajoutez les commandes pour exécuter yum update.

   Exemple Red Hat

   Pour Red Hat 8 :

   FROM registry.access.redhat.com/ubi8/ubi:latest

   RUN yum -y update

   Pour Red Hat 7 :

   FROM registry.access.redhat.com/ubi7/ubi:latest

   RUN yum -y update

   Exemple Centos

   Pour Centos 7 :

   FROM centos:7

   RUN yum -y update

6. Modifiez le fichier Docker et ajoutez les commandes pour copier le package RPM de Bridge, installez-le, puis supprimez-le de l’image

   COPY <your_bridge_rpm>.rpm /<path_of_container>

   RUN ACCEPT_EULA=y yum install -y $(find . -name *.rpm) && rm -rf *.rpm

7. Créez une nouvelle image de conteneur à l’aide de la commande docker build. La commande suivante crée une image dans le répertoire actuel en y ajoutant la balise ​"bridge_base".

   docker buildx build --platform=linux/amd64 -t bridge_base .

8. Vérifiez que l’image de base que vous avez créée est affichée dans la liste des images.

   docker images | grep bridge

Étape 2 : Installer les pilotes

Le client Bridge a besoin de pilotes pour faciliter la connectivité entre les données du réseau privé et Tableau Cloud. Pour les pilotes, accédez à Téléchargement du pilotes, sélectionnez la source de données, puis sélectionnez Linux comme système d’exploitation.

1. L’installation peut être effectuée de manière interactive après le lancement de l’image de base, ou des fichiers Docker distincts peuvent être écrits sous forme de couche au-dessus de l’image de base.

   Exemple

   Une fois que vous avez copié le RPM du pilote MySQL dans le répertoire, vous pouvez créer un répertoire de travail distinct pour superposer les pilotes MySQL à l’aide du Dockerfile suivant :

   # Using previously built bridge_base image

   FROM bridge_base COPY mysql-connector-odbc-8.0.26-1.el7.x86_64.rpm .

   RUN yum install -y mysql-connector-odbc-8.0.26-1.el7.x86_64.rpm

   Exemple

   Installation d’un pilote JDBC postgres. Vous pouvez également utiliser un Dockerfile séparé.

   # Using previously built bridge_base image

   FROM bridge_base COPY postgresql-42.3.3.jar /opt/tableau/tableau_driver/jdbc/

   Exemple

   Installation du pilote Amazon Redshift.

   # Using previously built bridge_base image

   FROM bridge_base

   yum install -y unixODBC

   yum --nogpgcheck localinstall -y

   AmazonRedshiftODBC-64-bit-1.4.59.1000-1.x86_64.rpm

   odbcinst -i -d -f /opt/amazon/redshiftodbc/Setup/odbcinst.ini

2. Création d’une nouvelle image :

docker image build -t bridge_final .

L’image bridge_final utilise l’image mise en cache de l’étape précédente et automatise l’installation du pilote pour toutes vos instances Bridge. Si vous disposez d’un référentiel d’images, vous pouvez publier l’image dans ce référentiel et la distribuer à tous les ordinateurs sur lesquels vous souhaitez exécuter Bridge.

Étape 3 : Exécuter le conteneur Bridge

Maintenant que vous avez créé une image de base, vous pouvez la déployer à l’aide de diverses méthodes. Suivez ces étapes de base :

1. Démarrez l’instance du conteneur Bridge.
2. Connectez-vous et démarrez le worker.
3. Affectez l’agent à un pool.
   

Remarque : Bridge pour Linux ne prend pas en charge (les anciennes programmations) Bridge. Voir Migrer des (anciennes) programmations Bridge vers les programmations Online pour plus d’informations.

1. Avant de commencer à déployer le conteneur, créez un Jeton d’accès personnel (PAT). Le PAT est requis pour se connecter à l’agent.

   Les noms de jetons suivants doivent correspondre : le patTokenId (utilisé lors de l’exécution de la commande TabBridgeClientWorker), le nom du jeton dans le fichier JSON et le nom du jeton lors de la génération du jeton PAT dans Tableau Cloud.

2. Définissez les paramètres régionaux dans Docker en utilisant ENV LC_ALL en_US.UTF-8. Vous pouvez également définir les paramètres régionaux en ajoutant ce qui suit au fichier /etc/profile.

export LANG="en_US.utf8"

export LANGUAGE="en_US.utf8"

export LC_ALL="en_US.utf8"

3. Démarrez une instance du conteneur Bridge. Il existe de nombreuses manières de configurer et de démarrer l’image du conteneur. La méthode interactive suivante illustre les étapes nécessaires pour démarrer le worker. Lorsque vous quittez, le conteneur cesse de fonctionner.
   1. Utilisez la méthode suivante pour déplacer l’invite du shell pour le conteneur en tant que root. Le reste des commandes est exécuté dans le cadre de cette session interactive du conteneur.

      docker container run -it bridge_final /bin/bash

   2. Ajoutez le jeton PAT à un fichier plat au format JSON. Par exemple :

      /home/jSmith/Documents/MyTokenFile.txt

   Exemple de syntaxe de jeton :

   {"MyToken" : "uLICC7e8SUS8ZNGe8RIFn4u==:lRihmYHI0XBKle7e8S4uSORXGqAkAl4"}

   3. Modifiez les autorisations du fichier pour restreindre l’accès à l’utilisateur actuel. Par exemple :

      chmod 600 MyTokenFile.txt

   4. Démarrez le worker avec la commande TabBridgeClientWorker et fournissez les options de commande suivantes :

      Commande	Description
      TabBridgeClientWorker -e	Commande pour démarrer le worker client Bridge. L’argument -e est requis et exécute la commande au premier plan. Actuellement, le mode arrière-plan n’est pas pris en charge.
      --patTokenId	ID du PAT. Voir Jetons d’accès personnels pour plus d’informations.
      --userEmail	Adresse e-mail de l’utilisateur associé au PAT.
      --client	Nom que vous souhaitez donner au worker.
      --site	Nom du site tel qu’il apparaît dans l’URI. N’incluez pas le chemin de l’URI.
      --patTokenFile	Nom du fichier et chemin d’accès au fichier texte PAT.
      --poolId	(Facultatif) ID de pool attribué au client. Voir Utiliser un ID de pool.

      Exemple de commande

      /opt/tableau/tableau_bridge/bin/TabBridgeClientWorker -e --patTokenId="Mytoken" --userEmail="admin@tableau.com" --client="myBridgeAgent" --site="mySite" --patTokenFile="/home/jSmith/Documents/MyTokenFile.txt" --poolId="1091bfe4-604d-402a-b41c-29ae4b85ec94"

Le message suivant indique que l’agent a démarré. “Service started: ...”

Utilisez Control-C pour arrêter le worker. Plutôt que de redémarrer le worker, vous pouvez démarrer un nouveau worker pour l’image du conteneur.

Si vous n’avez pas attribué de pool à l’aide de l’option de commande --poolId, le client est affecté au pool par défaut. Si vous souhaitez utiliser le client avec des domaines ou des VConn spécifiques, vous pouvez affecter le client à un pool nommé à l’aide de l’interface utilisateur. Le menu correspondant sur Tableau Cloud est Accueil > Paramètres > Bridge. Pour plus d’informations, consultez Configurer le pool de clients Bridge.

Utiliser un ID de pool

Si vous démarrez Worker Bridge avec la commande TabBridgeClientWorker , poolId est facultatif. Toutefois, le comportement du client varie selon qu’il est inscrit sur un site ou affecté à un pool. Tableau Bridge ne peut se connecter ou s’enregistrer que sur un seul Tableau Cloud à la fois. Le client est enregistré sur un site lorsque vous vous déconnectez et vous reconnectez.

Si aucun ID de pool n’est fourni

• Si le client Bridge a été enregistré, le statut du client reste le même :
  • Si le client est affecté à un pool, il lui reste affecté, qu’il s’agisse d’un pool nommé ou d’un pool par défaut.
  • Si le client n’est pas affecté à un pool, il restera non affecté.
• Si le client Bridge est nouveau (vous ne vous êtes jamais connecté à Tableau Cloud), le client est affecté au pool par défaut.

Si un ID de pool est fourni

• Si l’ID du pool est fourni et correct, le client Bridge est affecté au pool nommé.
• Si l’ID du pool est fourni et incorrect :
  • Si le client Bridge n’est pas enregistré, le client est affecté au pool par défaut.
  • Si le client Bridge est enregistré, le statut du client reste le même, quel que soit le pool nommé, le pool par défaut ou non attribué.

Trouver l’ID du pool

Pour trouver l’ID du pool, accédez à la page Paramètres > Bridge et cliquez sur le nom du pool. Par exemple :

Résolution des problèmes

Travailler avec des fichiers journaux

Les fichiers journaux sont stockés dans le dossier My_Tableau_Bridge_Repository/Logs de l’utilisateur. Vous pouvez enregistrer les journaux dans un dossier tmp en exécutant la commande suivante :

docker container run --volume /tmp/bridge_logs:/root/Documents/My_Tableau_Bridge_Repository/Logs -it bridge_final /bin/bash

Dans cet exemple, l’emplacement est spécifié par /tmp/bridge_logs. L’utilisation de la commande docker simplifie l’enregistrement des fichiers journaux et vous évite de devoir copier manuellement les fichiers journaux Bridge du conteneur vers votre système de fichiers local.

Échec du pilote MySQL

Si LC_MESSAGES ne sont pas définis avec les paramètres régionaux UTF-8, vous pouvez rencontrer des problèmes de lecture et d’affichage. Vous pouvez modifier le fichier /etc/profile ou relancer le worker à l’aide de la commande suivante :

LC_ALL=en_US.UTF-8 /opt/tableau/tableau_bridge/bin/TabBridgeClientWorker -e