Mengaktifkan deployment HTTP

Secara default, Edge menggunakan RPC untuk men-deploy proxy API. Meskipun mode ini berfungsi sangat baik untuk sebagian besar penginstalan, topologi yang lebih besar dengan banyak MP mungkin mengalami waktu tunggu habis saat banyak panggilan serentak dilakukan melalui RPC. Apigee berencana untuk menghentikan implementasi ini di masa mendatang.

Akibatnya, Apigee merekomendasikan agar deployment yang lebih besar menggunakan HTTP, bukan RPC untuk deployment.

Selain berpotensi memberikan keandalan yang lebih baik, mengaktifkan deployment HTTP juga akan meningkatkan konten dan format pengecualian yang mungkin ditampilkan selama proses deployment.

Bagian ini menjelaskan cara mengaktifkan HTTP untuk deployment.

Memperbarui organisasi Anda

Untuk mengaktifkan deployment HTTP, kirim permintaan PUT ke Update organization properties API. Tetapkan properti berikut dalam isi permintaan:

Properti Deskripsi
allow.deployment.over.http Menentukan apakah Edge dapat men-deploy proxy API melalui HTTP (selain RPC). Tetapkan ke true untuk mengizinkan deployment HTTP; jika tidak, false. Default-nya adalah false.

Untuk mengaktifkan deployment HTTP, Anda harus menetapkan properti ini ke true.

use.http.for.configuration

Menentukan metode yang akan digunakan untuk peristiwa konfigurasi. Nilai yang dimungkinkan adalah:

  • never: Semua peristiwa konfigurasi menggunakan RPC. Ini adalah defaultnya.
  • retry: Semua peristiwa konfigurasi menggunakan RPC terlebih dahulu; jika peristiwa gagal melalui RPC, Edge akan mencoba HTTP. Hal ini dapat menyebabkan penundaan jika Anda harus menggunakan HTTP.
  • always: Semua peristiwa konfigurasi menggunakan HTTP.

Untuk mengaktifkan deployment HTTP, Apigee merekomendasikan penyetelan properti ini ke always.

Selain menetapkan properti ini dalam isi pesan, Anda juga harus menetapkan header Content-Type ke application/json atau application/xml.

Contoh berikut memanggil Update organization properties API dengan isi pesan 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"
      } ]
    }
  }'

Untuk mengaktifkan deployment HTTP pada semua proxy API di seluruh organisasi, Anda harus memperbarui setiap organisasi seperti yang dijelaskan di atas.

Menguji update

Untuk menguji apakah update Anda berhasil, picu peristiwa deployment pada proxy API di organisasi yang diupdate, lalu lihat file log Message Processor. Entri log untuk peristiwa deployment harus berisi mode:API.

Untuk mengetahui informasi selengkapnya, lihat File log.