克隆 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 的克隆副本是一个多步骤的过程,其中两个高级步骤是:
- 从您想要复制的 Tableau Server 安装创建克隆有效负载。
- 使用克隆有效负载安装 Tableau Server 的第二个部署。您负责匹配两个安装的拓扑、添加其他节点以匹配原始部署。
创建克隆有效负载
若要生成一组包含 Tableau Server 的配置和拓扑设置的文件(克隆有效负载),请使用 tsm settings clone
命令。该命令采用单个参数,即应在其中保存这一组文件的输出目录:
tsm settings clone --output-directory <output_directory>
创建克隆有效负载后,您可以在安装与源安装具有相同配置和拓扑的 Tableau Server 新实例时使用该有效负载。
使用克隆有效负载创建 Tableau Server 的副本
在初始节点上安装 Tableau Server 软件包。不要初始化 Tableau Server。安装 Tableau Server 软件包
运行
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 用户具有对克隆目录和文件的读取访问权限。在大多数情况下,这需要向“其他人”授予对克隆目录内容的读取权限以及对所有父目录的执行权限(用于遍历)。
(可选)安装附加节点,以匹配原始(克隆)Tableau Server 安装的节点数。如果原始安装有附加节点,则需要执行此步骤。仅安装附加节点以匹配原始安装上的数量。
- 在初始节点上生成引导程序文件:
在每个附加节点上安装 Tableau Server 并运行 initialize-tsm 脚本:
在初始节点上,完成初始化:
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_FILE
和BOOTSTRAP_INSTALL
环境变量
在容器部署中创建多节点环境的详细步骤可以在这里找到:多节点“容器中的 Tableau Server”。
注意:克隆有效负载只需要在群集中的初始节点上装载和使用。您无需在附加节点上装载克隆有效负载。