Hilfe zu Tableau Server für Linux

Beschränkungen für Tableau Server in einem Container

• Tableau Server in einem Container unterstützt nur die Lizenzaktivierung mit Server ATR. Die Offline-Aktivierung mit Server ATR wird ab 2023.1 unterstützt. Diese Funktionalität ist zwar in Containern verfügbar, erfordert jedoch zusätzliche Schritte und Genehmigung. Wenn Sie Tableau Server in einem Container in einer Air-Gap- oder Offline-Umgebung ausführen müssen, wenden Sie sich für weitere Informationen an Ihren Kundenbetreuer.
• Tableau Server in einem Container unterstützt derzeit den Resource Monitoring Tool (RMT)-Agent nicht.
• Kerberos wird in Tableau Server in einem Container nicht unterstützt.

Einrichtungstool für Tableau Server in einem Container

Das Einrichtungstool für Tableau Server in einem Container build-image erstellt ein benutzerdefiniertes Image von Tableau Server in einem Container aus einem Tableau-Installationsprogramm (.rpm) und den bereitgestellten Konfigurationsdateien.

Das Einrichtungstool verwendet ein Tableau Server-Installationsprogramm sowie Ihre Treiber und andere Artefakte als Eingaben und erstellt ein Docker-Image. Wenn das build-image-Tool richtig verwendet wird, verfügt das neu erzeugte Image über die gewünschten installierten Artefakte.

Unterstützte Distributionen für das Erstellen

Installation

Das Einrichtungstool für Tableau Server in einem Container wird als Tar-Archiv bereitgestellt. Sie müssen den Inhalt der komprimierten Datei extrahieren. In dem nachfolgend gezeigten Beispiel wird davon ausgegangen, dass sich das Archiv mit dem Einrichtungstool für Tableau Server in einem Container in Ihrem aktuellen Verzeichnis befindet:

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

Dadurch wird ein neues tableau-server-container-setup-tool-<VERSION>-Verzeichnis mit dem build-image-Skript erstellt, das Sie zum Ausführen des Tools verwenden.

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

Verwendung des Tools

Es gibt ein ausführbares Skript in dem Einrichtungstool namens build-image. Wenn Sie dieses mit der Option -h ausführen, wird eine Hilfe angezeigt:

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

Beispiel für die grundlegende Verwendung:

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

Der Befehl kann zwar ohne die Angabe von Artefakten oder eines Einrichtungsskripts ausgeführt werden, bewirkt dann aber nichts, da keine zusätzlichen Ressourcen in das ursprüngliche "Tableau Server in einem Container"-Image kopiert oder installiert werden.

Orchestrierung

Tableau bietet nur Dokumentation und Support für Tableau Server-Container, die unter Linux ausgeführt werden. Für Container-Orchestrierungssysteme (wie Kubernetes oder Docker Swarm) stellt Tableau keine Dokumentation oder Unterstützung bereit. Kubernetes kann jedoch verwendet werden, um Tableau Server in einem Container bereitzustellen. Ressourcen und Anleitungen zum Bereitstellen von Tableau-Containern in Kubernetes finden Sie in unserem von der Community unterstützten GitHub-Projekt: https://github.com/tableau/tableau-server-in-kubernetes(Link wird in neuem Fenster geöffnet).

Anpassen des Images

Festlegen von Umgebungsvariablen zum Zeitpunkt der Erstellung des Images

Eine Teilmenge der Umgebungsvariablen, mit denen Sie Ihr Image anpassen können, kann nur beim Erstellen des Images festgelegt werden. Dazu gehören Benutzer-, Gruppen- und andere Eigenschaften, die Root-Rechte innerhalb des Containers erfordern. Root-Aktionen sind zur Laufzeit standardmäßig nicht verfügbar. Außerdem kann es nützlich sein, bestimmte Umgebungsvariablen zur Erstellungszeit in das Image einzubinden, damit sie nicht bei jedem Start des Images neu festgelegt werden müssen. Alle diese Umgebungsvariablen können festgelegt werden, indem eine Umgebungsdatei an das build-image-Skript übergeben wird.

Umgebungsdatei

Die Umgebungsdatei kann mithilfe des Arguments -e an das build-image-Skript übergeben werden. Die Datei muss das folgende Format haben:

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

Verwendungsbeispiel:

Erstellen Sie eine Umgebungsdatei im richtigen Format:

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

Übergeben Sie die Datei an den Image-Builder:

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

Umgebungsvariablen

In der Umgebungsdatei kann jede beliebige Umgebungsvariable festgelegt werden. Im Abschnitt "Umgebungsvariablen" finden Sie die vollständige Liste.

Umgebungsvariablen zum Zeitpunkt der Erstellung können nur festgelegt werden, wenn dieses Skript zum Erstellen des Images ausgeführt wird:

Treiber, Zertifikate und andere Dateien

Das Tableau Server-Image enthält keine vorinstallierten Daten-Connectoren oder Treiber. Sie müssen ein Bash-Setup-Skript erstellen, welches das build-image-Skript anweisen soll, die von Tableau Server benötigten Daten-Connectoren zu installieren. Dazu müssten Sie wie folgt vorgehen:

1. Stellen Sie sicher, dass das Einrichtungstool für Tableau Server in einem Container ordnungsgemäß installiert ist.

2. Laden Sie den Treiber von der Tableau-Treiberseite herunter: https://www.tableau.com/de-de/support/drivers(Link wird in neuem Fenster geöffnet).

3. Kopieren Sie die heruntergeladene Treiberdatei in das Verzeichnis "customer-files" im Einrichtungstool für Tableau Server in einem Container.

   Das Verzeichnis customer-files wird in das Docker-Image kopiert. Es befindet sich im folgenden Pfad innerhalb des Containers: /docker/customer-files.

4. Bearbeiten Sie die Datei customer-files/setup-script im Einrichtungstool für Tableau Server in einem Container, um Docker mitzuteilen, wie der Treiber installiert werden soll.

   Das Skript ist einfach nur eine ausführbare Bash-Datei, die beim Erstellen des Docker-Images ausgeführt wird. (Theoretisch können damit beliebige Aktionen im Image ausgeführt werden, wie die Einrichtung einer Umgebung, die Konfiguration usw.).

   Das Skript wird im Container ausgeführt. Beachten Sie also, dass die Befehle funktionieren müssen, wenn sie innerhalb des Images von Tableau Server in einem Container ausgeführt werden.

   Wenn Sie beispielsweise einen Treiber mit dem Namen "mydriver.rpm" installieren möchten, müssen Sie Folgendes in setup-script schreiben:

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

Tableau-Verwaltungsansichten

Für Tableau-Verwaltungsansichten muss der PostgreSQL-Treiber installiert sein. Wenn Sie diese Ansichten verwenden möchten, müssen Sie die oben aufgeführten Schritte durchführen und den PostgreSQL-Treiber installieren. Weitere Informationen zu Verwaltungsansichten finden Sie unter Verwaltungsansichten .

Beispiele für Bereitstellungskonfigurationen

Docker

Grundlegende Verwendung von Tableau Server in einem Container

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

Grundlegende Verwendung von Tableau Server in einem Container mit automatisiertem ursprünglichem Administratorbenutzer

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>

Nur TSM-Modus

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

Grundlegende Verwendung mehrerer Knotenpunkte

Anfangsknoten

Option 1: Verwenden Sie Folgendes, wenn die Serverkonfiguration (CONFIG_FILE) eine Topologie mit mehreren Knoten vorgibt:

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: Verwenden Sie Folgendes, wenn Sie eine Bereitstellung mit mehreren Knoten wünschen, auch wenn die Serverkonfiguration keine Topologie mit mehreren Knoten vorgibt:

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>

Weiterer Knoten

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>

Externalisieren der Datennutzung

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>

Grundlegende Verwendung des Init-Containers

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>

Ausführen des Containers

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

Grundlegendes Wiederherstellen aus einer Einzelknotensicherung

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>