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

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

เมื่อวันอังคารที่ 8 กันยายน 2015 เราได้เปิดตัว Feature Release ที่สำคัญของ 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. เรียกใช้คำสั่งค้นหานี้
      > find -name *-hf-*
      ผลลัพธ์ควรเว้นว่างไว้ ซึ่งหมายความว่าจะไม่มีไฟล์ .db อยู่ในรูปแบบ hf หากไม่เห็นไฟล์ในรูปแบบ hf แสดงว่าการดำเนินการเสร็จสิ้นและสามารถอัปเกรดเป็น 4.15.07.00 ได้
      
      รูปแบบ hf มีไว้สำหรับ Cassandra 1.0 SSTables หากมีไฟล์ *.db ในรูปแบบ hf คุณจะต้องอัปเกรด SSTable ตามที่อธิบายไว้ในส่วนที่เหลือของกระบวนการนี้
2. หากคุณพบไฟล์ *.db ในรูปแบบ hf ให้อัปเกรด SSTable โดยการเรียกใช้คำสั่งต่อไปนี้ในโหนด Cassandra ทั้งหมดจนกว่าคุณจะอัปเกรดโหนด 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. หลังจากอัปเกรดแล้ว
   
   -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)

การติดตั้ง SmartGoogle

เมื่อติดตั้ง SmartDocs ด้วยสคริปต์ Setup-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 ที่รวมอยู่ในรุ่นนี้

Edge Private Cloud รองรับ OpenJDK 1.7

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 พร็อพเพอร์ตี้ชื่อแฮช.oauth.tokens.enabled ในไฟล์ keymanagement.properties (ในเซิร์ฟเวอร์การจัดการและผู้ประมวลผลข้อความ) ได้เปิดใช้การแฮช SHA1 โดยอัตโนมัติของโทเค็น OAuth พร็อพเพอร์ตี้นี้เลิกใช้งานแล้ว

หากก่อนหน้านี้คุณใช้พร็อพเพอร์ตี้ Has.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 ที่สมบูรณ์มากขึ้นแทนตัวอย่างข้อมูลขนาดเล็ก การค้นหาที่รวบรวมข้อมูลชื่อไฟล์และข้อความ และอีกมากมาย (MGMT-2279)

นโยบายการลบข้อมูล OAuth เวอร์ชัน 2.0 ใหม่

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

นโยบายการลบข้อมูล OAuth เวอร์ชัน 1.0 ใหม่

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

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

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

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

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

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

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

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

การนำ Classic Trace ในเครื่องมือแก้ไขพร็อกซีของ API ออก

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

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

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

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

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

โดยค่าเริ่มต้น Edge จะแสดงรหัสสถานะข้อผิดพลาดภายในเซิร์ฟเวอร์ HTTP 500 และข้อผิดพลาด ExecutionFailed หากข้อความไม่ผ่านนโยบาย Threat Protection ของ 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)

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

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

ความพร้อมให้บริการโดยทั่วไปของ Smartdocs

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

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

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

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

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

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

บริการการวิเคราะห์

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

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

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

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

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

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

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

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

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

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

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

การซิงค์ช่วงเวลาของค่าธรรมเนียมและระยะเวลาการสรุปเก็บข้อมูลตามรอบ

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

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

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

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

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

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

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

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

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

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