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

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

เมื่อวันที่ 27 มกราคม 2020 Google ได้เปิดตัวรันไทม์แบบไฮบริดของ Apigee เวอร์ชัน 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 เชื่อมต่อกับระนาบการจัดการได้โดยที่คุณไม่ต้องแสดงปลายทาง MART หากใช้ Apigee Connect คุณไม่จำเป็นต้องกำหนดค่าเกตเวย์ขาเข้าของ MART ด้วยชื่อแทนโฮสต์และใบรับรอง DNS ที่ได้รับอนุญาต สำหรับรายละเอียด โปรดติดต่อตัวแทน Apigee ของคุณ

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

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

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

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

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

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

ปัญหาต่อไปนี้ที่แสดงในบันทึกประจำรุ่นของ Apigee ไฮบริด 1.0.0 ได้รับการแก้ไขแล้ว

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

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

ตารางต่อไปนี้อธิบายปัญหาที่ทราบของรุ่นนี้

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

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

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

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

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

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

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

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

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

143659917

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

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

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

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