เปิดใช้การทําให้ HTTP ใช้งานได้

โดยค่าเริ่มต้น Edge จะใช้ RPC เพื่อทำให้พร็อกซี API ใช้งานได้ แม้ว่าโหมดนี้จะทำงานได้ดีมากสำหรับการติดตั้งส่วนใหญ่ แต่โทโพโลยีขนาดใหญ่ที่มี MP จำนวนมากอาจเกิดการหมดเวลาเมื่อมีการโทรพร้อมกันจำนวนมากผ่าน RPC Apigee วางแผนที่จะเลิกใช้งานการติดตั้งใช้งานนี้ในอนาคต

ด้วยเหตุนี้ Apigee จึงแนะนำให้การติดตั้งใช้งานขนาดใหญ่ใช้ HTTP แทน RPC สำหรับการติดตั้งใช้งาน

นอกเหนือจากความน่าเชื่อถือที่อาจเพิ่มขึ้นแล้ว การเปิดใช้การติดตั้งใช้งาน HTTP ยังช่วยปรับปรุงเนื้อหาและรูปแบบของข้อยกเว้นที่อาจเกิดขึ้นระหว่างกระบวนการติดตั้งใช้งานด้วย

ส่วนนี้จะอธิบายวิธีเปิดใช้ HTTP สำหรับการติดตั้งใช้งาน

อัปเดตองค์กร

หากต้องการเปิดใช้การติดตั้งใช้งาน HTTP ให้ส่งคำขอ PUT ไปยัง API อัปเดตพร็อพเพอร์ตี้ขององค์กร ตั้งค่าพร็อพเพอร์ตี้ต่อไปนี้ในเนื้อหาของคำขอ

พร็อพเพอร์ตี้ คำอธิบาย
allow.deployment.over.http กำหนดว่า Edge สามารถทำให้พร็อกซี API ใช้งานได้ผ่าน HTTP (นอกเหนือจาก RPC) หรือไม่ ตั้งค่าเป็น true เพื่ออนุญาตการติดตั้งใช้งาน HTTP ไม่เช่นนั้นให้ตั้งค่าเป็น false ค่าเริ่มต้นคือ false

หากต้องการเปิดใช้การติดตั้งใช้งาน HTTP คุณต้องตั้งค่าพร็อพเพอร์ตี้นี้เป็น true
use.http.for.configuration

ระบุวิธีการที่จะใช้สำหรับเหตุการณ์การกำหนดค่า ค่าที่เป็นไปได้มีดังนี้

  • never: เหตุการณ์การกำหนดค่าทั้งหมดใช้ RPC ทั้งนี้ ตัวเลือกนี้คือค่าเริ่มต้น
  • retry: เหตุการณ์การกำหนดค่าทั้งหมดจะใช้ RPC ก่อน หากเหตุการณ์ล้มเหลวผ่าน RPC, Edge จะลองใช้ HTTP ซึ่งอาจทำให้เกิดความล่าช้าหากคุณควรใช้ HTTP
  • always: เหตุการณ์การกำหนดค่าทั้งหมดใช้ HTTP

หากต้องการเปิดใช้การติดตั้งใช้งาน HTTP ทาง Apigee ขอแนะนำให้ตั้งค่าพร็อพเพอร์ตี้นี้เป็น always

นอกจากการตั้งค่าพร็อพเพอร์ตี้เหล่านี้ในเนื้อหาของข้อความแล้ว คุณต้องตั้งค่าส่วนหัว Content-Type เป็น application/json หรือ application/xml ด้วย

ตัวอย่างต่อไปนี้จะเรียก API อัปเดตพร็อพเพอร์ตี้ขององค์กรด้วยเนื้อหาข้อความ JSON

curl -u admin_email:admin_password
  "http://management_server_IP:8080/v1/organizations/org_name"
  -X POST -H "Content-Type: application/json" -d
  '{
    "properties" : {
      "property" : [
      {
        "name" : "allow.deployment.over.http",
        "value" : "true"
      },
      {
        "name" : "use.http.for.configuration",
        "value" : "always"
      } ]
    }
  }'

หากต้องการเปิดใช้การติดตั้งใช้งาน HTTP ในพร็อกซี API ทั้งหมดในทุกองค์กร คุณต้องอัปเดตแต่ละองค์กรตามที่อธิบายไว้ข้างต้น

ทดสอบการอัปเดต

หากต้องการทดสอบว่าการอัปเดตสำเร็จหรือไม่ ให้ทริกเกอร์เหตุการณ์การทำให้ใช้งานได้ในพร็อกซี API ในองค์กรที่อัปเดตแล้ว จากนั้นดูไฟล์บันทึกของ Message Processor รายการบันทึกสำหรับเหตุการณ์การติดตั้งใช้งานควรมี mode:API

ดูข้อมูลเพิ่มเติมได้ที่ไฟล์บันทึก