Tableau Server in een container – Snelle start

Inleiding

Tableau Server in een container is het eerste containergebaseerde serveraanbod van Tableau. Tableau Server in een container is een alles-in-één Tableau Server-instantie die wordt uitgevoerd in een Linux Docker-container. Met andere woorden: een afbeelding van Tableau Server in een container is een Docker-afbeelding die een volledige, zelfstandige Tableau Server-toepassing uitvoert. Tableau Server in een container is de eerste stap in ons proces om het uitvoeren van Tableau Server in containergebaseerde omgevingen mogelijk te maken. De eenvoudigste manier om het concept van Tableau Server in een container te begrijpen, is door het te zien als een virtuele machine waarop Tableau Server vooraf is geïnstalleerd. De afbeelding is gebaseerd op een UBI 8-afbeelding (CentOS 7 voor versie 2022.1 en lager) en voert supervisord uit (in plaats van systemd) in de container. Wanneer de container supervisord start, wordt er onmiddellijk geprobeerd om Tableau Server te initialiseren en te starten. Een groot deel van de documentatie hier beschrijft hoe u configuratie kunt bieden en automatisering kunt benutten, zodat u Tableau Server in Docker-omgevingen kunt uitvoeren.

Met de configuratietool van Tableau Server in een container-afbeelding kunt u container-afbeeldingen maken en aanpassen, zodat u aangepaste pakketten en artefacten kunt toevoegen. Een van de belangrijkste functies van de tool is het bouwen van de containerafbeelding en het installeren van aangepaste dataconnectors. Zie Tableau Server in een container – De set-up-tool gebruiken voor gedetailleerde informatie over het gebruik van de set-up-tool.

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.

Tableau Server in een container – Snelstartgids

In dit onderwerp worden alle stappen beschreven die nodig zijn om een snelle basisimplementatie van de afbeelding van Tableau Server in een container uit te voeren via de opdrachtregel. De hieronder beschreven configuratie geeft u het snelste en eenvoudigste pad naar Tableau Server op een Linux-installatie die in een container wordt uitgevoerd. Voor een diepgaandere bespreking van wat Tableau Server in een container te bieden heeft, zie De set-up-tool voor Tableau Server in een container en Afbeelding van Tableau Server in een container.

Belangrijk: Gebruik de volgende snelstartprocedure niet als een op zichzelf staand hulpmiddel voor de implementatie van Tableau Server in een productieomgeving.

Voordat u begint

Er zijn twee basisstappen vereist om Tableau Server in een container te gebruiken:

  1. De Docker-afbeelding bouwen

    Het bouwen van de Docker-afbeelding van Tableau Server in een container wordt alleen ondersteund op een RHEL-gebaseerd Linux-systeem (RHEL, CentOS of Amazon Linux 2). Het is misschien wel mogelijk om de afbeelding op andere Linux-distributies te bouwen, maar dit is momenteel niet getest en wordt niet ondersteund. Het maken van afbeeldingen op macOS wordt niet ondersteund. De gemaakte afbeelding is gebaseerd op een UBI 8-image (CentOS 7.x voor versie 2022.1 en lager).

    Docker-versie 18.09 of hoger moet op de host geïnstalleerd zijn om de containerafbeeldingen te kunnen bouwen. Over het algemeen raden wij aan om de nieuwste stabiele versie van Docker te gebruiken. Sommige Linux-distributies bieden alleen oudere versies van Docker aan in hun softwareopslagplaatsen. In dat geval moet u Docker mogelijk vanuit een andere bron installeren. Docker-versies ouder dan versie 18.09 bevatten niet de functies die vereist zijn voor Tableau Server in een container.

  2. De Docker-afbeelding uitvoeren

    Productiegebruik van Tableau Server in een container wordt alleen ondersteund op Linux. Voor verkennend prototyping- en testwerk zou elk systeem dat Linux-gebaseerde Docker-afbeeldingen kan uitvoeren, Tableau Server in een container-afbeeldingen moeten kunnen uitvoeren (ervan uitgaande dat het voldoet aan de hardware- en besturingssysteemvereisten zoals beschreven in Voor de installatie...).

    Voor het uitvoeren van Tableau Server in een container-afbeeldingen zijn dezelfde hardwarebronnen nodig als voor Tableau Server zelf. Voor productie-implementaties volgt u de aanbevelingen zoals beschreven in Aanbevelingen voor minimale productiehardware. Voor verkennend werk volgt u de aanbevelingen zoals beschreven in Minimale installatiehardwarevereisten. Als u implementeert in een openbare cloudomgeving, raadpleeg dan de links onderaan de pagina Minimale hardwarevereisten en aanbevelingen voor Tableau Server, voor gedetailleerde aanbevelingen over de grootte van instanties. Als u Docker Desktop op Windows of macOS gebruikt voor verkennend werk, houd er dan rekening mee dat de standaard resourcelimieten voor containers ver onder de minimumvereisten liggen en moeten worden verhoogd om de container succesvol te kunnen uitvoeren.

Opmerking: Tableau-ondersteuning kan u niet helpen bij problemen op niet-ondersteunde platforms of configuraties.

Bij de onderstaande stappen wordt ervan uitgegaan dat u een Linux-systeem hebt waarop Docker is geïnstalleerd en dat u zowel de set-up-tool voor Tableau Server in een container als een versiecompatibel RPM-installatieprogramma voor Tableau Server hebt gedownload.

  1. Pak de set-up-tool voor Tableau Server in een container uit.

    De set-up-tool voor Tableau Server in een container is beschikbaar als een tarball. Om het tar-bestand uit te pakken, gebruikt u de volgende opdracht:

    tar -xzf tableau-server-container-setup-tool-<VERSION>.tar.gz
  2. Bewerk het registratiebestand om uw unieke identificatiedata te verstrekken die nodig zijn om Tableau Server te registreren in overeenstemming met de licentieovereenkomst voor eindgebruikers. Het bestand, reg-info.json, dient als sjabloon voor uw vereiste, uniek identificeerbare registratiedata en bevindt zich in de hoofdmap van de set-up-tool voor Tableau Server in een container. Dit bestand wordt gebruikt om de Tableau Server-instantie te registreren die in de afbeelding wordt uitgevoerd. Het verstrekken van de juiste informatie zorgt ervoor dat het registratieproces correct verloopt.

    De veldwaarde eula is vooraf ingevuld met 'accepteren' om aan te geven dat u akkoord gaat met onze licentieovereenkomst voor eindgebruikers (EULA). U kunt de EULA bekijken in de EULA-map van de build-tool. Zoals beschreven in de EULA moet u bij het activeren van Tableau Server een uniek identificeerbare gebruikersregistratie verzenden. Wanneer u klaar bent met het bewerken van het registratiebestand, moeten de overige velden waarden bevatten die uw unieke informatie weerspiegelen. Dit bestand wordt gebruikt om de Tableau Server-instantie te registreren die in de afbeelding wordt uitgevoerd. Het verstrekken van de juiste informatie zorgt ervoor dat het registratieproces wordt voltooid en dat uw aanvraag voldoet aan de vereisten voor de licentieverlening.

    Opmerking: U moet de EULA accepteren om Tableau Server te kunnen gebruiken. Als u de EULA niet accepteert, kunt u Tableau Server niet uitvoeren.

    Dit is het registratiebestandsjabloon reg-info.json voordat u het bewerkt:

    {
    "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>"
    }
  3. Bouw de afbeelding van Tableau Server in een container.

    Voer het build-image-script uit in de set-up-tool voor Tableau Server in een container:

    ./build-image --accepteula -i <Tableau Server Installer>.rpm
  4. Voer de afbeelding van Tableau Server in een container uit

    1. Voer de opdracht om Docker uit te voeren uit met alle argumenten ingevuld. U moet de volgende informatie opgeven in de opdrachtregel:

      • Productcode of licentiesleutelbestand
      • Gebruikersnaam en wachtwoord voor een nieuw initieel beheerdersaccount (u gebruikt deze om u na het opstarten van Tableau Server aan te melden)
      • Een statische (interne) hostnaam voor de computer
      • Naam van de afbeelding van Tableau Server in een container
    2. Wanneer u deze informatie hebt verzameld, voert u de volgende Docker-opdracht uit op een host met minimale specificaties:

      docker run \
      -e LICENSE_KEY=<key> \
      -e TABLEAU_USERNAME=<username> \
      -e TABLEAU_PASSWORD=<password> \
      --hostname=<static (internal) name of host machine> \
      -p 8080:8080 -d <Tableau Server in a Container image ID or tag>
    3. Na 10-20 minuten is Tableau Server geïnitialiseerd.
  5. Open Tableau Server.

    Wanneer Tableau Server volledig is geïnitialiseerd, controleert u of de server correct werkt door een webbrowser te openen en naar http://<hostname>:8080 te gaan waarbij <hostname> de hostnaam is van de machine waarop de afbeelding wordt uitgevoerd.

Op dit punt zou u een actieve instantie van Tableau Server in een Docker-container moeten hebben. Voor meer geavanceerde en aangepaste implementaties kunt u de onderstaande documentatie gebruiken.

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=<static (internal) 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=<static (internal) 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=<static (internal) 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=<static (internal) name of host machine> \
-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=<static (internal) name of host machine> \
-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=<static (internal) name of host machine> \
-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>

 

 

Bedankt voor uw feedback.De feedback is verzonden. Dank u wel.