Mengaktifkan deployment HTTP

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

Oleh karena itu, Apigee merekomendasikan agar deployment yang lebih besar menggunakan HTTP, bukan RPC, untuk deployment.

Selain berpotensi memberikan keandalan yang lebih tinggi, mengaktifkan deployment HTTP juga 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. Defaultnya 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 seharusnya menggunakan HTTP.
  • always: Semua peristiwa konfigurasi menggunakan HTTP.

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

Selain menetapkan properti ini dalam isi pesan, Anda 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 di semua proxy API di semua organisasi, Anda harus mengupdate 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.