4.16.05 - Edge สำหรับบันทึกประจำรุ่นของ Private Cloud

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

เราได้เปิดตัว Apigee Edge เวอร์ชันใหม่สำหรับ Private Cloud ในวันอังคารที่ 31 พฤษภาคม 2016

เนื่องจาก Edge for Private Cloud Feature Release รุ่นก่อนหน้า (4.16.01) มีรุ่นต่อไปนี้และรวมอยู่ในการเผยแพร่ฟีเจอร์นี้

• ระบบคลาวด์: 16.02.17, 16.03.02, 16.03.09 (UI), 16.03.16 (UI), 16.03.23 (UI), 16.03.30

โปรดดูเกี่ยวกับหมายเลขรุ่นเพื่อทำความเข้าใจวิธีดูว่ารุ่นระบบคลาวด์ที่เฉพาะเจาะจงนั้นรวมอยู่ใน Edge เวอร์ชันที่คุณใช้สำหรับ Private Cloud หรือไม่

ฟีเจอร์ใหม่และการเพิ่มประสิทธิภาพ

ฟีเจอร์และการเพิ่มประสิทธิภาพใหม่ๆ ในรุ่นนี้มีดังนี้ นอกเหนือจากการเพิ่มประสิทธิภาพต่อไปนี้แล้ว รุ่นนี้ยังมีการเพิ่มประสิทธิภาพด้านความสามารถในการใช้งาน ประสิทธิภาพ ความปลอดภัย และความเสถียรหลายอย่างอีกด้วย

โปรดดูรายละเอียดเพิ่มเติมและวิธีการในเอกสารประกอบของ Edge สำหรับ Private Cloud

คู่มือการติดตั้งและการดำเนินการย้ายไปออนไลน์แล้ว

คุณเข้าถึง Edge for Private Cloud คู่มือการติดตั้งและการดำเนินการ ได้ที่เวอร์ชัน 4.18.01

การอัปเดตซอฟต์แวร์

การอัปเดตซอฟต์แวร์ต่อไปนี้จะรวมอยู่ในรุ่นนี้

• Java JDK 1.8 - รุ่นนี้ใช้ได้กับ Java 1.8 เพื่อใช้ประโยชน์จากฟีเจอร์ล่าสุดของ Java สภาพแวดล้อมของคุณจำเป็นต้องมี Oracle JDK 1.8 หรือ OpenJDK 8
  การอัปเดต Java 8 ทำให้การเข้ารหัส TLS บางรายการใช้งานไม่ได้ใน Oracle JDK 1.8 อีกต่อไป ดูรายการทั้งหมดได้ที่ส่วน "ชุดการเข้ารหัสที่ปิดใช้เริ่มต้น" http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html
• Cassandra 2.1.13 - อัปเดตจาก Cassandra 2.0.15

การติดตั้ง อัปเกรด ย้อนกลับ

ต่อไปนี้เป็นรายการการเปลี่ยนแปลงในการติดตั้ง อัปเกรด และสคริปต์ที่เกี่ยวข้อง โปรดดูข้อมูลการใช้งานที่เอกสาร Edge สำหรับ Private Cloud

• กระบวนการใหม่ที่จะอัปเดตจาก 4.16.01 - รุ่นนี้จะแทนที่ยูทิลิตี apigee-migrate ด้วยยูทิลิตี update.sh เพื่ออัปเดตการติดตั้งจาก 4.16.01 เป็น 4.16.05 โปรดดูอัปเดต Apigee Edge 4.16.01 เป็น 4.16.05
• สายรัดเท้า
  • ตอนนี้ bootstrap.sh (เวอร์ชัน 4.16.01) เปลี่ยนเป็น bootstrap_4.16.05.sh ใน 4.16.05 แล้ว
  • คุณไม่จำเป็นต้องระบุ uname:pword เพื่อดาวน์โหลด bootstrap_4.16.05.sh อีกต่อไป
• ย้อนกลับ - หากต้องการย้อนกลับการอัปเดตเป็น 4.16.05 ให้ถอนการติดตั้งคอมโพเนนต์เวอร์ชัน 4.16.05 และติดตั้งเวอร์ชันก่อนหน้าอีกครั้ง นำยูทิลิตี rollback.sh ก่อนหน้านี้ออกแล้ว โปรดดูกระบวนการย้อนกลับ
• setup.sh และ update.sh เขียนไฟล์บันทึกไปยัง /tmp ได้ - โดยค่าเริ่มต้น ยูทิลิตี setup.sh และ update.sh จะเขียนข้อมูลบันทึกไปยัง /opt/apigee/var/log/apigee-setup หากผู้ใช้ที่เรียกใช้ยูทิลิตีไม่มีสิทธิ์เข้าถึงไดเรกทอรีนั้น ระบบจะเขียนบันทึกไปยังไดเรกทอรี /tmp หากผู้ใช้ไม่มีสิทธิ์เข้าถึง /tmp ยูทิลิตีจะล้มเหลว
• ขั้นตอนการอัปเดต API BaaS - ในรุ่น 4.16.01 คุณต้องติดตั้ง API BaaS อีกครั้งเพื่อย้ายข้อมูล ยูทิลิตี update.sh ใหม่รองรับการอัปเดต API BaaS ที่ใช้อยู่ โปรดดูอัปเดต Apigee Edge 4.16.01 เป็น 4.16.05

การบริหารจัดการ

ฟีเจอร์ใหม่สำหรับการดูแลระบบและการกำหนดค่า Private Cloud มีดังนี้

• การตรวจสอบการติดตั้ง - ยูทิลิตี apigee-validate ที่ใช้ทดสอบการติดตั้ง Edge Private Cloud สามารถเรียกใช้จากเซิร์ฟเวอร์การจัดการได้แล้ว ซึ่งก่อนหน้านี้คุณต้องเรียกใช้สคริปต์บนตัวประมวลผลข้อความ โปรดดูหัวข้อทดสอบการติดตั้ง
• ชื่อภูมิภาค - ภูมิภาคอาจเป็นชื่อใดก็ได้ ในรุ่นก่อนหน้า ชื่ออยู่ในรูปแบบ "dc-#" โดยที่ # เป็นค่าจำนวนเต็ม
• พ็อดเกตเวย์ - พ็อดเกตเวย์อาจมีชื่อใดก็ได้ ในรุ่นก่อนหน้านี้ พ็อดต้องมีชื่อว่า "เกตเวย์"
• การดูแลระบบตามสคริปต์ - ยูทิลิตีบรรทัดคำสั่งใหม่ของ apigee-adminapi.sh ช่วยให้คุณทำงานการกำหนดค่า Edge ได้แบบเดียวกับที่ดำเนินการโดยการเรียกใช้ Edge Management API โปรดดูการใช้ยูทิลิตี apigee-adminapi.sh
• การกำหนดค่า SSL ของโฮสต์เสมือน - เมื่อสร้างองค์กรหรือสภาพแวดล้อม คุณสามารถส่งพร็อพเพอร์ตี้เพื่อกำหนดค่า SSL บนโฮสต์เสมือนได้แล้ว โปรดดูหัวข้อเริ่มต้นใช้งานองค์กร

บริการ API

ต่อไปนี้เป็นฟีเจอร์ใหม่สำหรับบริการ Edge API ซึ่งนำส่งในผลิตภัณฑ์ ระบบคลาวด์ก่อนหน้านี้

คำนำหน้าความยาวคงที่สำหรับการบันทึกข้อความ syslog (Cloud 16.03.30)

นโยบายการบันทึกข้อความมีองค์ประกอบ <FormatMessage> ใหม่ในการกำหนดค่า Syslog เมื่อตั้งค่า <FormatMessage>true</FormatMessage> ข้อความ Syslog จะเริ่มด้วยจำนวนอักขระคงที่ ซึ่งช่วยให้คุณกรองข้อมูลที่แทรกโดย Apigee ได้ ดูข้อมูลเพิ่มเติมได้ที่นโยบายการบันทึกข้อความ (APIRT-1398)

ไวลด์การ์ดในเส้นทางฐานพร็อกซี API (UI ของ Cloud 16.03.09)

UI การจัดการรองรับการใช้ไวลด์การ์ด /*/ อย่างน้อย 1 รายการในเส้นทางฐานพร็อกซี API ตัวอย่างเช่น เส้นทางฐานของ /team/*/members จะอนุญาตให้ไคลเอ็นต์เรียกใช้พร็อกซีด้วย https://[host]/team/blue/members หรือ https://[host]/team/green/members โดยที่คุณไม่ต้องสร้างพร็อกซีใหม่เพื่อสนับสนุนทีมใหม่ โปรดทราบว่าไม่อนุญาตให้ใช้ /**/ (MGMT-3154)

เชนพร็อกซี API (Cloud 16.03.02, UI ของ Cloud 16.03.09)

Edge รองรับเชนพร็อกซี API ในเครื่อง ซึ่งทำให้พร็อกซี API 1 รายการเรียกใช้พร็อกซี API อื่นที่ทำให้ใช้งานได้ในองค์กร Edge ได้โดยไม่มีค่าใช้จ่ายของเครือข่ายเพิ่มเติม ก่อนหน้านี้ เชนพร็อกซี API ต้องมีการเรียก http ไปยังพร็อกซี API อื่น ซึ่งส่งต่อคำขอผ่านตัวจัดสรรภาระงาน เราเตอร์ และผู้ประมวลผลข้อความ

องค์ประกอบ LocalTargetConnection ใหม่พร้อมใช้งานใน TargetEndpoint ของพร็อกซี API ซึ่งช่วยให้คุณระบุชื่อพร็อกซี API, ชื่อของ ProxyEndpoint ที่เฉพาะเจาะจงภายในพร็อกซี API หรือมีเพียงเส้นทางฐานไปยังทรัพยากรพร็อกซี API ในเครื่อง (เช่น /v1/myresource) UI ของตัวแก้ไขพร็อกซียังมีตัวเลือกเหล่านี้เมื่อคุณเพิ่มหรืออัปเดต TargetEndpoint

เชนพร็อกซีพร้อมใช้งานในนโยบายคำขอราคาเสนอบริการด้วย

ดูข้อมูลเพิ่มเติมได้ที่พร็อกซี Chaining API ร่วมกัน นอกจากนี้ องค์ประกอบ LocalTargetConnection ใหม่ยังแสดงอยู่ในสคีมา XML ที่ https://github.com/apigee/api-platform-samples/blob/master/schemas/configuration/configuration_schemas.xsd (MGMT-3049, MGMT-3050)

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

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

Edge สำหรับ Private Cloud 4.16.05

ระบบคลาวด์ 16.03.30

UI ของ Cloud 16.03.16

UI ของ Cloud 16.03.09

ระบบคลาวด์ 16.03.02

ระบบคลาวด์ 16.02.17

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

รุ่นนี้มีปัญหาที่ทราบดังต่อไปนี้

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart

เปย์โหลด JSON ในนโยบาย Assign Message, Java อัปโหลดรูปภาพ และ Raise Fault

นโยบาย "กำหนดข้อความ" "ไฮไลต์ของ Java" และ "ยกความผิด" ช่วยให้คุณสร้างเนื้อหาข้อความโดยใช้องค์ประกอบ <Set><Payload> ได้ ในฐานะส่วนหนึ่งของข้อความเหล่านั้น คุณจะรวมตัวแปรที่มีค่าที่ระบบเติมขณะรันไทม์โดยอัตโนมัติได้ ตัวอย่างเช่น หากต้องการแสดงวันที่จากส่วนหัว HTTP ก็แทรก {message.header.date} ในข้อความได้

หากรูปแบบข้อความเป็น JSON ข้อความจะมีลักษณะดังนี้

{"The date is: " : "{message.header.date}"}

อย่างไรก็ตาม คุณจะเห็นว่ามี JSON ที่มีรูปแบบไม่ถูกต้อง หากต้องการแก้ไขปัญหานี้ คุณมี 2 ตัวเลือกดังนี้

• ใช้วงเล็บปีกกาเปิดโดยใช้แบ็กสแลชดังนี้

  \{"The date is: " : "{message.header.date}"}
  

• ในการกำหนดค่าองค์ประกอบเพย์โหลด ให้ใช้แอตทริบิวต์ variablePrefix และ variableSuffix เพื่อระบุตัวแปรในเพย์โหลด JSON ตัวอย่างเช่น
  

  <Payload contentType="application/json" variablePrefix="#" variableSuffix="%">{"The date is: " : "#message.header.date%"}</Payload>
  

ใน Edge for Private Cloud รุ่นถัดไป คุณจะใช้วงเล็บปีกกาสำหรับตัวแปรในข้อความ JSON ได้โดยไม่มีปัญหา (APIRT-1160)

เราเตอร์เริ่มต้น Nginx ไม่ได้ หรือเราเตอร์เริ่มทำงานไม่ได้

หากเราเตอร์ Edge เริ่มต้น Nginx ไม่ได้หรือเริ่มต้นไม่ได้เลยดังที่แสดงในไฟล์ /opt/apigee/var/log/edge-router/logs/system.log ให้ลบไฟล์ทั้งหมดในไดเรกทอรี /opt/nginx/conf.d จากนั้นรีสตาร์ทเราเตอร์

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart