การใช้ตัวจัดการเหตุการณ์

คุณสามารถใช้ตัวจัดการเหตุการณ์ใน SolusVM 2 เพื่อให้การดำเนินการบางอย่างเกิดขึ้นโดยอัตโนมัติเมื่อมีเหตุการณ์เฉพาะเกิดขึ้น ในขณะนี้ webhooks เป็นเพียงประเภทตัวจัดการเหตุการณ์ที่รองรับเท่านั้น ประเภทตัวจัดการเหตุการณ์อื่นๆ อาจถูกเพิ่มเข้ามาในอนาคต

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

การสร้างเว็บฮุค

Webhook คือการเรียกกลับ HTTP/HTTPS ที่ผู้ใช้กำหนด ทุกครั้งที่มีการทริกเกอร์ตัวจัดการเหตุการณ์ประเภทนี้ ตัวจัดการจะดำเนินการ webhook จากนั้น SolusVM 2 จะส่งคำขอ POST ไปยัง URL ของ webhook SolusVM 2 ติดตามการเปลี่ยนเส้นทางสูงสุดห้าครั้ง และไม่ตรวจสอบความถูกต้องของใบรับรอง SSL/TLS ของเว็บไซต์ (ถ้ามี) พารามิเตอร์ที่กำหนดไว้ล่วงหน้าจำนวนหนึ่งจะถูกส่งผ่าน URL เสมอ (เช่น ID ของเซิร์ฟเวอร์ที่กำลังถูกลบ หรือที่อยู่ IP ที่ถูกเพิ่ม) เว็บฮุคยังอาจได้รับการกำหนดค่าให้ส่งพารามิเตอร์เพิ่มเติมที่ผู้ใช้กำหนด

ทุกครั้งที่ Webhook ถูกทริกเกอร์ งานจะถูกสร้างขึ้นใน SolusVM 2 งานจะมีสถานะ "ล้มเหลว" หากสคริปต์ส่งคืนรหัสสถานะ HTTP 4хх หรือ 5хх

หากต้องการสร้างเว็บฮุค:

1. เข้าสู่ระบบ SolusVM 2
2. ไปที่ การตั้งค่า > ตัวจัดการเหตุการณ์ จากนั้นคลิก เพิ่ม Webhook
3. ตั้งชื่อเว็บฮุคที่ไม่ซ้ำใคร
4. ระบุ URL ของเว็บฮุค คำขอจะถูกส่งไปยัง URL นี้ทุกครั้งที่มีการทริกเกอร์เว็บฮุค
5. เลือกหนึ่งเหตุการณ์ขึ้นไปจากเมนูแบบเลื่อนลง ทุกครั้งที่มีเหตุการณ์ที่รองรับเกิดขึ้น เว็บฮุคจะถูกทริกเกอร์
6. (ไม่บังคับ) ระบุพารามิเตอร์คำขอเพิ่มเติมที่จะส่งผ่าน URL ของเว็บฮุค พารามิเตอร์ต้องอยู่ในรูปแบบ JSON
7. (ไม่บังคับ) เลือกช่องทำเครื่องหมาย "เปิดใช้งาน" หากคุณต้องการให้เว็บฮุคใช้งานได้หลังการสร้าง หรือคุณสามารถเปิดใช้งานเว็บฮุคในภายหลังได้
8. คลิก บันทึก

สร้างเว็บฮุคแล้ว คุณจะพบได้ใน การตั้งค่า > ตัวจัดการเหตุการณ์ หากคุณเปิดใช้ Webhook ในระหว่างการสร้าง ครั้งถัดไปที่มีกิจกรรมที่รองรับเกิดขึ้น Webhook จะถูกทริกเกอร์ และคำขอจะถูกส่งไปยัง URL ของ Webhook

การแก้ไข ปิดการใช้งาน และการลบ Webhooks

หากต้องการแก้ไขเว็บฮุค:

1. เข้าสู่ระบบ SolusVM 2
2. ไปที่ การตั้งค่า > ตัวจัดการเหตุการณ์
3. คลิกไอคอน ที่ตรงกับเว็บฮุคที่คุณต้องการแก้ไข
4. ทำการเปลี่ยนแปลงที่ต้องการ จากนั้นคลิก บันทึก

การเปลี่ยนแปลงมีผลแล้ว

หากต้องการเปิดหรือปิดใช้งานเว็บฮุค:

1. เข้าสู่ระบบ SolusVM 2
2. ไปที่ การตั้งค่า > ตัวจัดการเหตุการณ์
3. คลิกปุ่มสลับที่ตรงกับเว็บฮุคที่คุณต้องการเปิดหรือปิดใช้งานเพื่อให้แสดง "เปิดใช้งาน" (สีน้ำเงิน) หรือ "ปิดใช้งาน" (สีเทา)

ขณะนี้เว็บฮุคเปิดใช้งานแล้ว (หรือปิดใช้งาน)

หากต้องการลบเว็บฮุค:

1. เข้าสู่ระบบ SolusVM 2
2. ไปที่ การตั้งค่า > ตัวจัดการเหตุการณ์
3. คลิกไอคอน ที่เกี่ยวข้องกับเว็บฮุคที่คุณต้องการลบ จากนั้นคลิก ลบ

เว็บฮุคถูกลบแล้ว

รายการพารามิเตอร์ที่ส่งผ่านโดย Webhooks

ทุกครั้งที่มีการทริกเกอร์เว็บฮุค เว็บฮุคจะส่งพารามิเตอร์ต่อไปนี้ผ่าน URL:

• crId
• crHostname
• crStatus (commissioning, configure_network, active, failed, unavailable)
• crLicenseType (micro, mini, standard)
• serverId
• serverIps (เช่น ["10.0.0.1", "10.0.0.2"])
• serverHostname
• serverUuid
• serverStatus (ไม่มีอยู่ เริ่มแล้ว หยุดแล้ว ไม่พร้อมใช้งาน)
• userId
• billingUserId
• userEmail
• สถานะผู้ใช้ (ใช้งานอยู่ ล็อค ถูกระงับ)
• userAllowedIps (เช่น ["10.0.0.1", "10.0.0.2"])

ตัวอย่างเว็บฮุค

คุณสามารถสร้างเว็บฮุคที่จะอัปเดตที่อยู่ IP ของเซิร์ฟเวอร์ที่ย้ายจากทรัพยากรการประมวลผลหนึ่งไปยังอีกแหล่งหนึ่งใน WHMCS โดยอัตโนมัติ

หากต้องการสร้างเว็บฮุค:

1. เข้าสู่ระบบเซิร์ฟเวอร์ WHMCS ของคุณผ่าน SSH

2. ค้นหาไฟล์ hook_example.php ที่มาพร้อมกับโปรแกรมเสริม SolusVM 2 WHMCS ไฟล์ควรอยู่ในไดเร็กทอรี modules/servers/solusvm2vps/

3. ทำสำเนาของไฟล์ จากนั้นเริ่มแก้ไขสำเนา

4. ลบ exit(); ในบรรทัดที่ 6 ออก

5. เพิ่มความลับของคุณลงในตัวแปร $securitySecrets

6. เพิ่มที่อยู่ IP ของโหนดการจัดการ SolusVM 2 ของคุณลงในตัวแปร $connectionIPs

7. บันทึกการเปลี่ยนแปลง.

8. เข้าสู่ระบบ SolusVM 2

9. ไปที่ การตั้งค่า > ตัวจัดการเหตุการณ์ จากนั้นคลิก เพิ่ม Webhook

10. ตั้งชื่อเว็บฮุคที่ไม่ซ้ำใคร

11. ระบุ URL ของสคริปต์ที่แก้ไข

12. เลือก "เพิ่มหรือลบ IP เพิ่มเติม" จากเมนูแบบเลื่อนลง

13. ระบุข้อมูลลับที่คุณเพิ่มลงในสคริปต์ในระหว่างขั้นตอนที่ 5 ของขั้นตอนนี้:

    {
     "secret": "<your secret goes here>"
    }
    

14. เลือกช่องทำเครื่องหมาย "เปิดใช้งาน" แล้วคลิก บันทึก

ขณะนี้ ทุกครั้งที่ย้ายเซิร์ฟเวอร์ งานในการอัปเดตที่อยู่ IP ของเซิร์ฟเวอร์ใน WHMCS จะถูกสร้างขึ้นใน SolusVM 2