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

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

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

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

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

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

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

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

การเปิดตัวนโยบายการตรวจสอบความถูกต้องเวอร์ชันเบต้า

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

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

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

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

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

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

Apigee Operators (AO) จะสร้างและอัปเดตทรัพยากร Kubernetes และ Istio ในระดับต่ำที่จำเป็นต่อการทำให้ใช้งานและบำรุงรักษา AD ได้ ตัวอย่างเช่น ตัวควบคุมจะปล่อยตัวประมวลผลข้อความ นอกจากนี้จะตรวจสอบการกำหนดค่า ApigeeDeployment ก่อนที่จะคงไว้ในคลัสเตอร์ Kubernetes AO มาแทนที่ Apigee Deployment Admissionhook (ADAH) และผู้ควบคุมการติดตั้งใช้งาน Apigee (ADC) ดูในข้อมูลอ้างอิงพร็อพเพอร์ตี้การกำหนดค่า (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)

ช่วยให้ลูกค้าสร้างความสับสนก่อนส่งข้อมูลไปยัง Analytics

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

ขยายวอลุ่มแบบถาวรสำหรับชุดสถานะ

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

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

ตอนนี้ Apigee แบบผสมรองรับ GKE 1.14.x, Anthos 1.2 และ AKS 1.14.x (149578101)

รองรับ TLS 1.3 สำหรับการเชื่อมต่อแบบ Northbound

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

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

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

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

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

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

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

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

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

รหัสปัญหา ชื่อคอมโพเนนต์ คำอธิบาย
147958049 รันไทม์ ปัญหาเรื่องเวลาในการจัดลำดับการเริ่มต้นรันไทม์ได้รับการแก้ไขแล้ว ซึ่งบางครั้งทำให้ตัวซิงค์ข้อมูลเริ่มต้นทำงานอย่างไม่ถูกต้อง
149867244 แพลตฟอร์ม K8S Apigee-cps-setup พ็อดล้มเหลวในการตั้งค่าหลายภูมิภาค
150187652 / 149117839 รันไทม์ ใช้ขีดกลางในชื่อสภาพแวดล้อมไม่ได้
149220463 พ็อด MP พร็อกซีที่ทำให้ใช้งานได้ก่อนหน้านี้ต้องทำให้ใช้งานได้อีกครั้ง
144321144 รันไทม์ โหลดพร็อกซีกับโฮสต์เสมือนที่ปลอดภัยซ้ำไม่ได้
147685310 รันไทม์ การเริ่มต้นซิงค์ล้มเหลวเนื่องจากการดึงข้อมูลโทเค็น GCP ล้มเหลวระหว่างการเริ่มต้น
151115900 รันไทม์ ระบบไม่ตรวจสอบภายในแบบเป็นระยะๆ กับ 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 หากคุณสร้างเซสชันการแก้ไขข้อบกพร่อง แต่เซสชันนั้นยังไม่มีธุรกรรมอยู่ในนั้น แสดงรายการ API เซสชันการแก้ไขข้อบกพร่องจะไม่รวมเซสชันนั้นในรายการนี้ API จะรวมเฉพาะเซสชันในการตอบกลับในกรณีที่เซสชันนั้นมีธุรกรรมอย่างน้อย 1 รายการ
143659917

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

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

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

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