Theo mặc định, Edge sử dụng RPC để triển khai proxy API. Mặc dù chế độ này hoạt động rất hiệu quả đối với hầu hết các lượt cài đặt, nhưng các cấu trúc liên kết lớn hơn có nhiều MP có thể bị hết thời gian chờ khi một số lượng lớn các lệnh gọi đồng thời được thực hiện qua RPC. Apigee dự định sẽ ngừng sử dụng phương thức triển khai này trong tương lai.
Do đó, Apigee khuyến nghị các quy trình triển khai lớn hơn sử dụng HTTP thay vì RPC để triển khai.
Ngoài việc có thể mang lại độ tin cậy cao hơn, việc cho phép triển khai HTTP còn giúp cải thiện nội dung và định dạng của các trường hợp ngoại lệ có thể được gửi trong quá trình triển khai.
Phần này mô tả cách bật HTTP để triển khai.
Cập nhật tổ chức của bạn
Để bật tính năng triển khai HTTP, hãy gửi yêu cầu PUT
tới Cập nhật API thuộc tính của tổ chức. Đặt các thuộc tính sau trong phần nội dung của yêu cầu:
Tài sản | Nội dung mô tả |
---|---|
allow.deployment.over.http |
Xác định xem Edge có thể triển khai proxy API qua HTTP (ngoài RPC) hay không. Đặt thành true để cho phép triển khai HTTP; nếu không thì hãy false . Giá trị mặc định là
false .
Để bật chế độ triển khai HTTP, bạn phải đặt thuộc tính này thành |
use.http.for.configuration |
Chỉ định phương thức cần sử dụng cho các sự kiện cấu hình. Các giá trị có thể là:
Để cho phép triển khai HTTP, Apigee đề xuất đặt thuộc tính này thành |
Ngoài việc đặt các thuộc tính này trong phần nội dung thư, bạn phải thiết lập tiêu đề Content-Type
thành application/json
hoặc application/xml
.
Ví dụ sau đây gọi Cập nhật API thuộc tính của tổ chức kèm theo nội dung thông báo JSON.
curl -u admin_email:admin_password "http://management_server_IP:8080/v1/organizations/org_name" -X POST -H "Content-Type: application/json" -d '{ "properties" : { "property" : [ { "name" : "allow.deployment.over.http", "value" : "true" }, { "name" : "use.http.for.configuration", "value" : "always" } ] } }'
Để bật tính năng triển khai HTTP trên tất cả các proxy API trong toàn bộ tổ chức của mình, bạn phải cập nhật từng tổ chức như mô tả ở trên.
Kiểm thử bản cập nhật
Để kiểm tra xem bản cập nhật có thành công hay không, hãy kích hoạt một sự kiện triển khai trên proxy API trong tổ chức đã cập nhật, sau đó xem các tệp nhật ký của Bộ xử lý thư. Mục nhập nhật ký cho các sự kiện triển khai phải chứa mode:API
.
Để biết thêm thông tin, hãy xem bài viết Tệp nhật ký.