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 bản cài đặt lỗi lớn hơn với nhiều MP có thể hết thời gian chờ khi số lượng tệp lớn các lệnh gọi đồng thời được thực hiện thông qua RPC. Apigee dự định sẽ ngừng sử dụng cách triển khai này trong tương lai.

Do đó, Apigee khuyến nghị các quy trình triển khai lớn nên sử dụng HTTP thay vì RPC cho triển khai.

Ngoài việc có thể mang lại độ tin cậy cao hơn, việc triển khai HTTP cũng cải thiện nội dung và định dạng của các 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 đến Cập nhật API thuộc tính của tổ chức. Thiết lập 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 thì false. 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; nếu một sự kiện không thành công qua RPC, Edge sẽ thử HTTP. Việc này có thể gây chậm trễ nếu bạn sử dụng HTTP.
  • always: Tất cả sự kiện cấu hình đều sử dụng HTTP.

Để bật tính năng triển khai HTTP, bạn nên đặt tài sản 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 đặt tiêu đề Content-Type đến 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 bằng thông báo JSON nội dung.

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 trong toàn bộ tổ chức của mình, bạn phải cập nhật từng proxy 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 sự kiện triển khai trên proxy API trong đã cập nhật rồi xem tệp nhật ký của Trình xử lý thư. Mục nhập nhật ký cho sự kiện triển khai cần chứa mode:API.

Để biết thêm thông tin, hãy xem bài viết Tệp nhật ký.