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

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

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

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

• Cloud: 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 สำหรับ Private Cloud ได้ที่เวอร์ชัน 4.18.01

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

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

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

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

ต่อไปนี้เป็นรายการการเปลี่ยนแปลงการติดตั้ง อัปเกรด และสคริปต์ที่เกี่ยวข้อง สำหรับข้อมูล เมื่อใช้งาน โปรดดูเอกสารประกอบ Edge for 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 ออกแล้ว โปรดดูกระบวนการย้อนกลับ 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"
• การดูแลระบบโดยใช้สคริปต์ - A ยูทิลิตีบรรทัดคำสั่ง 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 (Cloud 16.03.09 UI)

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 ไปยังพร็อกซี API อื่น ซึ่งส่งต่อคำขอผ่าน ตัวจัดสรรภาระงาน เราเตอร์ และผู้ประมวลผลข้อความ

องค์ประกอบ LocalTargetConnection ใหม่พร้อมใช้งานในพร็อกซี API TargetEndpoint ซึ่งช่วยให้คุณระบุชื่อพร็อกซี 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 ใน กำหนดนโยบายข้อความ, การเรียก Java และ Raise Fault

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

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

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

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

• ซ่อนวงเล็บปีกกาเปิดด้วยแบ็กสแลช

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

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

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

ใน Edge ครั้งถัดไปสำหรับการเผยแพร่ฟีเจอร์ 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