4.16.05 - Catatan rilis Edge untuk Private Cloud

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

Pada hari Selasa, 31 Mei 2016, kami merilis versi baru Apigee Edge untuk Private Cloud.

Sejak Edge for Private Cloud Feature Release sebelumnya (4.16.01), berikut ini rilis terjadi dan disertakan dalam Rilis Fitur ini:

Lihat Tentang rilis penomoran untuk memahami cara mengetahui apakah rilis cloud tertentu disertakan dalam versi Edge Anda untuk Private Cloud.

Fitur dan peningkatan baru

Berikut adalah fitur dan peningkatan baru dalam rilis ini. Selain hal-hal berikut peningkatan, rilis ini juga berisi beberapa kegunaan, performa, keamanan, dan stabilitas penyempurnaan.

Untuk mengetahui detail dan petunjuk lebih lanjut, lihat dokumentasi Edge untuk Private Cloud.

Pemasangan dan Panduan Operasi telah dipindahkan ke internet

Anda kini dapat mengakses panduan Penginstalan dan Operasi Edge untuk Private Cloud di Versi 4.18.01.

Update software

Update software berikut disertakan dalam rilis tersebut:

  • Java JDK 1.8 - Untuk memanfaatkan fitur Java terbaru, kompatibel dengan Java 1.8. Oracle JDK 1.8 atau OpenJDK 8 diperlukan di lingkungan Anda.
    Sebagai bagian dari pembaruan untuk Java 8, beberapa cipher TLS tidak lagi tersedia di Oracle JDK 1.8. Untuk mengetahui daftar lengkapnya, lihat bagian "Suite Cipher Nonaktif Default" http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.
  • Cassandra 2.1.13 - Diperbarui dari Cassandra 2.0.15.

Penginstalan, peningkatan versi, rollback

Berikut adalah daftar perubahan pada penginstalan, upgrade, dan skrip terkait. Untuk informasi saat digunakan, lihat dokumentasi Edge untuk Private Cloud.

  • Proses baru untuk diupdate dari 4.16.01 - Rilis ini menggantikan Utilitas apigee-migrate dengan utilitas update.sh untuk memperbarui instalasi dari 4.16.01 ke 4.16.05. Lihat Mengupdate Apigee Edge 4.16.01 ke 4.16.05.
  • Bootstrap
    • bootstrap.sh (versi 4.16.01) sekarang bootstrap_4.16.05.sh di 4.16.05.
    • Anda tidak perlu lagi menentukan uname:pword untuk mendownload bootstrap_4.16.05.sh.
  • Rollback - Untuk melakukan rollback update ke 4.16.05, uninstal 4.16.05 versi komponen dan menginstal ulang versi sebelumnya. Sebelumnya Utilitas rollback.sh telah dihapus. Lihat 4.16.05 Proses Rollback.
  • setup.sh dan update.sh dapat menulis file log ke /tmp - Secara default, setup.sh dan Utilitas update.sh menulis informasi log ke /opt/apigee/var/log/apigee-setup. Jika pengguna yang menjalankan utilitas tersebut tidak memiliki akses ke direktori tersebut, aplikasi akan menulis log ke direktori /tmp. Jika pengguna tidak memiliki akses ke /tmp, utilitas akan gagal.
  • Prosedur update BaaS API - Dalam rilis 4.16.01, Anda harus menginstal ulang API BaaS untuk memigrasikannya. Utilitas update.sh baru mendukung mengupdate API BaaS di tempat. Lihat Mengupdate Apigee Edge 4.16.01 ke 4.16.05.

Administrasi

Berikut adalah fitur baru untuk administrasi dan konfigurasi Private Cloud.

  • Validasi penginstalan - Utilitas apigee-validate yang digunakan untuk menguji Edge Private Cloud Anda penginstalan sekarang dapat dijalankan dari Server Pengelolaan. Sebelumnya, skrip harus dijalankan pada Pemroses Pesan. Lihat Menguji menginstal aplikasi.
  • Nama wilayah - Wilayah dapat berupa nama apa pun. Pada rilis sebelumnya, namanya dalam bentuk "dc-#", dengan # adalah nilai integer.
  • Pod gateway - Pod gateway dapat memiliki nama apa pun. Dalam rilis sebelumnya, pod harus diberi nama "{i>gateway<i}".
  • Administrasi berbasis skrip - A utilitas command line apigee-adminapi.sh yang baru memungkinkan Anda melakukan Tugas konfigurasi Edge yang Anda lakukan dengan melakukan panggilan ke API pengelolaan Edge. Lihat Menggunakan utilitas apigee-adminapi.sh.
  • Konfigurasi diam SSL host virtual - Saat membuat organisasi atau lingkungan, Anda sekarang dapat meneruskan properti untuk mengkonfigurasi SSL pada {i>host<i} virtual. Lihat Aktivasi organisasi.

Layanan API

Berikut adalah fitur baru untuk Layanan Edge API, yang dikirimkan di cloud sebelumnya dari setiap versi.

Awalan panjang tetap untuk logging pesan syslog (Cloud 16.03.30)

Kebijakan Logging Pesan memiliki elemen <FormatMessage> baru di konfigurasi Syslog. Menurut menyetel <FormatMessage>true</FormatMessage>, pesan Syslog dimulai dengan jumlah karakter tetap, yang memungkinkan Anda memfilter data yang disisipkan Apigee. Untuk selengkapnya informasi, lihat Kirim pesan Kebijakan logging. (APIRT-1398)

Karakter pengganti di Jalur Dasar proxy API (Cloud 16.03.09 UI)

UI pengelolaan mendukung penggunaan satu atau beberapa karakter pengganti /*/ di proxy API jalur dasar. Misalnya, jalur dasar /team/*/members memungkinkan klien untuk memanggil proxy Anda dengan https://[host]/team/blue/members atau https://[host]/team/green/members tanpa Anda harus membuat proxy baru untuk mendukung tim baru. Perlu diperhatikan bahwa /**/ tidak diizinkan. (MGMT-3154)

Perantaian proxy API (Cloud 16.03.02, Cloud 16.03.09 UI)

Edge mendukung rantai proxy API lokal, yang memungkinkan satu proxy API untuk memanggil proxy API lainnya yang di-deploy di organisasi Edge Anda tanpa overhead jaringan tambahan. Sebelumnya, proxy API perantaian memerlukan panggilan http ke proxy API lain, yang meneruskan permintaan melalui load balancer, router, dan pemroses pesan.

Elemen LocalTargetConnection baru tersedia di proxy API TargetEndpoint, yang memungkinkan Anda menentukan nama proxy API, nama ProxyEndpoint tertentu dalam proxy API, atau cukup Jalur Dasar ke sumber daya proxy API lokal (seperti /v1/myresource). UI editor proxy juga menyediakan opsi ini saat Anda menambahkan atau memperbarui TargetEndpoint.

Perantaian proxy juga tersedia di kebijakan Info Layanan.

Untuk informasi selengkapnya, lihat Proxy rantai API bersama-sama. Elemen LocalTargetConnection baru juga tercantum dalam XML skema di sini: https://github.com/apigee/api-platform-samples/blob/master/schemas/configuration/configuration_schemas.xsd. (MGMT-3049, MGMT-3050)

Bug diperbaiki

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

Edge untuk Private Cloud 4.16.05

ID Masalah Deskripsi
PRC-770 Penginstal 16.01 gagal mendaftarkan server standby Postgres di grup axgroup
PRC-758 Pengguna dengan peran Pengguna dapat mengedit laporan kustom
PRC-883 Update pada server Postgres dengan konfigurasi master-standby gagal

Cloud 16.03.30

ID Masalah Deskripsi
SECENG-584 Pemeriksaan validasi untuk baris baru antar-sertifikat dalam rantai sertifikat menyebabkan masalah pada beberapa sertifikasi dalam produksi
MGMT-3217 Panggilan Management API gagal jika nama KVMap diakhiri dengan "keys"
MGMT-3214 Konflik class dapat terjadi selama Javacallouts yang menyebabkan kode Java pelanggan gagal
MGMT-3185 Terjadi error saat menambahkan orgadmin ke organisasi
EDGEUI-127 Mendapatkan izin yang tidak memadai dengan editor proxy baru
EDGEUI-119 Masalah waktu tunggu sesi UI
CORESERV-671 Melihat "Tidak ada dering yang dikonfigurasi; Tidak dapat menginisialisasi layanan cps" error
AXAPP-2345 Masalah dalam mencantumkan laporan kustom AX untuk pelanggan non-cps
AXAPP-2302 Ringkasan Analisis Apigee Harian menampilkan nol di bagian developer adopsi
APIRT-2750 Kegagalan traffic yang tinggi di organisasi tertentu
APIRT-2516 Error runtime dalam info JavaScript menentukan baris yang salah angka
APIRT-2508 Muncul error saat memanggil pemrosesan ekspres dalam callback vault
APIRT-2336 Masalah Gzip dengan Node.js
APIRT-1975 Menyembunyikan Konfigurasi yang tidak berfungsi untuk message.content

UI Cloud 16.03.16

ID Masalah Deskripsi
MGMT-3142 Grafik tidak dimuat di dasbor Error Analysis (perbaikan yang diperbarui)

UI Cloud 16.03.09

ID Masalah Deskripsi
MGMT-3158 Izin yang tidak memadai di UI saat RBAC pada setiap proxy disetel melalui API
MGMT-3142 Grafik tidak dimuat di dasbor Error Analysis
MGMT-3118 UI menampilkan konfigurasi host virtual SSL yang salah untuk "clientAuthEnabled" parameter
DEVRT-2344 Definisi laporan satu hari tidak memuat transaksi di UI

Cloud 16.03.02

ID Masalah Deskripsi
MGMT-3083 Pemuatan ulang otomatis Log Node.js terlalu panjang dengan pesan log
DEVRT-2275 Paket tarif Atribut Khusus hanya menampilkan 5 atribut, bukan 10 diizinkan
DEVRT-1275 Tidak semua developer ditampilkan di menu drop-down Paket Tarif
DEVRT-1074 Developer Prabayar dengan saldo nol akan memunculkan NullpointerException jika kredit diterapkan

Cloud 16.02.17

ID Masalah Deskripsi
MGMT-3083 Pemuatan ulang otomatis Log Node.js terlalu panjang dengan pesan log
MGMT-3077 UI menghasilkan paket proxy yang tidak valid dari WSDL yang menggunakan namespace
MGMT-1642 Peran pengguna khusus tidak memiliki "get" izin untuk Aplikasi Developer

Masalah umum

Rilis ini memiliki masalah umum berikut.

ID Masalah Deskripsi
APIRT-2978

Router gagal memulai Nginx atau Router gagal dimulai

Jika Edge Router gagal memulai Nginx atau gagal memulai sama sekali, seperti ditunjukkan dalam /opt/apigee/var/log/edge-router/logs/system.log file, lalu hapus semua file di direktori /opt/nginx/conf.d, dan mulai ulang {i>router<i}:

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart
APIRT-3364

Pemroses Pesan melakukan pencarian DNS di IPv4 dan IPv6

Jika Anda telah menginstal dan mengaktifkan NSCD (Name Service Cache Daemon), Anda mungkin perhatikan bahwa Prosesor Pesan membuat dua pencarian DNS: satu untuk IPv4 dan satu untuk IPv6.

Untuk menonaktifkan pencarian DNS di IPv6:

  1. Di setiap node Message Processor, edit /etc/nscd.conf.
  2. Tetapkan properti berikut:

    host host-cache tidak
PRC-1118

Error saat menjalankan "apigee-service apigee-postgresql pg-data-purge" menggunakan perintah

Jika Anda menjalankan "apigee-service apigee-postgresql pg-data-purge" perintah dan melihat {i>error<i} dalam formulir:

ERROR: harus merupakan pemilik relasi

Edit /opt/apigee/apigee-postgresql-4.16.05-0.0.894/lib/actions/pg-data-purge dan tetapkan properti berikut ke 'apigee':

POSTGRES_USER=apigee

DOC-1687 Karena adanya konflik dependensi paket yang diketahui, agen Katello yang digunakan dalam program Server 6 tidak dapat diinstal dengan benar di host Apigee Edge yang menjalankan Qpid daemon.

Payload JSON di Menetapkan kebijakan Pesan, Pemanggilan Java, dan Tingkatkan Kesalahan

Kebijakan Tetapkan Pesan, Panggilan Java, dan Angkat Kesalahan memungkinkan Anda membuat pesan menggunakan elemen <Set><Payload>. Sebagai bagian dari pesan tersebut, Anda dapat menyertakan variabel yang nilainya terisi otomatis saat runtime. Misalnya, jika Anda ingin menghasilkan tanggal dari header HTTP, Anda dapat masukkan {message.header.date} dalam pesan Anda.

Jika format pesan adalah JSON, formatnya akan terlihat seperti ini:

{"The date is: " : "{message.header.date}"}

Namun, Anda dapat melihat bahwa format JSON yang salah. Untuk mengatasi masalah ini, Anda memiliki dua opsi:

  • Escape kurung kurawal buka dengan garis miring terbalik:
    \{"The date is: " : "{message.header.date}"}
    
  • Dalam konfigurasi elemen Payload, gunakan variablePrefix dan Atribut variableSuffix untuk menunjukkan variabel dalam payload JSON. Sebagai contoh:
    <Payload contentType="application/json" variablePrefix="#" variableSuffix="%">{"The date is: " : "#message.header.date%"}</Payload>
    

Pada Edge for Private Cloud Feature Release berikutnya, Anda akan dapat menggunakan kurung kurawal untuk variabel dalam pesan JSON tanpa masalah. (APIRT-1160)

{i>Router<i} gagal memulai Nginx atau Router gagal dimulai

Jika Router Edge gagal memulai Nginx atau gagal memulai sama sekali, seperti yang ditunjukkan di /opt/apigee/var/log/edge-router/logs/system.log file, lalu hapus semua file di direktori /opt/nginx/conf.d, dan mulai ulang {i>router<i}:

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart