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

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

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

ตั้งแต่การเปิดตัวฟีเจอร์ Edge for 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 มีรุ่น 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 ทำให้ Oracle JDK 1.8 ไม่รองรับการเข้ารหัส TLS บางรายการอีกต่อไป ดูรายการทั้งหมดได้ที่ส่วน "ชุดการเข้ารหัสที่ปิดใช้โดยค่าเริ่มต้น" 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

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

คำนำหน้าแบบคงที่สำหรับการบันทึกข้อความ 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, Cloud 16.03.09 UI)

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

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

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

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