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

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

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

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

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

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

หากต้องการเปิดใช้การติดตั้งใช้งาน HTTP ให้ส่งคำขอ PUT ไปยังUpdate organization properties 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

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