1.1.0 - บันทึกประจำรุ่นของรันไทม์แบบผสม Apigee

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

เมื่อวันที่ 27 มกราคม 2020 Google ได้เผยแพร่ Apigee Hybrid Runtime เวอร์ชัน 1.1.0 ส่วนนี้ อธิบายฟีเจอร์ใหม่และการเปลี่ยนแปลงที่เปิดตัวในเวอร์ชัน 1.1.0

กำลังอัปเกรด

คุณจะอัปเกรดจาก 1.0.0 เป็น 1.1.0 ไม่ได้ และเวอร์ชันใหม่จะไม่มีความเข้ากันได้แบบย้อนหลังกับ เวอร์ชัน 1.0.0 เวอร์ชัน 1.1.0 ต้องมีการติดตั้งใหม่

ฟีเจอร์และการปรับปรุงใหม่ๆ

Apigee Connect (รุ่นอัลฟ่า)

Apigee Connect Alpha ช่วยให้บริการ MART แบบไฮบริดของ Apigee เชื่อมต่อกับ Management Plane ได้ โดยไม่ต้องเปิดเผยปลายทาง MART หากใช้ Apigee Connect คุณไม่จำเป็นต้องกำหนดค่าเกตเวย์ขาเข้า MART ด้วยนามแฝงโฮสต์และใบรับรอง DNS ที่ได้รับอนุญาต โปรดติดต่อตัวแทนของ Apigee เพื่อขอรายละเอียด

การกำหนดเส้นทางเส้นทางฐาน

การกำหนดเส้นทางเส้นทางฐานช่วยให้คุณกำหนดค่าและจัดการวิธีที่ Apigee Hybrid กำหนดเส้นทางการเรียกพร็อกซี API ไปยังสภาพแวดล้อมที่เฉพาะเจาะจงได้ โปรดดูรายละเอียดที่หัวข้อกำหนดค่าการกำหนดเส้นทางเส้นทางฐาน

การเปลี่ยนแปลง

มีการเปลี่ยนแปลงต่อไปนี้สำหรับรันไทม์แบบไฮบริดเวอร์ชัน 1.1.0 การเปลี่ยนแปลงบางอย่างเหล่านี้เข้ากันได้กับเวอร์ชัน 1.0.0

  • ตอนนี้ apigeectl CLI จะติดตั้ง Istio ในเนมสเปซ istio-system นี่คือเนมสเปซเริ่มต้นสำหรับ Istio การเปลี่ยนแปลงนี้ไม่สามารถใช้งานร่วมกับไฮบริดเวอร์ชัน 1.0.0
  • ตอนนี้ apigeectl CLI จะติดตั้ง CertManager ในเนมสเปซ cert-manager การเปลี่ยนแปลงนี้ไม่สามารถใช้งานร่วมกับไฮบริดเวอร์ชัน 1.0.0
  • ระบบได้ย้ายข้อมูล Istio เวอร์ชันที่รองรับซึ่งติดตั้งใช้งานกับรันไทม์ไฮบริดของ Apigee ไปยังเวอร์ชัน 1.4.2 เนื่องจากไม่รองรับเวอร์ชัน 1.2.x อีกต่อไป

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

เราได้แก้ไขปัญหาต่อไปนี้ที่ระบุไว้ในหมายเหตุประจำรุ่นของ Apigee Hybrid 1.0.0 แล้ว

ปัญหา คำอธิบาย
144886537 การกำหนดเส้นทางเส้นทางฐานไม่ทำงานใน Apigee Hybrid v1.0.0 เมื่อตั้งค่าการลบล้างให้กำหนดเส้นทางไปยังสภาพแวดล้อมต่างๆ ที่มี hostAlias เดียวกัน Ingress จะไม่กำหนดเส้นทางไปยังสภาพแวดล้อมตามเส้นทาง
143774187 UI แบบไฮบริดจะแสดงป้ายกำกับ "บริษัท" ในมุมมองแอป

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

ตารางต่อไปนี้อธิบายปัญหาที่ทราบในการเปิดตัวนี้

ปัญหา คำอธิบาย
ไม่มี คุณใช้ "*" สำหรับพร็อพเพอร์ตี้ hostAlias ทั้งการกำหนดค่า mart และ envs ไม่ได้ แนวทางปฏิบัติแนะนำคือการใช้ชื่อโฮสต์ที่เฉพาะเจาะจง สำหรับการกำหนดค่า mart
ไม่มี ไม่รองรับการตั้งค่าตัวแปร HTTP_PROXY, HTTPS_PROXY และ NO_PROXY ใน Apigee Connect เวอร์ชันอัลฟ่า
ไม่มี

ข้อผิดพลาดเกี่ยวกับส่วนหัว HTTP ไม่ถูกต้อง: Istio Ingress จะเปลี่ยนการตอบกลับเป้าหมายขาเข้าทั้งหมด เป็นโปรโตคอล HTTP2 เนื่องจากตัวประมวลผลข้อความแบบไฮบริดรองรับเฉพาะ HTTP1 คุณอาจเห็นข้อผิดพลาดต่อไปนี้เมื่อมีการเรียกใช้พร็อกซี API

http2 error: Invalid HTTP header field was received: frame type: 1, stream: 1,
   name: [:authority], value: [domain_name]

หากเห็นข้อผิดพลาดนี้ คุณสามารถดำเนินการอย่างใดอย่างหนึ่งต่อไปนี้เพื่อแก้ไขปัญหา ได้

  • แก้ไขบริการเป้าหมายเพื่อละเว้นส่วนหัว Host ในการตอบกลับ
  • นำส่วนหัว Host ออกโดยใช้นโยบาย AssignMessage ในพร็อกซี API หากจำเป็น
144584813 หากคุณสร้างเซสชันการแก้ไขข้อบกพร่อง แต่เซสชันยังไม่มีธุรกรรมใดๆ API รายการเซสชันการแก้ไขข้อบกพร่องจะไม่รวมเซสชันไว้ในรายการนี้ API จะรวมเฉพาะเซสชันในการตอบกลับหากเซสชันมีการทำธุรกรรมอย่างน้อย 1 รายการ
144436206 ในมุมมองประสิทธิภาพของแคช การคำนวณอัตราส่วนการค้นพบแคช ไม่ถูกต้อง
144321491 Apigee Hybrid จะบันทึกการแจ้งเตือน "สร้างแคชที่ขาดหายไป" ซึ่งบ่งบอกถึง ประสิทธิภาพที่อาจลดลง ข้อความเหล่านี้เป็นเรื่องปกติและคุณไม่จำเป็นต้องดำเนินการใดๆ
144321144 โหลดพร็อกซีที่มีโฮสต์เสมือนที่ปลอดภัยซ้ำไม่ได้
144286363

มาสก์การแก้ไขข้อบกพร่องใน env.json ไม่ได้มาสก์ข้อมูลการตอบกลับ

API ต่อไปนี้เพื่ออัปเดตมาสก์การแก้ไขข้อบกพร่อง env.json ด้วยฟิลด์ responseJSONPaths ใช้ไม่ได้

PATCH /v1/organizations/org/environments/env/debugmask?replaceRepeatedFields=true
{
  "responseJSONPaths": ["$.maskedDataEnv"]
}

หากต้องการหลีกเลี่ยงปัญหานี้ด้วยการติดตาม คุณสามารถลบเซสชันการติดตามทั้งหมดใน UI หรือใช้ Trace API เพื่อลบธุรกรรมแต่ละรายการภายในเซสชันได้
143659917

ต้องตั้งค่าหมดอายุของนโยบาย PopulateCache เป็นค่าที่ชัดเจน ระหว่าง 1 ถึง 30 เช่น 

<ExpirySettings>
  <TimeoutInSec>30</TimeoutInSec>
</ExpirySettings>
133192879

สรุป: มีเวลาในการตอบสนองสูงมากเมื่อใช้ API หรือ UI เพื่อดูสถานะการติดตั้งใช้งานขององค์กร เวลาในการตอบสนองนี้อาจส่งผลให้ได้คำตอบเป็น HTTP 204 (No Content) หรือ HTTP 400 (Bad Request)

วิธีแก้ปัญหาชั่วคราว: รีเฟรชเบราว์เซอร์ (หรือส่งคำขออีกครั้ง)