ความช่วยเหลือ Tableau Server บน Linux

ข้อจำกัดของ Tableau Server ในคอนเทนเนอร์

• Tableau Server ในคอนเทนเนอร์รองรับเฉพาะการเปิดใช้งานใบอนุญาตโดยใช้ Server ATR เท่านั้น รองรับการเปิดใช้งานแบบออฟไลน์โดยใช้ Server ATR ในเวอร์ชัน 2023.1 และใหม่กว่า ฟังก์ชันนี้พร้อมให้ใช้งานในคอนเทนเนอร์ แต่ต้องมีขั้นตอนและการอนุมัติเพิ่มเติม หากคุณต้องการเรียกใช้ Tableau Server ในคอนเทนเนอร์ในสภาพแวดล้อมแบบตัดขาดจากระบบเครือข่ายหรือออฟไลน์ โปรดติดต่อตัวแทนบัญชีของคุณเพื่อขอข้อมูลเพิ่มเติม
• ปัจจุบัน Tableau Server ในคอนเทนเนอร์ไม่รองรับเอเจนต์ของ Resource Monitoring Tool (RMT)
• Tableau Server ในคอนเทนเนอร์ไม่รองรับ Kerberos

เครื่องมือตั้งค่า Tableau Server ในคอนเทนเนอร์

เครื่องมือตั้งค่า Tableau Server ในคอนเทนเนอร์ build-image สร้าง Tableau Server แบบกำหนดเองในอิมเมจคอนเทนเนอร์จากตัวติดตั้ง Tableau .rpm และไฟล์การกำหนดค่าที่ให้ไว้

เครื่องมือตั้งค่าใช้ตัวติดตั้ง Tableau Server และไดรเวอร์ของคุณ และอาร์ติแฟกต์อื่นๆ เป็นอินพุตและสร้างอิมเมจด็อกเกอร์ เมื่อใช้เครื่องมือ 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 ให้เอกสารกำกับและการสนับสนุนสำหรับคอนเทนเนอร์ Tableau Server ที่ทำงานบน Linux เท่านั้น Tableau ไม่ได้ให้เอกสารกำกับหรือการสนับสนุนสำหรับระบบการจัดระเบียบและผสมผสานคอนเทนเนอร์ เช่น Kubernetes หรือ Docker Swarm อย่างไรก็ตาม สามารถใช้ Kubernetes เพื่อปรับใช้ Tableau Server ในคอนเทนเนอร์ได้ สำหรับแหล่งข้อมูลและคำแนะนำในการปรับใช้คอนเทนเนอร์ Tableau ใน Kubernetes โปรดดู โครงการ GitHub ที่ที่สนับสนุนโดยชุมชนของเรา: https://github.com/tableau/tableau-server-in-kubernetes(ลิงก์จะเปิดในหน้าต่างใหม่)

การปรับแต่งอิมเมจ

การตั้งค่าตัวแปรสภาพแวดล้อม ณ เวลาสร้าง

คุณสามารถตั้งค่าชุดย่อยของตัวแปรสภาพแวดล้อมที่สามารถปรับแต่งอิมเมจของคุณได้เมื่อสร้างอิมเมจเท่านั้น ซึ่งรวมถึงผู้ใช้ กลุ่ม และคุณสมบัติอื่นๆ ที่ต้องการสิทธิ์รูทภายในคอนเทนเนอร์ การดำเนินการรูทไม่ได้มีให้ตามค่าเริ่มต้นที่รันไทม์ นอกจากนี้ อาจมีประโยชน์ในการอบตัวแปรสภาพแวดล้อมบางอย่างลงในอิมเมจ ณ เวลาสร้าง ดังนั้นจึงไม่ต้องตั้งค่าทุกครั้งที่ใช้งานอิมเมจ ตัวแปรสภาพแวดล้อมเหล่านี้ทั้งหมดสามารถตั้งค่าได้โดยการส่งผ่านไฟล์สภาพแวดล้อมไปยังสคริปต์ build-image

ไฟล์สภาพแวดล้อม

ไฟล์สภาพแวดล้อมสามารถส่งผ่านไปยังสคริปต์ build-image โดยใช้อาร์กิวเมนต์ -e ไฟล์ต้องเป็นไปตามรูปแบบนี้:

<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/th-th/support/drivers(ลิงก์จะเปิดในหน้าต่างใหม่)

3. คัดลอกไฟล์ไดรเวอร์ที่ดาวน์โหลดลงในไดเรกทอรี customer-files ใน Tableau Server ในเครื่องมือตั้งค่าคอนเทนเนอร์

   ไดเรกทอรี customer-files จะถูกคัดลอกไปยังอิมเมจด็อกเกอร์ ซึ่งจะอยู่ในเส้นทางต่อไปนี้ภายในคอนเทนเนอร์: /docker/customer-files

4. แก้ไขไฟล์ในเครื่องมือตั้งค่า Tableau Server ในคอนเทนเนอร์ customer-files/setup-script เพื่อบอกด็อกเกอร์ถึงวิธีการติดตั้งไดรเวอร์

   สคริปต์เป็นเพียงไฟล์ Bash ที่สามารถเรียกใช้งานได้ซึ่งจะดำเนินการเมื่อสร้างอิมเมจด็อกเกอร์ (ในทางเทคนิค สามารถใช้ในการดำเนินการที่กำหนดเองใดๆ ในอิมเมจ รวมถึงการตั้งค่าสภาพแวดล้อม การกำหนดค่า ฯลฯ)

   สคริปต์จะถูกเรียกใช้ภายในคอนเทนเนอร์ ดังนั้นโปรดระวังว่าคำสั่งจะต้องทำงานเมื่อดำเนินการภายใน Tableau Server ในอิมเมจคอนเทนเนอร์

   ตัวอย่างเช่น หากคุณต้องการติดตั้งไดรเวอร์ชื่อ mydriver.rpm คุณจะต้องเขียนสิ่งนี้ใน setup-script:

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

มุมมองสำหรับการดูแลระบบ Tableau

มุมมองการดูแลระบบ Tableau จำเป็นต้องติดตั้งไดรเวอร์ PostgreSQL หากคุณวางแผนที่จะใช้มุมมองเหล่านี้ คุณจะต้องทำตามขั้นตอนด้านบนและติดตั้งไดรเวอร์ PostgreSQL หากต้องการข้อมูลเพิ่มเติม เกี่ยวกับมุมมองการดูแลระบบ โปรดดู มุมมองสำหรับการดูแลระบบ

ตัวอย่างการกำหนดค่าการปรับใช้

ด็อกเกอร์

การใช้งานพื้นฐานของ 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>