4.15.07.00 - บันทึกประจำรุ่นของ Apigee Edge สำหรับ Private Cloud

คุณกำลังดูเอกสารประกอบของ Apigee Edge
ไปที่เอกสารประกอบของ Apigee X info

เมื่อวันอังคารที่ 8 กันยายน 2015 เราได้เปิดตัวฟีเจอร์สำคัญของ Apigee Edge สำหรับ Private Cloud

ตั้งแต่ Edge for Private Cloud รุ่นรายไตรมาสก่อนหน้า (4.15.04.00) มีการเปิดตัวรุ่นต่อไปนี้และรวมอยู่ในรุ่นรายไตรมาสนี้

• ระบบคลาวด์: 15.04.15, 15.04.29, 15.05.27, 15.06.10 และ 15.06.24
• Private Cloud: 4.15.04.01

คุณอัปเกรดเป็น Edge เวอร์ชันใดได้บ้าง 4.15.07.00

คุณจะทำอย่างใดอย่างหนึ่งต่อไปนี้ได้ ทั้งนี้ขึ้นอยู่กับเวอร์ชันปัจจุบันของ Edge

• อัปเกรดเป็น 4.15.07.00 โดยตรง
• อัปเกรดทีละเวอร์ชัน ซึ่งหมายความว่าคุณต้องอัปเกรดจาก Edge เวอร์ชันปัจจุบันเป็นอีกเวอร์ชันหนึ่ง แล้วจึงอัปเกรดเป็น 4.15.07.00

ดูข้อมูลเพิ่มเติมได้ที่คุณอัปเกรด Edge สำหรับ Private Cloud เป็นเวอร์ชันใดได้บ้าง 4.15.07.00

ก่อนอัปเกรดจากเวอร์ชัน 4.15.01.x หรือจากเวอร์ชันก่อนหน้า

1. ตรวจสอบเวอร์ชัน SSTable ของ Cassandra ดังนี้
   1. เปลี่ยนไดเรกทอรีเป็น /<install-root>/apigee4/data/cassandra/data
   2. เรียกใช้คำสั่งค้นหา
      > find . -name *-ic-*
      ผลลัพธ์ควรแสดงชุดไฟล์ .db หากคุณใช้ SSTable ของ Cassandra 1.2
   3. เรียกใช้คำสั่ง find นี้
      > find . -name *-hf-*
      ผลลัพธ์ควรว่างเปล่า ซึ่งหมายความว่าไม่มีไฟล์ .db ในรูปแบบ hf หากไม่เห็นไฟล์ในรูปแบบ hf แสดงว่าคุณ ดำเนินการเสร็จแล้วและอัปเกรดเป็น 4.15.07.00 ได้
      
      รูปแบบ hf ใช้สำหรับ SSTable ของ Cassandra 1.0 หากมีไฟล์ *.db ในรูปแบบ hf คุณจะต้อง อัปเกรด SSTable ตามที่อธิบายไว้ในส่วนที่เหลือของขั้นตอนนี้
2. หากพบไฟล์ *.db ในรูปแบบ hf ให้อัปเกรด SSTable โดยเรียกใช้คำสั่งต่อไปนี้ในทุกโหนด Cassandra จนกว่าจะอัปเกรดโหนด Cassandra ทั้งหมดแล้ว
   > /<install-root>/apigee4/share/apache-cassandra/bin/nodetool -h localhost upgradesstables -a
3. ทำซ้ำขั้นตอนที่ 1 เพื่อตรวจสอบว่าไฟล์ *.db ทั้งหมดอยู่ในรูปแบบ ic สำหรับ Cassandra 1.2 เวอร์ชัน
4. ทำขั้นตอนที่ 1 ถึง 3 ซ้ำในโหนด Cassandra ทุกโหนดในการติดตั้ง Edge
5. อัปเกรดเป็น Edge 4.15.07.00
6. หลังจากอัปเกรดเป็น 4.15.07.00 แล้ว ให้ตรวจสอบไฟล์ *.db เพื่อให้แน่ใจว่าได้อัปเกรดทั้งหมดแล้ว เป็น sstable รูปแบบ C* 2.0:
   > cd /<install-root>/apigee4/data/cassandra/data
   > find . -name *-jb-*
   คำสั่งนี้ควรแสดงชุดไฟล์ .db หากคุณใช้ Cassandra 2.0

ฟีเจอร์ใหม่และการเพิ่มประสิทธิภาพ

ฟีเจอร์ใหม่และการปรับปรุงในรุ่นนี้มีดังนี้

การติดตั้งและการอัปเกรด

การอัปเกรดและถอนการติดตั้งคอมโพเนนต์บางรายการ

ตอนนี้สคริปต์ apigee-upgrade.sh และ apigee-uninstall.sh ช่วยให้คุณเลือกคอมโพเนนต์ Edge ที่จะอัปเกรดหรือถอนการติดตั้งได้แล้ว ก่อนหน้านี้จะอัปเกรดหรือถอนการติดตั้งคอมโพเนนต์ทั้งหมดในโหนด (OPDK-1377, OPDK-1175)

การย้อนกลับการอัปเกรด

หาก apigee-upgrade.sh ล้มเหลวระหว่างการอัปเกรด ตอนนี้คุณสามารถใช้สคริปต์ apigee-rollback.sh เพื่อย้อนกลับการอัปเกรดได้แล้ว หลังจากแก้ไขปัญหาการอัปเกรดแล้ว คุณจะลองอัปเกรดอีกครั้งได้ (OPDK-1275)

ตัวเลือกสคริปต์โปรแกรมติดตั้งที่ย่อแล้ว

สคริปต์การติดตั้งจะไม่ใช้ตัวเลือกแบบยาว เช่น --help อีกต่อไป ตอนนี้จะใช้ได้เฉพาะตัวเลือกที่เป็นตัวอักษรเดียว เช่น -h (OPDK-1356)

การติดตั้ง SmartDocs

เมื่อติดตั้ง SmartDocs ด้วยสคริปต์ setup-smartdocs.sh ระบบจะแจ้งให้คุณป้อน องค์กร สภาพแวดล้อม และโฮสต์เสมือน ซึ่งจะช่วยให้มั่นใจได้ว่าระบบจะติดตั้ง SmartDocs ใน ตำแหน่งที่คาดไว้ ก่อนหน้านี้ ค่าเหล่านั้นจะมีการฮาร์ดโค้ดในสคริปต์ (OPDK-1310)

เรียกใช้ update-cass-pwd-in-config.sh โดยไม่ต้องแจ้ง

สคริปต์ update-cass-pwd-in-config.sh สามารถเรียกใช้ได้โดยไม่ต้องแจ้งให้ทราบหากคุณตั้งค่าตัวแปรสภาพแวดล้อม ENABLE_CASS_AUTH, CASS_USERNAME และ CASS_PASSWORD (OPDK-1309)

Edge Platform

ต่อไปนี้คือฟีเจอร์ใหม่ของแพลตฟอร์ม Edge ที่รวมอยู่ในรุ่นนี้

OpenJDK 1.7 ที่ Edge Private Cloud รองรับ

Edge รุ่นนี้รองรับ Oracle JDK 1.7 และ OpenJDK 7 และได้นำการรองรับ JDK 1.6 ออกแล้ว (OPDK-1187)

การรองรับระบบปฏิบัติการ

Apigee Edge สำหรับ Private Cloud ได้ขยายการรองรับระบบปฏิบัติการให้ครอบคลุม Red Hat Enterprise Linux 6.6 และ 7.0 (64 บิต), CentOS 6.5, 6.6 และ 7.0 (64 บิต) รวมถึง Oracle Linux 6.5

รวม Cassandra 2.0.15 ไว้ใน OPDK 15.07

รุ่นนี้จะติดตั้ง Cassandra 2.0.15 หากคุณอัปเกรดจากรุ่นก่อนหน้า ระบบจะอัปเดต Cassandra เวอร์ชันของคุณ (OPDK-1197)

การรองรับ SHA2 สำหรับการแฮชโทเค็น OAuth

Edge รองรับอัลกอริทึม SHA2 สำหรับการแฮชโทเค็น OAuth (นอกเหนือจาก SHA1) เพื่อปกป้องโทเค็น OAuth ได้ดียิ่งขึ้นในกรณีที่เกิดการละเมิดความปลอดภัยของฐานข้อมูล พร็อพเพอร์ตี้ระดับองค์กรใหม่ ช่วยให้คุณเปิดใช้และกำหนดค่าการแฮชสำหรับโทเค็นใหม่ รวมถึงคงการแฮชเดิม ไว้ในโทเค็นที่มีอยู่ก่อนฟีเจอร์ใหม่นี้ได้ ก่อนหน้านี้ใน Edge for Private Cloud พร็อพเพอร์ตี้ที่ชื่อ hash.oauth.tokens.enabled ในไฟล์ keymanagement.properties (ในเซิร์ฟเวอร์การจัดการและตัวประมวลผลข้อความ) ได้เปิดใช้การแฮช SHA1 ของโทเค็น OAuth โดยอัตโนมัติ เราเลิกใช้งานพร็อพเพอร์ตี้นี้แล้ว

หากก่อนหน้านี้คุณใช้พร็อพเพอร์ตี้ hash.oauth.tokens.enabled เพื่อเปิดใช้การแฮช SHA1 สคริปต์การอัปเกรดสำหรับรุ่นนี้จะสร้างพร็อพเพอร์ตี้ระดับองค์กรใหม่ให้คุณโดยอัตโนมัติ หากต้องการ ยืนยันหลังการอัปเกรด ให้ส่งคำขอ GET ในฐานะผู้ดูแลระบบด้วย API นี้ https://{host}:{port}/v1/o/{your_org}

• ดูข้อมูลเกี่ยวกับการเปิดใช้การแฮชโทเค็นในองค์กรด้วยพร็อพเพอร์ตี้ใหม่ได้ที่ "การแฮชโทเค็นในฐานข้อมูล" ในหัวข้อการขอโทเค็นเพื่อการเข้าถึง
• ดูข้อมูลเกี่ยวกับการแฮชโทเค็นที่มีอยู่เป็นกลุ่มได้ที่คู่มือการปฏิบัติงานของ Edge สำหรับ Private Cloud (APIRT-1389)

โครงสร้างไดเรกทอรีแบบเรียบสำหรับไฟล์บันทึก

คุณสามารถกำหนดค่า Edge ให้จัดเก็บไฟล์บันทึกในโครงสร้างไดเรกทอรีแบบราบได้โดยตั้งค่าพร็อพเพอร์ตี้ใหม่ enable.flat.directory.structure เป็น true ในไฟล์ message-logging.properties ดูข้อมูลเพิ่มเติมได้ที่นโยบายการบันทึกข้อความ (APIRT-1394)

ประสิทธิภาพของแคชสภาพแวดล้อม

เราได้เลิกใช้งานการตั้งค่า "องค์ประกอบสูงสุดในหน่วยความจำ" ในทรัพยากรแคชของสภาพแวดล้อมเพื่อการจัดการและการใช้แคชในหน่วยความจำที่ดีขึ้น จำนวนองค์ประกอบทั้งหมดที่มีอยู่ใน ทรัพยากรแคชทั้งหมด (รวมถึงแคชเริ่มต้น) จะขึ้นอยู่กับหน่วยความจำทั้งหมดที่จัดสรรให้กับ แคช โดยค่าเริ่มต้น หน่วยความจำทั้งหมดที่จัดสรรไว้สำหรับการแคชในหน่วยความจำในเครื่องประมวลผลข้อความที่กำหนด คือ 40% ของหน่วยความจำทั้งหมดที่ใช้ได้ ซึ่งกำหนดโดยการตั้งค่าพร็อพเพอร์ตี้แคชในไฟล์ cache.properties ของเครื่องประมวลผลข้อความ ระบบจะนำองค์ประกอบออกจากแคชในหน่วยความจำก็ต่อเมื่อมีหน่วยความจำแคชไม่เพียงพอหรือองค์ประกอบหมดอายุ

หากต้องการเปลี่ยนกลับไปใช้ลักษณะการทำงานเดิมของการใช้พร็อพเพอร์ตี้ "Maximum Elements in Memory" สำหรับ การจัดการแคช ให้ตั้งค่าพร็อพเพอร์ตี้ overrideMaxElementsInCacheResource=false ในไฟล์ cache.properties (APIRT-1140)

บริการ API

ฟีเจอร์ใหม่ของบริการ API ที่รวมอยู่ในรุ่นนี้มีดังนี้

ใช้โปรแกรมแก้ไขพร็อกซีใหม่เป็นค่าเริ่มต้น

ระบบจะเปิดใช้เครื่องมือแก้ไขพร็อกซี API ใหม่โดยค่าเริ่มต้นใน UI การจัดการ เครื่องมือแก้ไขใหม่มีการปรับปรุงด้านความสามารถในการใช้งานหลายอย่าง ซึ่งรวมถึงมุมมองที่ครอบคลุมมากขึ้นของโฟลว์แบบมีเงื่อนไขและ ปลายทางในหน้าภาพรวม การกำหนดค่าทั้งหมดในหน้าพัฒนา การเพิ่มโฟลว์แบบมีเงื่อนไข ปลายทาง และนโยบายที่ใช้งานง่ายขึ้น มุมมอง XML ที่สมบูรณ์มากขึ้นแทนที่จะเป็นข้อมูลโค้ดขนาดเล็ก การค้นหาที่ทำการ Crawl ชื่อไฟล์และข้อความ และอื่นๆ (MGMT-2279)

นโยบายใหม่ในการลบข้อมูล OAuth v2.0

นโยบาย "ลบข้อมูล OAuth v2.0" ใหม่ช่วยให้คุณลบโทเค็นเพื่อการเข้าถึง OAuth v2 และรหัสการให้สิทธิ์ได้ นโยบายนี้จะแทนที่ฟังก์ชันการทำงานที่ API การจัดการเคยมีให้ ดูข้อมูลเพิ่มเติมได้ที่นโยบายการลบ ข้อมูล OAuthV2 (MGMT-2257)

นโยบายใหม่ในการลบข้อมูล OAuth v1.0

นโยบายใหม่ "ลบข้อมูล OAuth v1.0" ช่วยให้คุณลบโทเค็นคำขอ โทเค็นเพื่อการเข้าถึง และรหัสยืนยัน OAuth v1.0 ได้ นโยบายนี้จะแทนที่ฟังก์ชันการทำงานที่ API การจัดการ เคยมีให้ ดูข้อมูลเพิ่มเติมได้ที่นโยบายการลบข้อมูล OAuth V1 (APIRT-1351)

นโยบายการควบคุมการเข้าถึง

เราได้ปรับปรุงนโยบายการควบคุมการเข้าถึงเพื่อให้ประเมินที่อยู่ IP ได้ละเอียดยิ่งขึ้น สำหรับการอนุญาตและปฏิเสธรายการเมื่อที่อยู่ IP อยู่ใน X-FORWARDED-FOR ส่วนหัว HTTP

เมื่อเปิดใช้การตรวจสอบที่อยู่ IP หลายรายการในส่วนหัว (ติดต่อทีมสนับสนุนเพื่อตั้งค่า feature.enableMultipleXForwardCheckForACL) องค์ประกอบ <ValidateBasedOn> ใหม่ในนโยบายจะช่วยให้คุณตรวจสอบกับ IP แรก, IP สุดท้าย หรือ IP ทั้งหมดในส่วนหัวได้ ดูข้อมูลเพิ่มเติมได้ที่นโยบายการควบคุมการเข้าถึง

เอนทิตีใหม่ในนโยบายเอนทิตีการเข้าถึง

นโยบายเอนทิตีการเข้าถึงจะให้สิทธิ์เข้าถึงเอนทิตีใหม่ต่อไปนี้ consumerkey-scopes, authorizationcode, requesttoken และ verifier ดูข้อมูลเพิ่มเติมได้ที่นโยบายเอนทิตีการเข้าถึง

นโยบายเครื่องมือรวบรวมสถิติ: การแปลงชื่อสถิติเป็นตัวพิมพ์เล็กโดยอัตโนมัติ

เมื่อสร้างคอลเล็กชันข้อมูลวิเคราะห์ที่กำหนดเองในเครื่องมือแก้ไขพร็อกซี API (หน้าพัฒนา > เครื่องมือ > คอลเล็กชันข้อมูลวิเคราะห์ที่กำหนดเอง) ตัวแปรของเครื่องมือรวบรวมข้อมูล (สถิติ) "ชื่อ" ต้องเป็นตัวพิมพ์เล็ก หากคุณป้อนชื่อด้วยตัวอักษรพิมพ์ใหญ่ เครื่องมือจะแปลงชื่อสถิติ เป็นตัวอักษรพิมพ์เล็กในนโยบายเครื่องมือรวบรวมสถิติโดยอัตโนมัติ (MGMT-740)

การนำการติดตามแบบคลาสสิกในเครื่องมือแก้ไขพร็อกซี API ออก

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

การเข้าถึงชุมชน Apigee จากเมนูความช่วยเหลือของ UI การจัดการ

คุณเข้าถึงชุมชน Apigee ได้จากเมนูความช่วยเหลือของ UI การจัดการ

ข้อความแสดงข้อผิดพลาดใน UI การจัดการ

การปรับปรุงข้อความแสดงข้อผิดพลาดใน UI การจัดการมีดังนี้

• UI การจัดการที่ใช้จัดกลุ่มและแสดงข้อความแสดงข้อผิดพลาดทั้งหมดใน UI สำหรับเซสชันการเข้าสู่ระบบทั้งหมด เว้นแต่คุณจะปิดข้อความเหล่านั้น การอัปเดตนี้จะล้างข้อความแสดงข้อผิดพลาดโดยอัตโนมัติเมื่อคุณออกจากหน้าที่เกิดข้อผิดพลาด (MGMT-2254)
• UI การจัดการจะไม่ระงับข้อความแสดงข้อผิดพลาดที่ซ้ำกันอีกต่อไป (MGMT-2242)

การปรับปรุงประสิทธิภาพ UI และข้อผิดพลาด

เราได้ทำการปรับปรุงทั่วไปในส่วนต่างๆ ของ UI การจัดการ ซึ่งรวมถึงการแสดงหน้าเว็บ ประสิทธิภาพ และการล้างข้อความแสดงข้อผิดพลาด

ไฮเปอร์ลิงก์ของบทบาทในหน้าผู้ใช้ขององค์กรใน UI การจัดการ

ในหน้าผู้ใช้ขององค์กรใน UI การจัดการ (ผู้ดูแลระบบ > ผู้ใช้ขององค์กร) ตอนนี้ชื่อบทบาท เป็นไฮเปอร์ลิงก์แล้ว ซึ่งช่วยให้คุณไปยังหน้าบทบาทได้อย่างรวดเร็ว (MGMT-1055)

ตัวแปรเป้าหมายใหม่ในโฟลว์ข้อความ

ตัวแปรใหม่ในโฟลว์ข้อความจะให้ข้อมูล URL ที่สมบูรณ์ยิ่งขึ้นสำหรับปลายทางเป้าหมายและเซิร์ฟเวอร์เป้าหมาย ดังนี้

• TargetEndpoint: request.url แทนที่ target.basepath.with.query
• TargetServer: loadbalancing.targetserver แทนที่ targetserver.name นอกจากนี้ ระบบจะป้อนข้อมูล target.basepath ก็ต่อเมื่อมีการใช้ องค์ประกอบ <Path> ในองค์ประกอบ HTTPTargetConnection <LoadBalancer> ของ TargetEndpoint

รองรับการระบุชื่อเซิร์ฟเวอร์ (Server Name Indication หรือ SNI)

Edge รองรับการใช้การแสดงชื่อเซิร์ฟเวอร์ (Server Name Indication) ขาออก (จากเครื่องประมวลผลข้อความไปยังปลายทางเป้าหมาย) หากต้องการใช้ SNI โปรดติดต่อทีมสนับสนุนของ Apigee Edge

ต้องใช้ Java 1.7

SNI เป็นส่วนขยายของ TLS/SSL ซึ่งช่วยให้แสดงเป้าหมาย HTTPS หลายรายการจากที่อยู่ IP และพอร์ตเดียวกันได้โดยไม่ต้องกำหนดให้เป้าหมายทั้งหมดใช้ใบรับรองเดียวกัน

ไม่จำเป็นต้องมีการกำหนดค่าเฉพาะ Edge หากสภาพแวดล้อมของคุณได้รับการกำหนดค่าสำหรับ SNI ขาออก (Edge Cloud เป็นค่าเริ่มต้น) Edge จะรองรับ SNI ขาออก

Edge จะดึงชื่อโฮสต์จาก URL ของคำขอโดยอัตโนมัติ และ เพิ่มลงในคำขอแฮนด์เชค SSL ตัวอย่างเช่น หากโฮสต์เป้าหมายคือ https://example.com/request/path แสดงว่า Edge จะเพิ่มส่วนขยาย server_name ดังที่แสดง ด้านล่าง

ดูข้อมูลเพิ่มเติมเกี่ยวกับ SNI ได้ที่ http://en.wikipedia.org/wiki/Server_Name_Indication

"อัลกอริธึมลายเซ็น" ในรายละเอียดใบรับรอง SSL

เราได้เพิ่มฟิลด์ "อัลกอริทึมลายเซ็น" ใหม่ลงในรายละเอียดใบรับรอง SSL ซึ่งดูได้ใน UI การจัดการ (ผู้ดูแลระบบ > ใบรับรอง SSL) และ Management API (รับ รายละเอียดใบรับรองจากที่เก็บคีย์หรือที่เก็บที่เชื่อถือ) ฟิลด์จะแสดง "sha1WithRSAEncryption" หรือ "sha256WithRSAEncryption" ขึ้นอยู่กับประเภทของอัลกอริทึมการแฮชที่ใช้สร้าง ใบรับรอง

แสดงใบรับรอง SSL ที่ใกล้หมดอายุ

หน้าใบรับรอง SSL ใน UI การจัดการ (ผู้ดูแลระบบ > ใบรับรอง SSL) จะระบุเวลาที่ใบรับรอง SSL กำลังจะหมดอายุภายใน 10, 15, 30 หรือ 90 วัน ทั้งนี้ขึ้นอยู่กับการเลือกของคุณใน ฟิลด์แบบเลื่อนลงการหมดอายุใหม่

การกำหนดค่าข้อผิดพลาดในการป้องกันภัยคุกคาม

โดยค่าเริ่มต้น Edge จะแสดงรหัสสถานะข้อผิดพลาด HTTP 500 Internal Server Error และข้อผิดพลาด ExecutionFailed หากข้อความไม่ผ่านนโยบายการป้องกันภัยคุกคาม JSON หรือ XML คุณเปลี่ยนลักษณะการทำงานของข้อผิดพลาดนั้นได้ด้วยพร็อพเพอร์ตี้ระดับองค์กรใหม่ เมื่อตั้งค่าพร็อพเพอร์ตี้ org features.isPolicyHttpStatusEnabled เป็น true จะเกิดลักษณะการทำงานต่อไปนี้

• คำขอ: เมื่อแนบนโยบายการป้องกันภัยคุกคามกับโฟลว์คำขอใดก็ตาม ข้อความที่ไม่ถูกต้อง จะแสดงรหัสสถานะ 400 พร้อมข้อความแสดงข้อผิดพลาดของนโยบายที่เกี่ยวข้อง
• การตอบกลับ: เมื่อแนบนโยบายการป้องกันภัยคุกคามกับโฟลว์การตอบกลับใดก็ตาม ข้อความที่ไม่ถูกต้อง จะยังคงแสดงรหัสสถานะ 500 และข้อความแสดงข้อผิดพลาดของนโยบายที่เกี่ยวข้องข้อความใดข้อความหนึ่ง (แทนที่จะเป็น ExecutionFailed เพียงอย่างเดียว)

ลูกค้า Cloud ต้องติดต่อทีมสนับสนุนของ Apigee Edge เพื่อตั้งค่าพร็อพเพอร์ตี้ขององค์กร ฟีเจอร์นี้จะพร้อมให้บริการแก่ลูกค้า Edge Private Cloud ในรุ่นไตรมาสถัดไปของ Private Cloud

สคีมาที่อัปเดตแล้วสำหรับปลายทาง พร็อกซี และเอนทิตีอื่นๆ

เราได้อัปเดตสคีมาอ้างอิงสำหรับเอนทิตีที่ไม่ใช่นโยบาย เช่น TargetEndpoint, ProxyEndpoint, APIProxy และอื่นๆ อีกมากมาย ดู https://github.com/apigee/api-platform-samples/tree/master/schemas (APIRT-1249)

บริการสำหรับนักพัฒนาแอป

ต่อไปนี้คือฟีเจอร์ใหม่ของบริการสำหรับนักพัฒนาแอปที่รวมอยู่ในรุ่นนี้

Smart Docs เวอร์ชันสำหรับผู้ใช้ทั่วไป

SmartDocs จะเปลี่ยนจากเวอร์ชันเบต้าเป็นเวอร์ชันสำหรับผู้ใช้ทั่วไป การอัปเดตและฟีเจอร์ใหม่ๆ มีดังนี้

• รองรับ Swagger 2.0 รวมถึงการนำเข้าตามไฟล์หรือ URL รวมถึงรองรับ ออบเจ็กต์ความปลอดภัยที่กำหนดชื่อเอง
• การปรับปรุงการออกแบบภาพในเทมเพลตที่สร้าง Smart Docs
• การปรับปรุงความสามารถในการใช้งานและเวิร์กโฟลว์ในพอร์ทัลนักพัฒนาแอป ซึ่งพร้อมใช้งานผ่านเมนูเนื้อหา > SmartDocs ใน Drupal
• การตรวจสอบสิทธิ์ที่เคยเรียกว่า "โทเค็นที่กำหนดเอง" ตอนนี้เปลี่ยนชื่อเป็น "คีย์ API" แล้ว
• ออบเจ็กต์ "security" การตรวจสอบสิทธิ์ที่กำหนดไว้ที่ระดับการแก้ไข
• การกำหนดค่าการตรวจสอบสิทธิ์ไคลเอ็นต์ที่ระดับเทมเพลต การแก้ไขใหม่จะไม่รีเซ็ต ข้อมูลเข้าสู่ระบบไคลเอ็นต์ Smart Docs ที่กำหนดค่าไว้ล่วงหน้าอีกต่อไป

ดูคำอธิบายฟีเจอร์เพิ่มเติมได้ที่บล็อก โพสต์นี้

ดูเอกสารประกอบ SmartDocs ได้ที่การใช้ SmartDocs เพื่อจัดทำเอกสาร API

ชื่อแอปของนักพัฒนาแอปที่แสดงใน UI การจัดการ

แอปของนักพัฒนาซอฟต์แวร์ใน Edge มีทั้งชื่อภายในที่ไม่เปลี่ยนแปลงและชื่อที่แสดงซึ่งคุณเปลี่ยนได้ ในหน้าแอปของนักพัฒนาแอปใน UI การจัดการ (เผยแพร่ > แอปของนักพัฒนาแอป > ชื่อแอป) ระบบจะแสดง "ชื่อ" ภายในของแอปพร้อมกับ "ชื่อที่แสดง" ซึ่งช่วยให้ระบุแอปด้วยชื่อภายในได้ง่ายขึ้น เพื่อการแก้ปัญหาและการจัดการ API

บริการ Analytics

ต่อไปนี้คือฟีเจอร์ใหม่ของบริการข้อมูลวิเคราะห์ที่รวมอยู่ในรุ่นนี้

ขีดจำกัดเวลาของข้อมูลที่เก็บรักษาไว้

เมื่อสร้างรายงานข้อมูลวิเคราะห์ด้วย UI หรือ API การจัดการ ระบบจะเข้าถึงข้อมูลที่เก่ากว่า 6 เดือนนับจากวันที่ปัจจุบันไม่ได้โดยค่าเริ่มต้น หากต้องการเข้าถึงข้อมูลที่เก่ากว่า 6 เดือน โปรดติดต่อทีมสนับสนุนของ Apigee Edge

เราจะนำรายงานที่กำหนดเองเวอร์ชันคลาสสิกออกจาก UI การจัดการ

รายงานข้อมูลวิเคราะห์ที่กําหนดเองเวอร์ชันคลาสสิกที่ไม่บังคับจะไม่มีให้บริการใน UI การจัดการอีกต่อไป

ประสิทธิภาพของวิดเจ็ตการมีส่วนร่วมของนักพัฒนาแอป

เราได้ปรับปรุงวิดเจ็ต Funnel ในแดชบอร์ดข้อมูลวิเคราะห์หลัก (ส่วนการมีส่วนร่วมของนักพัฒนาแอป) เพื่อให้ประสิทธิภาพดียิ่งขึ้น

การสร้างรายได้

ฟีเจอร์การสร้างรายได้ใหม่ที่รวมอยู่ในรุ่นนี้มีดังนี้

การแจ้งเตือนทางอีเมลเกี่ยวกับแพ็กเกจราคา

การแจ้งเตือนทางอีเมลเกี่ยวกับแพ็กเกจราคาใหม่ช่วยให้คุณแจ้งเตือนนักพัฒนาแอปได้เมื่อนักพัฒนาแอปทำธุรกรรมหรือใช้จ่ายถึงขีดจำกัดที่กำหนดในแพ็กเกจราคาแบบเป็นกลุ่มหรือแบบรวมที่ซื้อ ดูรายละเอียดได้ที่ตั้งค่า การแจ้งเตือนโดยใช้เทมเพลตการแจ้งเตือน

การซิงค์ระยะเวลาของค่าธรรมเนียมที่เกิดซ้ำและพื้นฐานการรวบรวม

ในแพ็กเกจราคา อาจมีช่วงเวลาที่แตกต่างกัน 2 ช่วงที่ใช้งานอยู่

• ระยะเวลาของค่าธรรมเนียมแบบเรียกเก็บซ้ำที่กำหนดค่าไว้ในแท็บค่าธรรมเนียมของแพ็กเกจราคา ซึ่งกำหนดเวลาที่ระบบเรียกเก็บค่าธรรมเนียมแบบเรียกเก็บซ้ำจากนักพัฒนาแอป
• ระยะเวลาพื้นฐานของการรวบรวมที่กำหนดไว้ในตารางราคาสำหรับแพ็กเกจแบบตามปริมาณหรือแบบรวม ซึ่ง กำหนดเมื่อมีการรีเซ็ตการใช้แพ็กเกจสำหรับนักพัฒนาแอป

ตอนนี้ระยะเวลาทั้ง 2 ช่วงซิงค์กันแล้ว เมื่อมีทั้งค่าธรรมเนียมแบบเรียกเก็บซ้ำที่ไม่ใช่ 0 และตารางอัตราค่าบริการแบบตามปริมาณ หรือแบบแพ็กเกจในแพ็กเกจราคา ระบบจะใช้ระยะเวลาค่าธรรมเนียมแบบเรียกเก็บซ้ำสำหรับทั้ง 2 อย่าง ตัวอย่างเช่น หากมีค่าธรรมเนียมแบบรายเดือนที่เรียกเก็บซ้ำ ระบบจะรีเซ็ตแพ็กเกจในตารางอัตราค่าบริการเป็นรายเดือนด้วย (โดยค่าเริ่มต้นคือ ในช่วงต้นเดือน)

หากไม่มีค่าธรรมเนียมแบบเกิดซ้ำ ระบบจะรีเซ็ตแพ็กเกจตามพื้นฐานการรวบรวมที่กำหนดไว้ใน บัตรราคา ตัวอย่างเช่น หากนักพัฒนาแอปเริ่มใช้ตารางราคาในวันที่ 19 ของเดือน และ พื้นฐานการรวบรวมคือทุกเดือน ระบบจะรีเซ็ตการใช้แพ็กเกจ 1 เดือนหลังจากวันที่ 19

เราจะเลิกใช้งาน Aggregation Basis และจะนำออกจากการสร้างรายได้ในรุ่นต่อๆ ไป ดูข้อมูลเพิ่มเติมได้ที่ระบุรายละเอียดแพ็กเกจการ์ดอัตราค่าโฆษณา

แอตทริบิวต์ที่กําหนดเองในรายงานรายได้สรุป

นโยบายการบันทึกธุรกรรมช่วยให้คุณเลือกบันทึกข้อมูลแอตทริบิวต์ที่กำหนดเองจากธุรกรรมได้ และตอนนี้คุณสามารถรวมแอตทริบิวต์ธุรกรรมที่กำหนดเองเหล่านั้นไว้ในรายงานรายได้สรุปได้แล้ว การเพิ่มพร็อพเพอร์ตี้ MINT.SUMMARY_CUSTOM_ATTRIBUTES ลงในองค์กรจะช่วยให้คุณ ระบุได้ว่าควรเพิ่มแอตทริบิวต์ที่กำหนดเองใดลงในตารางฐานข้อมูลเพื่อใช้ในรายงาน

ลูกค้า Apigee Edge สำหรับ Private Cloud สามารถตั้งค่าสถานะด้วยการเรียก API ต่อไปนี้และ ข้อมูลเข้าสู่ระบบของผู้ดูแลระบบ

curl -u email:password -X PUT -H "Content-type:application/xml" http://host:8080/v1/o/myorg -d \
"<Organization type="trial" name="MyOrganization">
    <Properties>
        <Property name="features.isMonetizationEnabled">true</Property>
        <Property name="MINT.SUMMARY_CUSTOM_ATTRIBUTES">[&quot;my_attribute_1&quot;,&quot;my_attribute_2&quot;]</Property>
        <Property name="features.topLevelDevelopersAreCompanies">false</Property>
    </Properties>
</Organization>"

โปรดทราบว่าอาร์เรย์ของแอตทริบิวต์ที่กำหนดเองในการเรียก API จะได้รับการเข้ารหัส URL

กระบวนการอัปเกรด SmartDocs

หากคุณใช้ SmartDocs ในช่วงเบต้าอยู่แล้ว ฟีเจอร์และความสามารถใหม่ๆ ในเวอร์ชันสำหรับผู้ใช้ทั่วไปกำหนดให้คุณต้องอัปเกรด SmartDocs ในพอร์ทัลนักพัฒนาซอฟต์แวร์

หน้า SmartDocs ที่เผยแพร่ในพอร์ทัลนักพัฒนาซอฟต์แวร์แล้วจะยังคงใช้งานได้ แต่คุณต้องทำตามกระบวนการอัปเดตก่อนที่จะแก้ไขหรือเผยแพร่การเปลี่ยนแปลงใดๆ ในหน้าที่มีอยู่หรือหน้าใหม่

โปรดทราบว่าแม้คุณจะแสดงผลและเผยแพร่ SmartDocs ภายในพอร์ทัลนักพัฒนาซอฟต์แวร์ได้ แต่ SmartDocs จะสร้างขึ้นจากโมเดล API ที่อยู่ในบริการการจัดการ API ของ Apigee Edge การเปลี่ยนแปลงใดๆ ที่คุณทำกับโมเดล API ใน Edge จะเหมือนกันในสภาพแวดล้อม Pantheon ทั้งหมด (คล้ายกับวิธีที่นักพัฒนาซอฟต์แวร์มีอยู่ในสภาพแวดล้อม Pantheon)

วิธีอัปเกรดจาก SmartDocs เวอร์ชันเบต้าเป็นเวอร์ชันสำหรับผู้ใช้ทั่วไป

1. อัปเดตและทดสอบรุ่น 15.05.27 ในสภาพแวดล้อมการพัฒนาหรือการทดสอบบน Pantheon
2. สร้างโมเดลใหม่เพื่อแทนที่โมเดล API ที่มีอยู่ซึ่งคุณใช้อยู่
   • หากคุณนำเข้าเอกสาร Swagger หรือ WADL ให้นำเข้าเอกสารเหล่านั้นอีกครั้งใน การแก้ไขใหม่
   • หากคุณดูแลรักษารูปแบบ API ผ่านโมดูล SmartDocs ให้ส่งออกเป็น SmartDocs JSON และนำเข้าไปยังโมเดลใหม่โดยใช้ไฟล์แนบ
3. ตั้งค่าพร็อพเพอร์ตี้ความปลอดภัยของการแก้ไขโมเดล ในหน้าเนื้อหา > SmartDocs > โมเดล ให้เลือกการตั้งค่าความปลอดภัย
   
4. ตรวจสอบการตรวจสอบสิทธิ์ที่กำหนดค่าไว้ล่วงหน้าในหน้าการตั้งค่าโมเดล (เนื้อหา > SmartDocs) โดยคลิกการตั้งค่าในคอลัมน์การดำเนินการ
   
5. อัปเดตเทมเพลตที่กำหนดเองเพื่อใช้ชิ้นงาน CSS และ JS เวอร์ชัน 6 และทำการเปลี่ยนแปลงเพื่อให้สอดคล้องกับ ชื่อออบเจ็กต์ใหม่ เช่น authSchemes และ apiSchema ดูข้อมูลเกี่ยวกับการอัปเดตเทมเพลต SmartDocs ได้ที่การใช้ SmartDocs เพื่อจัดทำเอกสาร API
6. แสดงผลอีกครั้งและเผยแพร่การแก้ไขโมเดล
7. หลังจากตรวจสอบเอกสารประกอบใหม่แล้ว ให้อัปเดตพอร์ทัลเวอร์ชันที่ใช้งานจริงเป็นรุ่น 15.05.27

หากคุณเป็นลูกค้าองค์กรของ Edge และมีคำถามหรือข้อกังวลเกี่ยวกับการอัปเกรด โปรดส่งอีเมลไปที่ marsh@apigee.com และ cnovak@apigee.com หรือใช้ชุมชน Apigee เพื่อรับคำตอบที่ดีที่สุด

การเปลี่ยนแปลงและการปรับปรุงฟีเจอร์ในอนาคต

ส่วนนี้แสดงตัวอย่างการเปลี่ยนแปลงและการปรับปรุงฟีเจอร์ที่คาดว่าจะเกิดขึ้นในอนาคต

การเปลี่ยนแปลงลักษณะการทำงานของนโยบายแคชการตอบกลับ

ในการเปิดตัวเวอร์ชันใหม่ในอนาคต (ซึ่งจะกำหนดในภายหลัง) ลักษณะการทำงานเริ่มต้นขององค์ประกอบ <ExcludeErrorResponse> ของนโยบายแคชการตอบกลับจะมีการเปลี่ยนแปลง

ลักษณะการทำงานปัจจุบัน: องค์ประกอบ <ExcludeErrorResponse> ใน นโยบายแคชการตอบกลับเป็นเท็จโดยค่าเริ่มต้น ซึ่งหมายความว่าโดยค่าเริ่มต้น นโยบายแคชการตอบกลับจะแคชการตอบกลับที่มีรหัสสถานะ HTTP ที่เป็นไปได้ (รวมถึง 3xx)

ลักษณะการทำงานในอนาคต: องค์ประกอบ <ExcludeErrorResponse> ใน นโยบายแคชการตอบกลับจะมีค่าเริ่มต้นเป็นจริง ซึ่งหมายความว่าโดยค่าเริ่มต้น ระบบจะแคชเฉพาะการตอบกลับที่มีรหัสสถานะ HTTP 200 ถึง 205 หากต้องการลบล้างลักษณะการทำงานนี้และแคชการตอบกลับสำหรับรหัสสถานะทั้งหมด คุณจะต้องตั้งค่าองค์ประกอบ <ExcludeErrorResponse> เป็น true อย่างชัดเจน

วิธีแก้ปัญหาชั่วคราวในปัจจุบัน: สำหรับ Private Cloud 4.15.07.00 และรุ่นเก่ากว่า หากต้องการแคชการตอบกลับที่มีรหัสสถานะ 200 ถึง 205 เท่านั้น คุณต้องตั้งค่าองค์ประกอบ <ExcludeErrorResponse> เป็น true อย่างชัดเจน

แก้ไขข้อบกพร่องแล้ว

เราได้แก้ไขข้อบกพร่องต่อไปนี้ในรุ่นนี้

ปัญหาที่ทราบ

รุ่นนี้มีปัญหาที่ทราบดังต่อไปนี้

> source /{install-dir}/apigee4/bin/apigee-env.sh

> VER=`basename $(find $SHARE_DIR/installer/monetization -name "mint-*.zip") | cut -d "-" -f 2,3,4`

> sed -i "s/^MONETIZATION_VERSION=.*/MONETIZATION_VERSION=$VER/" /install-dir/apigee4/bin/apigee-env.sh

> rm /install-dir/apigee4/share/monetization

**************************************
In order to complete the monetization upgrade please run:
sudo /opt/apigee4/share/monetization/schema/migration/MOPDK4.15.04.00/
365-create-notification-condition.sh
**************************************

connect.ranges.denied=10.0.0.0/8,192.168.0.0/16,127.0.0.1/32

<install_dir>/apigge4/bin/apigee-service message-processor restart