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 dalam 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 dan peningkatan baru

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 ingress MART dengan alias host dan sertifikat DNS yang sah. Untuk mengetahui detailnya, hubungi perwakilan Apigee Anda.

Perutean jalur dasar

Perutean jalur dasar memungkinkan Anda 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 dilakukan untuk runtime hybrid versi 1.1.0. Beberapa perubahan ini, seperti yang 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 mundur dengan versi hybrid 1.0.0.
  • CLI apigeectl kini menginstal CertManager ke dalam namespace cert-manager. Perubahan ini tidak kompatibel mundur dengan versi hybrid 1.0.0.
  • Versi Istio yang didukung yang di-deploy dengan runtime Apigee hybrid telah dimigrasikan ke 1.4.2 karena versi 1.2.x tidak lagi didukung.

Bug yang 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 merutekan ke lingkungan yang berbeda dengan hostAlias yang sama, ingress tidak merutekan ke lingkungan berdasarkan jalur.
143774187 UI hybrid 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 untuk konfigurasi mart dan envs. Praktik terbaiknya adalah menggunakan nama host tertentu untuk konfigurasi mart.
T/A Setelan variabel HTTP_PROXY, HTTPS_PROXY, dan NO_PROXY tidak didukung di versi Alfa Apigee Connect.
T/A

Error Header HTTP tidak valid: Ingress Istio mengalihkan semua respons target masuk ke protokol HTTP2. Karena pemroses pesan hybrid 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 AssignMessage di proxy API Anda jika perlu.
144584813 Jika Anda membuat sesi debug, tetapi sesi tersebut belum memiliki transaksi apa pun, maka List Debug Sessions API tidak akan menyertakan sesi tersebut dalam daftar ini. API hanya menyertakan sesi dalam respons jika sesi tersebut berisi setidaknya satu transaksi.
144436206 Dalam tampilan Performa Cache, perhitungan rasio cache ditemukan salah.
144321491 Log Apigee hybrid "Creating missing cache" yang menunjukkan potensi penurunan performa. Pesan ini sudah sesuai dan dapat diabaikan.
144321144 Proxy dengan host virtual yang aman tidak dapat dimuat ulang.
144286363

Masker debug di env.json tidak menyembunyikan 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 rekaman aktivitas, Anda dapat menghapus seluruh sesi rekaman aktivitas di UI, atau Anda dapat menggunakan API rekaman aktivitas untuk menghapus setiap transaksi dalam sesi.

143659917

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

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

Ringkasan: Ada 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).