คุณกำลังดูเอกสารประกอบของ Apigee Edge
ไปที่
เอกสารประกอบของ Apigee X info
Apigee Edge มีทรัพยากรหลายประเภทและแต่ละประเภทก็มีวัตถุประสงค์ที่แตกต่างกัน โดยมีทรัพยากรบางอย่างที่กำหนดค่าได้ (เช่น สร้าง อัปเดต และ/หรือ ลบ) ผ่าน UI ของ Edge, Management API หรือเครื่องมือที่ใช้ Management API เท่านั้น และผู้ใช้ต้องมีบทบาทและสิทธิ์ที่จำเป็น ตัวอย่างเช่น มีเพียงผู้ดูแลระบบขององค์กรที่อยู่ในองค์กรที่ เฉพาะเจาะจงเท่านั้นที่กำหนดค่าทรัพยากรเหล่านี้ได้ ซึ่งหมายความว่าผู้ใช้ปลายทางไม่สามารถกำหนดค่าทรัพยากรเหล่านี้ผ่านพอร์ทัลสำหรับนักพัฒนาแอปหรือวิธีอื่นๆ ได้ ทรัพยากรเหล่านี้ ได้แก่
- พร็อกซี API
- เวิร์กโฟลว์ที่แชร์
- ผลิตภัณฑ์ API
- แคช
- KVM
- ที่เก็บคีย์และที่เก็บใบรับรอง
- โฮสต์เสมือน
- เซิร์ฟเวอร์เป้าหมาย
- ไฟล์ทรัพยากร
แม้ว่าทรัพยากรเหล่านี้จะมีการจำกัดการเข้าถึง แต่หากผู้ใช้ที่ได้รับอนุญาตทำการแก้ไข แม้โดย ผู้ใช้ที่ได้รับอนุญาต ทรัพยากรดังกล่าวจะเขียนทับข้อมูลเก่าด้วยข้อมูลใหม่ เนื่องจากระบบจะจัดเก็บทรัพยากรเหล่านี้ใน Apigee Edge ตามสถานะปัจจุบันเท่านั้น โดยข้อยกเว้นหลักของกฎนี้คือพร็อกซี API และเวิร์กโฟลว์ที่แชร์
พร็อกซี API และเวิร์กโฟลว์ที่แชร์ภายใต้การควบคุมการแก้ไข
ระบบจะจัดการ (สร้าง อัปเดต และทำให้ใช้งานได้) พร็อกซี API และเวิร์กโฟลว์ที่แชร์ ผ่านการแก้ไข โดยการแก้ไขจะมีหมายเลขตามลำดับ ซึ่งช่วยให้คุณเพิ่มการเปลี่ยนแปลงใหม่และ บันทึกเป็นเวอร์ชันใหม่ หรือเปลี่ยนการเปลี่ยนแปลงกลับโดยทำให้เวอร์ชันก่อนหน้าของพร็อกซี API เวิร์กโฟลว์ที่แชร์ใช้งานได้ ในแต่ละช่วงเวลา จะมีพร็อกซี API/เวิร์กโฟลว์ที่แชร์ เพียงเวอร์ชันเดียวเท่านั้นที่ทำให้ใช้งานได้ในสภาพแวดล้อม เว้นแต่ว่าเวอร์ชันต่างๆ จะมีเส้นทางฐานที่แตกต่างกัน
แม้ว่าระบบจะจัดการพร็อกซี API และเวิร์กโฟลว์ที่แชร์ผ่านการแก้ไข แต่หากมีการแก้ไขเวอร์ชันที่มีอยู่ คุณจะย้อนกลับไม่ได้เนื่องจากระบบจะเขียนทับการเปลี่ยนแปลงเก่า
การตรวจสอบและประวัติ
Apigee Edge มีฟีเจอร์ การตรวจสอบ และประวัติ API, ผลิตภัณฑ์ และองค์กร ซึ่งอาจเป็นประโยชน์ในสถานการณ์การแก้ปัญหา ฟีเจอร์เหล่านี้ช่วยให้คุณ ดูข้อมูล เช่น ผู้ที่ดำเนินการที่เฉพาะเจาะจง (สร้าง อ่าน อัปเดต ลบ ทำให้ใช้งานได้ และยกเลิกการทำให้ใช้งานได้) และเวลาที่ดำเนินการกับทรัพยากร Edge อย่างไรก็ตาม หากมีการดำเนินการอัปเดต หรือลบทรัพยากร Edge ใดๆ การตรวจสอบจะไม่สามารถให้ข้อมูลเก่าแก่คุณได้
รูปแบบที่ไม่แนะนำ
การจัดการทรัพยากร Edge (ตามรายการด้านบน) โดยตรงผ่าน UI ของ Edge หรือ Management API โดยไม่ใช้ ระบบควบคุมเวอร์ชัน
ผู้ใช้บางรายเข้าใจผิดว่า Apigee Edge จะสามารถกู้คืนทรัพยากรกลับสู่สถานะก่อนหน้า ได้หลังจากการแก้ไขหรือลบ อย่างไรก็ตาม Edge Cloud ไม่มีการกู้คืนทรัพยากร กลับสู่สถานะก่อนหน้า ดังนั้น ผู้ใช้จึงมีหน้าที่รับผิดชอบในการตรวจสอบว่าได้จัดการข้อมูลทั้งหมดที่เกี่ยวข้องกับทรัพยากร Edge ผ่านการจัดการการควบคุมเวอร์ชัน เพื่อให้กู้คืนข้อมูลเก่าได้อย่างรวดเร็วในกรณีที่ลบโดยไม่ได้ตั้งใจหรือในสถานการณ์ที่ต้องย้อนกลับการเปลี่ยนแปลง ซึ่งมีความสำคัญอย่างยิ่งสำหรับสภาพแวดล้อมการใช้งานจริงที่ต้องใช้ข้อมูลนี้ สำหรับการรับส่งข้อมูลรันไทม์
เราจะอธิบายเรื่องนี้โดยใช้ตัวอย่าง 2-3 ตัวอย่างและผลกระทบที่อาจเกิดขึ้นหาก ไม่ได้จัดการข้อมูลผ่านระบบควบคุมเวอร์ชันและมีการแก้ไข/ลบข้อมูลโดยตั้งใจหรือไม่ ตั้งใจ
ตัวอย่างที่ 1: การลบหรือแก้ไขพร็อกซี API
เมื่อลบพร็อกซี API หรือทำให้การเปลี่ยนแปลงในเวอร์ชันที่มีอยู่ใช้งานได้ คุณจะไม่สามารถกู้คืนโค้ดก่อนหน้าได้ หากพร็อกซี API มีโค้ด Java, JavaScript, Node.js หรือ Python ที่ ไม่ได้จัดการในระบบการจัดการการควบคุมเวอร์ชัน (SCM) นอก Apigee คุณอาจสูญเสียงานและการพัฒนาจำนวนมาก
ตัวอย่างที่ 2: การกำหนดพร็อกซี API ที่ใช้โฮสต์เสมือนที่เฉพาะเจาะจง
ใบรับรองในโฮสต์เสมือนกำลังจะหมดอายุและต้องอัปเดตโฮสต์เสมือนนั้น การระบุ พร็อกซี API ที่ใช้โฮสต์เสมือนนั้นเพื่อวัตถุประสงค์ในการทดสอบอาจเป็นเรื่องยากหากมีพร็อกซี API จำนวนมาก หากจัดการพร็อกซี API ในระบบ SCM นอก Apigee คุณจะค้นหารีโปได้ง่าย
ตัวอย่างที่ 3: การลบที่เก็บคีย์/ที่เก็บใบรับรอง
หากลบที่เก็บคีย์/ที่เก็บใบรับรองที่ใช้โดยการกำหนดค่าโฮสต์เสมือนหรือเซิร์ฟเวอร์เป้าหมาย คุณจะไม่สามารถกู้คืนที่เก็บคีย์/ที่เก็บใบรับรองได้ เว้นแต่ว่าคุณจะจัดเก็บรายละเอียดการกำหนดค่าของ ที่เก็บคีย์/ที่เก็บใบรับรอง ซึ่งรวมถึงใบรับรองและ/หรือคีย์ส่วนตัวไว้ในการควบคุมเวอร์ชัน
ผลกระทบ
- หากลบทรัพยากร Edge ใดๆ คุณจะไม่สามารถกู้คืนทรัพยากรและ เนื้อหาของทรัพยากรนั้นจาก Apigee Edge ได้
- คำขอ API อาจล้มเหลวโดยมีข้อผิดพลาดที่ไม่คาดคิดซึ่งนำไปสู่การหยุดทำงานจนกว่าจะกู้คืนทรัพยากรกลับสู่สถานะก่อนหน้า
- การค้นหาการพึ่งพากันระหว่างพร็อกซี API กับทรัพยากรอื่นๆ ใน Apigee Edge เป็นเรื่องยาก
แนวทางปฏิบัติแนะนำ
- ใช้ SCM มาตรฐานร่วมกับไปป์ไลน์การรวมอย่างต่อเนื่องและการติดตั้งใช้งานอย่างต่อเนื่อง (CICD) เพื่อจัดการพร็อกซี API และเวิร์กโฟลว์ที่แชร์
- ใช้ SCM มาตรฐานเพื่อจัดการทรัพยากร Edge อื่นๆ ซึ่งรวมถึงผลิตภัณฑ์ API,
แคช, KVM, เซิร์ฟเวอร์เป้าหมาย, โฮสต์เสมือน และที่เก็บคีย์
- หากมีทรัพยากร Edge อยู่แล้ว ให้ใช้ Management API เพื่อรับรายละเอียดการกำหนดค่าของทรัพยากรเหล่านั้นเป็นเพย์โหลด JSON/XML และจัดเก็บไว้ในการจัดการการควบคุมเวอร์ชัน
- จัดการการอัปเดตใหม่ๆ สำหรับทรัพยากรเหล่านี้ในการจัดการการควบคุมเวอร์ชัน
- หากต้องการสร้างทรัพยากร Edge ใหม่หรืออัปเดตทรัพยากร Edge ที่มีอยู่ ให้ใช้เพย์โหลด JSON/XML ที่เหมาะสมซึ่งจัดเก็บไว้ในการจัดการการควบคุมเวอร์ชันและอัปเดต การกำหนดค่าใน Edge โดยใช้ Management API
* คุณไม่สามารถส่งออก KVM ที่เข้ารหัสเป็นข้อความธรรมดาจาก API ได้ ผู้ใช้มีหน้าที่รับผิดชอบ ในการบันทึกค่าที่ป้อนลงใน KVM ที่เข้ารหัส