Ayuda de Tableau Server en Linux

Límites de Tableau Server en un contenedor

• Tableau Server en un contenedor solo admite la activación de licencias mediante Server ATR. La activación sin conexión mediante Server ATR se admite en 2023.1 y versiones posteriores. Esta funcionalidad está disponible en Contenedores pero requiere aprobación y pasos adicionales. Si necesita ejecutar Tableau Server en un contenedor en un entorno aislado o sin conexión, póngase en contacto con su representante de cuentas para obtener más información.
• Actualmente, Tableau Server en un contenedor no es compatible con el agente de la Resource Monitoring Tool (RMT).
• Kerberos no es compatible con Tableau Server en un contenedor.

La herramienta de configuración de Tableau Server en un contenedor

La imagen de creación de la herramienta de configuración de Tableau Server en un contenedor, build-image, crea una imagen personalizada de Tableau Server en un contenedor a partir de un instalador de RPM (.rpm) de Tableau y los archivos de configuración proporcionados.

La herramienta de configuración toma un instalador de Tableau Server y sus controladores junto a otros artefactos como entrada y genera una imagen de Docker. Cuando se utiliza correctamente la herramienta build-image, la imagen recién generada tendrá instalados los artefactos deseados.

Distribuciones admitidas para la creación

Instalación

La herramienta de configuración de Tableau Server en un contenedor se proporciona como un tarball. Tendrá que extraer el contenido del archivo comprimido. A continuación se muestra un ejemplo que supone que el archivo de la herramienta de configuración de Tableau Server en un contenedor se encuentra en el directorio actual:

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

Esto crea un nuevo directorio, tableau-server-container-setup-tool-<VERSION> con el script build-image que utiliza para ejecutar la herramienta.

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

Utilizar la herramienta

Hay un script ejecutable en la herramienta de configuración llamado build-image. Al ejecutarlo con la opción l-h, aparece la ayuda:

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

Uso básico de ejemplo:

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

Ejecutar el comando sin proporcionar artefactos o un script de configuración funciona, pero no hace nada porque no estaría copiando ni instalando ningún recurso adicional en la imagen original de Tableau Server en un contenedor.

Organización

Tableau solo proporciona documentación y soporte para contenedores de Tableau Server que se ejecutan en Linux. Tableau no proporciona documentación ni soporte para sistemas de organización de contenedores como Kubernetes o Docker Swarm. Sin embargo, Kubernetes se puede usar para implementar Tableau Server en un contenedor. Para obtener recursos y orientación sobre la implementación de contenedores de Tableau en Kubernetes, consulte nuestro proyecto de GitHub respaldado por la comunidad: https://github.com/tableau/tableau-server-in-kubernetes(El enlace se abre en una ventana nueva).

Personalización de la imagen

Establecer variables de entorno en el momento de la creación

Un subconjunto de variables de entorno que pueden personalizar su imagen solo se puede configurar cuando se ha creado la imagen. Esto incluye usuario, grupo y otras propiedades que requieren privilegios raíz dentro del contenedor. Las acciones raíz no están disponibles de forma predeterminada en tiempo de ejecución. Además, puede ser útil incluir ciertas variables de entorno en la imagen en el momento de la creación para que no tengan que configurarse cada vez que se ejecuta la imagen. Todas estas variables de entorno se pueden configurar al pasar un archivo de entorno al script de creación de imagen.

Archivo de entorno

El archivo de entorno se puede pasar al script de creación de imagen mediante el argumento -e. El archivo debe ajustarse a este formato:

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

Ejemplo de uso:

Cree un archivo de entorno con el formato correcto:

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

Pase el archivo al generador de imágenes

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

Variables de entorno

Cualquier variable de entorno se puede configurar en el archivo de entorno. Eche un vistazo a la sección Variables de entorno para ver la lista completa.

Las variables de entorno de tiempo de creación solo se pueden configurar cuando se ejecuta este script para crear la imagen:

Controladores, certificados y otros archivos

La imagen de Tableau Server no incluye controladores o conectores de datos previamente instalados. Deberá crear un script de configuración Bash que mande al script build-image instalar los conectores de datos que necesitará Tableau Server. Estos son los pasos que debe seguir:

1. Asegúrese de que la herramienta de configuración de Tableau Server en un contenedor esté instalada correctamente.

2. Descargue el controlador de la página de controladores de Tableau: https://www.tableau.com/es-es/support/drivers(El enlace se abre en una ventana nueva).

3. Copie el archivo del controlador descargado en el directorio de archivos del cliente en la herramienta de configuración de Tableau Server en un contenedor.

   El directorio customer-files se copiará en la imagen de Docker. Estará ubicado en la siguiente ruta dentro del contenedor:/docker/customer-files.

4. Edite el archivo en la herramienta de configuración de Tableau Server en un contenedor customer-files/setup-script para decirle a Docker cómo instalar el controlador.

   El script es solo un archivo Bash ejecutable que se ejecuta cuando se crea la imagen de Docker. (Técnicamente, se puede usar para realizar cualquier acción arbitraria en la imagen, incluida la configuración del entorno, la configuración, etc.).

   El script se ejecutará dentro del contenedor, así que tenga en cuenta que los comandos deben funcionar cuando se ejecutan dentro de la imagen de Tableau Server en un contenedor.

   Por ejemplo, si desea instalar un controlador denominado mydriver.rpm es posible que desee escribirlo en setup-script:

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

Vistas administrativas de Tableau

Las vistas administrativas de Tableau requieren la instalación del controlador PostgreSQL. Si planea usar estas vistas, deberá seguir los pasos anteriores e instalar el controlador PostgreSQL. Para obtener más información sobre las vistas administrativas, consulte Vistas administrativas .

Ejemplos de configuración de la implementación

Docker

Uso básico de Tableau Server en un contenedor

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

Uso básico de Tableau Server en un contenedor con usuario administrador inicial automatizado

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>

Modo solo TSM

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

Uso básico de varios nodos

Nodo inicial

Opción 1: use esto si la configuración del servidor (CONFIG_FILE ) especifica una topología de varios nodos:

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>

Opción 2: utilice esta opción si desea una implementación de varios nodos incluso si la configuración del servidor no especifica la topología de varios nodos:

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>

Nodo adicional

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>

Externalizar el uso de datos

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>

Uso básico de 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>

Ejecutar contenedor

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

Restauración básica a partir de una copia de seguridad de nodo único

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>