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

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

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

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

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

ฟีเจอร์ใหม่และการปรับปรุง

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

ดูรายละเอียดและวิธีการเพิ่มเติมได้ในเอกสารประกอบของ Edge for 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 ทำให้ 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 จากเซิร์ฟเวอร์การจัดการได้แล้ว ก่อนหน้านี้ต้องเรียกใช้สคริปต์ ในตัวประมวลผลข้อความ ดูทดสอบการติดตั้ง
  • ชื่อภูมิภาค - ภูมิภาคอาจเป็นชื่อใดก็ได้ ในรุ่นก่อนหน้า ชื่อจะอยู่ในรูปแบบ "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, UI ของ 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

รหัสปัญหา คำอธิบาย
PRC-770 โปรแกรมติดตั้ง 16.01 ลงทะเบียนเซิร์ฟเวอร์สำรอง Postgres ใน axgroup ไม่สำเร็จ
PRC-758 ผู้ใช้ที่มีบทบาทผู้ใช้จะแก้ไขรายงานที่กำหนดเองได้
PRC-883 การอัปเดตเซิร์ฟเวอร์ Postgres ที่มีการกำหนดค่าหลัก-สแตนด์บายไม่สำเร็จ

Cloud 16.03.30

รหัสปัญหา คำอธิบาย
SECENG-584 การตรวจสอบความถูกต้องสำหรับบรรทัดใหม่ระหว่างใบรับรองในห่วงโซ่ใบรับรองทำให้เกิดปัญหาเกี่ยวกับ ใบรับรองบางรายการในเวอร์ชันที่ใช้งานจริง
MGMT-3217 การเรียก Management API จะล้มเหลวหากชื่อ KVMap ลงท้ายด้วย "keys"
MGMT-3214 ความขัดแย้งของคลาสอาจเกิดขึ้นระหว่าง JavaCallout ซึ่งทำให้โค้ด Java ของลูกค้า ล้มเหลว
MGMT-3185 เกิดข้อผิดพลาดขณะเพิ่มผู้ดูแลระบบขององค์กรไปยังองค์กร
EDGEUI-127 ได้รับสิทธิ์ไม่เพียงพอด้วยโปรแกรมแก้ไขพร็อกซีใหม่
EDGEUI-119 ปัญหาการหมดเวลาของเซสชัน UI
CORESERV-671 เห็นข้อผิดพลาด "ไม่ได้กำหนดค่าวงแหวน ไม่สามารถเริ่มต้นบริการ cps"
AXAPP-2345 ปัญหาในการแสดงรายงานที่กำหนดเองของ AX สำหรับลูกค้าที่ไม่ใช่ CPS
AXAPP-2302 สรุปข้อมูลวิเคราะห์ Apigee รายวันแสดงค่าเป็น 0 ในส่วนการยอมรับของนักพัฒนาแอป
APIRT-2750 การเข้าชมล้มเหลวสูงในองค์กรที่เฉพาะเจาะจง
APIRT-2516 ข้อผิดพลาดรันไทม์ใน Callout ของ JavaScript จะระบุหมายเลขบรรทัดที่ไม่ถูกต้อง
APIRT-2508 ข้อผิดพลาดในการออกเมื่อเรียกใช้การฟังด่วนภายใน Vault Callback
APIRT-2336 ปัญหา Gzip กับ Node.js
APIRT-1975 การกำหนดค่าการมาสก์ใช้ไม่ได้กับ message.content

UI ของ Cloud 16.03.16

รหัสปัญหา คำอธิบาย
MGMT-3142 กราฟไม่โหลดในแดชบอร์ดการวิเคราะห์ข้อผิดพลาด (การแก้ไขที่อัปเดตแล้ว)

UI ของ Cloud 16.03.09

รหัสปัญหา คำอธิบาย
MGMT-3158 สิทธิ์ไม่เพียงพอใน UI เมื่อตั้งค่า RBAC ในพร็อกซีแต่ละรายการผ่าน API
MGMT-3142 กราฟไม่โหลดในแดชบอร์ดการวิเคราะห์ข้อผิดพลาด
MGMT-3118 UI แสดงการกำหนดค่าโฮสต์เสมือน SSL ไม่ถูกต้องสำหรับพารามิเตอร์ "clientAuthEnabled"
DEVRT-2344 คำจำกัดความของรายงานแบบวันเดียวไม่โหลดธุรกรรมใน UI

Cloud 16.03.02

รหัสปัญหา คำอธิบาย
MGMT-3083 การรีเฟรชอัตโนมัติของบันทึก Node.js มีข้อความบันทึกมากเกินไป
DEVRT-2275 แพ็กเกจราคาแอตทริบิวต์ที่กำหนดเองแสดงแอตทริบิวต์เพียง 5 รายการแทนที่จะเป็น 10 รายการตามที่อนุญาต
DEVRT-1275 นักพัฒนาแอปบางรายอาจไม่ปรากฏในเมนูแบบเลื่อนลงของแพ็กเกจราคา
DEVRT-1074 นักพัฒนาแอปแบบชำระเงินล่วงหน้าที่มีเงินคงเหลือเป็น 0 จะได้รับ NullpointerException เมื่อมีการใช้เครดิต

Cloud 16.02.17

รหัสปัญหา คำอธิบาย
MGMT-3083 การรีเฟรชอัตโนมัติของบันทึก Node.js มีข้อความบันทึกมากเกินไป
MGMT-3077 UI สร้างชุดพร็อกซีที่ไม่ถูกต้องจาก WSDL ที่ใช้เนมสเปซเริ่มต้น
MGMT-1642 บทบาทของผู้ใช้ที่กำหนดเองไม่มีสิทธิ์ "get" สำหรับแอปของนักพัฒนาแอป

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

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

รหัสปัญหา คำอธิบาย
APIRT-2978

เราเตอร์เริ่ม 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
APIRT-3364

Message Processor จะค้นหา DNS ใน IPv4 และ IPv6

หากติดตั้งและเปิดใช้ NSCD (Name Service Cache Daemon) คุณอาจสังเกตเห็นว่าตัวประมวลผลข้อความทำการค้นหา DNS 2 ครั้ง ครั้งหนึ่งสำหรับ IPv4 และอีกครั้งสำหรับ IPv6

วิธีปิดใช้ DNS Lookup ใน IPv6

  1. แก้ไข /etc/nscd.conf ในโหนด Message Processor ทุกโหนด
  2. ตั้งค่าพร็อพเพอร์ตี้ต่อไปนี้

    enable-cache hosts no
PRC-1118

ข้อผิดพลาดเมื่อเรียกใช้คำสั่ง "apigee-service apigee-postgresql pg-data-purge"

หากคุณเรียกใช้คำสั่ง "apigee-service apigee-postgresql pg-data-purge" และ เห็นข้อผิดพลาดในรูปแบบต่อไปนี้

ข้อผิดพลาด: ต้องเป็นเจ้าของความสัมพันธ์

แก้ไข /opt/apigee/apigee-postgresql-4.16.05-0.0.894/lib/actions/pg-data-purge และตั้งค่าพร็อพเพอร์ตี้ต่อไปนี้เป็น "apigee"

POSTGRES_USER=apigee
DOC-1687 เนื่องจากความขัดแย้งของ Dependency ของแพ็กเกจที่ทราบแล้ว เอเจนต์ Katello ที่ใช้ใน Satellite Server 6 จะติดตั้งในโฮสต์ Apigee Edge ที่เรียกใช้ Daemon Qpid อย่างถูกต้องไม่ได้

เพย์โหลด 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
ก่อนหน้า
4.16.05.01
ถัดไป
4.16.01.08