Hjälp för Tableau Server på Linux

Begränsningar för Tableau Server i en behållare

• Tableau Server i en behållare stöder endast licensaktivering med hjälp av Server ATR. Offlineaktivering med Server ATR stöds i 2023.1 och senare. Denna funktion är tillgänglig i behållare men kräver extra steg och godkännande. Om du behöver köra Tableau Server i en behållare i en frånkopplad miljö eller offlinemiljö kontaktar du din kontorepresentant för mer information.
• Tableau Server i en container stöder för närvarande inte RMT-agenten (Resource Monitoring Tool).
• Kerberos stöds inte i Tableau Server i en container.

Tableau Server i ett installationsverktyg för behållare

Tableau Server i ett installationsverktyg för behållare, build-image, bygger en anpassad Tableau Server i en container-avbildning från ett Tableau installationsprogram, .rpm och de medföljande konfigurationsfilerna.

Installationsverktyget tar ett Tableau Server-installationsprogram och dina drivrutiner och andra artefakter som indata och skapar en Docker-avbildning. När verktyget build-image används korrekt kommer den nyligen genererade bilden att ha installerat de önskade artefakterna.

Stödda distributioner för byggnad

Installation

Tableau Server i ett installationsverktyg för behållare levereras som en komprimerad fil. Du måste extrahera innehållet i den komprimerade filen. Här är ett exempel som antar att Tableau- servern i ett arkiv med inställningsverktyg för behållare finns i din nuvarande katalog:

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

Detta skapar en ny katalog, tableau-server-container-setup-tool-<VERSION> med skriptet build-image som du använder för att köra verktyget.

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

Hur man använder verktyget

Det finns ett körbart skript i installationsverktyget som heter build-image. Om du kör det här med alternativet -h visas hjälpen:

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

Grundläggande exempel på användning:

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

Att köra kommandot utan att tillhandahålla artefakter eller ett installationsskript kommer att fungera, men gör egentligen ingenting eftersom det inte skulle kopiera eller installera några ytterligare resurser i den ursprungliga Tableau Server i en container-avbildning.

Orkestrering

Tableau tillhandahåller endast dokumentation och stöd för Tableau Server-behållare som körs på Linux. Tableau tillhandahåller inte dokumentation eller stöd för behållarorkestreringssystem som Kubernetes eller Docker Swarm. Kubernetes kan dock användas för att distribuera Tableau Server i en container. För resurser och vägledning om hur du distribuerar Tableau-behållare i Kubernetes, se vårt community-stödda GitHub-projekt: https://github.com/tableau/tableau-server-in-kubernetes(Länken öppnas i ett nytt fönster).

Anpassa bilden

Ställa in miljövariabler vid byggtid

En delmängd av miljövariabler som kan anpassa din bild kan endast ställas in när bilden byggs. Detta inkluderar användare, grupp och andra egenskaper som kräver rotprivilegier inuti behållaren. Rotåtgärder är inte tillgängliga som standard vid körning. Dessutom kan det vara användbart att baka in vissa miljövariabler i bilden vid byggtiden så att de inte behöver ställas in varje gång bilden körs. Alla dessa miljövariabler kan ställas in genom att skicka in en miljöfil till byggbildsskriptet.

Miljöfil

Miljöfilen kan skickas till byggbildsskriptet med argumentet -e. Filen måste överensstämma med detta format:

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

Exempel på användning:

Skapa en miljöfil med rätt format:

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

Skicka filen till bildbyggaren

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

Miljövariabler

Alla miljövariabler kan ställas in i miljöfilen. Ta en titt på avsnittet Miljövariabler för att se hela listan.

Miljövariabler för byggtid kan bara ställas in när skriptet körs för att bygga bilden:

Drivrutiner, certifikat och andra filer

Tableau Server-bilden levereras inte med förinstallerade dataanslutningar eller drivrutiner. Du måste skapa ett bash installationsskript som kommer att instruera skriptet build-image att installera de dataanslutningar som Tableau Server behöver. Det här är stegen du skulle följa:

1. Se till att Tableau Server i ett installationsverktyg för behållare är korrekt installerat

2. Ladda ner drivrutinen från sidan Tableau drivrutiner: https://www.tableau.com/sv-se/support/drivers(Länken öppnas i ett nytt fönster)

3. Kopiera den nedladdade drivrutinfilen till kundfilskatalogen i Tableau Server i ett installationsverktyg för behållare.

   customer-files Katalogen kopieras till Docker-avbildningen. Den kommer att placeras i följande sökväg inuti behållaren: /docker/customer-files

4. Redigera filen i Tableau Server i ettinstallationsverktyg för behållare customer-files/setup-script för att tala om för Docker hur drivrutinen ska installeras.

   Skriptet är bara en körbar bash-fil som körs när Docker-avbildningen byggs. (Tekniskt sett kan den användas för att utföra godtyckliga åtgärder i bilden, inklusive miljöinställning, konfiguration, osv.)

   Skriptet kommer att köras inuti behållaren så kom ihåg att kommandona måste fungera när de körs inuti Tableau Server i en container-avbildning.

   Om du till exempel vill installera en drivrutin som heter mydriver.rpm skriver du detta i setup-script:

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

Tableau administratörsvyer

Tableau administratörsvyer kräver att PostgreSQL-drivrutinen är installerad. Om du planerar att använda dessa vyer måste du följa stegen ovan och installera PostgreSQL-drivrutinen. Mer information om administratörsvyer finns i Administrativa vyer

Exempel på konfiguration för driftsättning

Docker

Grundläggande användning av Tableau Server i en container

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

Grundläggande användning av Tableau Server i en container med automatisk första administratörsanvändare

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>

Endast TSM-läge

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

Grundläggande användning med flera noder

Ursprunglig nod

Alternativ 1: Använd detta om serverkonfigurationen (CONFIG_FILE) föreskriver en topologi med flera noder:

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>

Alternativ 2: Använd detta om du vill ha en konfiguration med flera noder även om serverkonfigurationen inte föreskriver en topologi med flera noder:

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>

Ytterligare nod

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>

Externalisera dataanvändningen

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>

Grundläggande användning av Init-container

Init-behållare

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>

Körningsbehållare

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

Grundläggande återställning från enkel säkerhetskopieringsnod

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>