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 untuk Rilis Fitur 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.

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 utilitas update.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 menjadi bootstrap_4.16.05.sh dalam 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 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:

  1. Pada 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 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 dan variableSuffix 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