容器中的 Tableau Server - 使用设置工具

“容器中的 Tableau Server”的限制

• “容器中的 Tableau Server”仅支持使用服务器 ATR 激活许可证。不支持脱机激活。
• “容器中的 Tableau Server”当前不支持 Resource Monitoring Tool (RMT) 代理。
• “容器中的 Tableau Server”不支持 Kerberos。

“容器中的 Tableau Server”设置工具

“容器中的 Tableau Server”设置工具 build-image 可依据 Tableau .rpm 安装程序和提供的配置文件构建“容器中的 Tableau Server”自定义映像。

设置工具将 Tableau Server 安装程序和驱动程序以及其他项目作为输入，并创建 Docker 映像。当正确使用 build-image 工具时，新生成的映像将安装所需的项目。

支持的构建发行版

安装

“容器中的 Tableau Server”设置工具以压缩包形式提供。您将需要提取压缩文件的内容。下面是一个示例，该示例假定“容器中的 Tableau Server”设置工具存档位于当前目录中：

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

这将创建一个新目录 tableau-server-container-setup-tool-<VERSION>，其中包含用于运行工具的 build-image 脚本。

{
"zip" : "[value]",
"country" : "[value]",
"city" : "[value]",
"last_name" : "[value]",
"industry" : "[value]",
"eula" : "[value]",
"title" : "[value]",
"company_employees" : "[value]",
"phone" : "[value]",
"company" : "[value]",
"state" : "[value]",
"opt_in" : "[value]",
"department" : "[value]",
"first_name" : "[value]",
"email" : "[value]"
}

如何使用该工具

设置工具中有一个名为 build-image 的可执行脚本。使用 -h 选项运行此脚本将显示帮助：

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

基本示例用法：

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

在不提供项目或设置脚本的情况下运行该命令可以正常工作，但它不会执行任何操作，因为它不会将任何附加资源复制或安装到原始“容器中的 Tableau Server”映像中。

编排

Tableau 仅为在 Linux 上运行的 Tableau Server 容器提供文档和支持。Tableau 不为 Kubernetes 或 Docker Swarm 等容器编排系统提供文档或支持。但是，Kubernetes 可用于部署“容器中的 Tableau Server”。有关在 Kubernetes 中部署 Tableau 容器的资源和指南，请参见我们社区支持的 GitHub 项目：https://github.com/tableau/tableau-server-in-kubernetes。

自定义映像

构建时设置环境变量

一部分可以自定义映像的环境变量只能在构建映像时设置。包括在容器内需要 root 权限的用户、组和其他属性。默认情况下，root 操作在运行时不可用。此外，在构建时将某些环境变量引入到映像中也很有用，这样就不必在每次运行映像时都设置它们。所有这些环境变量都可以通过将环境文件传递给 build-image 脚本来设置。

环境文件

可以使用 -e 参数将环境文件传递给 build-image 脚本。该文件必须符合以下格式：

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

示例用法：

创建具有正确格式的环境文件：

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

将文件传递给映像构建器

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

环境变量

可以在环境文件中设置任何环境变量。查看“环境变量”部分以查看完整列表。

构建时环境变量只能在运行此脚本构建映像时设置：

驱动程序、证书和其他文件

Tableau Server 映像不附带预安装的数据连接器或驱动程序。您将需要创建一个 bash 设置脚本，用于指示 build-image 脚本安装 Tableau Server 将需要的数据连接器。以下是您将采取的步骤：

1. 确保“容器中的 Tableau Server”设置工具已正确安装

2. 从 Tableau 驱动程序页面下载驱动程序：https://www.tableau.com/zh-cn/support/drivers

3. 将下载的驱动程序文件复制到“容器中的 Tableau Server”设置工具中的 customer-files 目录中。

   customer-files 目录将被复制到 docker 映像中。它将位于容器内的以下路径中：/docker/customer-files

4. 在“容器中的 Tableau Server”设置工具中编辑文件 customer-files/setup-script，指示 Docker 如何安装驱动程序。

   该脚本只是一个可执行 bash 文件，在构建 Docker 映像时执行。（从技术上讲，它可用于在映像中执行任何任意操作，包括环境设置、配置和驱动程序更新或添加等。）

   该脚本将在容器内运行，因此请注意，在“容器中的 Tableau Server”映像内执行命令时，这些命令必须有效。

   举例来说，如果要安装名为 mydriver.rpm 的驱动程序，则您将在 setup-script 中编写此命令：

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

Tableau 管理视图

Tableau 管理视图需要安装 PostgreSQL 驱动程序。如果您计划使用这些视图，则需要按照上述步骤安装 PostgreSQL 驱动程序。有关管理视图的详细信息，请参见管理视图

部署配置举例

Docker

“容器中的 Tableau Server”基本用法

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

具有自动化初始管理员用户的“容器中的 Tableau Server”基本用法

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>

仅 TSM 模式

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

多节点基本用法

初始节点

选项 1：如果服务器配置 (CONFIG_FILE ) 指定多节点拓扑，则使用此选项：

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>

选项 2：如果您想要多节点部署，即使服务器配置未指定多节点拓扑，也可以使用此选项：

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>

附加节点

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>

外部化数据用法

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>

初始化容器基本用法

初始化容器

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>

运行容器

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

基本备份还原：单节点

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>