1.2.0 - Catatan rilis runtime hybrid Apigee

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

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

Mengupgrade

Fitur dan info terbaru

Berikut adalah fitur dan update baru dalam rilis ini.

Konfigurasi host virtual baru ditambahkan untuk menentukan aturan perutean

Fitur konfigurasi virtualhosts baru mengatasi masalah ketika urutan jalur dasar yang dirutekan 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 permintaan atau pesan respons yang masuk 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 rahasia 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 di secret Kubernetes. (133377603)

Elemen Apigee Operators (AO) menggantikan ADAC dan ADAH

Operator Apigee (AO) Membuat dan mengupdate resource Kubernetes dan Istio tingkat rendah yang diperlukan untuk men-deploy dan memelihara AD. Misalnya, pengontrol melakukan pelepasan pemroses pesan. Juga memvalidasi konfigurasi ApigeeDeployment sebelum menyimpannya di cluster Kubernetes. AO menggantikan Admissionhook Deployment Apigee (ADAH) dan Pengontrol Deployment Apigee (ADC). Lihat ao di Referensi properti konfigurasi. (151250559)

Mengganti dan menghentikan penggunaan properti konfigurasi project dan cluster tertentu

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

Perluasan Volume Persisten untuk Cassandra di Kubernetes

Proses telah 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 telah ditambahkan yang memberikan fleksibilitas lebih besar dalam cara Anda menentukan sertifikat TLS, kunci enkripsi, dan kunci akun layanan. Properti baru 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 meng-obfuscate data sebelum mengirimkannya ke analytics

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

Memperluas volume persisten untuk statefulset

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

Versi minimum GKE, Anthos, dan AKS yang didukung akan 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 penerusan proxy. (148970527)

Mendukung beberapa hostAlias 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 sudah tidak digunakan lagi. Untuk mengetahui detailnya, lihat Menambahkan beberapa alias host ke lingkungan. (150738495)

Mengizinkan template untuk set properti

Elemen <PropertySetRef> baru ditambahkan ke elemen <AssignVariable> dari kebijakan <AssignMessage>. <PropertySetRef> memungkinkan Anda membuat pasangan nama/kunci set 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 diselesaikan. Fitur ini tidak dirancang untuk memberikan informasi mendetail bagi semua pengguna.

ID Masalah Nama Komponen Deskripsi
147958049 Runtime Masalah pengaturan waktu dalam pengurutan startup runtime telah diatasi yang terkadang mencegah sinkronisasi dimulai dengan benar.
149867244 Platform K8S Pod apigee-cps-setup gagal dalam penyiapan multi-region
150187652 / 149117839 Runtime Tidak dapat menggunakan tanda hubung dalam nama lingkungan.
149220463 Pod MP Proxy yang sebelumnya di-deploy perlu di-deploy ulang.
144321144 Runtime Proxy dengan host virtual aman tidak dapat dimuat ulang.
147685310 Runtime Kegagalan inisialisasi sinkronisasi karena pengambilan token GCP gagal selama inisialisasi.
151115900 Runtime Pemeriksaan Internal Berkala 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 perlu.
144584813 Jika Anda membuat sesi debug, tetapi sesi tersebut belum memiliki transaksi apa pun, maka List Debug Sessions API tidak 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).