Help bij Tableau Server op Linux

Beperkingen voor Tableau Server in een container

• Tableau Server in een container ondersteunt alleen licentieactivering met behulp van Server ATR. Offline activering met Server ATR wordt ondersteund in 2023.1 en later. Deze functionaliteit is beschikbaar in containers, maar vereist extra stappen en goedkeuring. Als u Tableau Server in een container wilt uitvoeren in een niet-verbonden of offline omgeving, neem dan contact op met uw accountvertegenwoordiger voor meer informatie.
• Tableau Server in een container ondersteunt momenteel de RMT-agent (Resource Monitoring Tool) niet.
• Kerberos wordt niet ondersteund in Tableau Server in een container.

De set-up-tool voor Tableau Server in een container

De set-up-tool voor Tableau Server in een container, build-image, bouwt een aangepaste afbeelding van Tableau Server in een container van een Tableau .rpm-installatieprogramma en de meegeleverde configuratiebestanden.

De set-up-tool gebruikt een Tableau Server-installatieprogramma, uw stuurprogramma's en andere artefacten als invoer en maakt een Docker-afbeelding. Wanneer de build-image-tool correct wordt gebruikt, zal de nieuw gegenereerde afbeelding de gewenste artefacten hebben geïnstalleerd.

Ondersteunde distributies voor het bouwen

Installatie

De set-up-tool voor Tableau Server in een container wordt geleverd als een tarball. U moet de inhoud van het gecomprimeerde bestand uitpakken. Hier is een voorbeeld waarbij ervan wordt uitgegaan dat de set-up-tool voor Tableau Server in een container zich in uw huidige directory bevindt:

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

Hiermee wordt een nieuwe directory gemaakt, tableau-server-container-setup-tool-<VERSION> met het build-image-script dat u gebruikt om de tool uit te voeren.

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

De tool gebruiken

Er is een uitvoerbaar script in de set-up-tool genaamd build-image. Als u dit uitvoert met de -h-optie wordt de Help weergegeven:

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

Basisvoorbeeld van gebruik:

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

Het uitvoeren van de opdracht zonder artefacten of een installatiescript werkt wel, maar doet eigenlijk niets, omdat er geen extra resources naar de oorspronkelijke afbeelding van Tableau Server in een container worden gekopieerd of geïnstalleerd.

Indeling

Tableau biedt alleen documentatie en ondersteuning voor Tableau Server-containers die op Linux worden uitgevoerd. Tableau biedt geen documentatie of ondersteuning voor containersystemen zoals Kubernetes of Docker Swarm. Kubernetes kan echter wel worden gebruikt om Tableau Server in een container te implementeren. Raadpleeg ons door de community ondersteunde GitHub-project voor resources en begeleiding bij het implementeren van Tableau-containers in Kubernetes: https://github.com/tableau/tableau-server-in-kubernetes(Link wordt in een nieuw venster geopend).

De afbeelding aanpassen

Omgevingsvariabelen instellen tijdens het bouwen

Een subset van omgevingsvariabelen waarmee de afbeelding kan worden aangepast, kan alleen worden ingesteld wanneer de afbeelding wordt gebouwd. Dit omvat gebruiker, groep en andere eigenschappen waarvoor root-machtigingen vereist zijn binnen de container. Root-acties zijn niet standaard beschikbaar tijdens runtime. Daarnaast kan het handig zijn om bepaalde omgevingsvariabelen al tijdens het bouwen van de afbeelding in te bouwen, zodat ze niet telkens opnieuw ingesteld hoeven te worden als de afbeelding wordt uitgevoerd. Al deze omgevingsvariabelen kunnen worden ingesteld door een omgevingsbestand door te geven aan het build-image-script.

Omgevingsbestand

Het omgevingsbestand kan worden doorgegeven aan het build-image-script met behulp van het -e-argument. Het bestand moet voldoen aan dit formaat:

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

Voorbeeldgebruik:

Maak een omgevingsbestand met de juiste indeling:

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

Geef het bestand door aan de image-builder:

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

Omgevingsvariabelen

Elke omgevingsvariabele kan in het omgevingsbestand worden ingesteld. Bekijk het gedeelte Omgevingsvariabelen voor de volledige lijst.

Omgevingsvariabelen die tijdens het bouwen worden ingesteld, kunnen alleen worden ingesteld wanneer dit script wordt uitgevoerd om de afbeelding te bouwen:

Stuurprogramma's, certificaten en andere bestanden

De Tableau Server-afbeelding wordt niet geleverd met vooraf geïnstalleerde dataconnectors of stuurprogramma's. U moet een bash-configuratiescript maken dat het build-image-script instrueert om de dataconnectors te installeren die Tableau Server nodig heeft. Dit zijn de stappen die u hiervoor zou moeten nemen:

1. Zorg ervoor dat de set-up-tool voor Tableau Server in een container correct is geïnstalleerd.

2. Download het stuurprogramma van de Tableau-pagina met stuurprogramma's: https://www.tableau.com/nl-nl/support/drivers(Link wordt in een nieuw venster geopend).

3. Kopieer het gedownloade stuurprogrammabestand naar de directory customer-files in de set-up-tool voor Tableau Server in een container.

   De directory customer-files wordt gekopieerd naar de docker-afbeelding. Deze bevindt zich in het volgende pad in de container: /docker/customer-files

4. Bewerk het bestand in de set-up-tool voor Tableau Server in een container customer-files/setup-script om Docker te vertellen hoe het stuurprogramma geïnstalleerd moet worden.

   Het script is slechts een uitvoerbaar bash-bestand dat wordt uitgevoerd wanneer de Docker-afbeelding wordt gebouwd. (Technisch gezien kan het gebruikt worden om willekeurige acties in de afbeelding uit te voeren, inclusief het instellen van de omgeving, configuratie, etc.)

   Het script wordt uitgevoerd in de container. Houd er dus rekening mee dat de opdrachten moeten werken wanneer ze worden uitgevoerd in de afbeelding van Tableau Server in een container.

   Als u bijvoorbeeld een stuurprogramma met de naam mydriver.rpm wilt installeren, schrijft u het volgende in setup-script:

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

Tableau-beheerweergaven

Voor Tableau-beheerweergaven moet het PostgreSQL-stuurprogramma zijn geïnstalleerd. Als u van plan bent deze weergaven te gebruiken, moet u de bovenstaande stappen volgen en het PostgreSQL-stuurprogramma installeren. Zie Beheerweergaven voor meer informatie over beheerweergaven.

Voorbeelden van implementatieconfiguraties

Docker

Basisgebruik van Tableau Server in een container

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

Basisgebruik van Tableau Server in een container met geautomatiseerde initiële beheerdersgebruiker

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>

Alleen TSM-modus

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

Basisgebruik van meerdere knooppunten

Eerste knooppunt

Optie 1: Gebruik dit als de serverconfiguratie (CONFIG_FILE) een topologie met meerdere knooppunten specificeert:

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>

Optie 2: Gebruik dit als u een implementatie met meerdere knooppunten wilt, zelfs als de serverconfiguratie geen topologie met meerdere knooppunten specificeert:

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>

Extra knooppunt

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>

Datagebruik externaliseren

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>

Basisgebruik van Eerste container

Eerste 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>

Container uitvoeren

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

Basisherstel van back-up met één knooppunt

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-samenstelling

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>