1.2.0 - Catatan rilis runtime hybrid Apigee

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

Pada 3 April 2020, kami merilis runtime Apigee hybrid versi 1.2.0.

Mengupgrade

Fitur dan update baru

Berikut adalah fitur dan update baru dalam rilis ini.

Konfigurasi host virtual baru ditambahkan untuk menentukan aturan perutean

Fitur konfigurasi virtualhosts baru mengatasi masalah yang menyebabkan urutan perutean jalur dasar ke beberapa lingkungan tidak pasti. Untuk mengetahui detailnya, lihat Mengonfigurasi host virtual. (150336519)

Rilis beta kebijakan OASValidation

Kebijakan OASValidation (Validasi Spesifikasi OpenAPI) (Beta) memungkinkan Anda memvalidasi sebuah permintaan masuk atau pesan respons terhadap Spesifikasi OpenAPI 3.0 (JSON atau YAML). Untuk mengetahui informasi selengkapnya, lihat Kebijakan OASValidation (Beta). (144949685)

Rilis beta dukungan WebSocket

Apigee hybrid mendukung koneksi WebSocket. Klien proxy API kini dapat meminta upgrade protokol dari HTTP ke WebSockets. Untuk mengetahui detailnya, lihat Menggunakan WebSockets (Beta).

Mengakses nilai secret kebijakan dari secret Kubernetes

Fitur baru memungkinkan Anda mengakses nilai yang disimpan dalam secret Kubernetes di variabel alur proxy. Untuk mengetahui detailnya, lihat Menyimpan data dalam secret Kubernetes. (133377603)

Elemen Apigee Operators (AO) menggantikan ADAC dan ADAH

Apigee Operators (AO) Membuat dan mengupdate resource Kubernetes dan Istio tingkat rendah yang diperlukan untuk men-deploy dan memelihara AD. Misalnya, pengontrol melakukan rilis pemroses pesan. Selain itu, pengontrol juga memvalidasi konfigurasi ApigeeDeployment sebelum mempertahankannya di cluster Kubernetes. AO menggantikan Apigee Deployment Admissionhook (ADAH) dan Apigee Deployment Controller (ADC). Lihat ao di Referensi properti konfigurasi. (151250559)

Mengganti dan menghentikan penggunaan properti konfigurasi cluster dan project tertentu

Dua properti konfigurasi baru ditambahkan: k8sCluster dan gcp. Properti ini menggantikan properti berikut yang tidak digunakan lagi: k8sClusterName, gcpRegion, dan gcpProjectID. Untuk mengetahui detailnya, lihat Referensi properti konfigurasi. (146299599)

Ekspansi Volume Persisten untuk Cassandra di Kubernetes

Proses ditambahkan untuk memperluas volume persisten yang digunakan oleh apigee-cassandra untuk mengakomodasi kebutuhan penyimpanan, tanpa perlu menambahkan lebih banyak node hanya untuk meningkatkan penyimpanan. Lihat Memperluas volume persisten Cassandra. (138167919)

Mendukung sumber tambahan untuk sertifikat, kunci enkripsi, dan SA

Properti konfigurasi baru ditambahkan yang memberikan fleksibilitas lebih besar dalam cara Anda menentukan sertifikat TLS, kunci enkripsi, dan kunci akun layanan. Properti baru tersebut tercantum di bawah:

  • kmsEncryptionPath
  • kmsEncryptionSecret.key
  • kmsEncryptionSecret.name
  • cassandra.backup.serviceAccountSecretRef
  • cassandra.restore.serviceAccountSecretRef
  • envs[].cacheEncryptionPath
  • envs[].cacheEncryptionSecret.key
  • envs[].cacheEncryptionSecret.name
  • envs[].kmsEncryptionPath
  • envs[].kmsEncryptionSecret.key
  • envs[].kmsEncryptionSecret.name
  • envs[].serviceAccountSecretRefs.synchronizer
  • envs[].serviceAccountSecretRefs.udca
  • envs[].sslSecret
  • logger.serviceAccountSecretRef
  • mart.serviceAccountSecretRef
  • mart.sslSecret
  • metrics.serviceAccountSecretRef
  • synchronizer.serviceAccountSecretRef
  • udca.serviceAccountSecretRef

Untuk mengetahui informasi selengkapnya, lihat Referensi properti konfigurasi. (145303466)

Mengizinkan pelanggan mengaburkan data sebelum mengirimkannya ke analisis

Fitur ditambahkan yang memungkinkan Anda mengaburkan data analisis tertentu sebelum dikirim ke bidang pengelolaan. Untuk mengetahui detailnya, lihat Mengaburkan data pengguna untuk analisis. (142578910)

Memperluas volume persisten untuk statefulset

Fitur ditambahkan yang memungkinkan Anda memperluas volume persisten yang digunakan oleh apigee-cassandra untuk mengakomodasi kebutuhan penyimpanan, tanpa menambahkan lebih banyak daya komputasi. Untuk mengetahui informasi selengkapnya, lihat Memperluas volume persisten untuk statefulset. (138167919)

Versi minimum GKE, Anthos, dan AKS yang didukung diupgrade

Apigee hybrid kini mendukung GKE 1.14.x, Anthos 1.2, dan AKS 1.14.x. (149578101)

Mendukung TLS 1.3 untuk koneksi Northbound

Dua properti konfigurasi baru memungkinkan Anda menetapkan versi TLS minimum dan maksimum untuk ingress: ingress.minTLSProtocolVersion dan maxTLSProtocolVersion. Nilai yang mungkin adalah 1.0, 1.1, 1.2, dan 1.3. Untuk mengetahui informasi selengkapnya, lihat Referensi properti konfigurasi. (117580780)

Mendukung konfigurasi proxy penerusan untuk runtime hybrid

Penetapan proxy penerusan HTTP kini didukung untuk proxy API yang di-deploy ke lingkungan. Untuk mengetahui detailnya, lihat Mengonfigurasi penetapan proxy penerusan. (148970527)

Mendukung beberapa hostAliases per lingkungan

Properti konfigurasi baru, envs[].hostAliases, telah ditambahkan. Properti ini memungkinkan Anda menambahkan beberapa alias host ke lingkungan. Gunakan elemen ini, bukan hostAlias, yang tidak digunakan lagi. Untuk mengetahui detailnya, lihat Menambahkan beberapa alias host ke lingkungan. (150738495)

Mengizinkan template untuk kumpulan properti

Elemen baru <PropertySetRef> ditambahkan ke elemen <AssignVariable> dari kebijakan <AssignMessage> kebijakan. <PropertySetRef> memungkinkan Anda membuat pasangan kunci/nama kumpulan properti secara dinamis. Fitur ini hanya tersedia untuk proxy API yang di-deploy ke Apigee hybrid. Lihat AssignVariable. (148612340)

Bug yang diperbaiki

Bug berikut diperbaiki dalam rilis ini. Daftar ini terutama ditujukan bagi pengguna yang memeriksa untuk melihat apakah tiket dukungan mereka telah diperbaiki. Daftar ini tidak dirancang untuk memberikan informasi mendetail bagi semua pengguna.

ID Masalah Nama Komponen Deskripsi
147958049 Runtime Masalah waktu dalam pengurutan startup runtime telah diatasi yang terkadang mencegah sinkronisasi dimulai dengan benar.
149867244 Platform K8S Pod penyiapan apigee-cps gagal dalam penyiapan multi-region
150187652 / 149117839 Runtime Tidak dapat menggunakan tanda hubung dalam nama lingkungan.
149220463 Pod MP Proxy yang di-deploy sebelumnya harus di-deploy ulang.
144321144 Runtime Proxy dengan host virtual yang aman tidak dapat dimuat ulang.
147685310 Runtime Kegagalan inisialisasi sinkronisasi karena pengambilan token GCP gagal selama inisialisasi.
151115900 Runtime Probe Internal Periodik tidak terjadi untuk HybridMART sehingga menghasilkan hasil positif palsu.

Masalah umum

Tabel berikut menjelaskan masalah umum untuk rilis ini:

Masalah Deskripsi
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 diperlukan.
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.
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).