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

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

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

การติดตั้ง SmartDocument

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

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

• ดูข้อมูลเพิ่มเติมเกี่ยวกับการเปิดใช้การแฮชโทเค็นในองค์กรด้วยพร็อพเพอร์ตี้ใหม่ได้ที่ "การแฮชโทเค็นในฐานข้อมูล" ในหัวข้อการขอโทเค็นเพื่อการเข้าถึง หัวข้อ
• โปรดดูข้อมูลเกี่ยวกับการแฮชโทเค็นที่มีอยู่แบบเป็นกลุ่มที่หัวข้อ Edge for 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 ที่สมบูรณ์มากกว่าข้อมูลโค้ดขนาดเล็ก การค้นหาที่รวบรวมข้อมูลชื่อไฟล์และข้อความ และอื่นๆ (MGMT-2279)

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

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

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

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

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

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

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

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

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

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

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

การสนับสนุน Server Name Information Interface (SNI)

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

ต้องใช้ Java 1.7

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

ไม่ต้องกำหนดค่าเฉพาะ Edge หากมีการกำหนดค่าสภาพแวดล้อมให้เป็นแบบทิศใต้ SNI (Edge คือระบบคลาวด์โดยค่าเริ่มต้น) 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) และ API การจัดการ (รับ รายละเอียดใบรับรองจากคีย์สโตร์หรือ Truststore) ฟิลด์นี้จะแสดง "sha1WithRSAEncryption" หรือ "sha256WithRSAEncryption" ขึ้นอยู่กับประเภทอัลกอริทึมการแฮชที่ใช้ในการสร้าง ใบรับรอง

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

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

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

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

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

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

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

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

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

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

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

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

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

สำหรับคำอธิบายคุณลักษณะเพิ่มเติม โปรดดูบล็อกนี้ โพสต์

โปรดดูเอกสารประกอบของ Smartdocs ที่หัวข้อการใช้ SmartDocuments เพื่อจัดทำเอกสาร API

ชื่อแอปนักพัฒนาซอฟต์แวร์ที่แสดงใน UI การจัดการ

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

บริการ Analytics

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

ขีดจำกัดเวลาอินเทอร์เน็ตที่สงวนไว้

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

รายงานที่กำหนดเองเวอร์ชันเดิมถูกนำออกจาก UI การจัดการแล้ว

รายงาน Analytics ที่กำหนดเองเวอร์ชันคลาสสิกที่เป็นตัวเลือก ไม่มีจำหน่ายใน UI ของการจัดการ

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

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

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

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

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

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

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

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

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

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

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

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

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

นโยบายการบันทึกธุรกรรมช่วยให้คุณบันทึกข้อมูลแอตทริบิวต์ที่กำหนดเองจาก ธุรกรรม และคุณสามารถรวมแอตทริบิวต์ธุรกรรมที่กำหนดเองเหล่านั้นไว้ในสรุปรายได้ รายงาน เมื่อเพิ่มพร็อพเพอร์ตี้ 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 ในช่วงเบต้า ฟีเจอร์และความสามารถใหม่ๆ ในเวอร์ชันสำหรับผู้ใช้ทั่วไป คุณต้องอัปเกรด SmartDocuments ในนักพัฒนาซอฟต์แวร์ของคุณ พอร์ทัล

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

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

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

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

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

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

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

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

จะมีมาในรุ่นในอนาคต (รอการกำหนด) ลักษณะการทำงานเริ่มต้นของ &lt;ExcludeErrorResponse&gt; ของนโยบายแคชการตอบกลับจะเปลี่ยนไป

การทำงานปัจจุบัน: องค์ประกอบ <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