Linux 기반 Tableau Server 도움말

Tableau Server 컨테이너 제한 사항

• Tableau Server 컨테이너는 서버 ATR을 사용한 라이선스 활성화만 지원합니다. 서버 ATR을 사용한 오프라인 활성화는 2023.1 이상에서 지원됩니다. 이 기능은 컨테이너에서 사용할 수 있지만 추가 단계와 승인이 필요합니다. Air-Gapped 환경이나 오프라인 환경에서 Tableau Server 컨테이너를 실행해야 하는 경우 계정 담당자에게 자세한 내용을 문의하십시오.
• Tableau Server 컨테이너는 현재 RMT(Resource Monitoring Tool) 에이전트를 지원하지 않습니다.
• 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

이렇게 하면 도구를 실행하는 데 사용하는 build-image 스크립트를 사용하여 새 디렉터리 tableau-server-container-setup-tool-<VERSION>가 만들어집니다.

{
"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

파일을 Image Builder로 전달합니다.

./build-image --accepteula -i tableau-server-2020-3.x86_64.rpm -e <path-to-env-file>

환경 변수

환경 파일에서 모든 환경 변수를 설정할 수 있습니다. 전체 목록을 보려면 환경 변수 섹션을 살펴보십시오.

빌드 타임 환경 변수는 이 스크립트를 실행하여 이미지를 작성하는 경우에만 설정할 수 있습니다.

드라이버, 인증서 및 기타 파일

Tableau Server 이미지는 사전 설치된 데이터 커넥터 또는 드라이버와 함께 제공되지 않습니다. Tableau Server에 필요한 데이터 커넥터를 설치하도록 build-image 스크립트에 지시하는 bash setup-script를 만들어야 합니다. 다음 단계를 수행하십시오.

1. Tableau Server 컨테이너 설정 도구가 제대로 설치되어 있는지 확인합니다.

2. Tableau 드라이버 페이지 https://www.tableau.com/ko-kr/support/drivers(링크가 새 창에서 열림)에서 드라이버를 다운로드합니다.

3. 다운로드한 드라이버 파일을 Tableau Server 컨테이너 설정 도구의 customer-files 디렉터리에 복사합니다.

   customer-files 디렉터리가 docker 이미지로 복사됩니다. 이는 컨테이너 내부의 /docker/customer-files 경로에 있습니다.

4. Tableau Server 컨테이너 설정 도구 customer-files/setup-script의 파일을 편집하여 Docker에 드라이버 설치 방법을 지시합니다.

   스크립트는 Docker 이미지가 작성될 때 실행되는 bash 실행 파일입니다. (기술적으로 환경 설정, 구성 등을 포함하여 이미지에서 임의의 동작을 수행하는 데 사용할 수 있습니다.)

   스크립트는 컨테이너 내부에서 실행되므로 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>

컨테이너 초기화 기본 사용법

컨테이너 초기화

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>