Tableau Server on Linux ヘルプ

Tableau Server in a Container に関する制限事項

• Tableau Server in a Container では、サーバー ATR を使用したライセンス認証のみをサポートします。Server ATR を使用したオフライン アクティベーションは、2023.1 以降でサポートされています。この機能はコンテナで利用できますが、追加の手順と承認が必要です。エアギャップ環境またはオフライン環境のコンテナで Tableau Server を実行する必要がある場合、詳細についてはアカウント担当者にお問い合わせください。
• Tableau Server in a Container では現在、Resource Monitoring Tool (RMT) エージェントはサポートされていません。
• Kerberos は、Tableau Server in a Container ではサポートされていません。

Tableau Server in a Container のセットアップ ツール

Tableau Server in a Container のセットアップ ツールで build-image を実行すると、Tableau .rpm インストーラーと提供されている構成ファイルから Tableau Server in a Container のカスタム イメージが構築されます。

セットアップ ツールでは、Tableau Server インストーラー、ドライバー、およびアーティファクトを入力として受け取り、Docker イメージを作成します。build-image ツールが適切に使用されると、新しく生成されたイメージによって目的のアーティファクトがインストールされます。

構築でサポートされているディストリビューション

インストール

Tableau Server in a Container のセットアップ ツールは、tarball として提供されます。圧縮ファイルの内容は抽出する必要があります。次に示すのは、Tableau Server in a Container のセットアップ ツールのアーカイブが現在のディレクトリにあると想定した例です。

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 in a Container のイメージにコピーされず、インストールもされないため、何も実行されません。

オーケストレーション

Tableau では、Linux で実行されている Tableau Server コンテナーのドキュメントとサポートのみが提供されます。Tableau では、Kubernetes や Docker Swarm などのコンテナー オーケストレーション システムのドキュメントやサポートは提供されていません。ただし、Kubernetes を使用して Tableau Server in a Container を展開することができます。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 セットアップ スクリプトを作成して、build-image スクリプトに Tableau Server に必要なデータ コネクターをインストールするよう指示する必要があります。以下のステップに従います。

1. Tableau Server in a Container のセットアップ ツールが正しくインストールされていることを確認する

2. Tableau ドライバー ページ https://www.tableau.com/en-us/support/drivers(新しいウィンドウでリンクが開く) からドライバーをダウンロードする

3. ダウンロードしたドライバー ファイルを、Tableau Server in a Container のセットアップ ツールの customer-files ディレクトリにコピーします。

   customer-files ディレクトリが Docker イメージにコピーされます。コンテナー内の次のパスに配置されます。/docker/customer-files

4. Tableau Server in a Container のセットアップ ツール　customer-files/setup-script　でファイルを編集し、Docker にドライバーのインストール方法を指示します。

   このスクリプトは、Docker イメージの構築時に実行される実行可能な bash ファイルです。(このファイルは、技術的には、環境のセットアップ、構成など、イメージ内の任意のアクションを実行するために使用できます。)

   このスクリプトはコンテナ行されるため、Tableau Server in a Container のイメージで実行するときにコマンドが機能する必要があることに注意してください。

   たとえば、"mydriver.rpm" という名前のドライバーをインストールする場合は、これを setup-script で次のように記述します。

   yum install -y /docker/customer-files/mydriver.rpm

Tableau 管理ビュー

Tableau 管理ビューでは、PostgreSQL ドライバーがインストールされている必要があります。これらのビューを使用する場合は、上記のステップに従って PostgreSQL ドライバーをインストールする必要があります。管理ビューの詳細については、管理ビュー を参照してください。

展開構成の例

Docker

Tableau Server in a Container の基本的な使用例

docker run \
-e LICENSE_KEY=<key>
-p 8080:8080
-d <Tableau Server in a Container image ID or tag>

自動化された初期管理ユーザーによる Tableau Server in a Container の基本的な使用例

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 の構成

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>