คู่มือการนำ Tableau Server ไปใช้งานในองค์กร

ตัวอย่าง: ทำให้การปรับใช้โครงสร้างพื้นฐานของ AWS เป็นแบบอัตโนมัติด้วย Terraform

ส่วนนี้จะอธิบายวิธีกำหนดค่าและเรียกใช้ Terraform เพื่อปรับใช้สถาปัตยกรรมอ้างอิง EDG ใน AWS ตัวอย่างการกำหนดค่า Terraform ที่แสดงในที่นี้เป็นการปรับใช้ AWS VPC กับเครือข่ายย่อย กลุ่มความปลอดภัย และอินสแตนซ์ EC2 ที่อธิบายไว้ในส่วนที่ 3 - การเตรียมการปรับใช้ทั่วทั้งองค์กร Tableau Server

คุณสามารถดูตัวอย่างเทมเพลต Terraform ได้ในเว็บไซต์ Tableau Samples ที่ https://help.tableau.com/samples/en-us/edg/edg-terraform.zip(ลิงก์จะเปิดในหน้าต่างใหม่) เทมเพลตเหล่านี้ต้องได้รับการกำหนดค่าและปรับแต่งสำหรับองค์กรของคุณ เนื้อหาการกำหนดค่าที่กล่าวไว้ในส่วนนี้จะอธิบายถึงการเปลี่ยนแปลงเทมเพลตที่จำเป็นขั้นต่ำที่คุณต้องปรับแต่งเพื่อนำไปปรับใช้

เป้าหมาย

เทมเพลตและเนื้อหาของ Terraform ที่ให้ไว้นี้มีจุดประสงค์เพื่อเป็นตัวอย่างการทำงานที่จะช่วยให้คุณสามารถปรับใช้ EDG ได้อย่างรวดเร็วในสภาพแวดล้อมการทดสอบเพื่อการพัฒนา

เราได้พยายามอย่างสุดความสามารถที่จะทดสอบและจัดทำเอกสารสำหรับตัวอย่างการปรับใช้ Terraform นี้ อย่างไรก็ตาม การใช้ Terraform เพื่อปรับใช้และบำรุงรักษา EDG ในสภาพแวดล้อมการใช้งานจริงจะต้องอาศัยความเชี่ยวชาญจาก Terraform ซึ่งอยู่นอกเหนือขอบเขตของตัวอย่างนี้ Tableau ไม่รองรับตัวอย่างโซลูชัน Terraform ที่บันทึกไว้ในที่นี้

สถานะสิ้นสุด

โปรดปฏิบัติตามขั้นตอนในส่วนนี้เพื่อตั้งค่า VPC ใน AWS ที่ทำงานเทียบเท่ากับ VPC ที่ระบุไว้ในส่วนที่ 3 - การเตรียมการปรับใช้ทั่วทั้งองค์กร Tableau Server

ตัวอย่างเทมเพลต Terraform และเนื้อหาประกอบในส่วนนี้:

• สร้าง VPC ที่มีที่อยู่ IP แบบยืดหยุ่น, โซนความพร้อมใช้งาน 2 โซน และการจัดระเบียบเครือข่ายย่อยตามที่แสดงไว้ด้านบน (ที่อยู่ IP ต่างกัน)
• สร้างกลุ่มความปลอดภัย Bastion, Public, Private และ Data
• ตั้งค่ากฎขาเข้าและขาออกส่วนใหญ่ในกลุ่มความปลอดภัย คุณจะต้องแก้ไขกลุ่มความปลอดภัยหลังจากเรียกใช้ Terraform แล้ว
• สร้างโฮสต์ EC2 ต่อไปนี้ (แต่ละโฮสต์เรียกใช้ AWS Linux2): เบสชัน, พร็อกซี 1 พร็อกซี 2, โหนด Tableau 1, โหนด Tableau 2, โหนด Tableau 3, โหนด Tableau 4
• ระบบไม่ได้สร้างโฮสต์ EC2 สำหรับ PostgreSQL คุณต้องสร้าง EC2 ด้วยตนเองในกลุ่มความปลอดภัยของข้อมูล จากนั้นจึงติดตั้งและกำหนดค่า PostgreSQL ตามที่อธิบายไว้ในติดตั้ง กำหนดค่า และ tar PostgreSQL

ข้อกำหนด

• บัญชี AWS - คุณต้องมีสิทธิ์เข้าถึงบัญชี AWS ที่อนุญาตให้คุณสร้าง VPC ได้
• หากคุณใช้งาน Terraform จากคอมพิวเตอร์ Windows คุณจะต้องติดตั้ง AWS CLI ด้วย
• ที่อยู่ IP แบบยืดหยุ่นที่มีอยู่ในบัญชี AWS ของคุณ
• โดเมนที่ลงทะเบียนใน AWS Route 53 Terraform จะสร้างโซน DNS และใบรับรอง SSL ที่เกี่ยวข้องใน Route 53 ดังนั้น โปรไฟล์ที่เรียกใช้ Terraform จึงต้องมีสิทธิ์ที่เหมาะสมใน Route 53 ด้วย

ก่อนที่คุณจะเริ่มต้น

• ตัวอย่างบรรทัดคำสั่งในขั้นตอนนี้มีไว้สำหรับ Terminal ที่มี Apple OS หากคุณเรียกใช้ Terraform บน Windows คุณอาจต้องปรับคำสั่งกับเส้นทางไฟล์ตามความเหมาะสม
• โปรเจ็กต์ Terraform ประกอบด้วยไฟล์การกำหนดค่าข้อความจำนวนมาก (นามสกุลไฟล์ .tf) คุณกำหนดค่า Terraform ได้โดยปรับแต่งไฟล์เหล่านี้ หากคุณไม่มีเครื่องมือแก้ไขข้อความที่มีประสิทธิภาพ ให้ติดตั้ง Atom หรือ Text++
• หากคุณกำลังแชร์โปรเจ็กต์ Terraform กับผู้อื่น เราขอแนะนำให้จัดเก็บโปรเจ็กต์ไว้ใน Git เพื่อจัดการการเปลี่ยนแปลง

ขั้นตอนที่ 1 - เตรียมสภาพแวดล้อม

ดาวน์โหลดและติดตั้ง Terraform

https://www.terraform.io/downloads(ลิงก์จะเปิดในหน้าต่างใหม่)

B. สร้างคู่คีย์ส่วนตัวและสาธารณะ

นี่คือคีย์ที่คุณจะใช้เพื่อเข้าถึง AWS และสภาพแวดล้อม VPC ที่เป็นผลลัพธ์ เมื่อคุณเรียกใช้ Terraform คุณจะต้องใส่คีย์สาธารณะ

เปิด Terminal และเรียกใช้คำสั่งดังต่อไปนี้

1. Create a private key. For example, my-key.pem:

   openssl genrsa -out my-key.pem 1024

2. สร้างคีย์สาธารณะ รูปแบบคีย์นี้ไม่ได้ใช้สำหรับ Terraform คุณจะแปลงเป็นคีย์ ssh ในภายหลังในขั้นตอนนี้:

   openssl rsa -in my-key.pem -pubout > my-key.pub

3. ตั้งค่าสิทธิ์ในคีย์ส่วนตัว:

   sudo chmod 0600 my-key.pem

   วิธีการตั้งค่าสิทธิ์บน Windows:

   • ค้นหาไฟล์ใน Windows Explorer คลิกขวาที่ไฟล์แล้วเลือก Properties ไปที่แท็บ Security แล้วคลิก Advanced
   • เปลี่ยนเจ้าของเป็นคุณ ปิดใช้งานการสืบทอด และลบสิทธิ์ทั้งหมด ให้สิทธิ์ Full control แก่ตัวคุณเอง จากนั้นคลิก Save ทำเครื่องหมายไฟล์เป็นแบบอ่านอย่างเดียว

4. สร้างคีย์ ssh สาธารณะ นี่คือคีย์ที่คุณจะคัดลอกไปยัง Terraform ในภายหลังในขั้นตอนนี้

   ssh-keygen -y -f my-key.pem >my-key-ssh.pub

C. ดาวน์โหลดโปรเจ็กต์และเพิ่มไดเร็กทอรีสถานะ

1. ดาวน์โหลดและแตกไฟล์ซิป EDG Terraform project(ลิงก์จะเปิดในหน้าต่างใหม่) แล้วบันทึกลงในเครื่องคอมพิวเตอร์ของคุณ หลังจากที่คุณแตกซิปไฟล์ที่ดาวน์โหลดมาแล้ว คุณจะมีไดเร็กทอรีระดับบนสุด, edg-terraform และชุดไดเร็กทอรีย่อย

2. สร้างไดเร็กทอรีที่ชื่อว่า state โดยให้อยู่ระดับเดียวกับไดเรกทอรี edg-terraform ระดับบนสุด

ขั้นตอนที่ 2: ปรับแต่งเทมเพลต Terraform

คุณต้องปรับแต่งเทมเพลต Terraform ให้เหมาะกับสภาพแวดล้อม AWS และ EDG ของคุณ ตัวอย่างนี้แสดงการปรับแต่งเทมเพลตขั้นต่ำที่องค์กรส่วนใหญ่จำเป็นต้องทำ โดยมีความเป็นไปได้ว่าสภาพแวดล้อมที่เฉพาะเจาะจงของคุณจะต้องมีการปรับแต่งอื่นๆ

ส่วนนี้จัดระเบียบตามชื่อเทมเพลต

อย่าลืมบันทึกการเปลี่ยนแปลงทั้งหมดก่อนดำเนินการต่อในขั้นตอนที่ 3 - เรียกใช้ Terraform

versions.tf

There are three instances of versions.tf files where the required_version field must match the version of terraform.exe you're using. Check the version of terraform (terraform.exe -version) and update each of the following instances:

• edg-terraform\versions.tf
• edg-terraform\modules\proxy\versions.tf
• edg-terraform\modules\tableau_instance\versions.tf

key-pair.tf

1. เปิดรหัสสาธารณะที่คุณสร้างขึ้นในขั้นตอน 1B และคัดลอกคีย์:

    less my-key-ssh.pub

   Windows: คัดลอกเนื้อหาของคีย์สาธารณะของคุณ

2. คัดลอกสตริงคีย์สาธารณะลงในอาร์กิวเมนต์ public_key เช่น

   resource "aws_key_pair" "tableau" {
   key_name = "my-key"
   public_key = "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAAgQ (truncated example) dZVHambOCw=="

Ensure that the key_name value is unique in the datacenter or terraform apply will fail.

locals.tf

Update user.owner to your name or alias. The value you enter here will be used for the "Name" tag in AWS on the resources that Terraform creates.

providers.tf

1. เพิ่มแท็กตามความต้องการขององค์กรของคุณ ตัวอย่าง:

   default_tags {
     tags = {
         
      "Application" = "tableau",
      "Creator" = "alias@example.com",
      "DeptCode" = "8675309",
      "Description" = "EDG",
      "Environment" = "test",
      "Group" = "itcloud@example.com"
     }
   }

2. If using provider, comment out the assume_role lines:

   /* assume_role {
   role_arn     = "arn:aws:iam::310946706895:role/terraform-backend"
   session_name = "terraform"
   }*/  

elb.tf

Under 'resource "aws_lb" "tableau" {' choose a unique value to use for name and tags.Name.

If another AWS load balancer has the same name in the datacenter, then terraform apply will fail.

Add idle_timeout:

resource "aws_lb" "tableau" {
name                       = "edg-again-alb"
load_balancer_type         = "application"
subnets                    = [for subnet in aws_subnet.public : subnet.id]
security_groups            = [aws_security_group.public.id]
drop_invalid_header_fields = true
idle_timeout               = 400
tags = {
Name = "edg-again-alb"
}
			}

variables.tf

อัปเดตชื่อโดเมนรูท ชื่อนี้ต้องตรงกับโดเมนที่คุณลงทะเบียนใน Route 53

variable "root_domain_name" {
 default = "example.com"
 }

โดยค่าเริ่มต้น ระบบจะระบุโดเมนย่อย tableau สำหรับชื่อโดเมน VPC DNS หากต้องการเปลี่ยนแปลง ให้อัปเดต subdomain:

variable "subdomain" {
 default = "tableau"
}

modules/tableau_instance/ec2.tf

There are two ec2.tf files in the project. This customization is for the Tableau instance of the ec2.tf in the directory: modules/tableau_instance/ec2.tf.

• หากจำเป็น ให้เพิ่มแท็ก blob:

  tags = { 
   "Name" : var.ec2_name,
   "user.owner" = "ALIAS",
   "Application" = "tableau",
   "Creator" = "ALIAS@example.com",
   "DeptCode" = "8675309",
   "Description" = "EDG",
   "Environment" = "test",
   "Group" = "itcloud@example.com"
   }
  }

• หากจำเป็น คุณสามารถเลือกอัปเดตที่เก็บข้อมูลของคุณเพื่อจัดการกับข้อกำหนดด้านข้อมูลได้:

  ปริมาณราก:

  root_block_device {
   volume_size = 100
   volume_type = "gp3"
  }

  ปริมาณแอปพลิเคชัน:

  resource "aws_ebs_volume" "tableau" {
   availability_zone = data.aws_subnet.tableau.availability_zone
   size              = 500
   type              = "gp3"
  }

ขั้นตอนที่ 3 - เรียกใช้ Terraform

A. เริ่มใช้งาน Terraform

ใน Terminal ให้เปลี่ยนป็นไดเรกทอรี edg-terraform และเรียกใช้คำสั่งต่อไปนี้

terraform init

หากการเริ่มใช้งานสำเร็จ ให้ไปยังขั้นตอนถัดไป หากการเริ่มใช้งานล้มเหลว ให้ทำตามคำแนะนำในเอาต์พุต Terraform

B. วางแผน Terraform

จากไดเร็กทอรีเดียวกัน ให้รันคำสั่ง plan:

terraform plan

คำสั่งนี้สามารถเรียกใช้ได้หลายครั้ง เรียกใช้คำสั่งนี้ได้หลายครั้งตามที่จำเป็นเพื่อแก้ไขข้อผิดพลาด เมื่อคำสั่งนี้ทำงานโดยปราศจากข้อผิดพลาดแล้ว ให้ไปยังขั้นตอนถัดไป

C. นำ Terraform ไปใช้งาน

จากไดเร็กทอรีเดียวกัน ให้รันคำสั่ง apply :

terraform apply

Terraform will prompt you to verify deployment, type Yes.

ทางเลือก: ทำลาย Terraform

คุณสามารถทำลาย VPC ทั้งหมดได้โดยใช้คำสั่ง destroy:

terraform destroy

คำสั่ง destroy จะทำลายเฉพาะสิ่งที่สร้างขึ้นเท่านั้น หากคุณทำการเปลี่ยนแปลงบางออบเจ็กต์ใน AWS ด้วยตนเอง (เช่น กลุ่มความปลอดภัย เครือข่ายย่อย ฯลฯ) เช่นนั้นแล้ว destroy จะล้มเหลว หากต้องการออกจากการดำเนินการทำลายที่ล้มเหลว/หยุดทำงาน ให้พิมพ์ Control + C จากนั้น คุณต้องล้างข้อมูล VPC ด้วยตนเองให้อยู่ในสถานะเดิมดังเช่นที่สร้าง Terraform ขึ้นในตอนแรก จากนั้นคุณจะสามารถเรียกใช้คำสั่ง destroy ได้

ขั้นตอนที่ 4 - เชื่อมต่อ Bastion

การเชื่อมต่อบรรทัดคำสั่งทั้งหมดผ่านโฮสต์ Bastion บน TCP 22 (โปรโตคอล SSH)

1. ใน AWS ให้สร้างกฎขาเข้าในกลุ่มความปลอดภัยของ Bastion (AWS > Security Groups > Bastion SG > แก้ไขกฎขาเข้า ) และสร้างกฎเพื่ออนุญาตการเชื่อมต่อ SSH (TCP 22) จากที่อยู่ IP หรือมาสก์เครือข่ายย่อยที่คุณจะเรียกใช้คำสั่ง Terminal

   ทางเลือก: คุณอาจพบว่าการอนุญาตให้คัดลอกไฟล์ระหว่างอินสแตนซ์ EC2 ในกลุ่มส่วนตัวและสาธารณะระหว่างการปรับใช้นั้นอาจเป็นประโยชน์ สร้างกฎ SSH ขาเข้า:

   • ส่วนตัว: สร้างกฎขาเข้าเพื่ออนุญาต SSH จากสาธารณะ
   • สาธารณะ: สร้างกฎขาเข้าเพื่ออนุญาต SSH จากส่วนตัวและจากสาธารณะ

2. ใช้คีย์ pem ที่คุณสร้างขึ้นในขั้นตอน 1.B เพื่อเชื่อมต่อกับโฮสต์ Bastion :

   บน Mac Terminal:

   เรียกใช้คำสั่งต่อไปนี้จากไดเรกทอรีที่เก็บคีย์ pem:

   ssh-add —apple-use-keychain <keyName>.pem

   If you get a warning about private key being accessible by others, then run this command: chmod 600 <keyName.pem> and then run the ssh-add command again.

   Connect to the bastion host with this command: ssh -A ec2-user@IPaddress

   For example: ssh -A ec2-user@3.15.12.112.

   บน Windows โดยใช้ PuTTY และ Pageant:

   1. สร้าง ppk จากคีย์ pem: ใช้ PuTTY Key Generator โหลดคีย์ pem ที่คุณสร้างขึ้นในขั้นตอน 1.B หลังจากนำเข้าคีย์แล้ว ให้คลิกบันทึกคีย์ส่วนตัว ซึ่งจะสร้างไฟล์ ppk ขึ้นมา

   2. ใน PuTTY - เปิดการกำหนดค่าและทำการเปลี่ยนแปลงต่อไปนี้

      • เซสชัน>ชื่อโฮสต์: เพิ่มที่อยู่ IP ของโฮสต์ Bastion
      • เซสชัน>พอร์ต: 22
      • การเชื่อมต่อ>ข้อมูล>ชื่อผู้ใช้ที่เข้าสู่ระบบอัตโนมัติ: ec2-user
      • การเชื่อมต่อ>SSH>การให้สิทธิ์>อนุญาตการส่งต่อเอเจนต์
      • Connection>SSH>การให้สิทธิ์> สำหรับคีย์ส่วนตัว ให้คลิก Browse แล้วเลือกไฟล์ .ppk ที่คุณเพิ่งสร้างขึ้น

   3. ติดตั้ง Pageant และโหลด ppk ลงในแอปพลิเคชัน

   ขั้นตอนที่ 5 - ติดตั้ง PostgreSQL

   เทมเพลต Terraform ไม่ได้ติดตั้ง PostgreSQL เพื่อใช้เป็นที่เก็บภายนอก อย่างไรก็ตาม มีการสร้างกลุ่มความปลอดภัยและเครือข่ายย่อยที่เกี่ยวข้องขึ้นมา หากคุณจะติดตั้งพื้นที่เก็บภายนอกบนอินสแตนซ์ EC2 ที่เรียกใช้ PostgreSQL คุณต้องปรับใช้อินสแตนซ์ EC2 ตามที่อธิบายไว้ในส่วนที่ 3 - การเตรียมการปรับใช้ทั่วทั้งองค์กร Tableau Server

   จากนั้นจึงติดตั้ง กำหนดค่า และสำรองข้อมูล tar ของ PostgreSQL ตามที่อธิบายไว้ในตอนที่ 4: ติดตั้งและกำหนดค่า Tableau Server

   ขั้นตอนที่ 6 - เรียกใช้ DeployTab4EDG (ทางเลือก)

   สคริปต์ TabDeploy4EDG จะทำการปรับใช้ Tableau แบบสี่โหนดที่อธิบายไว้ในส่วนที่ 4 โดยอัตโนมัติ โปรดดูสคริปต์การติดตั้ง TabDeploy4EDG อัตโนมัติ