Bật triển khai HTTP

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 true.
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à: never: Tất cả các sự kiện định cấu hình đều sử dụng RPC. Đây là lựa chọn mặc định. retry: Tất cả các sự kiện cấu hình đều sử dụng RPC trước tiên. Nếu một sự kiện không thành công qua RPC, Edge sẽ thử HTTP. Điều này có thể gây ra sự chậm trễ nếu bạn đang sử dụng HTTP. always: Tất cả các sự kiện định cấu hình đều sử dụng HTTP. Để cho phép triển khai HTTP, Apigee đề xuất đặt thuộc tính này thành always.

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ý.