容器中的 Tableau Server - 快速入门

简介

“容器中的 Tableau Server”是 Tableau 的第一款基于容器的服务器产品。“容器中的 Tableau Server”是在 Linux Docker 容器内运行的一体化 Tableau Server 实例。换句话说，“容器中的 Tableau Server”是运行整个自包含 Tableau Server 应用程序的 Docker 映像。“容器中的 Tableau Server”是我们为在基于容器的环境中运行的 Tableau Server 提供支持的许多步骤中的第一个步骤。了解“容器中的 Tableau Server”概念的最简单方法是将其看作一个预装了 Tableau Server 的 VM。映像以 UBI 8 映像（适用于版本 2022.1 及更低版本的 CentOS 7）为基础，并在容器内运行 supervisord（而不是 systemd）。容器启动 supervisord 后，将立即尝试初始化和启动 Tableau Server。此处的大部分文档旨在描述如何提供配置和利用自动化，以便您可以在 Docker 环境中运行 Tableau Server。

“容器中的 Tableau Server”映像设置工具可帮助您创建和自定义容器映像以包括自定义包和项目。该工具的主要功能之一是构建容器映像并安装自定义数据连接器。有关使用设置工具的详细信息，请参见容器中的 Tableau Server - 使用设置工具。

“容器中的 Tableau Server”的限制

“容器中的 Tableau Server”仅支持使用服务器 ATR 激活许可证。2023.1 及更高版本支持使用服务器 ATR 脱机激活。此功能在容器中可用，但需要额外的步骤和批准。如果您需要在隔离网络的环境或脱机环境中运行“容器中的 Tableau Server”，请联系您的客户代表了解详细信息。
“容器中的 Tableau Server”当前不支持 Resource Monitoring Tool (RMT) 代理。
“容器中的 Tableau Server”不支持 Kerberos。

容器中的 Tableau Server - 快速入门指南

本主题提供使用命令行执行“容器中的 Tableau Server”映像的基本快速启动部署所需的所有步骤。本文描述的配置用途是提供最快、最简单的途径以在容器内运行 Linux 版 Tableau Server 安装。若要更深入地了解“容器中的 Tableau Server”所提供的功能，请参见“容器中的 Tableau Server”设置工具和“容器中的 Tableau Server”映像。

重要信息：不要将以下快速入门程序用作将 Tableau Server 部署到生产环境中的独立资源。

开始之前

使用“容器中的 Tableau Server”需要两个基本步骤：

构建 Docker 映像
仅在基于 RHEL 的 Linux 系统（RHEL、CentOS 或 Amazon Linux 2）上支持构建“容器中的 Tableau Server”Docker 映像。在任何其他 Linux 发行版上进行构建是也许可行，但目前未经测试且不受支持。不支持在 macOS 上构建映像。创建的映像基于 UBI 8映像（对于版本 2022.1 及更低版本为 CentOS 7.x）。
您必须在主机上安装 Docker 版本 18.09 或更高版本才能构建容器映像。一般来说，我们推荐使用最新的稳定版 Docker。某些 Linux 发行版仅在其软件存储库中提供旧版本的 Docker，在这种情况下，您可能需要从其他来源安装 Docker。低于版本 18.09 的 Docker 版本不包含“容器中的 Tableau Server”所需的功能。
运行 Docker 映像
仅支持在 Linux 上将“容器中的 Tableau Server”用作生产用途。对于探索性原型设计和测试工作，任何可以运行基于 Linux 的 Docker 映像的系统都应该能够运行“容器中的 Tableau Server”映像（假设它满足安装之前...中概述的硬件和操作系统要求）。
“容器中的 Tableau Server”映像需要与 Tableau Server 本身相同的硬件资源才能运行。对于生产部署，请遵循最低生产硬件推荐配置中显示的建议。对于探索性工作，请遵循最低安装硬件要求所示的建议。如果您在公共云环境中进行部署，请参见Tableau Server 的最低硬件要求和推荐配置页面底部的链接，了解有关实例大小调整的详细建议。如果在 Windows 或 macOS 上使用 Docker Desktop 进行探索性工作，请注意容器的默认资源限制设置为远低于最低要求，需要增加才能成功运行容器。

注意：Tableau 支持无法帮助解决有关不受支持的平台或配置的问题。

下面的步骤假设您有一个安装了 Docker 的 Linux 系统，并且您已经在容器设置工具和版本兼容的 Tableau Server RPM 安装程序中下载了 Tableau Server。

解压缩“容器中的 Tableau Server”设置工具
“容器中的 Tableau Server”设置工具以压缩包形式提供。若要解包 tar 存档，只需使用以下命令：
```
tar -xzf tableau-server-container-setup-tool-<VERSION>.tar.gz
```
编辑注册文件以提供您根据最终用户许可协议注册 Tableau Server 所需的唯一标识信息。文件 reg-info.json 用作必需、唯一可识别的注册信息的模板，位于“容器中的 Tableau Server”设置工具的顶级目录中。此文件用于注册在映像中运行的 Tableau Server 实例。提供准确的信息将确保注册过程正确完成。
eula 字段值预先填入“接受”，表示您接受我们的最终用户许可协议 (EULA)。您可以在构建工具的 EULA 目录中查看 EULA。如 EULA 中所述，您必须在激活 Tableau Server 时提交唯一可识别的用户注册。完成注册文件编辑后，其他字段应具有反映您的独特信息的值。此文件用于注册在映像中运行的 Tableau Server 实例。提供准确的信息将确保注册过程完成，并且您提交的内容符合许可授予的要求。
注意：您必须接受 EULA 才能使用 Tableau Server。如果您不接受 EULA，则无法运行 Tableau Server。
编辑前的注册文件模板 reg-info.json：
```
{
"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>"
}
```
构建“容器中的 Tableau Server”映像
在“容器中的 Tableau Server”设置工具中运行 build-image 脚本
```
./build-image --accepteula -i <Tableau Server Installer>.rpm
```
运行“容器中的 Tableau Server”映像
1. 执行 Docker run 命令，并填写所有参数。您需要在命令中提供以下信息：
  - 许可证密钥或许可证密钥文件
  - 新初始管理员帐户的用户名和密码（您将在启动后使用此帐户登录 Tableau Server）
  - 计算机的静态（内部）主机名
  - “容器中的 Tableau Server”映像的名称
2. 收集此信息后，在最低规格的主机上运行以下 docker 命令：
```
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. 10-20 分钟后，Tableau 服务器将初始化。
访问 Tableau Server
Tableau Server 完全初始化后，通过打开 Web 浏览器并转到 http://<hostname>:8080 来检查服务器是否正常运行，其中 <hostname> 是运行映像的机器的主机名。

此时，Docker 容器中应该有 Tableau Server 正在运行的实例。对于更高级的自定义的部署，请使用以下文档来指导您。

部署配置举例

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=<static (internal) 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=<static (internal) 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=<static (internal) 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=<static (internal) name of host machine> \
-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=<static (internal) name of host machine> \
-p 8080:8080 -d <Tableau Server in a Container image ID or tag>

运行容器

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>

基本备份还原：单节点

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>

回到顶部

感谢您的反馈!

您的反馈已成功提交。谢谢!

Linux 版 Tableau Server 帮助