คุณกำลังดูเอกสารประกอบของ Apigee Edge
ไปที่เอกสารประกอบของ
Apigee X info
ส่วนนี้อธิบายการเปิดตัวฟีเจอร์ Edge สำหรับ 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) ดูข้อมูลเพิ่มเติมเกี่ยวกับปัญหาที่ทราบแต่ละรายการ รวมถึงวิธีแก้ปัญหาได้ที่ ปัญหาที่ทราบ |
|||
ส่วนต่อไปนี้จะอธิบายแต่ละหัวข้อโดยละเอียด
เส้นทางการอัปเกรด
ตารางต่อไปนี้แสดงเส้นทางการอัปเกรดสำหรับการเปิดตัวฟีเจอร์นี้
| ตั้งแต่ 01/18/4 | อัปเกรดจาก 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 เมษายน 2009 | อัปเกรดจาก 4.16.09 → 4.18.01 จากนั้นอัปเกรดจาก 4.18.01 → 4.18.05 |
| ตั้งแต่ 16/04/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 ต่อไปนี้ ไม่ได้อยู่ในเวอร์ชันเบต้าแล้ว และตอนนี้เป็นเวอร์ชัน GA แล้ว
ซอฟต์แวร์ที่รองรับ
การเปิดตัวฟีเจอร์นี้มีการเปลี่ยนแปลงต่อไปนี้ในซอฟต์แวร์ที่รองรับ
- ตอนนี้รองรับ 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
ตอนนี้คุณตั้งค่าตัวเลือกการลองเราเตอร์อีกครั้งได้ที่ระดับโฮสต์เสมือน
ตอนนี้คุณสามารถตั้งค่าตัวเลือกการลองใหม่สำหรับการสื่อสารของเราเตอร์กับ 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 ภายนอกครั้งสุดท้าย
หากต้องการระบุที่อยู่ IP ของไคลเอ็นต์เดิมที่ส่งคำขอ API ไปยัง Edge
การเปิดตัวนี้จะเพิ่มมิติข้อมูลใหม่ลงในข้อมูลวิเคราะห์ Edge ซึ่งก็คือ ax_resolved_client_ip
ตอนนี้คุณสามารถใช้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 สำหรับ Private Cloud ครั้งก่อน มีการเปิดตัวรุ่นต่อไปนี้ และรวมอยู่ในการเปิดตัวฟีเจอร์นี้
| Edge UI | การจัดการ/รันไทม์ของ 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 สำหรับ Private Cloud 4.18.05 | ||
คลิกลิงก์ด้านบนเพื่อดูการแก้ไขข้อบกพร่องและฟีเจอร์ใหม่จากรุ่นเหล่านั้นที่รวมอยู่ในการเปิดตัวฟีเจอร์นี้
การเลิกใช้งาน
ส่วนนี้จะอธิบายฟีเจอร์ที่เลิกใช้งานในการเปิดตัวฟีเจอร์นี้
API BaaS
เลิกใช้งาน API BaaS แล้ว ดูข้อมูลเพิ่มเติมได้ที่ การเลิกใช้งาน การหยุดให้บริการ และการเปลี่ยนแปลง CPS ของ Apigee
แดชบอร์ดการตรวจสอบ (เบต้า)
เราได้หยุดให้บริการแดชบอร์ดการตรวจสอบ (เบต้า) แล้ว และจะไม่รองรับแดชบอร์ดนี้อีกต่อไป ด้วยเหตุนี้ คอมโพเนนต์ต่อไปนี้จึงไม่ได้รวมอยู่ในการติดตั้งอีกต่อไป
apigee-influxdbapigee-telegrafapigee-grafana
หากต้องการรับเมตริกเราเตอร์, Message Processor และโหนดต่อไป Apigee ขอแนะนําให้คุณ ใช้ JMX เพื่อผสานรวมข้อมูลของ Edge สําหรับ Private Cloud กับเครื่องมือตรวจสอบของคุณเอง ดูข้อมูลเพิ่มเติมได้ที่สิ่งที่ต้องตรวจสอบและวิธีตรวจสอบ
หากอัปเกรดการติดตั้งที่มีอยู่เป็นเวอร์ชัน 4.18.05 คุณควร ถอนการติดตั้งแดชบอร์ดการตรวจสอบ Apigee ไม่รับประกันว่าฟีเจอร์นี้จะยังคงทำงานได้ตามที่คาดไว้
การเลิกใช้งาน
เราได้เลิกใช้งานฟีเจอร์ต่อไปนี้ในฟีเจอร์รุ่นนี้
ดูข้อมูลเพิ่มเติมได้ที่ การเลิกใช้งาน การหยุดให้บริการ และการเปลี่ยนแปลง CPS ของ Apigee
ที่เก็บข้อมูลที่ปลอดภัยของ Apigee (Vault)
เรากำลังจะเลิกใช้งานที่เก็บข้อมูลที่ปลอดภัยของ Apigee หรือที่เรียกว่า "Vault" และจะหยุดให้บริการในเดือนกันยายน 2018
ให้ใช้แมปค่าคีย์ (KVM) ที่เข้ารหัสแทนการใช้ที่เก็บข้อมูลที่ปลอดภัย ตามที่อธิบายไว้ใน การทำงานกับแมปค่าคีย์ KVM ที่เข้ารหัสมีความปลอดภัยเช่นเดียวกับห้องเก็บข้อมูล และมีตัวเลือกเพิ่มเติมสำหรับการสร้างและ การดึงข้อมูล
การเพิ่มเส้นทางในแท็บประสิทธิภาพของพร็อกซี API
ก่อนการเปิดตัวนี้ คุณสามารถไปที่พร็อกซี API ใน UI การจัดการ ไปที่แท็บประสิทธิภาพ และสร้างเส้นทางต่างๆ สำหรับการเปรียบเทียบแบบแผนภูมิในแท็บประสิทธิภาพของพร็อกซีและในแดชบอร์ดธุรกรรมทางธุรกิจ
ตอนนี้เราเลิกใช้งานฟีเจอร์นี้แล้วและจะไม่มีให้บริการใน UI อีกต่อไป หากต้องการใช้ฟังก์ชันการทำงานอื่นแทนฟังก์ชันนี้ โปรดดู ทางเลือกแทน Business Transactions API
พร็อพเพอร์ตี้ SMTPSSL สำหรับพอร์ทัลบริการสำหรับนักพัฒนาแอป
หากต้องการตั้งค่าโปรโตคอลที่เซิร์ฟเวอร์ SMTP ใช้เมื่อเชื่อมต่อกับพอร์ทัล ตอนนี้คุณต้องใช้พร็อพเพอร์ตี้ SMTP_PROTOCOL แทนพร็อพเพอร์ตี้ SMTPSSL ค่าที่ใช้ได้
ของ SMTP_PROTOCOL คือ "standard", "ssl" และ "tls"
ดูข้อมูลเพิ่มเติมได้ที่ การติดตั้งพอร์ทัล Developer Services
การแก้ไขบั๊ก
ส่วนนี้แสดงข้อบกพร่องของ 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 ผลลัพธ์คือเซิร์ฟเวอร์การจัดการอาจไม่เริ่มทำงานเนื่องจากพยายามเชื่อมต่อกับโหนด Cassandra
ในทั้ง dc-1 และ dc-2 โปรดทราบว่าสถานะที่คาดไว้คือเซิร์ฟเวอร์การจัดการจะไม่เชื่อมต่อกับคอมโพเนนต์ Datastore ในภูมิภาคต่างๆ วิธีแก้ปัญหาชั่วคราว วิธีแก้ปัญหาคือยกเลิกการลงทะเบียนโหนด 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