Linux 版 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，build-image，會透過 Tableau .rpm 安裝程式和提供的設定檔在容器映像中建立自訂 Tableau Server。

設定工具會將 Tableau Server 安裝程式以及您的驅動程式和其他成品作為輸入，並建立 Docker 映像。若正確使用 build-image 工具，新產生的映像將已安裝所需的成品。

支援的建立發行版

安裝

容器中的 Tableau Server 設定工具會以 tarball 形式提供。需要擷取壓縮檔的內容。以下範例假設容器中的 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" : "accept",
"title" : "<value>",
"phone" : "<value>",
"company" : "<value>",
"state" : "<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(連結在新視窗開啟)。

自訂映像

在組建時設定環境變數

可以自訂映像的環境變數子集只能在組建映像時設定。這包括在容器內需要根目錄權限的使用者、群組和其他屬性。預設情況下，根目錄動作在執行階段不可用。此外，在組建時將某些環境變數製作到映像中也很有用，這樣就不必在每次執行映像時都進行設定。所有這些環境變數都可以透過將環境檔案傳遞給 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 setup-script 來指示 build-image 指令碼安裝 Tableau Server 所需的資料連接器。將採取的步驟如下：

1. 確保已正確安裝容器中的 Tableau Server 設定工具

2. 從 Tableau 驅動程式頁面下載驅動程式：https://www.tableau.com/zh-tw/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>

Init 容器基本使用方式

Init 容器

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>