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

Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến Tài liệu về Apigee X. thông tin

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

Xem bài viết Giới thiệu về bản phát hành đánh số để biết được làm thế nào để xác định xem một bản phát hành trên đám mây cụ thể có có trong phiên bản Edge dành cho Private Cloud của bạn.

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 tốt hơn API, bao gồm:

• Quy trình chung hỗ trợ triển khai 0 (thời gian ngừng hoạt động).
• Tính năng xoá dữ liệu kiếm tiền cho một tổ chức hiện đã được hỗ trợ.
• Các tính năng mới bổ sung được mô tả dưới đây.

Trong bối cảnh chúng tôi ngừng sử dụng, Vault đã ngừng hoạt động.

Phần còn lại của chủ đề này bao gồm 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 sử dụng

Các tính năng sau đây đã ngừng hoạt động hoặc bị gỡ bỏ trong bản phát hành này. Vui lòng xem Chính sách về việc ngừng sử dụng Edge để biết thêm thông tin.

Đã nghỉ hưu: Đang thêm đường dẫn trên thẻ Hiệu suất proxy API

Đối với bản phát hành này, bạn có thể chuyển đến proxy API 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 đồ dựa trên proxy trong thẻ Hiệu suất và trong trang tổng quan Giao dịch của doanh nghiệp. Tính năng này hiện đã ngừng hoạt động và hoạt động lâu hơn trong giao diện người dùng. Nếu bạn muốn sử dụng chức năng thay thế cho chức năng này, hãy xem bài viết sau đây về Apigee Bài viết trên cộng đồng: https://community.apigee.com/articles/23936/alternative-to-business-transactions-api.html. (EDGEUI-902)

Đã nghỉ hưu: URL buildInfo cho cổng 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 của bạn, bạn đã mở các URL trong trình duyệt:

http://yourportal.com/buildInfo

Vào ngày 4.17.05, đường liên kết này đã bị gỡ bỏ. Để xác định phiên bản, hãy mở Báo cáo > Mục nhập trình đơn của báo cáo trạng thái trong Drupal. Phiên bản cổng thông tin sẽ xuất hiện trong bảng trong hàng có tên là Cài đặt hồ sơ.

Ngừng sử dụng Apigee kho lưu trữ an toàn

Ứng dụng Apigee bảo mật kho lưu trữ, còn được gọi là " Vault" đang không được dùng nữa và sẽ được gỡ bỏ một năm kể từ ngày thông báo ngừng sử dụng được hiển thị trên Ngừng sử dụng và trang ngừng hoạt động. Vault là nơi lưu trữ được mã hoá của các cặp khoá/giá trị bằng API quản lý và được truy cập trong thời gian chạy bằng các hàm trong quyền truy cập apigee Mô-đun Node.js.

Thay vì sử dụng kho bảo mật, hãy dùng bản đồ giá trị khoá đã mã hoá (KVM) theo mô tả trong Sử dụng bản đồ khoá-giá trị. KVM được mã hoá cũng an toàn như kho lưu trữ và mang lại 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à tính năng nâng cao trong bản phát hành này. Ngoài các sản phẩm sau các tính năng nâng cao, bản phát hành này cũng có nhiều tính hữu dụng, hiệu suất, tính bảo mật và độ ổn định các tính năng nâng cao.

Đám mây riêng

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

Bây giờ, bạn phải sử dụng thông 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. Xem Cài đặt các thành phần Edge trên 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 lượng mà 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ờ:

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

Xem Đặ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 để biết thêm thông tin.

(EDGEUI-816)

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

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

Xem phần Định cấu hình Bộ định tuyến để thử kết nối lại với Trình xử lý thư để tìm hiểu thêm.

(APIRT-2912)

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

Tài liệu hiện được đưa vào để thay đổi quản trị viên hệ thống mặc định.

Xem phần Quản lý Người dùng, Vai trò và Quyền để tìm hiểu thêm.

(DOS-4895)

Thêm tài liệu về cách phân 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 thư mục gốc

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

Xem phần Cài đặt Edge Tổng quan để tìm hiểu thêm.

(DOS-4573)

Đã thêm thuộc tính để đặt tên máy chủ cho các 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 nhất định, chẳng hạn như khi một người dùng được thêm vào một tổ chức. Nhiều email trong số này chứa một đường liên kết. Ví dụ: khi bạn thêm một người dùng mới vào tổ chức, giao diện người dùng Edge sẽ gửi cho người dùng một email có chứa URL đăng nhập ở dạng:

https://domain/login

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

Hãy xem phần Đặt tên máy chủ của đườ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 của Edge hiển thị cho proxy API

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

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

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

Edge dành cho Private Cloud 4.17.05 trở lên hỗ trợ một thuộc tính trên máy chủ ảo có tên là <BaseUrl> giúp bạn sẽ ghi đè URL mà giao diện người dùng Edge hiển thị. Dưới đây là ví dụ cho thấy đối tượng máy chủ ảo với <BaseURL> mới . Trong ví dụ này, giá trị "http://myCo.com" 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>, theo mặc định, thì URL mặc định do giao diện người dùng Edge hiển thị sẽ xuất hiện dưới dạng: "http://DNS_name_or_IP:9005/", trong khi cách thiết lập bí danh máy chủ lưu trữ 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 apigee-provision tiện ích.

Xem Định cấu hình TLS quyền truy cập vào API dành cho Đám mây riêng tư để 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

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 Edge thành phần.

Xem Bật tính năng ghi nhật ký gỡ lỗi để tìm hiểu thêm.

(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 Private Cloud đều phải gửi số liệu thống kê của Apigee về API lưu lượng truy cập proxy bằng cách sử dụng bản phát hành Beta của dòng lệnh apigee-analytics-collector tiện ích. Tiện ích này sẽ gửi báo cáo số lượng cuộc gọi API lại cho Apigee.

Bản phát hành Edge này chứa hướng dẫn cài đặt mới và cú pháp lệnh cho apigee-analytics-collector tiện ích. Trong bản phát hành này, bạn hiện sử dụng apigee-service để cài đặt tiện ích apigee-analytics-collector của chúng tôi, 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 lệnh độc lập.

Xem phần Tải lên API Lưu lượng truy cập vào Apigee – Bản phát hành beta để tìm hiểu thêm.

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

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

/opt/apigee/apigee-drupal

đến:

/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ể

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

Các pháp nhân chịu ảnh hưởng bao gồm:

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

(MGMT-3840)

Triển khai luồng không gian ngừng hoạt động theo quy trình chung

Khi bạn muốn triển khai luồng dùng chung và đảm bảo rằng có í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ý triển khai zero-time (không ngừng hoạt động). Quá trình này gần giống với việc triển khai thời gian ngừng hoạt động bằng 0 cho các proxy API sử dụng API quản lý. Chỉ khác biệ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 thực hiện việc 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 tổ chức

Có thể bạn muốn xoá dữ liệu kiếm tiền của tổ chức trong những 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 của một tổ chức thử nghiệm mà bạn muốn sử dụng lại. Trong phần này 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 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 thuộc tổ chức của bạn. (DEVRT-2581)

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

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

Xem phần Bật kiếm tiền cho tổ chức.

(DEVRT-2383)

Đã khắc phục lỗi

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 đang kiểm tra để xem nếu phiếu yêu cầu hỗ trợ của họ đã được khắc phục. Tính năng này không được thiết kế nhằm cung cấp thông tin chi tiết về tất cả người dùng.

Cloud riêng tư 4.17.05

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

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

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

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)