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 untuk Rilis Fitur Private Cloud sebelumnya (4.16.01), rilis berikut telah terjadi dan disertakan dalam Rilis Fitur ini:
- Cloud: 16.02.17, 16.03.02, 16.03.09 (UI), 16.03.16 (UI), 16.03.23 (UI), 16.03.30
Lihat Tentang penomoran rilis untuk memahami cara mengetahui apakah rilis cloud tertentu disertakan dalam versi Edge untuk Private Cloud.
Fitur dan peningkatan baru
Berikut adalah sejumlah fitur dan peningkatan baru dalam rilis ini. Selain peningkatan berikut, rilis ini juga berisi beberapa peningkatan kegunaan, performa, keamanan, dan stabilitas.
Untuk detail dan petunjuk selengkapnya, lihat dokumentasi Edge untuk Private Cloud.
Panduan Penginstalan dan Operasi dipindahkan ke online
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:
- Java JDK 1.8 - Untuk memanfaatkan fitur Java terbaru, rilis ini
kompatibel dengan Java 1.8. Oracle JDK 1.8 atau OpenJDK 8 diperlukan di
lingkungan Anda.
Sebagai bagian dari update untuk Java 8, beberapa cipher TLS tidak lagi tersedia di Oracle JDK 1.8. Untuk daftar lengkapnya, lihat bagian "Default Disabled Cipher Suite" http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html. - Cassandra 2.1.13 - Diperbarui dari Cassandra 2.0.15.
Penginstalan, upgrade, rollback
Berikut adalah daftar perubahan untuk penginstalan, upgrade, dan skrip terkait. Untuk mengetahui informasi tentang penggunaan, lihat dokumentasi Edge untuk Private Cloud.
- Proses baru untuk diupdate dari versi 4.16.01 - Rilis ini menggantikan utilitas
apigee-migrate
dengan utilitasupdate.sh
untuk mengupdate penginstalan Anda dari 4.16.01 ke 4.16.05. Lihat Mengupdate Apigee Edge 4.16.01 hingga 4.16.05. -
Bootstrap
bootstrap.sh
(versi 4.16.01) sekarang menjadibootstrap_4.16.05.sh
dalam 4.16.05.- Anda tidak perlu lagi menentukan
uname:pword
untuk mendownloadbootstrap_4.16.05.sh
.
- Rollback - Untuk melakukan rollback update ke 4.16.05, Anda harus meng-uninstal komponen versi 4.16.05 dan menginstal ulang versi sebelumnya. Utilitas
rollback.sh
sebelumnya telah dihapus. Lihat 4.16.05 Proses Rollback. setup.sh
danupdate.sh
dapat menulis file log ke/tmp
- Secara default, utilitassetup.sh
danupdate.sh
menulis informasi log ke/opt/apigee/var/log/apigee-setup
. Jika pengguna yang menjalankan utilitas tersebut tidak memiliki akses ke direktori tersebut, ia akan menulis log ke direktori/tmp
. Jika pengguna tidak memiliki akses ke/tmp
, utilitas akan gagal.- Prosedur update API BaaS - Dalam rilis 4.16.01, Anda harus menginstal ulang BaaS API untuk memigrasikannya. Utilitas
update.sh
baru mendukung update BaaS API yang sudah diterapkan. Lihat Mengupdate Apigee Edge 4.16.01 hingga 4.16.05.
Administrasi
Berikut adalah fitur baru untuk administrasi dan konfigurasi Private Cloud.
- Validasi penginstalan
- Utilitas
apigee-validate
yang digunakan untuk menguji penginstalan Edge Private Cloud kini dapat dijalankan dari Server Pengelolaan. Sebelumnya, skrip perlu dijalankan di Message Processor. Lihat Menguji penginstalan. - Nama wilayah - Wilayah dapat berupa nama apa pun. Pada rilis sebelumnya, namanya dalam bentuk "dc-#", dengan # sebagai nilai bilangan bulat.
- Pod gateway - Pod gateway dapat memiliki nama apa pun. Dalam rilis sebelumnya, pod harus diberi nama "gateway".
- Administrasi berbasis skrip - Utilitas command line
apigee-adminapi.sh
baru memungkinkan Anda melakukan tugas konfigurasi Edge yang sama dengan yang Anda lakukan dengan melakukan panggilan ke Edge Management API. Lihat Menggunakan utilitas apigee-adminapi.sh. - Konfigurasi SSL host virtual - Saat membuat organisasi atau lingkungan, kini Anda dapat meneruskan properti untuk mengonfigurasi SSL pada host virtual. Lihat Melakukan orientasi organisasi.
Layanan API
Berikut adalah fitur-fitur baru untuk Layanan Edge API, yang disediakan di produk versi cloud sebelumnya.
Awalan panjang tetap untuk logging pesan syslog (Cloud 16.03.30)
Kebijakan Message Logging memiliki elemen <FormatMessage>
baru dalam konfigurasi Syslog. Dengan menyetel <FormatMessage>true</FormatMessage>
, pesan Syslog dimulai dengan jumlah karakter yang tetap, sehingga Anda dapat memfilter data yang disisipkan Apigee. Untuk mengetahui informasi selengkapnya, lihat kebijakan Logging Pesan. (APIRT-1398)
Karakter pengganti di Jalur Dasar proxy API (UI Cloud 16.03.09)
UI pengelolaan mendukung penggunaan satu atau beberapa karakter pengganti /*/
di jalur dasar proxy API. Misalnya, jalur dasar /team/*/members
memungkinkan klien 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. Perhatikan bahwa /**/
tidak diizinkan. (MGMT-3.154)
Rantai proxy API (Cloud 16.03.02, Cloud 16.03.09 UI)
Edge mendukung perantaian proxy API lokal, yang memungkinkan satu proxy API memanggil proxy API lain yang di-deploy di organisasi Edge Anda tanpa overhead jaringan tambahan. Sebelumnya, perantaian proxy API memerlukan panggilan http ke proxy API lain, yang meneruskan permintaan melalui load balancer, router, dan pemroses pesan.
Elemen LocalTargetConnection
baru tersedia di TargetEndpoint proxy API, yang memungkinkan Anda menentukan nama proxy API, nama ProxyEndpoint tertentu dalam proxy API, atau hanya Jalur Dasar ke resource proxy API lokal (seperti /v1/myresource). UI editor proxy juga menyediakan opsi ini saat Anda menambahkan atau mengupdate
TargetEndpoint.
Proxy chain juga tersedia di kebijakan Info Layanan.
Untuk informasi selengkapnya, lihat Membuat rantai proxy API bersama. Elemen LocalTargetConnection
baru juga tercantum dalam skema XML di sini: https://github.com/apigee/api-platform-samples/blob/master/schemas/configuration/configuration_schemas.xsd.
(MGMT-3049, MGMT-3050)
Bug telah diperbaiki
Bug berikut telah diperbaiki dalam rilis ini. Daftar ini terutama ditujukan bagi pengguna yang memeriksa apakah tiket dukungan mereka telah diperbaiki. Layanan ini tidak dirancang untuk memberikan informasi mendetail kepada semua pengguna.
Edge untuk Private Cloud 4.16.05
ID Masalah | Deskripsi |
---|---|
PRC-770 | Penginstal 16.01 gagal mendaftarkan server standby Postgres di 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 antara sertifikat dalam rantai sertifikat menyebabkan masalah pada beberapa sertifikat dalam produksi |
MGMT-3217 | Panggilan Management API gagal jika nama KVMap berakhiran "keys" |
MGMT-3214 | Konflik class dapat terjadi selama JavaCallouts yang menyebabkan kegagalan kode Java pelanggan |
MGMT-3185 | Terjadi error saat menambahkan admin org ke organisasi |
EDGEUI-127 | Mendapatkan izin yang tidak memadai dengan editor proxy baru |
EDGEUI-119 | Masalah waktu tunggu sesi UI |
CORESERV-671 | Melihat error "Tidak ada rings yang dikonfigurasi; Tidak dapat melakukan inisialisasi layanan cps" |
AXAPP-2345 | Masalah dalam mencantumkan laporan kustom AX untuk pelanggan non-cps |
AXAPP-2302 | Ringkasan Analisis Harian Apigee menunjukkan nol berdasarkan adopsi developer |
APIRT-2750 | Kegagalan traffic yang tinggi di organisasi tertentu |
APIRT-2516 | Error runtime pada pemanggilan JavaScript menentukan nomor baris yang salah |
APIRT-2508 | Error keluar saat memanggil pemrosesan ekspres dalam callback vault |
APIRT-2336 | Masalah Gzip dengan Node.js |
APIRT-1975 | Konfigurasi Mask tidak berfungsi untuk message.content |
UI Cloud 16.03.16
ID Masalah | Deskripsi |
---|---|
MGMT-3142 | Grafik tidak dimuat di dasbor Analisis Error (perbaikan yang diperbarui) |
UI Cloud 16.03.09
ID Masalah | Deskripsi |
---|---|
MGMT-3158 | Izin tidak cukup di UI ketika RBAC pada proxy individual ditetapkan melalui API |
MGMT-3142 | Grafik tidak dimuat di dasbor Analisis Error |
MGMT-3118 | UI menampilkan konfigurasi host virtual SSL yang salah untuk parameter "clientAuthEnabled" |
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 atribut yang diizinkan |
DEVRT-1275 | Tidak semua developer ditampilkan di menu drop-down Paket Tarif |
DEVRT-1074 | Developer prabayar dengan saldo nol menampilkan NullpointerException saat 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 default |
MGMT-1642 | Peran pengguna khusus tidak memiliki izin "dapatkan" 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 Router Edge gagal memulai Nginx atau gagal dimulai sama sekali, seperti yang ditunjukkan dalam file /opt/apigee/var/log/edge-router/logs/system.log, hapus semua file di direktori /opt/nginx/conf.d, lalu mulai ulang router: > 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 telah menginstal dan mengaktifkan NSCD (Name Service Cache Daemon), Anda mungkin melihat bahwa Message Processors membuat dua pencarian DNS: satu untuk IPv4 dan satu untuk IPv6. Untuk menonaktifkan pencarian DNS di IPv6:
|
PRC-1118 |
Error saat menjalankan perintah "apigee-service apigee-postgresql pg-data-purge" Jika Anda menjalankan perintah "apigee-service apigee-postgresql pg-data-purge" dan melihat error dalam formulir: KESALAHAN: harus menjadi 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 konflik dependensi paket yang diketahui, agen Katello yang digunakan di Server Satelit 6 tidak akan diinstal dengan benar pada host Apigee Edge yang menjalankan daemon Qpid. |
Payload JSON dalam kebijakan Tetapkan Pesan, Java Callout, dan Raise Fault
Kebijakan Tetapkan Pesan, Info Java, dan Naikkan Kesalahan memungkinkan Anda membuat konten pesan menggunakan elemen <Set><Payload>
. Sebagai bagian dari pesan tersebut, Anda dapat menyertakan variabel yang nilainya akan terisi otomatis pada saat runtime. Misalnya, jika ingin
menghasilkan tanggal dari header HTTP, Anda dapat
menyisipkan {message.header.date}
dalam pesan.
Jika format pesannya adalah JSON, maka akan terlihat seperti ini:
{"The date is: " : "{message.header.date}"}
Namun, Anda dapat melihat bahwa format tersebut salah. Untuk mengatasi masalah ini, Anda memiliki dua opsi:
- Meng-escape kurung kurawal buka dengan garis miring terbalik:
\{"The date is: " : "{message.header.date}"}
- Dalam konfigurasi elemen Payload, gunakan atribut
variablePrefix
danvariableSuffix
untuk menunjukkan variabel dalam payload JSON. Contoh:
<Payload contentType="application/json" variablePrefix="#" variableSuffix="%">{"The date is: " : "#message.header.date%"}</Payload>
Di Edge berikutnya untuk Rilis Fitur Private Cloud, Anda akan dapat menggunakan tanda kurung kurawal untuk variabel dalam pesan JSON tanpa masalah. (APIRT-1160)
Router gagal memulai Nginx atau Router gagal dimulai
Jika Router Edge gagal memulai Nginx atau gagal memulai sama sekali, seperti yang ditunjukkan dalam file /opt/apigee/var/log/edge-router/logs/system.log, hapus semua file di direktori /opt/nginx/conf.d, lalu mulai ulang router:
> rm -f /opt/nginx/conf.d/* > /opt/apigee/apigee-service/bin/apigee-service edge-router restart