容器中的 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 需要兩個基本步驟:

  1. 組建 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 所需的功能。

  2. 執行 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 安裝程式。

  1. 解壓縮容器中的 Tableau Server 設定工具

    容器中的 Tableau Server 設定工具會以 tarball 形式提供。要解壓縮 tar 封存,只需使用以下命令:

    tar -xzf tableau-server-container-setup-tool-<VERSION>.tar.gz
  2. 編輯註冊檔案以提供根據終端使用者授權合約註冊 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>"
    }
  3. 組建容器中的 Tableau Server 映像

    在容器中的 Tableau Server 設定工具中執行 build-image 指令碼

    ./build-image --accepteula -i <Tableau Server Installer>.rpm
  4. 執行容器中的 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 將進行初始化。
  5. 存取 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>

 

 

感謝您的意見反應!已成功提交您的意見回饋。謝謝!