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

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

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

ตั้งแต่การเปิดตัวฟีเจอร์ Edge สำหรับ Private Cloud รุ่นก่อนหน้า (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 for Private Cloud

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

ตอนนี้คุณเข้าถึงคู่มือการติดตั้งและการดำเนินการ Edge สำหรับ 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
  • 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 เวอร์ชันก่อนหน้าออกแล้ว ดู4.16.05 กระบวนการย้อนกลับ
• 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 จากเซิร์ฟเวอร์การจัดการได้แล้ว ก่อนหน้านี้ต้องเรียกใช้สคริปต์ ใน Message Processor ดูทดสอบการ ติดตั้ง
• ชื่อภูมิภาค - ภูมิภาคอาจเป็นชื่อใดก็ได้ ในรุ่นก่อนหน้า ชื่อจะอยู่ในรูปแบบ "dc-#" โดยที่ # เป็นค่าจำนวนเต็ม
• พ็อดเกตเวย์ - พ็อดเกตเวย์จะมีชื่อใดก็ได้ ในรุ่นก่อนหน้า พ็อดต้องมีชื่อว่า "gateway"
• การดูแลระบบที่อิงตามสคริปต์ - ยูทิลิตีบรรทัดคำสั่ง 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 (UI ของ Cloud 16.03.02, Cloud 16.03.09)

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

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

การเชื่อมต่อพร็อกซีแบบลูกโซ่ยังใช้ได้ในนโยบายข้อความไฮไลต์ของบริการด้วย

ดูข้อมูลเพิ่มเติมได้ที่การเชื่อมต่อพร็อกซี 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

Cloud 16.03.30

UI ของ Cloud 16.03.16

UI ของ Cloud 16.03.09

Cloud 16.03.02

Cloud 16.02.17

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

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

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

เพย์โหลด JSON ในนโยบาย Assign Message, Java Callout และ Raise Fault

นโยบาย Assign Message, Java Callout และ Raise Fault ช่วยให้คุณสร้างเนื้อหาข้อความได้โดยใช้แท็ก <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 Router เริ่ม 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