การตั้งค่าสำหรับผู้พัฒนา: อินสแตนซ์เดี่ยว

เอกสารฉบับนี้จะแสดงวิธีตั้งค่าอินสแตนซ์เดี่ยวของไคลเอ็นต์ WhatsApp Business API ในอุปกรณ์ของผู้พัฒนาเพื่อวัตถุประสงค์ด้านการทดสอบ

สำหรับการตั้งค่าการผลิต ให้ทำตามคำแนะนำที่เกี่ยวข้องซึ่งระบุในการตั้งค่าการผลิต

ก่อนเริ่มต้น

คุณจำเป็นต้องมีสิ่งต่อไปนี้:

• Docker
• Docker Compose
  

  • ควรมีรวมอยู่แล้วในการติดตั้ง Docker แต่ถ้าไม่มี คุณก็สามารถติดตั้งได้เอง
• บัญชีทดสอบที่ตั้งค่าในเครื่องในสภาพแวดล้อมการพัฒนา

  • การดำเนินการนี้มีเพื่อการพัฒนาที่รวดเร็วและเพื่อทดสอบเวอร์ชั่นใหม่

การตั้งค่าเบื้องต้นของไคลเอ็นต์ WhatsApp Business API

ทำตามขั้นตอนต่อไปนี้เพื่ือติดตั้งอินสแตนซ์เดี่ยวของไคลเอ็นต์ WhatsApp Business API ในระบบของผู้พัฒนา

ขั้นตอนที่ 1: สร้างไดเรกทอรี biz สำหรับสคริปต์การตั้งค่า

เรียกใช้โค้ดต่อไปนี้ในตำแหน่งที่คุณต้องการสำหรับไคลเอ็นต์ WhatsApp Business API:

mkdir ~/biz; cd ~/biz;

ขั้นตอนที่ 2: รับไฟล์การกำหนดค่าไคลเอ็นต์ WhatsApp Business API

ไฟล์การกำหนดค่าสำหรับไคลเอ็นต์ WhatsApp Business API จะอยู่ในที่เก็บ WhatsApp-Business-API-Setup-Scripts GitHub คุณสามารถตั้งค่าไคลเอ็นต์ WhatsApp Business API ของคุณได้ด้วยอินสแตนซ์ฐานข้อมูล MySQL หรือ Postgres

• สำหรับการตั้งค่าฐานข้อมูล MySQL ให้คัดลอกไฟล์การกำหนดค่า docker-compose.yml และ db.env จากไดเรกทอรีการติดตั้งไปยังไดเรกทอรี ~/biz ที่คุณสร้างในขั้นตอนที่ 1
• สำหรับการตั้งค่าฐานข้อมูล Postgres ให้คัดลอกไฟล์การกำหนดค่า docker-compose.yml และ db.env จากไดเรกทอรีการติดตั้ง Postgres ไปยังไดเรกทอรี ~/biz ที่คุณสร้างในขั้นตอนที่ 1

ขั้นตอนที่ 3: กำหนดตัวแปรสภาพแวดล้อมการใช้งาน WA_API_VERSION

ควรกำหนดตัวแปรสภาพแวดล้อมการใช้งาน WA_API_VERSION ให้เป็นเวอร์ชั่นปัจจุบันโดยใช้:

export WA_API_VERSION=current-whatsapp-version

ขั้นตอนที่ 4: เริ่มใช้งานไคลเอ็นต์ WhatsApp Business API

หากต้องการเริ่มใช้งานไคลเอ็นต์ WhatsApp Business API โดยมีคอนเทนเนอร์ฐานข้อมูล 1 รายการ คอนเทนเนอร์ Webapp 1 รายการ และคอนเทนเนอร์ Coreapp 1 รายการ ให้เรียกใช้:

docker-compose up -d

เอาต์พุตผลลัพธ์ควรมีลักษณะดังต่อไปนี้:

Creating volume "biz_whatsappMedia" with local driver
Creating volume "biz_mysqlData" with local driver
Creating biz_db_1 ... done
Creating biz_wacore_1 ... done
Creating biz_waweb_1  ... done

ขั้นตอนที่ 5: ตรวจสอบยืนยันว่าคอนเทนเนอร์กำลังทำงานอยู่

คุณสามารถตรวจสอบได้ว่าทุกคอนเทนเนอร์มีสถานะเป็น UP โดยเรียกใช้:

docker-compose ps

ตามค่าเริ่มต้น คอนเทนเนอร์ Webapp จะทำงานบนพอร์ต 9090 และคอนเทนเนอร์ฐานข้อมูลจะทำงานบนพอร์ต 33060

เอาต์พุตผลลัพธ์ควรมีลักษณะดังต่อไปนี้:

~/biz $ docker-compose ps
     Name                    Command               State                   Ports
-------------------------------------------------------------------------------------------------
biz_db_1       docker-entrypoint.sh mysqld      Up      0.0.0.0:33060->3306/tcp, 33060/tcp
biz_wacore_1   /opt/whatsapp/bin/wait_on_ ...   Up      6250/tcp, 6251/tcp, 6252/tcp, 6253/tcp
biz_waweb_1    /opt/whatsapp/bin/wait_on_ ...   Up      0.0.0.0:9090->443/tcp

ขั้นตอนที่ 6: ดำเนินการตรวจสอบระบบ

คุณสามารถดำเนินการตรวจสอบไคลเอ็นต์ WhatsApp Business API โดยใช้การเรียก API ไปยังโหนด health

เอาต์พุตผลลัพธ์ควรมีลักษณะดังต่อไปนี้:

{
    "health": {
        "gateway_status": "unregistered"
    }
}

การตอบกลับจะแสดง gateway_status ของ unregistered ว่าเป็น gateway_status เนื่องจากยังไม่ได้ลงทะเบียนไคลเอนต์ WhatsApp Business API

ขั้นตอนที่ 7: ลงทะเบียนไคลเอ็นต์ WhatsApp Business API

คุณสามารถลงทะเบียนไคลเอ็นต์ WhatsApp Business API ของคุณได้โดยใช้การเรียก API ไปยังโหนด account

ขั้นตอนที่ 8: ดำเนินการตรวจสอบระบบครั้งที่สอง

ดำเนินการตรวจสอบไคลเอ็นต์ WhatsApp Business API อีกครั้งโดยใช้การเรียก API ไปยังโหนด health หลังจากลงทะเบียนเสร็จสิ้น

เอาต์พุตผลลัพธ์ควรมีลักษณะดังต่อไปนี้:

{
    "health": {
        "gateway_status": "connected"
    }
}

gateway_status ของ connected หมายความว่า คอนเทนเนอร์ Coreapp สามารถเชื่อมต่อกับเซิร์ฟเวอร์ WhatsApp เพื่อตรวจสอบผู้ติดต่อและส่งข้อความได้

การอัพเกรดไคลเอ็นต์ WhatsApp Business API

ขั้นตอนที่ 1: เปลี่ยนแปลงตัวแปรสภาพแวดล้อมการใช้งาน WA_API_VERSION เป็นเวอร์ชั่นใหม่

ควรอัพเดตตัวแปรสภาพแวดล้อมการใช้งาน WA_API_VERSION เป็นหมายเลขเวอร์ชั่นใหม่โดยใช้:

export WA_API_VERSION=new-whatsapp-version

ขั้นตอนที่ 2: รีสตาร์ทคอนเทนเนอร์ Docker

รีสตาร์ทคอนเทนเนอร์ Docker โดยเรียกใช้:

docker-compose up -d

เอาต์พุตผลลัพธ์ควรมีลักษณะดังต่อไปนี้:

biz_db_1 is up-to-date
Recreating biz_wacore_1 ... done
Recreating biz_waweb_1  ... done

สำหรับผู้ใช้ฐานข้อมูล MySQL ที่จะอัพเกรดเป็น v2.23.x ขึ้นไป

ตอนนี้คุณสามารถใช้บริการอัพเกรดฐานข้อมูลที่ทำให้คุณสามารถอัพเกรดฐานข้อมูลได้ขณะที่แอพพลิเคชั่นยังคงทำงานอยู่เพื่อหลีกเลี่ยงการหยุดทำงาน

ขั้นตอนที่ 1: ดาวน์โหลดไฟล์การกำหนดค่า

ไฟล์ dbupgrade-compose.yml มีช่องที่ระบุเวอร์ชั่นของคอนเทนเนอร์

ตัวอย่าง:

services:
  dbupgrade:
    image: docker.whatsapp.biz/coreapp:v${WA_API_VERSION:-2.21.3}

ขั้นตอนที่ 2: เริ่มใช้งานคอนเทนเนอร์

หากต้องการอัพเกรดการติดตั้ง ให้เริ่มใช้งานคอนเทนเนอร์ dbupgrade-service โดยตั้งค่าตัวแปรสภาพแวดล้อมการใช้งาน WA_API_VERSION เป็นเวอร์ชั่นล่าสุด:

WA_API_VERSION=new-whatsapp-version docker-compose -f dbupgrade-compose.yml up -d

หมายเหตุ: หากคุณกำลังใช้กระบวนการปฏิบัติที่รีสตาร์ทคอนเทนเนอร์เมื่อออก โดยไม่ว่าจะใช้รหัสการออกใดก็ตาม ให้เริ่มต้นบริการโดยกำหนดตัวแปรสภาพแวดล้อมการใช้งาน EXIT_ON_SUCCESS เป็น FALSE เพื่อหลีกเลี่ยงการออกจากคอนเทนเนอร์เมื่อรหัสการออกเป็น 0

ขั้นตอนที่ 3: รอให้การอัพเกรดเสร็จสิ้น

หากการอัพเกรดฐานข้อมูลสำเร็จ คอนเทนเนอร์จะออกโดยใช้รหัส 0 คุณสามารถใช้คำสั่ง Docker ต่อไปนี้เพื่อติดตามสถานะได้:

docker wait your-database-upgrade-container-name

ขั้นตอนนี้จะส่งเอาต์พุตรหัสการออกของคอนเทนเนอร์ dbupgrade-service

ขั้นตอนที่ 4: รีสตาร์ทคอนเทนเนอร์ Coreapp และ Webapp

รีสตาร์ทคอนเทนเนอร์ Docker ของ Coreapp และ Webapp โดยกำหนดตัวแปรสภาพแวดล้อมการใช้งาน WA_API_VERSION เป็นเวอร์ชั่นล่าสุด:

WA_API_VERSION=new-whatsapp-version docker-compose up -d

การถอนการติดตั้งไคลเอ็นต์ WhatsApp Business API

หากคุณต้องการรีเซ็ตสภาพแวดล้อมการพัฒนาของคุณโดยการลบคอนเทนเนอร์ทั้งหมด ให้เรียกใช้คำสั่งต่อไปนี้จากไดเรกทอรีที่มีไฟล์ docker-compose.yml:

docker-compose down

เอาต์พุตผลลัพธ์ควรมีลักษณะดังต่อไปนี้:

Stopping biz_waweb_1  ... done
Stopping biz_wacore_1 ... done
Stopping biz_db_1     ... done
Removing biz_waweb_1  ... done
Removing biz_wacore_1 ... done
Removing biz_db_1     ... done

เพื่อกำจัดปริมาณข้อมูลทั้งหมดที่กำหนดไว้ในไฟล์ docker-compose.yml นอกเหนือจากคอนเทนเนอร์ ให้เรียกใช้คำสั่ง down ด้วยพารามิเตอร์ -v:

docker-compose down -v

การแก้ไขปัญหา

ในกรณีที่ไม่สามารถใช้ WADebug ได้หรือการเรียกใช้เครื่องมือทำให้ได้ข้อผิดพลาดกลับมา ให้เรียกใช้คำสั่งต่อไปนี้เพื่อจะรวบรวมบันทึกจากคอนเทนเนอร์ทั้งหมด:

docker-compose logs > debug_output.txt

หากต้องการรวบรวมบันทึกของบริการใดบริการหนึ่งโดยเฉพาะ ให้ใส่ชื่อของบริการนั้นๆ (waweb หรือ wacore) ต่อท้ายคำสั่ง docker-compose logs:

docker-compose logs waweb > debug_output.txt

คุณสามารถหาบันทึกได้ในไฟล์ debug_output.txt ในไดเรกทอรีปัจจุบัน