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 for Private Cloud เป็นเวอร์ชันใดได้บ้าง 4.15.07.00

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

1. ตรวจสอบเวอร์ชัน SSTable ของ Cassandra โดยทำดังนี้
   1. เปลี่ยนไดเรกทอรีเป็น /<install-root>/apigee4/data/cassandra/data
   2. เรียกใช้คำสั่ง find
      > 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

ต่อไปนี้คือฟีเจอร์ใหม่ของแพลตฟอร์ม 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 สำหรับ 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 ใหม่เป็น "จริง" ในไฟล์ message-logging.properties ดูข้อมูลเพิ่มเติมได้ที่นโยบายการบันทึกข้อความ (APIRT-1394)

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

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

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

บริการ API

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

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

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

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

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

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

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

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

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

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

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

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

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

เมื่อสร้างคอลเล็กชันข้อมูลวิเคราะห์ที่กําหนดเองในเครื่องมือแก้ไขพร็อกซี 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

การรองรับการแสดงชื่อเซิร์ฟเวอร์ (SNI)

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

ต้องใช้ Java 1.7

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

SmartDocs พร้อมให้บริการแก่ผู้ใช้ทั่วไป

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

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

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

ดูเอกสารประกอบของ SmartDocs ได้ที่การใช้ SmartDocs เพื่อเขียนเอกสารประกอบ API

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

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

บริการ Analytics

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

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

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

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

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

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

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

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

ต่อไปนี้คือฟีเจอร์การสร้างรายได้ใหม่ที่มีให้ในรุ่นนี้

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

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

การซิงค์ระยะเวลาของค่าธรรมเนียมตามรอบและระยะเวลาของฐานการรวม

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

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

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

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

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

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

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

ลูกค้า Apigee Edge สำหรับ Private Cloud สามารถตั้งค่า Flag โดยใช้การเรียก 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 ที่อาศัยอยู่ภายในบริการการจัดการ Edge API ของ Apigee การเปลี่ยนแปลงใดๆ ที่คุณทำกับโมเดล API ใน Edge จะเหมือนกันในทุกสภาพแวดล้อมของ Pantheon (คล้ายกับวิธีที่นักพัฒนาซอฟต์แวร์มีอยู่ในทุกสภาพแวดล้อมของ Pantheon)

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

1. อัปเดตและทดสอบรุ่น 15.05.27 ในสภาพแวดล้อม dev หรือ test ใน 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 Enterprise และมีคำถามหรือข้อกังวลเกี่ยวกับกระบวนการอัปเกรด โปรดส่งอีเมลไปที่ marsh@apigee.com และ cnovak@apigee.com หรือใช้ชุมชน Apigee เพื่อรับคำตอบที่ดีที่สุด

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

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

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

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

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

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

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

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

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

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

เวอร์ชันนี้มีปัญหาที่ทราบดังต่อไปนี้

> 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