เปิดใช้การทําให้ 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

ตัวอย่างต่อไปนี้เรียกใช้ Update organization properties 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

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