--- schema_version: "1" id: 473faf2c791bb5c89d0db74ba6bc57ef62ca6742406d8d2aea456731e44f1b17 title: Installer Bridge pour Linux pour les conteneurs collection: tableau version: current locale: fr-fr portal_url: https://docs.salesforce.com/tableau/current/fr-fr/online/to_bridge_linux_install.md canonical_url: https://help.tableau.com/current/online/fr-fr/to_bridge_linux_install.htm source_site: help.tableau.com content_type: documentation content_hash: ed8392d10ad8be63e9db3011e983ba8c1be9ad31bd5374a28cb366f6eafa5f75 description: Install Tableau Bridge for Linux in a Docker container. --- [Passer au contenu principal](#main-content) # Installer Bridge pour Linux pour les conteneurs 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. Notes d’installation : - Vous pouvez déployer plusieurs conteneurs Bridge sur Linux sur un seul ordinateur. - Les solutions sans serveur avec des adresses IP dynamiques ne sont pas prises en charge. - Les anciennes programmations Bridge ne sont pas prises en charge. Voir [Migrer des (anciennes) programmations Bridge vers les programmations Online](https://help.tableau.com/current/online/fr-fr/to_sync_schedule.htm) pour plus d’informations. ### Conditions préalables - Moteur Docker installé. Pour l’image de base du conteneur Docker, Bridge sur Linux est pris en charge sur : - Amazon Linux 2023 - Red Hat Enterprise Linux 8 - Red Hat Enterprise Linux 9 **Remarque** : CentOS n’est pas pris en charge. - Le package Tableau Bridge RPM le plus récent disponible dans la page [Téléchargements](https://www.tableau.com/fr-fr/support/releases/bridge) sur le site Web de Tableau. - Expérience avec le système d’exploitation Linux. - Script shell de base. - Expérience Docker. - [Jeton d’accès personnel](https://help.tableau.com/current/online/fr-fr/security_personal_access_tokens.htm) (PAT) ou [Jeton d’accès unifié](https://help.tableau.com/current/api/cloud-manager/fr-fr/docs/unified_access_tokens.html) (UAT) pour l’administrateur de site Tableau. Vous devez utiliser un jeton PAT ou UAT dédié pour chaque client Bridge. Tableau prend en charge 104 jetons PAT par utilisateur. - Si votre hôte Bridge doit se connecter à un partage distant, vous devrez créer une section pour le mappage UNC dans votre fichier Docker. Consultez [Connexion à des fichiers plats et à des extraits basés sur des fichiers](https://help.tableau.com/current/online/fr-fr/to_sync_local_data.htm#remote-share). - Bridge pour Linux ne prend pas en charge Bridge (anciennes programmations). Voir [Migrer des (anciennes) programmations Bridge vers les programmations Online](https://help.tableau.com/current/online/fr-fr/%3Chttps://help.tableau.com/current/online/fr-fr/to_sync_schedule.htm#Migrate from Bridge \(legacy\) to Online schedules>). ### É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](https://docs.docker.com/get-started/overview/).[](https://docs.docker.com/get-started/overview/) 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. **Important** Les images de base varient en fonction des différents pilotes et plates-formes. Les exemples qui suivent ont pour but d’illustrer le processus de création d’une image de base. Vous devez l’adapter à votre environnement particulier. 1. Téléchargez le package `.rpm` de Bridge depuis la page [Téléchargements](https://www.tableau.com/fr-fr/support/releases/bridge) 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 [Modifier les paramètres du client Bridge](https://help.tableau.com/current/online/fr-fr/to_sync_change_computer_site.htm) 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 .` 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` 6. Modifiez le fichier Docker, puis entrez les commandes pour copier, installer et supprimer le package RPM Bridge depuis l’image : - **Option 1** : utilisez `--mount`, par exemple : FROM registry.access.redhat.com/ubi8/ubi:latest RUN --mount=type=bind,source=.rpm,target=/tmp/bridge.rpm \\ set -eux; \\ yum -y update; \\ ACCEPT\_EULA=y yum install -y /tmp/bridge.rpm; \\ yum -y clean all; \\ rm -rf /var/cache/yum - **Option 2** : téléchargez directement le rpm >, par exemple : FROM registry.access.redhat.com/ubi8/ubi:latest RUN set -eux; \\ yum -y update; \\ curl -fsSL https://repo.example.com/bridge.rpm -o /tmp/bridge.rpm; \\ ACCEPT\_EULA=y yum install -y /tmp/bridge.rpm; \\ rm -f /tmp/bridge.rpm; \\ yum -y clean all; \\ rm -rf /var/cache/yum 7. Créez une nouvelle image de conteneur à l’aide de la commande build `docker`. Par exemple, 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](https://www.tableau.com/fr-fr/support/drivers), 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.el8.x86_64.rpm` `RUN yum install -y mysql-connector-odbc-8.0.26-1.el8.x86_64.rpm` **Remarque :** les pilotes MySQL et Amazon Aurora MySQL nécessitent de configurer les paramètres régionaux et d’installer les langpacks dans l’image : Exemple : `RUN yum install -y glibc-langpack-en` `ENV LANG=en_US.UTF-8 LANGUAGE=en_US:en LC_ALL=en_US.UTF-8` **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-2.1.7.0.x86_64.rpm` `odbcinst -i -d -f /opt/amazon/redshiftodbcx64/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 : Installer les packs de langues et définir les paramètres régionaux dans Docker 1. Installez les packs de langues dans vos conteneurs Docker : `RUN yum install -y glibc-langpack-en` 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"` ### Étape 4 : 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. Créer des jetons 2. Démarrez l’instance du conteneur Bridge. 3. Affectez l’agent à un pool. #### Créer des jetons Avant de commencer à déployer le conteneur, créez un [Jeton d’accès personnel](https://help.tableau.com/current/online/fr-fr/security_personal_access_tokens.htm) (PAT) ou un [Jeton d’accès unifié](https://help.tableau.com/current/api/cloud-manager/fr-fr/docs/unified_access_tokens.html) (UAT). Un jeton PAT ou UAT est requis pour se connecter à l’agent. **Considérations et exigences** : - Tableau Cloud prend en charge 104 PAT par utilisateur. Nous vous recommandons d’utiliser un seul jeton PAT ou UAT par client. - Les noms de jetons suivants doivent correspondre : l’identifiant `patTokenId` ou `jwTokenFile` (utilisé lors de l’exécution de la commande `run-bridge.sh`), le nom du jeton dans le fichier JSON et le nom du jeton que vous spécifiez lors de la génération du jeton. - Si vous utilisez un UAT, vous devez inclure les portées Oauth requises : `"tableau:remote_agents:*"`, `"tableau: jobs:read"`, `"tableau:file_uploads:*"`, `"tableau:datasources:*"` #### Instance de démarrage La méthode interactive décrite dans cette procédure illustre les étapes nécessaires pour démarrer le worker. Lorsque vous quittez, le conteneur cesse de fonctionner. - Exécutez cette commande pour déplacer l’invite du shell pour le conteneur en tant que `root` : `docker container run -it bridge_final /bin/bash` Le reste des commandes est exécuté dans le cadre de cette session interactive du conteneur. 1. Ajoutez le jeton PAT ou UAT à un fichier plat au format JSON. Par exemple : `/home/jSmith/Documents/MyTokenFile.txt` 2. 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 une instance du conteneur Bridge en exécutant la commande `run-bridge.sh`. Le processus diffère selon le type de jeton que vous utilisez : **Exemple de commande PAT** /opt/tableau/tableau\_bridge/bin/run-bridge.sh -e --patTokenId="Mytoken" --userEmail="admin@tableau.com" --client="myBridgeAgent" --site="mySite" --patTokenFile="/home/jSmith/Documents/MyTokenFile.txt" --poolId="1091bfe4-604d-402a-b41c-29ae4b85ec94" **Exemple de commande UAT** /opt/tableau/tableau\_bridge/bin/run-bridge.sh -e --userEmail="admin@tableau.com" --client="myBridgeAgent" --site="mySite" --jwTokenFile="jwTokenFile.txt" --poolId="1091bfe4-604d-402a-b41c-29ae4b85ec94" run-bridge.sh parameters
Paramètres globaux
--client(Requis) Nom que vous souhaitez donner au worker.
--site(Requis) Nom du site tel qu’il apparaît dans l’URI. N’incluez pas le chemin de l’URI.
--userEmail(Requis) Adresse e-mail de l’utilisateur associé au jeton.
-e(Facultatif) Par défaut, le worker du client Bridge s’exécute en tant que service en arrière-plan. Pour exécuter le worker au premier plan, incluez l’argument -e.
--poolId(Facultatif) ID de pool attribué au client. Voir Utiliser un ID de pool.
PAT : paramètres requis
--patTokenIdID du PAT. Voir Jetons d’accès personnels pour plus d’informations.
--patTokenFileNom du fichier et chemin d’accès au fichier texte PAT.
UAT : paramètre requis
--jwTokenFileNom du fichier et chemin d’accès au fichier texte UAT.
**Remarque :** si vous installez des versions plus anciennes de Bridge pour Linux, vous devez exécuter une commande différente pour démarrer le worker. Pour les versions 2024.2 et antérieures, démarrez le worker avec la commande `TabBridgeClientWorker` (et non la commande `run-bridge.sh`). Toutes les options de commande sont les mêmes. **Agent démarré** Le message suivant indique que l’agent a démarré. `“Service started: ...”` **Arrêter le worker** 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. #### Affectation du pool par défaut 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.](https://help.tableau.com/current/online/fr-fr/to_enable_bridge_live_connections.htm) #### Utiliser un ID de pool Lorsque vous démarrez le worker Bridge avec la commande `run-bridge.sh`, `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 : ![](/tableau/current/fr-fr/online/fr-fr/Img/bridge_pool_id.png) ## Mise à niveau du client Bridge pour Linux En restant synchronisé avec la dernière version de Bridge, vous pouvez profiter des dernières fonctionnalités et correctifs inclus avec chaque nouvelle version du client Bridge. Vous ne pouvez pas exécuter une mise à niveau sur place pour le conteneur. Au lieu de cela, vous devez créer une nouvelle image de conteneur avec les derniers fichiers binaires Bridge, puis ajouter le client Bridge au pool à côté de la version précédente. Après avoir validé la fonctionnalité, vous supprimez le client Bridge précédent. Suivez ces étapes : 1. Installez et configurez le nouveau client Tableau Bridge comme expliqué dans les sections ci-dessus. 2. Ajoutez le nouveau client Bridge au pool concerné. Consultez [Configurer les pools](https://help.tableau.com/current/online/fr-fr/to_enable_bridge_live_connections.htm) 3. Surveillez l’intégrité des travaux Bridge pour valider la stabilité avant de passer à l’étape suivante. 4. Supprimez le(s) client(s) Bridge précédent(s) du pool. Ouvrez le pool, identifiez l’ordinateur client à supprimer et cliquez sur **Supprimer**. 5. Attendez que le processus d’actualisation d’extrait se termine sur le client Bridge. Le délai d’expiration par défaut est de 24 heures. Pour plus d’informations, consultez [dataSourceRefreshSettings](https://help.tableau.com/current/online/fr-fr/to_sync_change_computer_site.htm#dataSourceRefreshSettings). 6. Une fois le délai d’actualisation écoulé, vous pouvez supprimer l’instance précédente du client Bridge. ## Résolution des problèmes ### Installation d’anciennes versions Si vous installez des versions plus anciennes de Bridge pour Linux, vous devez exécuter une commande différente pour démarrer le worker. Pour les versions 2024.2 et antérieures, démarrez le worker avec la commande `TabBridgeClientWorker` (et non la commande `run-bridge.sh`). Toutes les options de commande sont les mêmes que celles documentées ci-dessus dans [Étape 4 : Exécuter le conteneur Bridge](#runBridgeContainer). Par exemple :  /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" ### Erreur de démarrage du worker Dans certains cas, l’erreur suivante s’affichera après l’exécution de la commande `run-bridge.sh` : `Missing log in parameters. Aborting the attempt to start service worker.` Dans la plupart des cas, réexécuter la commande avec les options d’origine et l’option `-e` résout le problème. L’option `-e` exécute le service du worker Bridge au premier plan. Si vous exécutez le client Bridge en mode arrière-plan et qu’une erreur de démarrage s’affiche, vérifiez que tous les paramètres d’entrée incluent les chemins d’accès aux fichiers requis. Par exemple, en mode arrière-plan, le contexte utilisateur n’est pas fourni pour résoudre un chemin d’accès au fichier de jeton. ### 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/run-bridge.sh -e ### Le client Bridge s’arrête de manière inattendue en raison de l’expiration du jeton d’accès personnel Lorsqu’un jeton d’accès personnel (PAT) expire, le client Bridge est déconnecté de Tableau Cloud, ce qui peut entraîner l’arrêt du conteneur. Depuis le client Bridge, vous pouvez valider si votre PAT a expiré en exécutant la commande Démarrer au premier plan. Si le jeton d’accès personnel a expiré, il se peut que l’erreur suivante s’affiche : `The client credentials are invalid. To complete the request, reset the credentials, and sign in to the Tableau Bridge client.` Si vous êtes le propriétaire d’origine du PAT, vous pouvez également vérifier si le PAT a expiré en visitant Gérer les paramètres du compte dans Tableau Cloud. Pour résoudre le problème, vous devrez générer un nouveau PAT et suivre les étapes ci-dessus, [Étape 4 : Exécuter le conteneur Bridge](#runBridgeContainer). ### Erreurs d’expiration de délai pour les extraits intégrés et les connexions en direct intégrées La version 24.3 de Bridge sur Linux a apporté d’importantes améliorations des performances pour les extraits intégrés et les connexions en direct intégrées. Si vous rencontrez des erreurs d’expiration de délai sur les versions antérieures, nous vous recommandons de mettre à niveau vers une version 24.3+ de Bridge sur Linux. Si cela ne résout pas le problème, publiez la source de données séparément du classeur.