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

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

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

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

ภาพรวมของรุ่น

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

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

ในส่วนของการเลิกใช้งาน เราได้เลิกใช้งานห้องเก็บเครื่องมือแล้ว

ส่วนที่เหลือของหัวข้อนี้มีรายละเอียดเกี่ยวกับฟีเจอร์ใหม่ การอัปเดต และการแก้ไขข้อบกพร่องทั้งหมด ที่รวมอยู่ในการเปิดตัว

การเลิกใช้งานและการหยุดให้บริการ

ฟีเจอร์ต่อไปนี้ถูกเลิกใช้งานหรือหยุดให้บริการในรุ่นนี้ ดูข้อมูลเพิ่มเติมได้ในนโยบายการเลิกใช้งาน Edge

เลิกใช้งาน: การเพิ่มเส้นทางในแท็บประสิทธิภาพของพร็อกซี API

ก่อนการเปิดตัวนี้ คุณสามารถไปที่พร็อกซี API ใน UI การจัดการ ไปที่แท็บประสิทธิภาพ และสร้างเส้นทางต่างๆ สำหรับการเปรียบเทียบแบบชาร์ตในแท็บประสิทธิภาพของพร็อกซีและในแดชบอร์ดธุรกรรมทางธุรกิจ เราเลิกใช้งานฟีเจอร์นี้แล้วและจะไม่มีให้บริการใน UI อีกต่อไป หากต้องการใช้ฟังก์ชันนี้ในรูปแบบอื่น โปรดดูบทความในชุมชน Apigee ต่อไปนี้ ทางเลือกแทน Business Transactions API (EDGEUI-902)

เลิกใช้งานแล้ว URL buildInfo สำหรับพอร์ทัลบริการสำหรับนักพัฒนาแอป

ในพอร์ทัลเวอร์ชันก่อนหน้า หากต้องการตรวจสอบเวอร์ชันพอร์ทัล ให้เปิด URL ต่อไปนี้ในเบราว์เซอร์

http://yourportal.com/buildInfo

ในเวอร์ชัน 4.17.05 เราได้นำลิงก์นี้ออกแล้ว หากต้องการดูเวอร์ชัน ให้เปิดรายการเมนูรายงาน > รายงานสถานะใน Drupal เวอร์ชันพอร์ทัลจะปรากฏในตารางในแถว ชื่อติดตั้งโปรไฟล์

การเลิกใช้งานที่เก็บข้อมูลที่ปลอดภัย (Vault) ของ Apigee

Apigee secure store หรือที่เรียกว่า "Vault" จะเลิกใช้งานและจะหยุดให้บริการในอีก 1 ปีนับจาก วันที่ประกาศการเลิกใช้งานที่แสดงใน หน้าการเลิกใช้งานและ การหยุดให้บริการ ระบบจะสร้าง Vault ซึ่งมีพื้นที่เก็บข้อมูลที่เข้ารหัสของคู่คีย์/ค่าด้วย Management API และเข้าถึงได้ที่รันไทม์ด้วยฟังก์ชันในโมดูล apigee-access Node.js

ให้ใช้แผนที่ค่าคีย์ (KVM) ที่เข้ารหัสแทนการใช้ที่เก็บข้อมูลที่ปลอดภัย ตามที่อธิบายไว้ใน การทำงานกับแผนที่ค่าคีย์ KVM ที่เข้ารหัสมีความปลอดภัยเช่นเดียวกับ Vault และมีตัวเลือกเพิ่มเติมสำหรับการสร้างและ การดึงข้อมูล (MGMT-3848)

ฟีเจอร์และการอัปเดตใหม่ๆ

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

Private Cloud

เพิ่มพารามิเตอร์การกำหนดค่า SMTP ใหม่ที่จำเป็นลงในการติดตั้ง

ตอนนี้คุณต้องใช้พารามิเตอร์ SMTPMAILFROM ใน ไฟล์การกำหนดค่าการติดตั้ง Edge พารามิเตอร์นี้ระบุอีเมล ที่ใช้เมื่อ Edge ส่งอีเมลอัตโนมัติ เช่น เมื่อผู้ใช้ขอรีเซ็ตรหัสผ่าน ดูข้อมูลเพิ่มเติมได้ที่ ติดตั้งคอมโพเนนต์ Edge ใน โหนด

(EDGEUI-1020)

ตอนนี้คุณสามารถตั้งค่าการหมดเวลาที่ Edge UI ใช้สำหรับการเรียกการจัดการ Edge API ได้แล้ว

ตอนนี้คุณระบุระยะหมดเวลาของ API ที่ใช้โดย Edge UI เพื่อควบคุมระยะเวลาที่ UI รอให้การเรียกใช้การจัดการ API กลับมาได้แล้ว พร็อพเพอร์ตี้ต่อไปนี้กำหนดการหมดเวลา

• conf_apigee_apigee.feature.apitimeout ตั้งค่า เวลาเป็นวินาทีที่ UI รอให้การเรียกไปยังแบ็กเอนด์แสดงผล ไม่ว่าจะมี กิจกรรมใดๆ ในนั้นก็ตาม หากการเรียกใช้ไม่เสร็จสมบูรณ์ภายในเวลานั้น UI จะแสดงข้อผิดพลาดหมดเวลา ค่าเริ่มต้นคือ 180 วินาที (3 นาที)
• conf_apigee_play.ws.timeout.idle กำหนดระยะเวลาที่ UI จะรอ กิจกรรมบนเซิร์ฟเวอร์เป็นมิลลิวินาที โดยสามารถตั้งค่าให้เท่ากับ conf_apigee_apigee_apitimeout หรือ ตั้งค่าให้น้อยกว่าก็ได้ การตั้งค่าเป็นค่าที่ใหญ่ขึ้นจะไม่มีผล ค่าเริ่มต้นคือ 180000 มิลลิวินาที (3 นาที)
• conf_apigee_play.ws.timeout.connection ตั้งค่า ระยะเวลาที่ UI รอให้สร้างการเชื่อมต่อ โดยสามารถตั้งค่าให้เท่ากับ conf_apigee_apigee_apitimeout หรือ ตั้งค่าให้น้อยกว่าก็ได้ การตั้งค่าเป็นค่าที่ใหญ่ขึ้นจะไม่มีผล ค่าเริ่มต้นคือ 120000 มิลลิวินาที (2 นาที)

ดูข้อมูลเพิ่มเติมได้ที่ตั้งค่าการหมดเวลา ที่ใช้โดย UI ของ Edge สำหรับการเรียกการจัดการ Edge API

(EDGEUI-816)

เพิ่มการหมดเวลาการลองใหม่ของตัวประมวลผลข้อความไปยังเราเตอร์

เพิ่มการหมดเวลาเพื่อให้เราเตอร์หยุดลองส่งคำขอไปยังตัวประมวลผลข้อความอีกครั้งและแสดงข้อความแสดงข้อผิดพลาด

ดูข้อมูลเพิ่มเติมได้ที่การกำหนดค่า เราเตอร์ให้ลองเชื่อมต่อกับ Message Processor อีกครั้ง

(APIRT-2912)

เพิ่มขั้นตอนในการเปลี่ยนผู้ดูแลระบบเริ่มต้น

ตอนนี้เราได้รวมเอกสารเพื่อเปลี่ยนผู้ดูแลระบบเริ่มต้นแล้ว

ดูข้อมูลเพิ่มเติมได้ที่การจัดการ ผู้ใช้ บทบาท และสิทธิ์

(DOS-4895)

เพิ่มเอกสารเกี่ยวกับการแยกงานการติดตั้ง Edge ระหว่างผู้ใช้รูทและผู้ใช้ที่ไม่ใช่รูท

เอกสารประกอบใหม่จะอธิบายขั้นตอนในการแยกงานการติดตั้ง Edge ระหว่างผู้ใช้รูทและผู้ใช้ที่ไม่ใช่รูท

ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมการติดตั้ง Edge

(DOS-4573)

เพิ่มพร็อพเพอร์ตี้เพื่อตั้งค่าชื่อโฮสต์สำหรับลิงก์ในอีเมลที่สร้างขึ้น

Edge จะส่งอีเมลโดยอัตโนมัติเพื่อตอบสนองต่อเหตุการณ์บางอย่าง เช่น เมื่อมีการเพิ่มผู้ใช้ลงใน องค์กร อีเมลเหล่านี้หลายฉบับมีลิงก์ เช่น เมื่อมีการเพิ่มผู้ใช้ใหม่ในองค์กร UI ของ Edge จะส่งอีเมลที่มี URL การเข้าสู่ระบบในรูปแบบต่อไปนี้ให้แก่ผู้ใช้

https://domain/login

Edge จะกำหนดโดเมนโดยอัตโนมัติ ซึ่งโดยปกติแล้วจะถูกต้องสำหรับองค์กร อย่างไรก็ตาม มีโอกาสที่เมื่อ UI ของ Edge อยู่หลังตัวจัดสรรภาระงาน ชื่อโดเมนที่สร้างขึ้นโดยอัตโนมัติจะไม่ถูกต้อง หากเป็นเช่นนั้น คุณสามารถใช้พร็อพเพอร์ตี้ conf_apigee_apigee.emails.hosturl เพื่อ ตั้งค่าส่วนชื่อโดเมนของ URL ที่สร้างขึ้นอย่างชัดแจ้ง

ดูข้อมูลเพิ่มเติมได้ที่การตั้งค่าชื่อโฮสต์สำหรับลิงก์ในอีเมลที่สร้างขึ้น

(EDGEUI-1044)

การตั้งค่า URL ฐานที่ UI ของ Edge แสดงสำหรับพร็อกซี API

UI ของ Edge จะแสดง URL ของพร็อกซี API ตามการตั้งค่าในโฮสต์เสมือน ที่สอดคล้องกับตำแหน่งที่พร็อกซีได้รับการติดตั้งใช้งาน การแสดงนี้อาจรวมหมายเลขพอร์ตเราเตอร์ของ โฮสต์เสมือน

ในกรณีส่วนใหญ่ URL ที่แสดงใน UI ของ Edge คือ URL ที่ถูกต้องสำหรับการส่งคำขอภายนอกไปยังพร็อกซี อย่างไรก็ตาม การกำหนดค่าบางอย่างอาจทำให้ URL ที่แสดงไม่ถูกต้อง ตัวอย่างเช่น การกำหนดค่าต่อไปนี้อย่างใดอย่างหนึ่งอาจทำให้ URL ที่แสดงไม่ตรงกับ URL จริงที่ใช้ในการส่งคำขอภายนอกไปยังพร็อกซี

• การสิ้นสุด SSL เกิดขึ้นที่ตัวจัดสรรภาระงาน
• การแมปพอร์ตจะเกิดขึ้นระหว่างตัวจัดสรรภาระงานกับเราเตอร์ Apigee
• ตัวจัดสรรภาระงานที่กำหนดค่าด้วยการเขียนเส้นทางใหม่

Edge สำหรับ Private Cloud 4.17.05 ขึ้นไปรองรับแอตทริบิวต์ในโฮสต์เสมือนที่ชื่อ <BaseUrl> ซึ่งช่วยให้คุณ ลบล้าง URL ที่แสดงโดย UI ของ Edge ได้ ตัวอย่างต่อไปนี้แสดงออบเจ็กต์โฮสต์เสมือนที่มีแอตทริบิวต์ <BaseURL> ใหม่ ในตัวอย่างนี้ ค่า "http://myCo.com" จะปรากฏใน UI ของ Edge

<VirtualHost name="myVHost">
   <HostAliases>
     <HostAlias>DNS_name_or_IP:9005</HostAlias>
   </HostAliases>
   <BaseUrl>http://myCo.com</BaseUrl>
   <Interfaces/>
   <Port>9005</Port>
</VirtualHost>

หากไม่ได้ตั้งค่า <BaseUrl> ค่าเริ่มต้น URL เริ่มต้นที่แสดงโดย UI ของ Edge จะปรากฏเป็น "http://DNS_name_or_IP:9005/" ในขณะที่การตั้งค่าชื่อแทนโฮสต์จริงคือ "http://myCo.com"

นอกจากนี้ คุณยังตั้งค่า URL ฐานเมื่อสร้างองค์กรได้โดยใช้พร็อพเพอร์ตี้ VHOST_BASEURL กับ ยูทิลิตี apigee-provision ได้ด้วย

ดูข้อมูลเพิ่มเติมได้ที่การกำหนดค่าการเข้าถึง TLS ไปยัง API สำหรับ Private Cloud

(EDGEUI-5008)

เพิ่มเอกสารประกอบเกี่ยวกับการเปิดใช้การบันทึกการแก้ไขข้อบกพร่อง

เพิ่มเอกสารประกอบเพื่ออธิบายวิธีเปิด/ปิดใช้การบันทึกการแก้ไขข้อบกพร่องสำหรับคอมโพเนนต์ Edge

ดูข้อมูลเพิ่มเติมได้ที่การเปิดใช้การบันทึกการแก้ไขข้อบกพร่อง

(APIRT-4018)

โปรแกรมติดตั้งและไวยากรณ์คำสั่งใหม่สำหรับยูทิลิตี apigee-analytics-collector

ลูกค้า Edge for Private Cloud ทุกรายต้องส่งสถิติเกี่ยวกับพร็อกซี API ไปยัง Apigee โดยใช้การเผยแพร่รุ่นเบต้าของยูทิลิตีบรรทัดคำสั่ง apigee-analytics-collector ยูทิลิตี้นี้จะส่งรายงานปริมาณการเรียก API กลับไปยัง Apigee

Edge เวอร์ชันนี้มีวิธีการติดตั้งและไวยากรณ์คำสั่งใหม่สำหรับยูทิลิตี apigee-analytics-collector ในรุ่นนี้ คุณจะใช้ apigee-service เพื่อติดตั้ง ยูทิลิตี apigee-analytics-collector แทน npm และเรียกใช้ยูทิลิตี apigee-analytics-collector ผ่าน apigee-service แทนที่จะเป็น คำสั่งแบบสแตนด์อโลน

ดูข้อมูลเพิ่มเติมได้ที่การอัปโหลด API ข้อมูลการเข้าชมไปยัง Apigee - เวอร์ชันเบต้า

ไดเรกทอรีการติดตั้งเริ่มต้นใหม่หลังจากอัปเดตพอร์ทัล Developer Services ของ Nginx/Postgres จากการติดตั้ง 4.17.01 ใหม่

หลังจากอัปเดตการติดตั้งใหม่ของ 4.17.01 ที่ใช้ Nginx/Postgres ไดเรกทอรีราก เปลี่ยนจาก

/opt/apigee/apigee-drupal

ถึง:

/opt/apigee/apigee-drupal/wwwroot

บริการ API

การตรวจสอบอินพุตที่เข้มงวดมากขึ้นสำหรับเอนทิตี

เราได้บังคับใช้การตรวจสอบอินพุตที่เข้มงวดมากขึ้นในทุกเอนทิตีขององค์กร Apigee Edge โดยปกติแล้วอักขระที่อนุญาตคือตัวอักษร (ทุกรูปแบบ) ตัวเลข และขีดล่าง

เอนทิตีที่ได้รับผลกระทบ ได้แก่

• องค์กร
• สภาพแวดล้อม
• พร็อกซี API
• การแก้ไขพร็อกซี API
• ชื่อนโยบายในพร็อกซี API
• รหัสการกำหนดค่ามาสก์การติดตามการแก้ไขข้อบกพร่อง
• ชื่อทรัพยากร (การเรียกใช้ Java, XSL, ทรัพยากรทั้งหมด)
• คีย์สโตร์
• CRLstores
• การอ้างอิงทรัพยากร
• เซิร์ฟเวอร์เป้าหมาย

(MGMT-3840)

การทำให้โฟลว์ที่แชร์ใช้งานได้โดยไม่มีการหยุดทำงาน

ตอนนี้คุณสามารถใช้ API การจัดการการติดตั้งใช้งานแบบไม่มีการหยุดทำงานได้แล้ว เมื่อต้องการติดตั้งใช้งานโฟลว์ที่แชร์และตรวจสอบว่ามีการปฏิเสธการเข้าชมขาเข้าน้อยมากหรือไม่มีเลย ในระหว่างการติดตั้งใช้งาน กระบวนการนี้ เกือบจะเหมือนกับการติดตั้งใช้งานพร็อกซี API โดยใช้ Management API แบบไม่มีการหยุดทำงาน ความแตกต่างเพียงอย่างเดียวคือทรัพยากร Management API

การเรียกใช้ต่อไปนี้จะทําให้การแก้ไขโฟลว์ที่แชร์ซึ่งระบุไว้ใน URI ใช้งานได้ จากนั้นจะยกเลิกการทําให้การแก้ไขที่ใช้งานก่อนหน้านี้ใช้งานไม่ได้ (พารามิเตอร์การค้นหา override=true จะเปิดใช้การดำเนินการนี้)

curl -X POST -H "Content-type:application/x-www-form-urlencoded" \
https://api.enterprise.apigee.com/v1/o/{org_name}/environments/{env-name}/sharedflows/{shared_flow_name}/revisions/{revision_number}/deployments?"override=true" \
-u email:password

(MGMT-3485)

การสร้างรายได้

การลบข้อมูลการสร้างรายได้ขององค์กร

คุณอาจต้องการลบข้อมูลการสร้างรายได้ขององค์กรในกรณีต่อไปนี้

• ลบองค์กร ในกรณีนี้ คุณต้องลบข้อมูลการสร้างรายได้ก่อนจึงจะลบองค์กรได้
• ล้างข้อมูลการสร้างรายได้จากองค์กรทดสอบที่คุณต้องการนำกลับมาใช้ใหม่ ในกรณีนี้ คุณต้องซิงค์ข้อมูล Apigee Edge หลังจากลบข้อมูลการสร้างรายได้

โปรดดูข้อมูลเพิ่มเติมที่หัวข้อลบข้อมูลการสร้างรายได้ ออกจากองค์กร (DEVRT-2581)

เพิ่ม API สำหรับเปิดใช้การสร้างรายได้สำหรับองค์กร

ตอนนี้คุณสามารถใช้ API เพื่อเปิดใช้การสร้างรายได้สำหรับองค์กรได้แล้ว

ดูข้อมูลเพิ่มเติมได้ที่หัวข้อเปิดใช้ การสร้างรายได้สำหรับองค์กร

(DEVRT-2383)

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

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

Private Cloud 4.17.05

Cloud 17.04.12 (UI)

Cloud 17.04.05 (UI)

Cloud 17.03.29 (UI)

Cloud 17.03.15.01 (UI)

Cloud 17.03.15 (UI)

Cloud 17.03.13.02 (การสร้างรายได้)

Cloud 17.03.13.01 (การสร้างรายได้)

Cloud 17.03.13 (การจัดการ API)

Cloud 17.03.1 (UI)

Cloud 17.02.15 (UI)

Cloud 17.02.13 (รันไทม์ API)

Cloud 17.02.13 (การจัดการ API)

Cloud 17.01.18 (UI)

Cloud 17.01.16 (การจัดการ API)

Cloud 17.01.16 (การสร้างรายได้)