คุณกำลังดูเอกสารประกอบของ Apigee Edge
ไปที่เอกสารประกอบของ
Apigee X info
ส่วนนี้อธิบายการเปิดตัวฟีเจอร์ Edge for Private Cloud เวอร์ชัน 4.18.05
ข้อมูลสรุปของรุ่น
ตารางต่อไปนี้สรุปการเปลี่ยนแปลงในฟีเจอร์รุ่นนี้
| ฟีเจอร์ใหม่ | ○ ตอนนี้นโยบาย JWT พร้อมให้บริการแก่บุคคลทั่วไป (GA) แล้ว ○ ตอนนี้ระบบรองรับ RedHat Enterprise Linux 6.9 แล้ว ○ ตอนนี้ระบบรองรับ Oracle Linux 6.9 แล้ว ○ ตอนนี้ระบบรองรับ CentOS 6.9 แล้ว ○ การเปลี่ยนแปลงการกำหนดค่าการติดตั้งใช้งานประสบการณ์ Edge ใหม่ ○ ตอนนี้คุณตั้งค่าตัวเลือกการลองใหม่ของเราเตอร์ได้ที่ระดับโฮสต์เสมือนแล้ว |
|||
| ผลงานที่รวม |
|
|||
| การหยุดให้บริการ | ○ API BaaS ○ แดชบอร์ดการตรวจสอบ (เบต้า) |
|||
| การเลิกใช้งาน | ○ KVM แทนที่ที่เก็บข้อมูลที่ปลอดภัย (Vault) ของ Apigee ○ การเพิ่มเส้นทางในแท็บประสิทธิภาพของพร็อกซี API ○ พร็อพเพอร์ตี้ SMTPSSL สำหรับพอร์ทัลบริการสำหรับนักพัฒนาซอฟต์แวร์ |
|||
| การแก้ไขข้อบกพร่อง | ○ ป้องกันไม่ให้มีการเปลี่ยนแปลงอีเมลของผู้ใช้ (65550638) ○ ช่องโหว่ด้านความปลอดภัยใน jackson-databind (69711616) ○ หน่วยความจำรั่วใน Message Processors (71612599) |
|||
| ปัญหาที่ทราบ | รุ่นนี้มีปัญหาที่ทราบแล้วดังต่อไปนี้ ○ การสำรองข้อมูล Message Processor ไม่ได้สำรองข้อมูลชุดไฟล์ที่ถูกต้อง (121095148)○ คำขอ HEAD ไปยังเป้าหมาย Node.js ค้าง (79993247)○ ตัวเลือกสร้างพร็อกซีแบบย้อนกลับผ่าน Open API แสดงขึ้น (79949124) ○ ชื่อโฮสต์ไม่ได้รับการแก้ไข (79757554) ○ DataAccessExceptions ในการกำหนดค่าศูนย์ข้อมูลหลายแห่ง (76087166) ○ ข้อความแสดงข้อผิดพลาดเกี่ยวกับสิทธิ์ปรากฏขึ้นเมื่อหยุด apigee-postgresql (72379834) ○ นโยบาย MessageLogging ที่มีข้อมูลเพิ่มเติมในข้อความในบันทึก (68722102) ดูข้อมูลเพิ่มเติมเกี่ยวกับปัญหาที่ทราบแต่ละรายการ รวมถึงวิธีแก้ปัญหาเบื้องต้นได้ที่ ปัญหาที่ทราบ |
|||
ส่วนต่อไปนี้จะอธิบายแต่ละหัวข้อเหล่านี้โดยละเอียด
เส้นทางการอัปเกรด
ตารางต่อไปนี้แสดงเส้นทางการอัปเกรดสำหรับฟีเจอร์รุ่นนี้
| ตั้งแต่ 4.18.01 | อัปเกรดจาก 4.18.01 → 4.18.05 โดยตรง |
| ตั้งแต่วันที่ 17 เมษายน 2009 | อัปเกรดจาก 4.17.09 → 4.18.05 โดยตรง |
| ตั้งแต่ 17/04/05 | อัปเกรดจาก 4.17.05 เป็น 4.18.05 โดยตรง |
| ตั้งแต่ 4.17.01 | อัปเกรดจาก 4.17.01 → 4.18.01 จากนั้นอัปเกรดจาก 4.18.01 → 4.18.05 |
| ตั้งแต่ 16/04/09 | อัปเกรดจาก 4.16.09 → 4.18.01 จากนั้นอัปเกรดจาก 4.18.01 → 4.18.05 |
| ตั้งแต่ 4.16.05 | อัปเกรดจาก 4.16.05 → 4.18.01 จากนั้นอัปเกรดจาก 4.18.01 → 4.18.05 |
| ตั้งแต่ 4.16.01 | อัปเกรดจาก 4.16.01 → 4.18.01 จากนั้นอัปเกรดจาก 4.18.01 → 4.18.05 |
| ตั้งแต่ 4.15.0x | อัปเกรดจาก 4.15.0x → 4.16.01 จากนั้นอัปเกรดจาก 4.16.01 → 4.18.01 แล้วอัปเกรดจาก 4.18.01 → 4.18.05 |
ฟีเจอร์ใหม่
ส่วนนี้จะอธิบายฟีเจอร์ใหม่ในการเปิดตัวฟีเจอร์นี้ นอกเหนือจากฟีเจอร์เหล่านี้แล้ว รุ่นนี้ยังมีฟีเจอร์ทั้งหมดในรุ่น UI ของ Edge, การจัดการ Edge และพอร์ทัลที่แสดงอยู่ใน รุ่นที่รวมไว้
นอกจากการปรับปรุงต่อไปนี้แล้ว รุ่นนี้ยังมีการปรับปรุงด้านความสามารถในการใช้งาน ประสิทธิภาพ ความปลอดภัย และความเสถียรอีกหลายอย่างด้วย
นโยบาย JWT
นโยบาย JWT ต่อไปนี้ไม่ได้อยู่ในเวอร์ชันเบต้าแล้ว และพร้อมใช้งานสำหรับผู้ใช้ทั่วไปแล้ว
ซอฟต์แวร์ที่รองรับ
การเปิดตัวฟีเจอร์นี้มีการเปลี่ยนแปลงต่อไปนี้ในซอฟต์แวร์ที่รองรับ
- ตอนนี้รองรับ Red Hat Enterprise Linux (RHEL) 6.9 แล้ว
- ตอนนี้ระบบรองรับ Oracle Linux 6.9 แล้ว
- ขณะนี้ระบบรองรับ CentOS 6.9 แล้ว
- ระบบไม่รองรับ RHEL/CentOS/Oracle Linux 7.2 อีกต่อไป
ดูข้อมูลเพิ่มเติมได้ที่ ซอฟต์แวร์และเวอร์ชันที่รองรับ
การเปลี่ยนแปลงการกำหนดค่าการติดตั้งประสบการณ์การใช้งาน Edge ใหม่
การเปิดตัวประสบการณ์การใช้งาน Edge เวอร์ชันใหม่ 4.18.05 มีการเปลี่ยนแปลงไฟล์การกำหนดค่าจาก การเปิดตัวเวอร์ชัน 4.18.01 พร็อพเพอร์ตี้ใหม่จะอธิบายไว้ใน การติดตั้ง การเปลี่ยนแปลงการกำหนดค่าจาก Edge 4.18.01
ตอนนี้คุณตั้งค่าตัวเลือกการลองเราเตอร์อีกครั้งได้ที่ระดับโฮสต์เสมือนแล้ว
ตอนนี้คุณสามารถตั้งค่าตัวเลือกการลองใหม่สำหรับการสื่อสารของ Router กับ Message Processor ในโฮสต์เสมือนได้แล้ว ซึ่งจะช่วยให้คุณควบคุมได้ละเอียดกว่าตัวเลือกก่อนหน้าซึ่ง ตั้งค่าได้ที่ระดับเราเตอร์เท่านั้น
ดูข้อมูลเพิ่มเติมได้ที่ พร็อพเพอร์ตี้การกำหนดค่า โฮสต์เสมือน
มิติข้อมูลวิเคราะห์ใหม่และการเปลี่ยนแปลงมิติข้อมูล x_forwarded_for_ip
Edge เปลี่ยนวิธีตั้งค่าx_forwarded_for_ipมิติข้อมูล
ในข้อมูลวิเคราะห์ของ Edge แล้ว ก่อนหน้านี้ หากมีที่อยู่ IP หลายรายการในส่วนหัว X-Forwarded-For
มิติข้อมูล x_forwarded_for_ip จะมีเฉพาะที่อยู่ IP สุดท้ายที่แสดง
ลูกค้ามักใช้มิติข้อมูล x_forwarded_for_ip เพื่อระบุที่อยู่ IP ของ
ไคลเอ็นต์ที่ส่งคำขอ API ไปยัง Edge
ในการเปิดตัวครั้งนี้ x_forwarded_for_ip มิติข้อมูลจะมีรายการที่อยู่ IP ทั้งหมดในส่วนหัวของ X-Forwarded-For
คำเตือน: ส่วนหัว X-Forwarded-For อาจถูกปลอมแปลงโดย IP ที่ถูกปฏิเสธการเข้าถึง
ยกเว้นที่อยู่สุดท้ายในส่วนหัว ซึ่งเป็นที่อยู่ IP ที่ Edge ได้รับจากการแฮนด์เชค TCP ภายนอกครั้งล่าสุด
การเปิดตัวครั้งนี้จะเพิ่มมิติข้อมูลใหม่ลงในข้อมูลวิเคราะห์ของ Edge ซึ่งก็คือ ax_resolved_client_ip เพื่อระบุที่อยู่ IP ของไคลเอ็นต์เดิมที่ส่งคำขอ API ไปยัง Edge
ตอนนี้คุณสามารถใช้มิติข้อมูล ax_resolved_client_ip ในรายงานที่กําหนดเองหรือใน
เงื่อนไขตัวกรองในรายงานที่กําหนดเองเพื่อระบุที่อยู่ IP ของไคลเอ็นต์ที่ทําคําขอ API ได้แล้ว
ดูข้อมูลเพิ่มเติมเกี่ยวกับมิติข้อมูล ax_resolved_client_ip ได้ที่ข้อมูลอ้างอิงเมตริก มิติข้อมูล และตัวกรองของ Analytics
การเปลี่ยนแปลงนี้ยังส่งผลต่อวิธีที่นโยบาย AccessControl จัดการส่วนหัว X-Forwarded-For ด้วย
ในรุ่นนี้ Edge จะกรอกข้อมูลในX-Forwarded-Forส่วนหัว HTTP โดยอัตโนมัติด้วย
ที่อยู่ IP เดียวที่ได้รับจากแฮนด์เชค TCP ภายนอกล่าสุด (เช่น IP ของไคลเอ็นต์หรือเราเตอร์)
ในรุ่นก่อนหน้า Edge จะตั้งค่าส่วนหัว HTTP X-Forwarded-For ด้วยที่อยู่ IP เดียวที่ได้รับจากแฮนด์เชค TCP ภายนอกครั้งแรก (เช่น IP ของไคลเอ็นต์หรือเราเตอร์)
ดูข้อมูลเพิ่มเติมได้ที่
เกี่ยวกับส่วนหัว HTTP ของ X-Forwarded-For
ผลงานที่รวมอยู่ด้วย
ตั้งแต่การเปิดตัวฟีเจอร์ Edge for Private Cloud ครั้งก่อน มีการเปิดตัวรุ่นต่อไปนี้ และรวมอยู่ในการเปิดตัวฟีเจอร์นี้
| UI ของ Edge | การจัดการ/รันไทม์ของ Edge | พอร์ทัล |
|---|---|---|
|
18.04.04 18.03.02 18.02.14 17.11.06 |
18.04.06 18.04.04 18.03.02* 18.02.02 18.01.05 |
18.04.25.01 18.04.25.00 18.04.23.00 18.03.28.00 18.03.05.00 18.02.15.00 18.01.31.00 17.12.20.00 |
| * การแก้ไขข้อบกพร่อง 74622499 ไม่รวมอยู่ในการเผยแพร่ Edge for Private Cloud 4.18.05 | ||
คลิกลิงก์ด้านบนเพื่อดูการแก้ไขข้อบกพร่องและฟีเจอร์ใหม่จากการเปิดตัวเหล่านั้นที่รวมอยู่ในการเปิดตัวฟีเจอร์นี้
การเลิกใช้งาน
ส่วนนี้อธิบายฟีเจอร์ที่เลิกใช้งานในการเปิดตัวฟีเจอร์นี้
API BaaS
เลิกใช้งาน API BaaS แล้ว ดูข้อมูลเพิ่มเติมได้ที่ การเลิกใช้งาน การหยุดให้บริการ และการเปลี่ยนแปลง CPS ของ Apigee
แดชบอร์ดการตรวจสอบ (เบต้า)
แดชบอร์ดการตรวจสอบ (เบต้า) ถูกเลิกใช้งานแล้วและจะไม่มีการรองรับอีกต่อไป ด้วยเหตุนี้ คอมโพเนนต์ต่อไปนี้จึงไม่ได้รวมอยู่ในการติดตั้งอีกต่อไป
apigee-influxdbapigee-telegrafapigee-grafana
หากต้องการรับเมตริกของ Router, Message Processor และโหนดต่อไป Apigee ขอแนะนําให้คุณ ใช้ JMX เพื่อผสานรวมข้อมูลของ Edge สำหรับ Private Cloud กับเครื่องมือตรวจสอบของคุณเอง ดูข้อมูลเพิ่มเติมได้ที่หัวข้อสิ่งที่ควรตรวจสอบและวิธีตรวจสอบ
หากอัปเกรดการติดตั้งที่มีอยู่เป็นเวอร์ชัน 4.18.05 คุณควรถอนการติดตั้งแดชบอร์ดการตรวจสอบ Apigee ไม่รับประกันว่าฟีเจอร์นี้จะยังคงทำงานได้ตามที่คาดไว้
การเลิกใช้งาน
เราเลิกใช้งานฟีเจอร์ต่อไปนี้ในฟีเจอร์รุ่นนี้
ดูข้อมูลเพิ่มเติมได้ที่ การเลิกใช้งาน การหยุดให้บริการ และการเปลี่ยนแปลง CPS ของ Apigee
ที่เก็บข้อมูลที่ปลอดภัยของ Apigee (Vault)
เราจะเลิกใช้งานที่เก็บข้อมูลที่ปลอดภัยของ Apigee หรือที่เรียกว่า "Vault" และจะหยุดให้บริการในเดือนกันยายน 2018
ให้ใช้แมปค่าคีย์ (KVM) ที่เข้ารหัสแทนการใช้ที่เก็บข้อมูลที่ปลอดภัย ตามที่อธิบายไว้ใน การทำงานกับแมปค่าคีย์ KVM ที่เข้ารหัสมีความปลอดภัยเช่นเดียวกับ Vault และมีตัวเลือกเพิ่มเติมสำหรับการสร้างและ การเรียกข้อมูล
การเพิ่มเส้นทางในแท็บประสิทธิภาพของพร็อกซี API
ก่อนการเปิดตัวนี้ คุณสามารถไปที่พร็อกซี API ใน UI การจัดการ ไปที่แท็บประสิทธิภาพ และสร้างเส้นทางต่างๆ สำหรับการเปรียบเทียบตามแผนภูมิในแท็บประสิทธิภาพของพร็อกซีและในแดชบอร์ดธุรกรรมทางธุรกิจ
เราเลิกใช้งานฟีเจอร์นี้แล้วและจะไม่มีให้บริการใน UI อีกต่อไป หากต้องการใช้ฟังก์ชันการทำงานนี้ในรูปแบบอื่น โปรดดู ทางเลือกแทน Business Transactions API
พร็อพเพอร์ตี้ SMTPSSL สำหรับพอร์ทัลบริการสำหรับนักพัฒนาแอป
หากต้องการตั้งค่าโปรโตคอลที่เซิร์ฟเวอร์ SMTP ใช้ซึ่งเชื่อมต่อกับพอร์ทัล ตอนนี้คุณต้องใช้พร็อพเพอร์ตี้ SMTP_PROTOCOL แทนพร็อพเพอร์ตี้ SMTPSSL ค่าที่ใช้ได้
ของ SMTP_PROTOCOL คือ "standard", "ssl" และ "tls"
ดูข้อมูลเพิ่มเติมได้ที่ การติดตั้งพอร์ทัลบริการสำหรับนักพัฒนาซอฟต์แวร์
การแก้ไขบั๊ก
ส่วนนี้แสดงข้อบกพร่องของ Private Cloud ที่ได้รับการแก้ไขในฟีเจอร์รุ่นนี้ นอกเหนือจากข้อบกพร่องที่แสดงอยู่ด้านล่างแล้ว ฟีเจอร์รุ่นนี้ยังรวมการแก้ไขข้อบกพร่องทั้งหมดใน UI ของ Edge, การจัดการ Edge และรุ่นพอร์ทัลที่แสดงในรุ่นที่รวมด้วย
| รหัสปัญหา | คำอธิบาย |
|---|---|
| 71612599 |
หน่วยความจำรั่วไหลในตัวประมวลผลข้อความ แก้ไขปัญหาหน่วยความจำรั่วไหลแล้ว เกิดขึ้นใน Message Processors เมื่อหยุด Qpidd แล้ว |
| 69711616 |
ช่องโหว่ด้านความปลอดภัยใน jackson-databind เราได้อัปเดตไลบรารี jackson-databind เป็นเวอร์ชัน 2.7.9.1 เพื่อป้องกันข้อบกพร่องในการ ยกเลิกการซีเรียลไลซ์ |
| 65550638 |
ป้องกันไม่ให้มีการเปลี่ยนอีเมลของผู้ใช้ คุณจะเปลี่ยนอีเมลของผู้ใช้ในเพย์โหลดข้อความที่ส่งไปยัง Management API ไม่ได้อีกต่อไป นอกจากนี้ ตอนนี้ Management API ยังไม่อนุญาตให้ใช้ XML ในส่วนเนื้อหาของคำขอด้วย |
ปัญหาที่ทราบ
ตารางต่อไปนี้แสดงปัญหาที่ทราบในฟีเจอร์รุ่นนี้
| รหัสปัญหา | คำอธิบาย |
|---|---|
| 121095148 |
การสำรองข้อมูล Message Processor ไม่ได้สำรองข้อมูลชุดไฟล์ที่ถูกต้อง วิธีแก้ปัญหาเฉพาะหน้า: เรียกใช้การสำรองข้อมูลเป็นครั้งที่ 2 แล้วระบบจะสำรองข้อมูลชุดไฟล์ที่ถูกต้อง |
| 79993247 |
คำขอ HEAD ไปยังเป้าหมาย Node.js อาจค้าง ทำให้การเชื่อมต่อรอดำเนินการ วิธีแก้ปัญหาเฉพาะหน้า: หากต้องการหลีกเลี่ยงปัญหานี้ ให้กำหนดตัวแฮนเดิลสำหรับคำขอ |
| 79949124 |
สร้างพร็อกซีแบบย้อนกลับผ่านตัวเลือก Open API ปัจจุบันวิซาร์ดพร็อกซีแสดงตัวเลือกในการสร้างพร็อกซีใหม่ผ่าน Open API ซึ่งทำใน Edge สำหรับ Private Cloud ไม่ได้ วิธีแก้ปัญหาเฉพาะหน้า: ไม่มี |
| 79757554 |
แก้ไขชื่อโฮสต์ไม่ได้ หลังจากติดตั้งหรืออัปเกรด Edge for Private Cloud แล้ว อาจไม่สามารถแก้ไขชื่อโฮสต์เป็นที่อยู่ได้ วิธีแก้ปัญหาเฉพาะหน้า: หากต้องการแก้ปัญหานี้ ให้รีสตาร์ทคอมโพเนนต์ UI ของ Edge โดยทำดังนี้ /opt/apigee/apigee-service/bin/apigee-service edge-ui restart |
| 76087166 |
DataAccessException ในการกำหนดค่าศูนย์ข้อมูลหลายแห่ง ในการกำหนดค่าศูนย์ข้อมูลหลายแห่ง หากที่เก็บข้อมูลแห่งใดแห่งหนึ่งไม่พร้อมใช้งาน คุณอาจเห็นข้อผิดพลาดต่อไปนี้ DataAccessException: Error while accessing datastore; Please retry later ผลลัพธ์คือ Management Server อาจไม่เริ่มทำงานเนื่องจากพยายามเชื่อมต่อกับโหนด Cassandra
ในทั้ง dc-1 และ dc-2 โปรดทราบว่าสถานะที่คาดไว้คือเซิร์ฟเวอร์การจัดการจะไม่เชื่อมต่อกับคอมโพเนนต์ของที่เก็บข้อมูล ในภูมิภาคต่างๆ วิธีแก้ปัญหาเฉพาะหน้า วิธีแก้ปัญหาคือยกเลิกการลงทะเบียนโหนด Cassandra ประเภทต่อไปนี้ในศูนย์ข้อมูลที่ไม่พร้อมใช้งาน แล้วลงทะเบียนอีกครั้งหลังจากที่โหนด Cassandra พร้อมใช้งานอีกครั้ง
หากต้องการยกเลิกการลงทะเบียนและลงทะเบียนโหนด Cassandra ประเภทเหล่านี้อีกครั้ง ให้ทำดังนี้
โปรดทราบว่าการดำเนินการเหล่านี้จะลงทะเบียนและยกเลิกการลงทะเบียนโหนดจาก Zookeeper และไม่มีผลกระทบต่อคลัสเตอร์ Cassandra ดูข้อมูลเพิ่มเติมเกี่ยวกับคำสั่งเหล่านี้ได้ที่อัปเดตการลงทะเบียน Datastore |
| 72379834 |
ข้อความแสดงข้อผิดพลาดเกี่ยวกับสิทธิ์ปรากฏขึ้นเมื่อหยุด apigee-postgresql เมื่อใช้คำสั่ง วิธีแก้ปัญหาเฉพาะหน้า: ไม่มี |
| 68722102 |
นโยบาย MessageLogging ที่มีข้อมูลเพิ่มเติมในข้อความในบันทึก องค์ประกอบ
วิธีแก้ปัญหาเฉพาะหน้า: ไม่มี |
ขั้นตอนถัดไป
หากต้องการเริ่มต้นใช้งาน Edge สำหรับ Private Cloud 4.18.05 ให้ใช้ลิงก์ต่อไปนี้
- การติดตั้งใหม่:
- ภาพรวมของการติดตั้งใหม่
- การติดตั้งที่มีอยู่:
- อัปเกรดจาก 4.18.01
- อัปเกรดจาก 4.17.05 หรือ 4.17.09
- อัปเกรดจาก 4.17.01
- อัปเกรดจาก 4.16.09
- อัปเกรดจาก 4.16.01 หรือ 4.16.05{/11