4.16.05 - Catatan rilis Edge untuk Private Cloud

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

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

Sejak Rilis Fitur Edge untuk Private Cloud sebelumnya (4.16.01), rilis berikut telah terjadi dan disertakan dalam Rilis Fitur ini:

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

Fitur dan peningkatan baru

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

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

Panduan Penginstalan dan Pengoperasian 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 ini:

  • 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 ke Java 8, beberapa sandi TLS tidak lagi tersedia di Oracle JDK 1.8. Untuk mengetahui daftar lengkapnya, lihat bagian "Default Disabled Cipher Suites" 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 pada penginstalan, upgrade, dan skrip terkait. Untuk informasi tentang penggunaan, lihat dokumentasi Edge untuk Private Cloud.

  • Proses baru untuk mengupdate dari 4.16.01 - Rilis ini menggantikan utilitas apigee-migrate dengan utilitas update.sh untuk mengupdate penginstalan 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) kini 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, 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 dan update.sh dapat menulis file log ke /tmp - Secara default, utilitas setup.sh dan update.sh menulis informasi log ke /opt/apigee/var/log/apigee-setup. Jika pengguna yang menjalankan utilitas tidak memiliki akses ke direktori tersebut, utilitas akan menulis log ke direktori /tmp. Jika pengguna tidak memiliki akses ke /tmp, utilitas akan gagal.
  • Prosedur update API BaaS - Pada rilis 4.16.01, Anda harus menginstal ulang API BaaS untuk memigrasikannya. Utilitas update.sh baru mendukung pembaruan 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 penginstalan Edge Private Cloud kini dapat dijalankan dari Server Pengelolaan. Sebelumnya, skrip perlu dijalankan di Pemroses Pesan. Lihat Uji penginstalan.
  • Nama wilayah - Wilayah dapat berupa nama apa pun. Pada rilis sebelumnya, nama tersebut berbentuk "dc-#", dengan # adalah nilai bilangan bulat.
  • Pod gateway - Pod gateway dapat memiliki nama apa pun. Pada 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 membuat panggilan ke Edge Management API. Lihat Menggunakan utilitas apigee-adminapi.sh.
  • Konfigurasi diam-diam SSL host virtual - Saat membuat organisasi atau lingkungan, Anda kini dapat meneruskan properti untuk mengonfigurasi SSL di host virtual. Lihat Mengaktifkan organisasi.

Layanan API

Berikut adalah fitur baru untuk Layanan API Edge, yang tersedia di versi cloud produk sebelumnya.

Awalan panjang tetap untuk logging pesan syslog (Cloud 16.03.30)

Kebijakan Pencatatan Pesan memiliki elemen <FormatMessage> baru dalam konfigurasi Syslog. Dengan menetapkan <FormatMessage>true</FormatMessage>, pesan Syslog dimulai dengan sejumlah karakter tetap, yang memungkinkan Anda memfilter data yang dimasukkan Apigee. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Pencatatan pesan. (APIRT-1398)

Wildcard 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-3154)

Rangkaian proxy API (UI Cloud 16.03.02, Cloud 16.03.09)

Edge mendukung rangkaian proxy API lokal, yang memungkinkan satu proxy API memanggil proxy API lain yang di-deploy di organisasi Edge Anda tanpa overhead jaringan tambahan. Sebelumnya, penggabungan proxy API memerlukan panggilan http(s) ke proxy API lain, yang meneruskan permintaan melalui load balancer, router, dan pemroses pesan.

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

Rantai proxy juga tersedia di kebijakan Panggilan Layanan.

Untuk mengetahui informasi selengkapnya, lihat Menggabungkan proxy API. 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 yang diperbaiki

Bug berikut telah 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 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 di 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 JavaCallout yang menyebabkan kode Java pelanggan gagal
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 "No rings configured; Cannot initialize cps service" (Tidak ada dering yang dikonfigurasi; Tidak dapat menginisialisasi layanan cps)
AXAPP-2345 Masalah dalam mencantumkan laporan kustom AX untuk pelanggan non-CPS
AXAPP-2302 Ringkasan Analisis Apigee Harian menunjukkan nol di bagian adopsi developer
APIRT-2750 Kegagalan traffic tinggi di organisasi tertentu
APIRT-2516 Error runtime di balon JavaScript menentukan nomor baris yang salah
APIRT-2508 Error keluar saat memanggil pendengaran ekspres dalam callback vault
APIRT-2336 Masalah Gzip dengan Node.js
APIRT-1975 Konfigurasi Masking 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 memadai di UI saat RBAC pada setiap proxy 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 Penyegaran otomatis Log Node.js terlalu verbose 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 memunculkan NullPointerException saat kredit diterapkan

Cloud 16.02.17

ID Masalah Deskripsi
MGMT-3083 Penyegaran otomatis Log Node.js terlalu verbose dengan pesan log
MGMT-3077 UI membuat paket proxy yang tidak valid dari WSDL yang menggunakan namespace default
MGMT-1642 Peran pengguna kustom tidak memiliki izin "get" 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 dimulai sama sekali, seperti yang ditunjukkan dalam file /opt/apigee/var/log/edge-router/logs/system.log, maka hapus semua file di direktori /opt/nginx/conf.d, dan mulai ulang router:

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

Message Processor melakukan pencarian DNS di IPv4 dan IPv6

Jika telah menginstal dan mengaktifkan NSCD (Name Service Cache Daemon), Anda mungkin melihat bahwa Pemroses Pesan melakukan 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:

    enable-cache hosts no
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 bentuk:

ERROR: harus menjadi pemilik hubungan

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 Satellite 6 tidak akan diinstal dengan benar di host Apigee Edge yang menjalankan daemon Qpid.

Payload JSON dalam kebijakan Assign Message, Java Callout, dan Raise Fault

Kebijakan Assign Message, Java Callout, dan Raise Fault memungkinkan Anda membuat konten pesan menggunakan elemen <Set><Payload>. Sebagai bagian dari pesan tersebut, Anda dapat menyertakan variabel yang nilainya diisi otomatis saat runtime. Misalnya, jika Anda ingin menampilkan tanggal dari header HTTP, Anda dapat menyisipkan {message.header.date} dalam pesan Anda.

Jika format pesan adalah JSON, tampilannya akan seperti ini:

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

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

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

Dalam Rilis Fitur Edge untuk Private Cloud berikutnya, 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 Edge Router 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
Sebelumnya
4.16.05.01
Berikutnya
4.16.01.08