容器中的 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 桌面進行探索性工作，請注意容器的預設資源限制設定遠低於最低要求，需要增加資源才能成功執行容器。

附註：Tableau 支援無法協助解決不受支援的平台或設定上的問題。

下方的步驟假設您具有已安裝 Docker 的 Linux 系統，並且您已下載容器中的 Tableau Server 設定工具以及版本相容的 Tableau Server RPM 安裝程式。

解壓縮容器中的 Tableau Server 設定工具
容器中的 Tableau Server 設定工具會以 tarball 形式提供。要解壓縮 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 Server 將進行初始化。
存取 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>

Init 容器基本使用方式

Init 容器

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 說明