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

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

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

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

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

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

หากต้องการเปิดใช้การทำให้ HTTP ใช้งานได้ ให้ส่งคำขอ PUT ไปยัง Update Organization Property 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 Property 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 ในองค์กรที่อัปเดต จากนั้นดูที่ไฟล์บันทึกของผู้ประมวลผลข้อความ รายการบันทึกสำหรับเหตุการณ์การทำให้ใช้งานได้ควรมี mode:API

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