4.17.05 – Ghi chú phát hành Edge for Private Cloud

Bạn đang xem tài liệu về Apigee Edge.
Truy cập vào tài liệu Apigee X. Thông tin

Kể từ Bản phát hành tính năng Edge cho Đám mây riêng tư trước đó, các bản phát hành sau đây đã diễn ra và được đưa vào Bản phát hành tính năng này:

Hãy xem phần Giới thiệu về cách đánh số bản phát hành để biết cách xác định xem một bản phát hành cụ thể trên đám mây có được đưa vào phiên bản Edge cho Đám mây riêng tư của bạn hay không.

Tổng quan về bản phát hành

Bản phát hành này bao gồm một số tính năng đáng chú ý giúp bạn kiểm soát và bảo mật API tốt hơn, bao gồm:

• Luồng dùng chung hỗ trợ triển khai mà không bị gián đoạn.
• Hiện tại, chúng tôi đã hỗ trợ việc xoá dữ liệu kiếm tiền của một tổ chức.
• Các tính năng mới khác được mô tả bên dưới.

Về việc ngừng sử dụng, các kho lưu trữ đã ngừng hoạt động.

Phần còn lại của chủ đề này chứa thông tin chi tiết về tất cả các tính năng mới, nội dung cập nhật và bản sửa lỗi có trong bản phát hành.

Ngừng sử dụng và ngừng cung cấp

Các tính năng sau đây đã bị ngừng cung cấp hoặc ngừng hoạt động trong bản phát hành này. Hãy xem Chính sách về việc không dùng Edge nữa để biết thêm thông tin.

Ngừng hoạt động: Thêm đường dẫn trên thẻ Hiệu suất của proxy API

Cho đến bản phát hành này, bạn có thể chuyển đến một API proxy trong giao diện người dùng quản lý, chuyển đến thẻ Hiệu suất và tạo các đường dẫn khác nhau để so sánh dựa trên biểu đồ trên thẻ Hiệu suất của proxy và trong trang tổng quan Giao dịch kinh doanh. Tính năng này hiện đã ngừng hoạt động và không còn xuất hiện trong giao diện người dùng nữa. Để biết giải pháp thay thế cho chức năng này, hãy xem bài viết sau đây trên Cộng đồng Apigee: Giải pháp thay thế cho Business Transactions API. (EDGEUI-902)

Không còn được dùng: URL buildInfo cho cổng thông tin Dịch vụ dành cho nhà phát triển

Trong các phiên bản trước của cổng thông tin, để xác định phiên bản cổng thông tin, bạn đã mở URL sau trong trình duyệt:

http://yourportal.com/buildInfo

Trong phiên bản 4.17.05, đường liên kết này đã bị xoá. Để xác định phiên bản, hãy mở mục trình đơn Báo cáo > Báo cáo trạng thái trong Drupal. Phiên bản cổng thông tin xuất hiện trong bảng ở hàng có tên là Hồ sơ cài đặt.

Ngừng sử dụng kho lưu trữ bảo mật (vault) Apigee

Kho lưu trữ an toàn của Apigee (còn gọi là "kho") sẽ ngừng hoạt động và sẽ bị loại bỏ sau một năm kể từ ngày thông báo ngừng hoạt động xuất hiện trên trang Ngừng hoạt động và loại bỏ. Các kho lưu trữ cung cấp bộ nhớ được mã hoá cho các cặp khoá/giá trị, được tạo bằng API quản lý và được truy cập trong thời gian chạy bằng các hàm trong mô-đun apigee-access Node.js.

Thay vì sử dụng bộ nhớ an toàn, hãy dùng các bản đồ khoá giá trị (KVM) đã mã hoá, như mô tả trong phần Làm việc với bản đồ khoá giá trị. KVM được mã hoá cũng an toàn như kho lưu trữ và cung cấp nhiều lựa chọn hơn để tạo và truy xuất. (MGMT-3848)

Thông tin cập nhật và tính năng mới

Sau đây là các tính năng mới và điểm cải tiến trong bản phát hành này. Ngoài những điểm cải tiến sau, bản phát hành này còn có nhiều điểm cải tiến về khả năng sử dụng, hiệu suất, tính bảo mật và độ ổn định.

Đám mây riêng tư

Đã thêm tham số cấu hình SMTP bắt buộc mới vào quá trình cài đặt

Giờ đây, bạn phải sử dụng tham số SMTPMAILFROM trong tệp cấu hình cài đặt Edge. Tham số này chỉ định địa chỉ email được dùng khi Edge gửi email tự động, chẳng hạn như khi người dùng yêu cầu đặt lại mật khẩu. Hãy xem phần Cài đặt các thành phần Edge trên một nút để biết thêm thông tin.

(EDGEUI-1020)

Giờ đây, bạn có thể đặt thời gian chờ mà Giao diện người dùng Edge sử dụng cho các lệnh gọi quản lý API Edge

Giờ đây, bạn có thể chỉ định khoảng thời gian chờ API mà Giao diện người dùng Edge sử dụng để kiểm soát thời gian giao diện người dùng chờ lệnh gọi quản lý API trả về. Các thuộc tính sau đây xác định thời gian chờ:

• conf_apigee_apigee.feature.apitimeout đặt thời gian (tính bằng giây) mà giao diện người dùng đợi một lệnh gọi đến phần phụ trợ trả về, bất kể có hoạt động nào trên đó hay không. Nếu lệnh gọi không hoàn tất trong thời gian đó, giao diện người dùng sẽ đưa ra lỗi hết thời gian chờ. Giá trị mặc định là 180 giây (3 phút).
• conf_apigee_play.ws.timeout.idle đặt khoảng thời gian mà giao diện người dùng chờ hoạt động trên máy chủ (tính bằng mili giây). Bạn có thể đặt giá trị này thành giá trị tương tự như conf_apigee_apigee_apitimeout hoặc thành giá trị nhỏ hơn. Việc đặt giá trị này thành một giá trị lớn hơn sẽ không có hiệu lực. Giá trị mặc định là 180000 mili giây (3 phút).
• conf_apigee_play.ws.timeout.connection đặt thời gian chờ của giao diện người dùng để thiết lập kết nối. Bạn có thể đặt giá trị này thành giá trị tương tự như conf_apigee_apigee_apitimeout hoặc thành giá trị nhỏ hơn. Việc đặt giá trị này thành một giá trị lớn hơn sẽ không có hiệu lực. Giá trị mặc định là 120000 mili giây (2 phút).

Hãy xem phần Đặt thời gian chờ mà giao diện người dùng Edge sử dụng cho các lệnh gọi quản lý Edge API để biết thêm thông tin.

(EDGEUI-816)

Đã thêm thời gian chờ thử lại của Trình xử lý thông báo vào Bộ định tuyến

Đã thêm một thời gian chờ để Bộ định tuyến ngừng thử lại yêu cầu đối với Bộ xử lý thông báo và trả về thông báo lỗi.

Hãy xem phần Định cấu hình Bộ định tuyến để thử lại các kết nối đến một Trình xử lý thông báo để biết thêm thông tin.

(APIRT-2912)

Thêm quy trình thay đổi quản trị viên hệ thống mặc định

Giờ đây, tài liệu này bao gồm cả cách thay đổi quản trị viên hệ thống mặc định.

Hãy xem phần Quản lý người dùng, vai trò và quyền để biết thêm thông tin.

(DOS-4895)

Thêm tài liệu về việc tách các tác vụ cài đặt Edge giữa người dùng gốc và người dùng không phải gốc

Tài liệu mới mô tả các bước để tách các tác vụ cài đặt Edge giữa người dùng root và người dùng không phải root.

Xem phần Tổng quan về quy trình cài đặt Edge để biết thêm thông tin.

(DOS-4573)

Thêm thuộc tính để đặt tên máy chủ cho các đường liên kết trong email được tạo

Edge tự động gửi email để phản hồi một số sự kiện, chẳng hạn như khi người dùng được thêm vào một tổ chức. Nhiều email trong số này có chứa một đường liên kết. Ví dụ: khi một người dùng mới được thêm vào một tổ chức, giao diện người dùng Edge sẽ gửi cho người dùng đó một email chứa URL đăng nhập ở dạng:

https://domain/login

Miền được Edge xác định tự động và thường chính xác đối với tổ chức. Tuy nhiên, có thể khi giao diện người dùng Edge nằm sau một bộ cân bằng tải, tên miền được tạo tự động sẽ không chính xác. Nếu có, bạn có thể sử dụng thuộc tính conf_apigee_apigee.emails.hosturl để đặt rõ ràng phần tên miền của URL được tạo.

Hãy xem phần Đặt tên máy chủ lưu trữ cho đường liên kết trong email được tạo để biết thêm thông tin.

(EDGEUI-1044)

Đặt URL cơ sở mà giao diện người dùng Edge hiển thị cho một proxy API

Giao diện người dùng Edge hiển thị URL của một API proxy dựa trên các chế độ cài đặt trong máy chủ ảo tương ứng với vị trí triển khai proxy. Màn hình này có thể bao gồm số cổng Bộ định tuyến của máy chủ ảo.

Trong hầu hết các trường hợp, URL xuất hiện trong giao diện người dùng Edge là URL chính xác để đưa ra các yêu cầu bên ngoài đối với proxy. Tuy nhiên, đối với một số cấu hình, URL hiển thị không chính xác. Ví dụ: bất kỳ cấu hình nào sau đây đều có thể khiến URL hiển thị không tương ứng với URL thực tế được dùng để đưa ra các yêu cầu bên ngoài cho proxy:

• Việc chấm dứt SSL diễn ra tại một trình cân bằng tải
• Quá trình liên kết cổng diễn ra giữa bộ cân bằng tải và các bộ định tuyến Apigee
• Một trình cân bằng tải được định cấu hình bằng tính năng viết lại đường dẫn

Edge cho Đám mây riêng tư phiên bản 4.17.05 trở lên hỗ trợ một thuộc tính trên máy chủ lưu trữ ảo có tên là <BaseUrl>. Thuộc tính này cho phép bạn ghi đè URL mà Giao diện người dùng Edge hiển thị. Sau đây là ví dụ minh hoạ đối tượng máy chủ ảo có thuộc tính <BaseURL> mới. Trong ví dụ này, giá trị "http://myCo.com" sẽ xuất hiện trong giao diện người dùng Edge:

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

Nếu bạn không đặt <BaseUrl>, thì URL mặc định do giao diện người dùng Edge hiển thị sẽ có dạng: "http://DNS_name_or_IP:9005/", trong khi chế độ thiết lập bí danh máy chủ thực tế là "http://myCo.com".

Bạn cũng có thể đặt URL cơ sở khi tạo một tổ chức bằng cách sử dụng thuộc tính VHOST_BASEURL với tiện ích apigee-provision.

Hãy xem phần Định cấu hình quyền truy cập TLS vào một API cho Đám mây riêng để biết thêm thông tin.

(EDGEUI-5008)

Thêm tài liệu về cách bật tính năng ghi nhật ký gỡ lỗi

Chúng tôi đã thêm tài liệu để mô tả cách bật/tắt tính năng ghi nhật ký gỡ lỗi cho các thành phần Edge.

Hãy xem bài viết Bật tính năng ghi nhật ký gỡ lỗi để biết thêm thông tin.

(APIRT-4018)

Trình cài đặt và cú pháp lệnh mới cho tiện ích apigee-analytics-collector

Tất cả khách hàng sử dụng Edge cho Đám mây riêng tư đều phải gửi cho Apigee số liệu thống kê về lưu lượng truy cập của API proxy bằng cách sử dụng phiên bản Beta của tiện ích dòng lệnh apigee-analytics-collector. Tiện ích này gửi báo cáo về số lượng lệnh gọi API trở lại Apigee.

Bản phát hành Edge này có hướng dẫn cài đặt và cú pháp lệnh mới cho tiện ích apigee-analytics-collector. Trong bản phát hành này, giờ đây, bạn có thể sử dụng apigee-service để cài đặt tiện ích apigee-analytics-collector thay vì npm, đồng thời gọi tiện ích apigee-analytics-collector thông qua apigee-service thay vì dưới dạng một lệnh độc lập.

Hãy xem bài viết Tải dữ liệu lưu lượng truy cập API lên Apigee – Bản phát hành thử nghiệm để biết thêm thông tin.

Thư mục cài đặt mặc định mới sau khi Cổng dịch vụ dành cho nhà phát triển cập nhật Nginx/Postgres từ một bản cài đặt 4.17.01 mới

Sau khi cập nhật một bản cài đặt mới của 4.17.01 sử dụng Nginx/Postgres, thư mục gốc đã thay đổi từ:

/opt/apigee/apigee-drupal

tới:

/opt/apigee/apigee-drupal/wwwroot

Dịch vụ API

Xác thực dữ liệu đầu vào nghiêm ngặt hơn cho các thực thể

Quy trình xác thực đầu vào nghiêm ngặt hơn đã được thực thi trên tất cả các thực thể của tổ chức Apigee Edge. Các ký tự được phép thường là chữ cái (tất cả các trường hợp), số, dấu gạch dưới.

Các thực thể chịu ảnh hưởng bao gồm:

• Tổ chức
• Môi trường
• API proxy
• Bản sửa đổi proxy API
• Tên chính sách trong proxy API
• Mã cấu hình mặt nạ theo dõi gỡ lỗi
• Tên tài nguyên (Chú thích Java, xsl, tất cả tài nguyên)
• Kho khoá
• CRLstores
• Mã tham chiếu tài nguyên
• Máy chủ đích

(MGMT-3840)

Triển khai luồng dùng chung mà không bị gián đoạn

Khi muốn triển khai các luồng dùng chung và đảm bảo rằng có rất ít hoặc không có lưu lượng truy cập đến bị từ chối trong quá trình triển khai, giờ đây, bạn có thể sử dụng API quản lý việc triển khai không có thời gian ngừng hoạt động. Quy trình này gần giống với việc triển khai không có thời gian ngừng hoạt động cho các proxy API bằng API quản lý. Sự khác biệt duy nhất là tài nguyên API quản lý.

Lệnh gọi sau đây triển khai bản sửa đổi luồng dùng chung được chỉ định trong URI, sau đó huỷ triển khai bản sửa đổi đã triển khai trước đó (tham số truy vấn override=true cho phép điều này):

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)

Kiếm tiền

Xoá dữ liệu kiếm tiền của một tổ chức

Bạn có thể muốn xoá dữ liệu kiếm tiền của tổ chức trong các trường hợp sau:

• Xoá tổ chức của bạn. Trong trường hợp này, bạn phải xoá dữ liệu kiếm tiền trước khi có thể xoá tổ chức.
• Xoá dữ liệu kiếm tiền khỏi một tổ chức kiểm thử mà bạn muốn sử dụng lại. Trong trường hợp này, bạn phải đồng bộ hoá dữ liệu Apigee Edge sau khi xoá dữ liệu về hoạt động kiếm tiền.

Để biết thêm thông tin, hãy xem bài viết Xoá dữ liệu kiếm tiền khỏi tổ chức của bạn. (DEVRT-2581)

Thêm API để bật tính năng kiếm tiền cho một tổ chức

Giờ đây, bạn có thể dùng API để bật tính năng kiếm tiền cho một tổ chức.

Xem bài viết Bật tính năng kiếm tiền cho tổ chức để biết thêm thông tin.

(DEVRT-2383)

Các lỗi đã được khắc phục

Các lỗi sau đây đã được khắc phục trong bản phát hành này. Danh sách này chủ yếu dành cho những người dùng kiểm tra xem phiếu yêu cầu hỗ trợ của họ đã được giải quyết hay chưa. Báo cáo này không được thiết kế để cung cấp thông tin chi tiết cho tất cả người dùng.

Private Cloud 4.17.05

Cloud 17.04.12 (UI)

Cloud 17.04.05 (Giao diện người dùng)

Cloud 17.03.29 (UI)

Cloud 17.03.15.01 (Giao diện người dùng)

Cloud 17.03.15 (Giao diện người dùng)

Cloud 17.03.13.02 (kiếm tiền)

Cloud 17.03.13.01 (kiếm tiền)

Cloud 17.03.13 (Quản lý API)

Cloud 17.03.1 (Giao diện người dùng)

Cloud 17.02.15 (Giao diện người dùng)

Cloud 17.02.13 (Thời gian chạy API)

Cloud 17.02.13 (Quản lý API)

Cloud 17.01.18 (Giao diện người dùng)

Cloud 17.01.16 (Quản lý API)

Cloud 17.01.16 (kiếm tiền)