Ajuda do Tableau Server no Linux

Limitações para o Tableau Server em um Contêiner

• O Tableau Server em um contêiner oferece suporte apenas à ativação de licença usando o Server ATR. A ativação offline usando o Server ATR é compatível com 2023.1 e versões posteriores. Esta funcionalidade está disponível em Contêineres, mas requer etapas extras e aprovação. Se você precisar executar o Tableau Server em um contêiner em um ambiente isolado ou off-line, entre em contato com o representante da sua conta para obter mais informações.
• O Tableau Server em um Contêiner atualmente não é compatível com o agente da Resource Monitoring Tool (RMT).
• O Kerberos não é compatível com o Tableau Server em um Contêiner.

Ferramenta de configuração Tableau Server em um Contêiner

O Tableau Server em uma Ferramenta de configuração de contêiner, build-image, cria uma imagem personalizada de Tableau Server em um Contêiner de um Instalador do Tableau .rpm e os arquivos de configuração fornecidos.

A ferramenta de Configuração usa uma imagem de contêiner do Tableau Server e artefatos do cliente como entrada e produz uma imagem do Docker. Quando usada corretamente, a ferramenta build-image recém-gerada instala os artefatos desejados.

Distribuições com suporte para criação

Instalação

A ferramenta de configuração Tableau Server em um Contêiner é fornecida como um tarball. É necessário extrair o conteúdo do arquivo compactado. Este é um exemplo que pressupõe que o arquivo da ferramenta de configuração Tableau Server em um Contêiner está no diretório atual:

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

Isso cria um novo diretório, tableau-server-container-setup-tool-<VERSION> com o script build-image que você usa para executar a ferramenta.

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

Instruções de uso da ferramenta

Há um script executável na ferramenta de configuração chamado build-image. Executá-lo com a opção -h exibe a ajuda:

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

Exemplo básico de uso:

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

A execução do comando, sem fornecer os artefatos ou um script de configuração funciona, mas não faz nada porque não copiaria ou instalaria os recursos adicionais na imagem de Contêiner original do Tableau Server.

Orquestração

O Tableau fornece apenas documentação e suporte para contêineres do Tableau Server em execução no Linux. O Tableau não fornece documentação ou suporte para sistemas de orquestração de contêineres como Kubernetes ou Docker Swarm. O Kubernetes pode, no entanto, ser usado para implantar o Tableau Server em um Contêiner. Para obter recursos e orientação sobre a implantação de Contêineres do Tableau no Kubernetes, consulte nosso projeto GitHub com suporte da comunidade: https://github.com/tableau/tableau-server-in-kubernetes(O link abre em nova janela) .

Personalização da imagem

Definição de variáveis de ambiente em tempo de criação

Um subconjunto de variáveis de ambiente que podem personalizar sua imagem só pode ser definido quando a imagem é criada. Isso inclui usuário, grupo e outras propriedades que requerem privilégio de root dentro do contêiner. As ações raiz não estão disponíveis por padrão no tempo de execução. Além disso, pode ser útil embutir certas variáveis de ambiente na imagem no momento da criação para que não tenham que ser definidas toda vez que a imagem for executada. Todas essas variáveis de ambiente podem ser definidas passando um arquivo de ambiente para o script de imagem de criação.

Arquivo de ambiente

O arquivo de ambiente pode ser passado para o script de imagem de criação usando o argumento -e. O arquivo deve estar de acordo com este formato:

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

Exemplo de uso:

Crie um arquivo de ambiente com o formato correto:

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

Passe o arquivo para o criador de imagens

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

Variáveis de ambiente

Qualquer variável de ambiente pode ser definida no arquivo de ambiente. Confira a seção Variáveis de ambiente para ver a lista completa.

As variáveis de ambiente de tempo de criação só podem ser definidas quando este script é executado para construir a imagem:

Drivers, certificados e outros arquivos

A imagem do Tableau Server não vem com conectores de dados ou drivers pré-instalados. Você precisará criar um script de configuração bash que instruirá o script build-image para instalar os conectores de dados de que o Tableau Server precisará. Estas são as etapas que você executaria:

1. Certifique-se de que o Tableau Server em uma ferramenta de configuração de Contêiner esteja instalado corretamente

2. Baixe o driver na página do driver do Tableau: https://www.tableau.com/en-us/support/drivers(O link abre em nova janela)

3. Copie o arquivo de driver baixado no diretório de arquivos do cliente no Tableau Server em uma ferramenta de configuração de Contêiner.

   O diretório customer-files será copiado para a imagem do docker. Ele estará localizado no seguinte caminho dentro do contêiner:/docker/customer-files

4. Edite o arquivo no Tableau Server em uma ferramenta de configuração de contêiner customer-files/setup-script para dizer ao Docker como instalar o driver.

   O script é apenas um arquivo bash executável que é executado quando a imagem Docker é construída. (Tecnicamente, pode ser usado para executar qualquer ação arbitrária na imagem, incluindo configuração do ambiente, configuração etc.)

   O script será executado dentro do contêiner, portanto, esteja ciente de que os comandos devem funcionar quando executados dentro do Tableau Server em uma imagem de contêiner.

   Por exemplo, se você deseja instalar um driver chamado mydriver.rpm”, grave-o em: setup-script:

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

Exibições administrativas do Tableau

As exibições administrativas do Tableau exigem que o driver PostgreSQL seja instalado. Se você planeja usar essas visualizações, precisará seguir as etapas acima e instalar o driver PostgreSQL. Para obter mais informações sobre exibições administrativas, consulte Exibições administrativas

Exemplos de configuração de implantação

Docker

Uso básico do Tableau Server em um Contêiner

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

Uso básico do Tableau Server em um Contêiner com Usuário 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>

Único modo do TSM

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

Uso básico de vários nós

Nó inicial

Opção 1: use se a configuração do servidor (CONFIG_FILE ) especifica uma topologia de vários nós:

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>

Opção 2: use se desejar uma implantação de vários nós, mesmo se a configuração do servidor não especificar a topologia de vários nós:

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>

Nó 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 o uso de dados

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 do init-container

Contêiner Init

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>

Contêiner de execução

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

Restauração básica do nó único de backup

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>