Aide de Tableau Server sur Linux

Limitations de Tableau Server dans un conteneur

• Tableau Server dans un conteneur prend en charge l’activation de licences à l’aide du service ATR du serveur uniquement. L’activation hors ligne à l’aide du service ATR du serveur est prise en charge dans la version 2023.1 et versions ultérieures. Cette fonctionnalité est disponible dans les conteneurs mais nécessite des étapes et une approbation supplémentaires. Si vous devez exécuter Tableau Server dans un conteneur dans un environnement isolé ou hors ligne, contactez votre représentant de compte pour plus d’informations.
• Tableau Server dans un conteneur ne prend actuellement pas en charge l’agent Resource Monitoring Tool (RMT).
• Tableau Server dans un conteneur ne prend pas en charge Kerberos.

Outil d’installation de Tableau Server dans un conteneur

L’outil d’installation de Tableau Server dans un conteneur build-image crée une image personnalisée Tableau Server dans un conteneur à partir d’un programme d’installation .rpm de Tableau et des fichiers de configuration fournis.

L’outil d’installation prend un programme d’installation de Tableau Server ainsi que votre pilote et d’autres artefacts comme entrées et génère une image Docker. Lorsque l’outil build-image est utilisé correctement, l’image qui vient d’être générée installe les artefacts souhaités.

Distributions prises en charge pour la création

Installation

Cet outil est fourni sous forme d’archive. Vous devrez extraire le contenu du fichier compressé. Voici un exemple qui part de l’hypothèse que l’archive de l’outil d’installation de Tableau Server dans un conteneur se trouve dans votre répertoire actuel :

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

Cela crée un nouveau répertoire, tableau-server-container-setup-tool-<VERSION> avec le script build-image que vous utilisez pour exécuter l’outil.

{
"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>"
}

Comment utiliser l’outil

Un script exécutable intitulé build-image est inclus dans l’outil d’installation. Si vous exécutez ce script avec l’option -h, l’aide s’affiche :

./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.

Exemple d’utilisation de base :

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

La commande peut s’exécuter correctement même si vous ne fournissez pas d’artefacts, mais elle n’a aucun effet parce qu’aucune ressource supplémentaire n’est copiée ou installée sur l’image d’origine Tableau Server dans un conteneur.

Orchestration

Tableau fournit uniquement la documentation et l’assistance pour les conteneurs Tableau Server s’exécutant sous Linux. Tableau ne fournit pas de documentation ni de support pour les systèmes d’orchestration de conteneurs tels que Kubernetes ou Docker Swarm. Il est toutefois possible d’utiliser Kubernetes pour déployer Tableau Server dans un conteneur. Pour obtenir des ressources et des conseils sur le déploiement de conteneurs Tableau dans Kubernetes, reportez-vous à notre projet GitHub pris en charge par la communauté : https://github.com/tableau/tableau-server-in-kubernetes(Le lien s’ouvre dans une nouvelle fenêtre).

Personnalisation de l’image

Définition de variables d’environnement au moment de la création d’image

Un sous-ensemble de variables d’environnement permettant de personnaliser votre image ne peut être défini que lors de la création de l’image. Cela inclut l’utilisateur, le groupe et d’autres propriétés qui nécessitent le privilège root à l’intérieur du conteneur. Les actions racine ne sont pas disponibles par défaut au moment de l’exécution. De plus, il peut être utile d’intégrer certaines variables d’environnement dans l’image au moment de la création afin qu’elles n’aient pas à être définies à chaque exécution de l’image. Toutes ces variables d’environnement peuvent être définies en transmettant un fichier d’environnement au script build-image.

Fichier d’environnement

Le fichier d’environnement peut être transmis au script build-image à l’aide de l’argument -e. Le fichier doit être conforme à ce format :

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

Exemple d’utilisation :

Créez un fichier d’environnement au format correct :

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

Transmettez le fichier au générateur d’images

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

Variables d’environnement

Toute variable d’environnement peut être définie dans le fichier d’environnement. Consultez la liste complète dans la section Variables d’environnement.

Les variables d’environnement d’heure de création ne peuvent être définies que lorsque ce script est exécuté pour créer l’image :

Pilotes, certificats et autres fichiers

L’image Tableau Server n’est pas fournie avec des connecteurs de données ou des pilotes préinstallés. Vous devrez créer un script de configuration bash qui demandera au script build-image d’installer les connecteurs de données dont Tableau Server aura besoin. Voici les étapes à suivre :

1. Assurez-vous que l’outil d’installation de Tableau Server dans un conteneur est correctement installé

2. Téléchargez le pilote depuis la page des pilotes Tableau : https://www.tableau.com/fr-fr/support/drivers(Le lien s’ouvre dans une nouvelle fenêtre)

3. Copiez le fichier de pilote téléchargé dans le répertoire customer-files de l’outil d’installation de Tableau Server dans un conteneur.

   Le répertoire customer-files sera copié dans l’image docker. Il sera situé dans le chemin suivant à l’intérieur du conteneur : /docker/customer-files

4. Dans l’outil d’installation de Tableau Server dans un conteneur, modifiez le fichier customer-files/setup-script pour indiquer à Docker comment installer le pilote.

   Le script est simplement un fichier bash exécutable qui est exécuté lorsque l’image Docker est générée. (Techniquement, il peut être utilisé pour effectuer des actions arbitraires dans l’image, y compris l’installation de l’environnement, la configuration, etc.)

   Le script sera exécuté à l’intérieur du conteneur. Vous devez donc garder à l’esprit que les commandes doivent fonctionner lorsqu’elles sont exécutées dans l’image Tableau Server dans un conteneur.

   Par exemple, si vous souhaitez installer un pilote intitulé « mydriver.rpm », vous pouvez écrire ce script dans setup-script :

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

Vues administratives Tableau

Les vues administratives Tableau nécessitent l’installation du pilote PostgreSQL. Si vous prévoyez d’utiliser ces vues, vous devrez suivre les étapes ci-dessus et installer le pilote PostgreSQL. Pour plus d’informations sur les vues administratives, consultez Vues administratives .

Exemples de configuration de déploiement

Docker

Utilisation de base de Tableau Server dans un conteneur

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

Utilisation de base de Tableau Server dans un conteneur avec un utilisateur administrateur initial automatisé

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>

Mode TSM uniquement

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

Utilisation de base d’une topologie multinœud

Nœud initial

Option 1 : utilisez cette option si la configuration du serveur (CONFIG_FILE) spécifie une topologie multinœud :

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>

Option 2 : utilisez cette option si vous souhaitez un déploiement multinœud même si la configuration du serveur ne spécifie pas une topologie multinœud :

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>

Nœud supplémentaire

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>

Externaliser l’utilisation des données

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>

Utilisation de base d’init-container

Init Container

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>

Run Container

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

Restauration de base depuis une sauvegarde sur un seul nœud

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>