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 saat banyak panggilan serentak dilakukan melalui RPC. Apigee berencana 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 besar, 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

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 harus 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 seluruh 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 dalam organisasi yang telah diupdate, lalu lihat file log Pemroses Pesan. Entri log untuk peristiwa deployment harus berisi mode:API.

Untuk mengetahui informasi selengkapnya, lihat File log.