克隆 Tableau Server

Tableau Server 版本 2022.3 开始,新的 tsm 命令使您能够创建 Tableau Server 部署的配置和拓扑的副本,并使用该副本创建原始部署的精确复制副本。tsm settings clone 命令创建一组文件(“克隆有效负载”),其中包括设置、密文、配置和拓扑,包括正在使用的端口以及有关外部服务的信息。

安全注意事项

tsm settings clone 命令生成一组文件(“克隆有效负载”),其中包括由 Tableau Server 生成的所有密文以及服务器管理员在配置期间提供的密文,包括包含密钥对和证书的密钥存储。保持克隆有效负载和输出位置的安全对于安全性极其重要。为此,请执行以下操作:

  • 如果输出目录不存在,tsm 将创建该目录,并且只有运行 tsm settings clone 命令的用户才能访问该目录。
  • 如果运行该命令时输出目录存在,tsm 将确认它属于运行该命令的用户,并且只有该用户拥有权限。如果目录没有预期的权限,将显示一条消息:

    The output directory '<path/to/directory>' exists, but must be restricted to owner only.

克隆有效负载的限制

  • 所克隆的 Tableau Server 版本必须与所创建的版本相匹配。您不能使用来自旧版本的克隆有效负载来安装较新版本的 Server。

使用克隆命令创建 Tableau Server 的副本

创建 Tableau Server 的克隆副本是一个多步骤的过程,其中两个高级步骤是:

  1. 从您想要复制的 Tableau Server 安装创建克隆有效负载。
  2. 使用克隆有效负载安装 Tableau Server 的第二个部署。您负责匹配两个安装的拓扑、添加其他节点以匹配原始部署。

创建克隆有效负载

若要生成一组包含 Tableau Server 的配置和拓扑设置的文件(克隆有效负载),请使用 tsm settings clone 命令。该命令采用单个参数,即应在其中保存这一组文件的输出目录:

tsm settings clone --output-directory <output_directory>

创建克隆有效负载后,您可以在安装与源安装具有相同配置和拓扑的 Tableau Server 新实例时使用该有效负载。

使用克隆有效负载创建 Tableau Server 的副本

  1. 在初始节点上安装 Tableau Server 软件包。不要初始化 Tableau Server安装 Tableau Server 软件包

  2. 运行 initialize-tsm 脚本,并指定由 tsm settings clone 命令创建的克隆有效负载的路径:

    sudo /opt/tableau/tableau_server/packages/scripts.<version>/initialize-tsm --accepteula --clone-artifact-dir=<path-to-clone-directory>

    注意:Tableau Server 以非特权 tableau 用户身份运行,因此管理员必须确保 tableau 用户具有对克隆目录和文件的读取访问权限。在大多数情况下,这需要向“其他人”授予对克隆目录内容的读取权限以及对所有父目录的执行权限(用于遍历)。

  3. (可选)安装附加节点,以匹配原始(克隆)Tableau Server 安装的节点数。如果原始安装有附加节点,则需要执行此步骤。仅安装附加节点以匹配原始安装上的数量。

    1. 在初始节点上生成引导程序文件:
    2. 在每个附加节点上安装 Tableau Server 并运行 initialize-tsm 脚本:

      安装和配置附加节点

  4. 在初始节点上,完成初始化:

    tsm initialize

容器

在容器中使用 Tableau Server 时克隆功能很方便,尤其是在与外部存储库和存储一起使用时。克隆命令允许管理员快速重新创建 Tableau Server 环境并重新连接外部服务。

注意:重新创建 Tableau Server 群集的步骤可能会有所不同,这取决于所使用的容器技术(例如:docker、docker compose 或 Kubernetes)。

以下信息专门针对使用 docker 的情况。启动初始节点容器时,您需要使用 CLONE_ARTIFACT_DIR 环境变量指定克隆有效负载的位置。

例如:

docker run \
-v <path-to-clone-directory>:/docker/custom-clone-path \
-e CLONE_ARTIFACT_DIR=/docker/custom-clone-path \
-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>

重新创建“容器中的 Tableau Server”的多节点部署

如果您的克隆有效负载来自多节点 Tableau Server 部署,您的初始容器将等待其他节点加入群集。

使用克隆时在群集中设置附加节点与在常规部署中添加节点相同,并且需要:

  • 装载卷以在节点之间共享引导程序文件
  • 指定 ALWAYS_WRITE_BOOTSTRAP_FILEBOOTSTRAP_INSTALL 环境变量

在容器部署中创建多节点环境的详细步骤可以在这里找到:多节点“容器中的 Tableau Server”

注意:克隆有效负载只需要在群集中的初始节点上装载和使用。您无需在附加节点上装载克隆有效负载。

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