Guida di Tableau Server su Linux

Limitazioni per Tableau Server in un contenitore

• Tableau Server in un contenitore supporta solo l’attivazione della licenza tramite il servizio ATR del server. L’attivazione offline tramite l’ATR del server è supportata nella versione 2023.1 e successive. Questa funzionalità è disponibile nei contenitori ma richiede operazioni e approvazioni aggiuntive. Se devi eseguire Tableau Server in un contenitore in un ambiente air gapped o offline, contatta il rappresentante del tuo account per ulteriori informazioni.
• Tableau Server in un contenitore attualmente non supporta l’agente di Resource Monitoring Tool (RMT).
• Kerberos non è supportato in Tableau Server in un contenitore.

Strumento di configurazione per Tableau Server in un contenitore

Lo strumento di configurazione per Tableau Server in un contenitore, build-image, crea un’immagine personalizzata di Tableau Server in un contenitore da un programma di installazione .rpm di Tableau e dai file di configurazione forniti.

Lo strumento di configurazione accetta come input il programma di installazione di Tableau Server, i driver e altri artefatti e crea una nuova immagine Docker. Se lo strumento build-image viene utilizzato correttamente, nella nuova immagine generata saranno installati gli artefatti desiderati.

Distribuzioni supportate per la compilazione

Installazione

Lo strumento di configurazione per Tableau Server in un contenitore viene fornito come file tarball. Sarà necessario estrarre il contenuto del file compresso. Di seguito è riportato un esempio che presuppone che l’archivio dello strumento di configurazione per Tableau Server in un contenitore si trovi nella directory corrente:

tar -xzf tableau-server-container-setup-tool-<VERSION>.tar.gz

Viene creata una nuova directory, tableau-server-container-setup-tool-<VERSION> con lo script build-image utilizzato per eseguire lo strumento.

{
"zip" : "<value>",
"country" : "<value>",
"city" : "<value>",
"last_name" : "<value>",
"industry" : "<value>",
"eula" : "accept",
"title" : "<value>",
"phone" : "<value>",
"company" : "<value>",
"state" : "<value>",
"department" : "<value>",
"first_name" : "<value>",
"email" : "<value>"
}

Come utilizzare lo strumento

Nello strumento di configurazione è disponibile uno script eseguibile denominato build-image. Eseguendo questo script con l’opzione -h, vengono visualizzate le informazioni della Guida:

./src/build-image -h
Usage: build-image --accepteula -i [INPUT_IMAGE_NAME] -o [OUTPUT_IMAGE_NAME] [optional arguments]
Creates new Tableau Server image with pre-installed database drivers, configuration, and instructions.
REQUIRED

--accepteula              Indicate that you have accepted the End User License Agreement (EULA).

The EULA is available in the EULA directory of this tool.

-i installer              Path to the Tableau Server installer.

OPTIONAL

-o output name            Tag of target generated Tableau Server image.

-e environment file       Optional environment file to configuration overrides to docker image at build time.

-v setup tool version     Prints the Setup tool version.


-b base image version     Prints the default base image URL.

Esempio di utilizzo di base:

./build-image --accepteula -i tableau-server-image.rpm

È possibile eseguire il comando senza specificare artefatti o uno script di configurazione, tuttavia in tal caso non viene effettuata alcuna operazione, perché non viene eseguita la copia o l’installazione di risorse aggiuntive nell’immagine originale di Tableau Server in un contenitore.

Orchestrazione

Tableau fornisce solo documentazione e supporto per i contenitori Tableau Server in esecuzione su Linux. Tableau non fornisce documentazione o supporto per sistemi di orchestrazione dei contenitori come Kubernetes o Docker Swarm. Kubernetes può tuttavia essere utilizzato per distribuire Tableau Server in un contenitore. Per risorse e indicazioni sulla distribuzione di contenitori Tableau in Kubernetes, fai riferimento al progetto GitHub supportato dalla community: https://github.com/tableau/tableau-server-in-kubernetes(Il collegamento viene aperto in una nuova finestra).

Personalizzazione dell’immagine

Impostazione delle variabili di ambiente in fase di compilazione

Un sottoinsieme di variabili d’ambiente che consentono di personalizzare l’immagine può essere impostato solo quando l’immagine è stata creata. Questo include l’utente, il gruppo e altre proprietà che richiedono privilegi root all’interno del contenitore. Le azioni root non sono disponibili per impostazione predefinita in fase di esecuzione. Inoltre, può essere utile inserire determinate variabili di ambiente nell’immagine in fase di compilazione, in modo che non debbano essere impostate ogni volta che viene eseguita l’immagine. Tutte queste variabili di ambiente possono essere impostate passando un file di ambiente allo script build-image.

File di ambiente

Il file di ambiente può essere passato allo script build-image tramite l’argomento -e. Il file deve essere conforme a questo formato:

<KEY>=<VALUE>
<KEY>=<VALUE>

Esempio di utilizzo:

Crea un file di ambiente con il formato corretto:

UNPRIVILEGED_TABLEAU_UID=1012
UNPRIVILEGED_TABLEAU_GID=1020
TABLEAU_USERNAME=myuser
TABLEAU_PASSWORD=pw

Passa il file allo strumento di compilazione delle immagini

./build-image --accepteula -i tableau-server-2020-3.x86_64.rpm -e <path-to-env-file>

Variabili di ambiente

Qualsiasi variabile di ambiente può essere impostata nel file di ambiente. Consulta la sezione Variabili di ambiente per vedere l’elenco completo.

Le variabili di ambiente in fase di compilazione possono essere impostate solo quando viene eseguito questo script per creare l’immagine:

Driver, certificati e altri file

L’immagine di Tableau Server non viene fornita con connettori dati o driver preinstallati. Dovrai creare uno script di installazione Bash che comunicherà allo script build-image di installare i connettori dati necessari per Tableau Server. Questi sono i passaggi necessari:

1. Assicurati che lo strumento di configurazione per Tableau Server in un contenitore sia installato correttamente

2. Scarica il driver dalla pagina dei driver di Tableau: https://www.tableau.com/it-it/support/drivers(Il collegamento viene aperto in una nuova finestra)

3. Copia il file del driver scaricato nella directory customer-files dello strumento di configurazione per Tableau Server in un contenitore.

   La directory customer-files verrà copiata nell’immagine Docker. Sarà disponibile nel seguente percorso all’interno del contenitore:/docker/customer-files

4. Modifica il file nello strumento di configurazione per Tableau Server in un contenitore customer-files/setup-script per comunicare a Docker come installare il driver.

   Lo script è semplicemente un file Bash eseguibile che viene eseguito durante la compilazione dell’immagine Docker. Tecnicamente, può essere utilizzato per eseguire qualsiasi azione arbitraria nell’immagine, come l’impostazione dell’ambiente, la configurazione e così via.

   Lo script verrà eseguito all’interno del contenitore, quindi tieni presente che i comandi devono funzionare quando vengono eseguiti all’interno dell’immagine di Tableau Server in un contenitore.

   Se ad esempio vuoi installare un driver denominato mydriver.rpm, puoi scrivere questo in setup-script:

   yum install -y /docker/customer-files/mydriver.rpm

Viste amministrative di Tableau

Le viste amministrative di Tableau richiedono l’installazione del driver PostgreSQL. Se prevedi di utilizzare queste viste, dovrai seguire i passaggi precedenti e installare il driver PostgreSQL. Per maggiori informazioni sulle viste amministrative, consulta Viste amministrative

Esempi di configurazione della distribuzione

Docker

Utilizzo di base di Tableau Server in un contenitore

docker run \
-e LICENSE_KEY=<key>
-p 8080:8080
-d <Tableau Server in a Container image ID or tag>

Utilizzo di base di Tableau Server in un contenitore con l’utente amministratore iniziale automatizzato

docker run \
-e LICENSE_KEY=<key> \
-e TABLEAU_USERNAME=<myadmin> \
-e TABLEAU_PASSWORD_FILE=/etc/tableau-admin-secret \
-v <full-path-to-pw-file>:/etc/tableau-admin-secret \
-p 8080:8080 -d <Tableau Server in a Container image ID or tag>

Modalità solo TSM

docker run \
-e TSM_ONLY=1 \
-p 8080:8080 -d <Tableau Server in a Container image ID or tag>

Utilizzo di base multi-nodo

Nodo iniziale

Opzione 1: utilizza questa opzione se la configurazione del server (CONFIG_FILE) specifica una topologia multi-nodo:

docker run \
-v <network-shared-directory>:/docker/config/bootstrap \
-v <full-path-to-config-file>:/docker/config/config.json:ro \
-e LICENSE_KEY=<key> \
-p 8080:8080 -p 8800-9000:8800-9000 -p 27000-27010:27000-27010 \
--hostname=<name-of-host-machine> \
-d <Tableau Server in a Container image ID or tag>

Opzione 2: utilizza questa opzione se desideri una distribuzione multi-nodo anche se la configurazione del server non specifica la topologia multi-nodo:

docker run \
-v <network-shared-directory>:/docker/config/bootstrap \
-e LICENSE_KEY=<key> -e ALWAYS_WRITE_BOOTSTRAP_FILE=1 \
-p 8080:8080 -p 8800-9000:8800-9000 -p 27000-27010:27000-27010 \
--hostname=<name-of-host-machine> \
-d <Tableau Server in a Container image ID or tag>

Nodo aggiuntivo

docker run \
-v <network-shared-directory>:/docker/config/bootstrap \
-e BOOTSTRAP_INSTALL=1 \
-p 8080:8080 -p 8800-9000:8800-9000 \
--hostname=<name-of-host-machine> \
-d <Tableau Server in a Container image ID or tag>

Esternalizzare l’utilizzo dei dati

docker run \
-v <empty-data-dir>:/var/opt/tableau \
-e LICENSE_KEY=<key> \
--hostname=localhost \
-p 8080:8080 -d <Tableau Server in a Container image ID or tag>

Utilizzo di base dell’inizializzazione del contenitore

Inizializzazione del contenitore

docker run \
-v <empty-data-dir>:/var/opt/tableau \
-e LICENSE_KEY=<key> \
-e INIT_CONTAINER=1 \
--hostname=localhost \
-p 8080:8080 -d <Tableau Server in a Container image ID or tag>

Esecuzione del contenitore

docker run \
-v <empty-data-dir>:/var/opt/tableau \
--hostname=localhost \
-p 8080:8080 -d <Tableau Server in a Container image ID or tag>

Ripristino di base da backup con nodo singolo

docker run \
-v <full-path-to-backup-file>:/docker/config/backup/backup-file.tsbak \
-v <full-path-to-config-only-file>:/docker/config/config.json:ro \
-e LICENSE_KEY=<key> \
-p 8080:8080 -d <Tableau Server in a Container image ID or tag>

Docker-Compose

version: '3.2'
services:
    tableau-server:
         hostname: localhost
         volumes:
              - <your-tsm-command-file>:/docker/config/tsm-commands:ro
              - <your-config-file >:/docker/config/config.json:ro
         ports:
              - "8080:8080"
         image: ${IMAGE_NAME}
         environment:
              - LICENSE_KEY=<license-key>