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 lớn hơn với nhiều MP có thể bị hết thời gian chờ khi có 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 cách triển khai này trong tương lai.

Do đó, Apigee đề xuất các bản triển khai lớn hơn nê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 bật tính năng triển khai HTTP còn 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 ra 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 đến API Cập nhật thuộc tính tổ chức. Đặt các thuộc tính sau trong phần nội dung của yêu cầu:

Thuộc tính 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, hãy đặt thành false. Giá trị mặc định là false.

Để bật tính năng 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 sẽ sử dụng cho các sự kiện cấu hình. Các giá trị có thể là:

  • never: Tất cả sự kiện cấu hình đều sử dụng RPC. Đây là tuỳ chọn mặc định.
  • retry: Tất 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 độ trễ nếu bạn đang sử dụng HTTP.
  • always: Tất cả sự kiện cấu hình đều sử dụng HTTP.

Để bật các lượt triển khai HTTP, Apigee khuyên bạn nên đặ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 của thông báo, bạn phải đặt 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 với phần nội dung của 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ả proxy API trên tất cả tổ chức, 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 quá trình 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 Trình xử lý thông báo. 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 phần Tệp nhật ký.