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

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

เมื่อวันที่ 3 เมษายน 2020 เราได้เปิดตัวรันไทม์แบบไฮบริดของ Apigee เวอร์ชัน 1.2.0

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

ฟีเจอร์และการอัปเดตใหม่ๆ

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

เพิ่มการกำหนดค่าโฮสต์เสมือนใหม่เพื่อระบุกฎการกำหนดเส้นทางแล้ว

ฟีเจอร์การกำหนดค่า virtualhosts แบบใหม่ช่วยแก้ปัญหา ลำดับที่มีการกำหนดเส้นทางฐานไปยังหลายสภาพแวดล้อม ไม่แน่ใจ ดูรายละเอียดได้ที่ กำหนดค่าโฮสต์เสมือน (150336519)

นโยบาย OASValidation รุ่นเบต้า

นโยบาย OASValidation (OpenAPI Specification Validation) (เบต้า) ช่วยให้คุณสามารถตรวจสอบ คำขอหรือข้อความตอบกลับที่เข้ามาใหม่เทียบกับข้อกำหนดของ OpenAPI 3.0 (JSON หรือ YAML) ดูข้อมูลเพิ่มเติมได้ที่ OASValidation (เบต้า) (144949685)

การสนับสนุน WebSocket รุ่นเบต้า

Apigee แบบไฮบริดรองรับการเชื่อมต่อ WebSocket ไคลเอ็นต์พร็อกซี API สามารถขออัปเกรดโปรโตคอลได้แล้ว จาก HTTP ไปยัง WebSockets โปรดดูรายละเอียดที่การใช้ WebSockets (เบต้า)

การเข้าถึงค่าข้อมูลลับของนโยบายจากข้อมูลลับ Kubernetes

ฟีเจอร์ใหม่ช่วยให้คุณเข้าถึงค่าที่จัดเก็บไว้ในข้อมูลลับ Kubernetes ในตัวแปรโฟลว์พร็อกซีได้ โปรดดูรายละเอียดที่หัวข้อการจัดเก็บข้อมูลในข้อมูลลับของ Kubernetes (133377603)

องค์ประกอบ Apigee Operators (AO) มาแทนที่ ADAC และ ADAH

Apigee Operators (AO) สร้างและอัปเดตทรัพยากร Kubernetes และ Istio ระดับต่ำที่จำเป็น เพื่อติดตั้งใช้งานและบำรุงรักษาโฆษณา ตัวอย่างเช่น ตัวควบคุมจะดำเนินการเผยแพร่ข้อความ โปรเซสเซอร์ ตรวจสอบการกำหนดค่า ApigeeDeployment ด้วยก่อนที่จะยืนยันการกำหนดค่าดังกล่าวใน Kubernetes คลัสเตอร์ AO มาแทนที่ Apigee Deployment Admissionhook (ADAH) และตัวควบคุมการติดตั้งใช้งาน Apigee (ADC) โปรดดู ao ในข้อมูลอ้างอิงพร็อพเพอร์ตี้การกำหนดค่า (151250559)

แทนที่และเลิกใช้งานพร็อพเพอร์ตี้การกำหนดค่าคลัสเตอร์และโปรเจ็กต์บางรายการ

เพิ่มพร็อพเพอร์ตี้การกำหนดค่าใหม่ 2 รายการ ได้แก่ k8sCluster และ gcp พร็อพเพอร์ตี้เหล่านี้จะแทนที่พร็อพเพอร์ตี้ที่เลิกใช้งานแล้วต่อไปนี้ k8sClusterName, gcpRegion และ gcpProjectID โปรดดูรายละเอียด ดูข้อมูลอ้างอิงพร็อพเพอร์ตี้การกำหนดค่า (146299599)

การขยายวอลุ่มแบบถาวรสำหรับ Cassandra บน Kubernetes

มีการเพิ่มกระบวนการเพื่อขยายปริมาณถาวรที่ apigee-cassandra ใช้เพื่อรองรับ ต้องการพื้นที่เก็บข้อมูล โดยไม่ต้องเพิ่มโหนดอีกเพียงเพื่อเพิ่มพื้นที่เก็บข้อมูล โปรดดู ขยายวอลุ่มแบบถาวรของ Cassandra (138167919)

รองรับแหล่งที่มาเพิ่มเติมสำหรับใบรับรอง คีย์การเข้ารหัส และ SA

เพิ่มพร็อพเพอร์ตี้การกำหนดค่าใหม่ที่ช่วยให้มีความยืดหยุ่นมากขึ้น คุณเป็นผู้ระบุใบรับรอง TLS, คีย์การเข้ารหัส และคีย์ของบัญชีบริการ พร็อพเพอร์ตี้ใหม่ มีดังนี้

  • kmsEncryptionPath
  • kmsEncryptionSecret.key
  • kmsEncryptionSecret.name
  • cassandra.backup.serviceAccountSecretRef
  • cassandra.restore.serviceAccountSecretRef
  • envs[].cacheEncryptionPath
  • envs[].cacheEncryptionSecret.key
  • envs[].cacheEncryptionSecret.name
  • envs[].kmsEncryptionPath
  • envs[].kmsEncryptionSecret.key
  • envs[].kmsEncryptionSecret.name
  • envs[].serviceAccountSecretRefs.synchronizer
  • envs[].serviceAccountSecretRefs.udca
  • envs[].sslSecret
  • logger.serviceAccountSecretRef
  • mart.serviceAccountSecretRef
  • mart.sslSecret
  • metrics.serviceAccountSecretRef
  • synchronizer.serviceAccountSecretRef
  • udca.serviceAccountSecretRef

สำหรับข้อมูลเพิ่มเติม โปรดดูที่การกำหนดค่า พร็อพเพอร์ตี้ (145303466)

ช่วยให้ลูกค้าปรับข้อมูลให้ยากต่อการอ่าน (Obfuscate) ก่อนส่งไปยังข้อมูลวิเคราะห์

มีการเพิ่มฟีเจอร์ที่จะช่วยให้คุณปรับข้อมูลการวิเคราะห์บางอย่างให้ยากต่อการอ่าน (Obfuscate) ก่อนที่จะส่งไปยัง ระนาบการจัดการ ดูรายละเอียดได้ที่ ปรับข้อมูลผู้ใช้ให้ยากต่อการอ่าน (Obfuscate) เพื่อการวิเคราะห์ (142578910)

ขยายวอลุ่มแบบถาวรสำหรับการเก็บสถานะ

มีการเพิ่มฟีเจอร์ที่ช่วยให้คุณขยายวอลุ่มถาวรที่ Apigee-cassandra ไปใช้เป็น รองรับความต้องการด้านพื้นที่เก็บข้อมูล โดยไม่ต้องเพิ่มกำลังการประมวลผล สำหรับข้อมูลเพิ่มเติม โปรดดู ขยายวอลุ่มแบบถาวรสำหรับการเก็บสถานะ (138167919)

อัปเกรด GKE, Anthos และ AKS เวอร์ชันที่รองรับขั้นต่ำแล้ว

ตอนนี้ Apigee ไฮบริดรองรับ GKE 1.14.x, Anthos 1.2 และ AKS 1.14.x (149578101)

รองรับ TLS 1.3 สำหรับการเชื่อมต่อแบบไปทางเหนือ

พร็อพเพอร์ตี้การกำหนดค่าใหม่ 2 รายการจะช่วยให้คุณตั้งค่าเวอร์ชัน TLS ต่ำสุดและสูงสุดสำหรับ ขาเข้า: ingress.minTLSProtocolVersion และ maxTLSProtocolVersion ค่าที่เป็นไปได้คือ 1.0, 1.1, 1.2 และ 1.3 สำหรับข้อมูลเพิ่มเติม โปรดดู การกําหนดค่า พร็อพเพอร์ตี้ (117580780)

รองรับการกำหนดค่าพร็อกซีการส่งต่อสำหรับรันไทม์แบบผสม

ตอนนี้พร็อกซี API ที่ทำให้ใช้งานได้ในสภาพแวดล้อมแล้วรองรับพร็อกซี HTTP Forward โปรดดูรายละเอียดที่หัวข้อกำหนดค่าพร็อกซีการส่งต่อ (148970527)

รองรับ hostAliases หลายรายการต่อสภาพแวดล้อม

เพิ่มพร็อพเพอร์ตี้การกำหนดค่า envs[].hostAliases ใหม่แล้ว ช่วงเวลานี้ พร็อพเพอร์ตี้ให้คุณเพิ่มชื่อแทนโฮสต์หลายชื่อในสภาพแวดล้อมหนึ่งๆ ได้ ใช้องค์ประกอบนี้แทน hostAlias ซึ่งเลิกใช้งานแล้ว โปรดดูรายละเอียดที่หัวข้อ การเพิ่ม ชื่อแทนโฮสต์หลายชื่อไปยังสภาพแวดล้อม (150738495)

อนุญาตให้ใช้เทมเพลตสำหรับชุดพร็อพเพอร์ตี้

องค์ประกอบใหม่ <PropertySetRef> ได้รับการเพิ่มลงใน <AssignVariable> องค์ประกอบของ <AssignMessage> &lt;PropertySetRef&gt; ช่วยให้คุณสร้างชื่อชุดพร็อพเพอร์ตี้/คู่คีย์แบบไดนามิก ฟีเจอร์นี้พร้อมใช้งานสำหรับพร็อกซี API ที่ทำให้ใช้งานได้กับ Apigee แบบไฮบริดเท่านั้น โปรดดู AssignVariable (148612340)

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

ข้อบกพร่องต่อไปนี้ได้รับการแก้ไขแล้วในรุ่นนี้ รายการนี้มีไว้สำหรับผู้ใช้ที่ตรวจสอบเป็นหลัก เพื่อดูว่าคำขอแจ้งปัญหาได้รับการแก้ไขไหม ไม่ได้ออกแบบมาให้แสดงรายละเอียด สำหรับผู้ใช้ทุกคน

รหัสปัญหา ชื่อคอมโพเนนต์ คำอธิบาย
147958049 รันไทม์ แก้ไขปัญหาเกี่ยวกับเวลาในลำดับการเริ่มต้นรันไทม์แล้ว ซึ่งบางครั้งทำให้ไม่สามารถดำเนินการได้ เครื่องมือซิงโครไนซ์เริ่มทำงานอย่างถูกต้อง
149867244 แพลตฟอร์ม K8S พ็อด apigee-cps-setup ล้มเหลวในการตั้งค่าแบบหลายภูมิภาค
150187652 / 149117839 รันไทม์ ใช้ขีดกลางในชื่อสภาพแวดล้อมไม่ได้
149220463 พ็อด MP พร็อกซีที่ทำให้ใช้งานได้ก่อนหน้านี้ต้องทำให้ใช้งานได้อีกครั้ง
144321144 รันไทม์ โหลดพร็อกซีที่มีโฮสต์เสมือนที่ปลอดภัยไม่ได้
147685310 รันไทม์ เริ่มต้นซิงค์ข้อมูลไม่สำเร็จเนื่องจากดึงข้อมูลโทเค็น GCP ระหว่างการเริ่มต้นไม่สำเร็จ
151115900 รันไทม์ การตรวจสอบภายในเป็นระยะ (Periodic Internal Probe) ไม่ได้เกิดขึ้นสำหรับ HybridMART ส่งผลให้เกิดผลบวกลวง

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

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

ปัญหา คำอธิบาย
ไม่มี

ข้อผิดพลาดส่วนหัว 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 หากคุณสร้างเซสชันการแก้ไขข้อบกพร่อง แต่เซสชันนั้นยังไม่มีธุรกรรม จากนั้น รายการ Debug Sessions API ไม่รวมเซสชันในรายการนี้ API มีเฉพาะ เซสชันในการตอบกลับหากเซสชันดังกล่าวมีธุรกรรมอย่างน้อย 1 รายการ
143659917

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

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

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

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