--- schema_version: "1" id: d4c543252b3452e09c9c0ce127f12dcd9ec50ce8b0c333bdfab40e445c462fc9 title: Installare Bridge per Linux per contenitori collection: tableau version: next locale: it-it portal_url: https://docs.salesforce.com/tableau/next/it-it/online/to_bridge_linux_install.md canonical_url: https://help.tableau.com/v0.0/online/it-it/to_bridge_linux_install.htm source_site: help.tableau.com content_type: documentation content_hash: 53dd6a6e497e8fefc74643b5b0cdd90dd0f859ddf3c6b6f01857b39835f90d15 description: Install Tableau Bridge for Linux in a Docker container. --- [Passa al contenuto principale](#main-content) # Installare Bridge per Linux per contenitori Bridge per Linux offre scalabilità e funzionalità ottimizzate per la gestione dei carichi di lavoro basati su contenitori. Le seguenti istruzioni descrivono un approccio semplice per eseguire Bridge per Linux e presuppongono una conoscenza di base di Docker e dei termini chiave utilizzati nell’ecosistema. ## Installare ed eseguire Bridge da un contenitore Docker Per utilizzare Bridge in Linux, è necessario creare un’immagine Docker personalizzata, installare il pacchetto RPM e quindi eseguire Bridge dall’interno dell’immagine del contenitore. Note per l’installazione: - È possibile distribuire più contenitori Bridge su Linux in un singolo computer. - Le soluzioni serverless con IP dinamici non sono supportate. - Le pianificazioni legacy di Bridge non sono supportate. Per maggiori informazioni, consulta [Eseguire la migrazione da pianificazioni Bridge (legacy) a pianificazioni Online](https://help.tableau.com/current/online/it-it/to_sync_schedule.htm). ### Prerequisiti - Motore Docker installato. Per l’immagine di base del contenitore Docker, Bridge su Linux è supportato in: - Amazon Linux 2023 - Red Hat Enterprise Linux 8 - Red Hat Enterprise Linux 9 **Nota**: CentOS non è supportato. - Il pacchetto RPM di Tableau Bridge più recente, disponibile nella pagina [Download](https://www.tableau.com/it-it/support/releases/bridge) del sito Web di Tableau. - Esperienza con il sistema operativo Linux. - Nozioni di base sullo scripting della shell. - Esperienza Docker. - [Token di accesso personale](https://help.tableau.com/current/online/it-it/security_personal_access_tokens.htm) o [token di accesso unificato](https://help.tableau.com/current/api/cloud-manager/it-it/docs/unified_access_tokens.html) (UAT) dell’amministratore del sito Tableau. Devi utilizzare un token di accesso personale o un token di accesso unificato dedicato per ciascun client Bridge. Tableau supporta 104 token di accesso personale per utente. - Se l'host Bridge si connetterà a una condivisione remota, sarà necessario creare una sezione per il mapping UNC nel file Docker. Consulta [Connessione a file flat ed estrazioni basate su file](https://help.tableau.com/v0.0/online/it-it/to_sync_local_data.htm#remote-share). - Bridge per Linux non supporta le pianificazioni legacy di Bridge. Consulta [Eseguire la migrazione da pianificazioni Bridge (legacy) a pianificazioni Online](https://help.tableau.com/v0.0/online/it-it/%3Chttps://help.tableau.com/current/online/it-it/to_sync_schedule.htm#Migrate from Bridge \(legacy\) to Online schedules>). ### Fase 1. Creare un’immagine del contenitore Bridge Le fasi seguenti rappresentano le istruzioni principali per creare un’immagine di base Bridge su Linux. Per maggiori informazioni, consulta [Panoramica di Docker](https://docs.docker.com/get-started/overview/) (in inglese).[](https://docs.docker.com/get-started/overview/) Quando Docker è installato, l’unico utente che dispone dell’autorizzazione per eseguire i comandi è root. Puoi eseguire i comandi Docker con `sudo` o da un utente membro del gruppo docker. **Importante** Le immagini di base variano a seconda dei diversi driver e piattaforme. Gli esempi che seguono hanno lo scopo di illustrare il processo di creazione di un'immagine di base. È necessario adattare il processo di compilazione per l'ambiente specifico. 1. Scarica il pacchetto `.rpm` di Bridge dalla pagina [Download](https://www.tableau.com/it-it/support/releases/bridge) sul sito Web di Tableau. 2. (Facoltativo) Puoi modificare le impostazioni di configurazione per cambiare la modalità di esecuzione del client. Per maggiori informazioni, consulta [Modificare le impostazioni del client Bridge](https://help.tableau.com/current/online/it-it/to_sync_change_computer_site.htm). 3. Crea una directory di lavoro e sposta il pacchetto `.rpm` nella directory. `cd ~` `$ mkdir Docker` `$ cd Docker` `$ mv .rpm .` 4. Crea un file Docker nella directory di lavoro. Ad esempio: `$ touch Dockerfile` 5. Modifica il file Docker e aggiungi i comandi per eseguire `yum update.` **Esempio per Red Hat** Per Red Hat 8: `FROM registry.access.redhat.com/ubi8/ubi:latest` `RUN yum -y update` 6. Modifica il file Docker, quindi immetti i comandi per copiare, installare e rimuovere il pacchetto RPM di Bridge dall’immagine: - **Opzione 1**: utilizza `--mount`, ad esempio: 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 - **Opzione 2**: scarica direttamente il pacchetto rpm, ad esempio: 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. Crea una nuova immagine del contenitore utilizzando il comando di creazione `docker`. Ad esempio, il comando seguente crea un’immagine nella directory corrente, contrassegnandola con la parola `​"bridge_base"`. `docker buildx build --platform=linux/amd64 -t bridge_base .` 8. Verifica che l’immagine di base creata sia visualizzata nell’elenco delle immagini: `docker images | grep bridge` ### Fase 2. Installare i driver Il client Bridge richiede driver per facilitare la connettività tra i dati della rete privata e Tableau Cloud. Per i driver, visita la pagina di [download dei driver](https://www.tableau.com/it-it/support/drivers), seleziona l’origine dati, quindi seleziona Linux per il sistema operativo. 1. L’installazione può essere eseguita in modo interattivo dopo l’avvio dell’immagine di base oppure è possibile scrivere Dockerfile separati da aggiungere all’immagine di base. **Esempio** Dopo aver copiato il pacchetto RPM del driver MySQL nella directory, puoi creare una directory di lavoro separata per aggiungere i driver MySQL utilizzando il seguente Dockerfile: `# 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` **Nota:** con i driver MySQL e Amazon Aurora MySQL è necessario configurare le impostazioni locali e installare i Language Pack nell’immagine: Esempio: `RUN yum install -y glibc-langpack-en` `ENV LANG=en_US.UTF-8 LANGUAGE=en_US:en LC_ALL=en_US.UTF-8` **Esempio** Installa un driver JDBC Postgres. Questa operazione può essere eseguita anche in un Dockerfile separato. `# Using previously built bridge_base image` `FROM bridge_base` `COPY postgresql-42.3.3.jar /opt/tableau/tableau_driver/jdbc/` **Esempio** Installa il driver 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. Crea una nuova immagine: `docker image build -t bridge_final .` L’immagine `bridge_final` utilizza l’immagine memorizzata nella cache della fase precedente e automatizza l’installazione del driver per tutte le istanze di Bridge. Se disponi di un repository di immagini, puoi pubblicare l’immagine nel repository e distribuirla a tutti i computer su cui desideri eseguire Bridge. ### Fase 3. Installare i Language Pack e definire le impostazioni locali in Docker 1. Installa i Language Pack nei contenitori Docker: `RUN yum install -y glibc-langpack-en` 2. Specifica le impostazioni locali in Docker utilizzando `ENV LC_ALL en_US.UTF-8`. Puoi anche impostare le impostazioni locali aggiungendo quanto segue al file `/etc/profile`: `export LANG="en_US.utf8"` `export LANGUAGE="en_US.utf8"` `export LC_ALL="en_US.utf8"` ### Fase 4. Eseguire il contenitore Bridge Ora che hai creato un’immagine di base, puoi distribuirla utilizzando diversi metodi. I passaggi fondamentali sono: 1. Creare token 2. Avviare l’istanza del contenitore Bridge. 3. Assegnare l’agente a un pool. #### Creare token Prima di iniziare a distribuire il contenitore, crea un [token di accesso personale](https://help.tableau.com/current/online/it-it/security_personal_access_tokens.htm) o un [token di accesso unificato](https://help.tableau.com/current/api/cloud-manager/it-it/docs/unified_access_tokens.html). Un token di accesso personale o un token di accesso unificato è necessario per accedere all’agente. **Considerazioni e requisiti**: - Tableau Cloud supporta 104 token di accesso personali per ogni utente. Si consiglia di utilizzare un token di accesso personale o un token di accesso unificato per client. - I seguenti nomi di token devono corrispondere: `patTokenId` o `jwTokenFile` (utilizzato durante l’esecuzione del comando `run-bridge.sh`), il nome del token nel file JSON e il nome del token che specifichi quando generi il token. - Se utilizzi un token di accesso unificato, devi includere gli ambiti OAuth richiesti: `"tableau:remote_agents:*"`, `"tableau: jobs:read"`, `"tableau:file_uploads:*"`, `"tableau:datasources:*"` #### Avviare l’istanza Il metodo interattivo in questa procedura illustra le fasi necessarie per avviare il worker. Quando esci, l’esecuzione del contenitore viene interrotta. - Esegui questo comando per passare al prompt della shell per il contenitore come `root`: `docker container run -it bridge_final /bin/bash` Il resto dei comandi viene eseguito nel contesto di questa sessione interattiva del contenitore. 1. Aggiungi il token di accesso personale o il token di accesso unificato a un file flat in formato JSON. Ad esempio: `/home/jSmith/Documents/MyTokenFile.txt` 2. Sintassi del token di esempio: `{"MyToken" : "uLICC7e8SUS8ZNGe8RIFn4u==:lRihmYHI0XBKle7e8S4uSORXGqAkAl4"}` 3. Modifica le autorizzazioni del file per limitare l’accesso all’utente corrente. Ad esempio: `chmod 600 MyTokenFile.txt` 4. Avvia un’istanza del contenitore Bridge mediante l’esecuzione del comando `run-bridge.sh`. Il processo varia a seconda del tipo di token che utilizzi: **Esempio di comando con token di accesso personale** /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" **Esempio di comando con token di accesso unificato** /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" Parametri di run-bridge.sh
Parametri globali
--client(Obbligatorio) Nome da assegnare al worker.
--site(Obbligatorio) Nome del sito così come viene visualizzato nell’URI. Non includere il percorso URI.
--userEmail(Obbligatorio) E-mail dell’utente associato al token.
-e(Facoltativo) Per impostazione predefinita, il worker client Bridge viene eseguito come servizio in background. Per eseguire il worker in primo piano, includi l'argomento -e.
--poolId(Facoltativo) ID del pool assegnato al client. Vedi Utilizzo di un ID del pool.
Token di accesso personale: parametri obbligatori
--patTokenIdID del token di accesso personale. Per maggiori informazioni, consulta Token di accesso personali.
--patTokenFileNome e percorso del file di testo del token di accesso personale.
Token di accesso unificato: parametro obbligatorio
--jwTokenFileNome e percorso del file del token di accesso unificato.
**Nota**: se si installano versioni precedenti di Bridge per Linux, è necessario eseguire un comando diverso per avviare il worker. Per le versioni 2024.2 e precedenti, avviare il worker con `TabBridgeClientWorker` comando (non il comando `run-bridge.sh`. Tutte le opzioni dei comandi sono le stesse. **Agente avviato** Il messaggio seguente indica che l’agente è avviato. `“Service started: ...”` **Arrestare il worker** Utilizza `Control-C` per arrestare il worker. Invece di riavviare il worker, puoi avviare un nuovo worker per l’immagine del contenitore. #### Assegnazione del pool predefinito Se non hai assegnato un pool utilizzando l’opzione di comando `--poolId`, il client viene assegnato al pool predefinito. Se desideri utilizzare il client con domini o connessioni virtuali specifici, puoi assegnare il client a un pool denominato tramite l’interfaccia utente. Il menu corrispondente in Tableau Cloud è disponibile in Home > Impostazioni > Bridge. Per maggiori informazioni, consulta [Configurare il pool di client Bridge](https://help.tableau.com/current/online/it-it/to_enable_bridge_live_connections.htm). #### Utilizzo di un ID del pool Quando si avvia il worker Bridge con il comando `run-bridge.sh`, `poolId` è facoltativo. Tuttavia, il comportamento del client dipende dal fatto che sia registrato o meno in un sito e che sia assegnato a un pool. Tableau Bridge può connettersi o eseguire la registrazione a un solo sito Tableau Cloud in qualsiasi momento. Il client viene registrato su un sito quando si effettua la disconnessione e si accede nuovamente. **Se non viene fornito un ID del pool** - Se il client Bridge è stato registrato, lo stato del client rimane invariato: - Se il client è assegnato a un pool, rimarrà assegnato al pool, indipendentemente dal fatto che si tratti di un pool denominato o di un pool predefinito. - Se il client non è assegnato a un pool, rimarrà non assegnato. - Se il client Bridge è nuovo (non hai mai effettuato l’accesso a Tableau Cloud), viene assegnato al pool predefinito. **Se viene fornito un ID del pool** - Se viene fornito l’ID del pool ed è corretto, il client Bridge viene assegnato al pool denominato. - Se l’ID del pool fornito è errato: - Se il client Bridge non è registrato, viene assegnato al pool predefinito. - Se il client Bridge è registrato, lo stato del client rimane invariato, indipendentemente dal fatto che appartenga a un pool denominato, a un pool predefinito o sia non assegnato. #### Trovare l’ID del pool Per trovare l’ID del pool, passa alla pagina Impostazioni > Bridge e fai clic sul nome del pool. Ad esempio: ![](/tableau/next/it-it/online/it-it/Img/bridge_pool_id.png) ## Aggiornamento del client Bridge per Linux Rimanere aggiornati all’ultima versione di Bridge assicura di poter sfruttare le ultime funzioni e correzioni incluse in ogni nuova versione del client Bridge. Non è possibile eseguire un upgrade sul posto per il contenitore. Devi invece creare una nuova immagine del contenitore con i file binari Bridge più recenti e quindi aggiungere il client Bridge al pool affiancato alla versione precedente. Dopo aver convalidato la funzionalità, rimuovi il client Bridge precedente. Segui questa procedura: 1. Installa e configura il nuovo client Tableau Bridge come documentato nelle sezioni precedenti. 2. Aggiungi il nuovo client Bridge al pool pertinente. Consulta [Configurare i pool](https://help.tableau.com/v0.0/online/it-it/to_enable_bridge_live_connections.htm). 3. Monitora lo stato di integrità dei processi Bridge per convalidarne la stabilità prima di procedere alla fase successiva. 4. Rimuovi il/i client Bridge precedente/i dal pool. Apri il pool, identifica il computer client da rimuovere e fai clic su **Elimina**. 5. Attendi il completamento del processo di timeout dell’aggiornamento dell’estrazione sul client Bridge. Il timeout predefinito è di 24 ore. Per maggiori informazioni, consulta [dataSourceRefreshSettings](https://help.tableau.com/v0.0/online/it-it/to_sync_change_computer_site.htm#dataSourceRefreshSettings). 6. Una volta trascorso il periodo di timeout dell’aggiornamento, puoi rimuovere l’istanza precedente del client Bridge. ## Risoluzione dei problemi ### Installazione di versioni precedenti Se si installano versioni precedenti di Bridge per Linux, è necessario eseguire un comando diverso per avviare il worker. Per le versioni 2024.2 e precedenti, avvia il worker con il comando `TabBridgeClientWorker` e non con il comando `run-bridge.sh`. Tutte le opzioni del comando sono uguali a quelle documentate sopra in [Fase 4. Eseguire il contenitore Bridge](#runBridgeContainer). Ad esempio:  /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" ### Errore di avvio del worker In alcuni casi, dopo aver eseguito il comando `run-bridge.sh` verrà visualizzato il seguente errore: `Missing log in parameters. Aborting the attempt to start service worker.` Nella maggior parte dei casi, rieseguire il comando con le opzioni originali e l'opzione `-e` risolve il problema. L'opzione `-e` esegue il servizio worker Bridge in primo piano. Se stai eseguendo il client Bridge in modalità background e viene visualizzato un errore di avvio, verifica che tutti i parametri di input includano i percorsi dei file richiesti. Ad esempio, in modalità background, il contesto utente non viene fornito per risolvere il percorso del file token. ### Utilizzo dei file di log I file di log sono archiviati nella cartella `My_Tableau_Bridge_Repository/Logs` dell’utente. Per salvare i log in una cartella `tmp` , esegui questo comando: docker container run --volume /tmp/bridge\_logs:/root/Documents/My\_Tableau\_Bridge\_Repository/Logs -it bridge\_final /bin/bash In questo esempio, il percorso è specificato da /tmp/bridge\_logs. L’utilizzo del comando Docker semplifica il salvataggio dei file di log ed evita di dover copiare manualmente i file di log di Bridge dal contenitore al file system locale. ### Errore del driver MySQL Se `LC_MESSAGES` non è impostato con impostazioni locali `UTF-8`, potresti riscontrare problemi di lettura e visualizzazione. Puoi modificare il file `/etc/profile` o riavviare il worker utilizzando il comando seguente: LC\_ALL=en\_US.UTF-8 /opt/tableau/tableau\_bridge/bin/run-bridge.sh -e ### Il client Bridge si arresta in modo imprevisto a causa della scadenza del token di accesso personale Quando un token di accesso personale (PAT) scade, il client Bridge si disconnette da Tableau Cloud e potrebbe causare l'arresto del contenitore. Dal client Bridge puoi verificare se il tuo PAT è scaduto eseguendo il comando Avvia in primo piano. Se il PAT non è abilitato, verrà visualizzato il seguente errore: `The client credentials are invalid. To complete the request, reset the credentials, and sign in to the Tableau Bridge client.` Se sei il proprietario originale del PAT, puoi anche verificare se il PAT è scaduto visitando Gestisci impostazioni account in Tableau Cloud. Per risolvere il problema, sarà necessario generare un nuovo PAT e seguire le fasi sopra indicate, [Fase 4. Eseguire il contenitore Bridge](#runBridgeContainer). ### Errori di timeout di estrazioni incorporate e connessioni live incorporate Alla versione 24.3 di Bridge per Linux sono stati apportati miglioramenti significativi a livello di prestazioni degli estratti incorporati e delle connessioni live incorporate. Se si verificano errori di timeout nelle versioni precedenti, si consiglia di eseguire l'aggiornamento alla versione 24.3 di Bridge per Linux. Se il problema persiste, pubblica l'origine dati separatamente rispetto alla cartella di lavoro.