1.1.0 - Catatan rilis runtime hybrid Apigee

Anda sedang melihat dokumentasi Apigee Edge.
Buka dokumentasi Apigee X.
info

Pada 27 Januari 2020, Google merilis Apigee Hybrid runtime versi 1.1.0. Bagian ini menjelaskan fitur dan perubahan baru yang dirilis pada versi 1.1.0.

Mengupgrade

Anda tidak dapat mengupgrade dari 1.0.0 ke 1.1.0, dan versi baru tidak kompatibel dengan versi 1.0.0. Versi 1.1.0 memerlukan penginstalan baru.

Fitur baru dan peningkatan

Apigee Connect (Rilis Alfa)

Apigee Connect Alpha memungkinkan layanan MART hybrid Apigee terhubung ke bidang pengelolaan tanpa mengharuskan Anda mengekspos endpoint MART. Jika menggunakan Apigee Connect, Anda tidak perlu mengonfigurasi gateway masuk MART dengan alias host dan sertifikat DNS resmi. Untuk mengetahui detailnya, hubungi perwakilan Apigee Anda.

Pemilihan rute jalur dasar

Dengan perutean jalur dasar, Anda dapat mengonfigurasi dan mengelola cara Apigee Hybrid merutekan panggilan proxy API ke lingkungan tertentu. Untuk mengetahui detailnya, lihat Mengonfigurasi perutean jalur dasar.

Perubahan

Perubahan berikut telah dibuat untuk runtime hybrid versi 1.1.0. Beberapa perubahan ini, seperti disebutkan, tidak kompatibel dengan versi sebelumnya dengan versi 1.0.0.

  • CLI apigeectl kini menginstal Istio di namespace istio-system. Ini adalah namespace default untuk Istio. Perubahan ini tidak kompatibel dengan versi sebelumnya dengan hybrid versi 1.0.0.
  • CLI apigeectl kini menginstal CertManager ke dalam namespace cert-manager. Perubahan ini tidak kompatibel dengan versi sebelumnya dengan hybrid versi 1.0.0.
  • Versi Istio yang didukung dan di-deploy dengan runtime hybrid Apigee telah dimigrasikan ke 1.4.2 karena versi 1.2.x tidak lagi didukung.

Bug telah diperbaiki

Masalah berikut yang tercantum dalam catatan rilis Apigee Hybrid 1.0.0 telah diperbaiki:

Masalah Deskripsi
144886537 Perutean jalur dasar tidak berfungsi di Apigee Hybrid v1.0.0. Jika penggantian disiapkan untuk dirutekan ke lingkungan yang berbeda dengan hostAlias host yang sama, traffic masuk tidak dirutekan ke lingkungan berdasarkan jalur.
143774187 UI hibrid menampilkan label "Perusahaan" di tampilan Aplikasi.

Masalah umum

Tabel berikut menjelaskan masalah umum untuk rilis ini:

Masalah Deskripsi
T/A Anda tidak dapat menggunakan "*" untuk properti hostAlias baik untuk konfigurasi mart maupun envs. Praktik terbaiknya adalah menggunakan nama host tertentu untuk konfigurasi mart.
T/A Menetapkan variabel HTTP_PROXY, HTTPS_PROXY, dan NO_PROXY tidak didukung pada Apigee Connect versi Alfa.
T/A

Error Header HTTP tidak valid: Ingress Istio mengalihkan semua respons target yang masuk ke protokol HTTP2. Karena pemroses pesan campuran hanya mendukung HTTP1, Anda mungkin melihat error berikut saat proxy API dipanggil:

http2 error: Invalid HTTP header field was received: frame type: 1, stream: 1,
   name: [:authority], value: [domain_name]

Jika melihat error ini, Anda dapat melakukan salah satu tindakan berikut untuk memperbaiki masalah:

  • Ubah layanan target untuk menghilangkan header Host dalam respons.
  • Hapus header Host menggunakan kebijakan ChooseMessage di proxy API jika diperlukan.
144584813 Jika Anda membuat sesi debug namun sesi tersebut belum memiliki transaksi apa pun di dalamnya, maka List Debug Sessions API tidak akan menyertakan sesi tersebut dalam daftar ini. API hanya menyertakan sesi dalam respons jika sesi berisi setidaknya satu transaksi.
144436206 Pada tampilan Cache Performance, penghitungan Rasio Hit Cache salah.
144321491 Apigee Hybrid mencatat notifikasi "Membuat cache yang hilang" yang menunjukkan potensi penurunan performa. Pesan ini sudah diperkirakan dan dapat diabaikan.
144321144 Proxy dengan host virtual aman tidak dapat dimuat ulang.
144286363

Mask debug dalam env.json tidak menyamarkan data respons.

API berikut untuk memperbarui mask debug env.json dengan kolom responseJSONPaths tidak berfungsi:

PATCH /v1/organizations/org/environments/env/debugmask?replaceRepeatedFields=true
{
  "responseJSONPaths": ["$.maskedDataEnv"]
}

Untuk mengatasi masalah ini dengan pelacakan, Anda dapat menghapus seluruh sesi pelacakan di UI, atau menggunakan API pelacakan untuk menghapus transaksi individual dalam sebuah sesi.

143659917

Setelan habis masa berlaku kebijakan filledCache harus ditetapkan ke nilai eksplisit antara 1 dan 30. Contoh:

<ExpirySettings>
  <TimeoutInSec>30</TimeoutInSec>
</ExpirySettings>
133192879

Ringkasan: Terdapat latensi yang sangat tinggi saat menggunakan API atau UI untuk mendapatkan status deployment organisasi Anda. Latensi ini dapat menghasilkan respons HTTP 204 (No Content) atau HTTP 400 (Bad Request).

Solusi: Muat ulang browser Anda (atau kirim ulang permintaan).