4.17.05 - Catatan rilis Edge untuk Private Cloud

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

Sejak Rilis Fitur Edge untuk Private Cloud sebelumnya, 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.

Ringkasan rilis

Rilis ini mencakup sejumlah fitur penting yang membantu Anda mengontrol dan mengamankan API dengan lebih baik, termasuk:

• Alur bersama mendukung deployment tanpa periode nonaktif.
• Penghapusan data monetisasi untuk organisasi kini didukung.
• Fitur baru tambahan yang dijelaskan di bawah.

Terkait penghentian penggunaan, vault telah dihentikan penggunaannya.

Bagian selanjutnya dari topik ini berisi detail tentang semua fitur baru, update, dan perbaikan bug yang ada dalam rilis.

Penghentian penggunaan dan penghentian

Fitur berikut tidak digunakan lagi atau dihentikan dalam rilis ini. Lihat Kebijakan penghentian penggunaan Edge untuk mengetahui informasi selengkapnya.

Dihentikan: Menambahkan jalur di tab Performa proxy API

Hingga rilis ini, Anda dapat membuka proxy API di UI pengelolaan, membuka tab Performa, dan membuat jalur yang berbeda untuk perbandingan berbasis diagram di tab Performa proxy dan di dasbor Transaksi Bisnis. Fitur ini kini telah dihentikan dan tidak tersedia lagi di UI. Untuk mengetahui alternatif fungsi ini, lihat artikel Komunitas Apigee berikut: Alternative to Business Transactions API. (EDGEUI-902)

Dihentikan: URL buildInfo untuk portal Layanan Developer

Di versi portal sebelumnya, untuk menentukan versi portal, Anda membuka URL berikut di browser:

http://yourportal.com/buildInfo

Di 4.17.05, link ini dihapus. Untuk menentukan versi, buka entri menu Reports > Status report di Drupal. Versi portal muncul di tabel pada baris bernama Install profile.

Penghentian penggunaan penyimpanan aman (vault) Apigee

Penyimpanan aman Apigee, yang juga dikenal sebagai "vault", tidak digunakan lagi dan akan dihentikan setahun sejak tanggal pengumuman penghentian penggunaan yang ditampilkan di halaman Penghentian penggunaan dan penghentian layanan. Vault, yang menyediakan penyimpanan terenkripsi untuk key-value pair, dibuat dengan Management API dan diakses saat runtime dengan fungsi di modul Node.js apigee-access.

Daripada menggunakan penyimpanan aman, gunakan peta nilai kunci (KVM) terenkripsi, seperti yang dijelaskan dalam Bekerja dengan peta nilai kunci. KVM terenkripsi sama amannya dengan vault dan memberikan lebih banyak opsi untuk pembuatan dan pengambilan. (MGMT-3848)

Fitur dan info terbaru

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

Cloud Pribadi

Menambahkan parameter konfigurasi SMTP wajib baru ke penginstalan

Sekarang Anda harus menggunakan parameter SMTPMAILFROM di file konfigurasi penginstalan Edge. Parameter ini menentukan alamat email yang digunakan saat Edge mengirim email otomatis, seperti saat pengguna meminta untuk menyetel ulang sandi. Lihat Menginstal komponen Edge di node untuk mengetahui informasi selengkapnya.

(EDGEUI-1020)

Sekarang dapat menetapkan waktu tunggu yang digunakan oleh Edge UI untuk panggilan pengelolaan Edge API

Sekarang Anda dapat menentukan durasi waktu tunggu API yang digunakan oleh UI Edge untuk mengontrol berapa lama UI menunggu panggilan pengelolaan API ditampilkan. Properti berikut menentukan waktu tunggu:

• conf_apigee_apigee.feature.apitimeout menetapkan waktu, dalam detik, yang digunakan UI untuk menunggu panggilan ke backend ditampilkan, terlepas dari aktivitas apa pun di dalamnya. Jika panggilan tidak selesai dalam waktu tersebut, UI akan menampilkan error waktu tunggu habis. Nilai default-nya adalah 180 detik (3 menit).
• conf_apigee_play.ws.timeout.idle menetapkan durasi tunggu UI, dalam milidetik, untuk aktivitas di server. Nilai ini dapat disetel ke nilai yang sama dengan conf_apigee_apigee_apitimeout atau ke nilai yang lebih kecil. Menyetelnya ke nilai yang lebih besar tidak akan berpengaruh. Defaultnya adalah 180.000 milidetik (3 menit).
• conf_apigee_play.ws.timeout.connection menetapkan berapa lama UI menunggu koneksi dibuat. Nilai ini dapat disetel ke nilai yang sama dengan conf_apigee_apigee_apitimeout atau ke nilai yang lebih kecil. Menyetelnya ke nilai yang lebih besar tidak akan berpengaruh. Defaultnya adalah 120.000 milidetik (2 menit).

Lihat Menetapkan waktu tunggu yang digunakan oleh UI Edge untuk panggilan pengelolaan Edge API untuk mengetahui informasi selengkapnya.

(EDGEUI-816)

Menambahkan waktu tunggu coba lagi Message Processor ke Router

Menambahkan waktu tunggu agar Router berhenti mencoba lagi permintaan ke Pemroses Pesan dan menampilkan pesan error.

Lihat Mengonfigurasi Router untuk mencoba lagi koneksi ke Message Processor untuk mengetahui informasi selengkapnya.

(APIRT-2912)

Menambahkan prosedur untuk mengubah administrator sistem default

Dokumentasi kini disertakan untuk mengubah administrator sistem default.

Lihat Mengelola Pengguna, Peran, dan Izin untuk mengetahui informasi selengkapnya.

(DOS-4895)

Menambahkan dokumentasi tentang pemisahan tugas penginstalan Edge antara pengguna root dan non-root

Dokumentasi baru menjelaskan langkah-langkah untuk memisahkan tugas penginstalan Edge antara pengguna root dan non-root.

Lihat Ringkasan Penginstalan Edge untuk mengetahui informasi selengkapnya.

(DOS-4573)

Menambahkan properti untuk menetapkan nama host untuk link dalam email yang dibuat

Edge otomatis mengirim email sebagai respons terhadap peristiwa tertentu, seperti saat pengguna ditambahkan ke organisasi. Banyak email ini berisi link. Misalnya, saat pengguna baru ditambahkan ke organisasi, UI Edge akan mengirimkan email kepada pengguna yang berisi URL login dalam bentuk:

https://domain/login

Domain ditentukan secara otomatis oleh Edge dan biasanya sudah benar untuk organisasi. Namun, ada kemungkinan bahwa saat UI Edge berada di belakang load balancer, nama domain yang dibuat secara otomatis salah. Jika ya, Anda dapat menggunakan properti conf_apigee_apigee.emails.hosturl untuk menetapkan bagian nama domain dari URL yang dihasilkan secara eksplisit.

Lihat Menetapkan nama host untuk link dalam email yang dibuat untuk mengetahui informasi selengkapnya.

(EDGEUI-1044)

Menetapkan URL dasar yang ditampilkan oleh UI Edge untuk proxy API

UI Edge menampilkan URL proxy API berdasarkan setelan di host virtual yang sesuai dengan tempat proxy di-deploy. Tampilan ini dapat mencakup nomor port Router dari host virtual.

Dalam sebagian besar kasus, URL yang ditampilkan di UI Edge adalah URL yang benar untuk membuat permintaan eksternal ke proxy. Namun, untuk beberapa konfigurasi, URL yang ditampilkan tidak benar. Misalnya, salah satu konfigurasi berikut dapat menyebabkan URL yang ditampilkan tidak sesuai dengan URL sebenarnya yang digunakan untuk membuat permintaan eksternal ke proxy:

• Penghentian SSL terjadi di load balancer
• Pemetaan port terjadi antara load balancer dan router Apigee
• Load balancer yang dikonfigurasi dengan penulisan ulang jalur

Edge untuk Private Cloud 4.17.05 dan yang lebih baru mendukung atribut pada host virtual yang disebut <BaseUrl> yang memungkinkan Anda mengganti URL yang ditampilkan oleh UI Edge. Berikut adalah contoh yang menunjukkan objek host virtual dengan atribut <BaseURL> baru. Dalam contoh ini, nilai "http://myCo.com" muncul di UI Edge:

<VirtualHost name="myVHost">
   <HostAliases>
     <HostAlias>DNS_name_or_IP:9005</HostAlias>
   </HostAliases>
   <BaseUrl>http://myCo.com</BaseUrl>
   <Interfaces/>
   <Port>9005</Port>
</VirtualHost>

Jika <BaseUrl> tidak disetel, default, maka URL default yang dirender oleh UI Edge akan muncul sebagai: "http://DNS_name_or_IP:9005/", sedangkan penyiapan alias host sebenarnya adalah "http://myCo.com".

Anda juga dapat menetapkan URL dasar saat membuat organisasi menggunakan properti VHOST_BASEURL dengan utilitas apigee-provision.

Lihat Mengonfigurasi akses TLS ke API untuk Private Cloud untuk mengetahui informasi selengkapnya.

(EDGEUI-5008)

Menambahkan dokumentasi tentang cara mengaktifkan logging debug

Dokumentasi telah ditambahkan untuk menjelaskan cara mengaktifkan/menonaktifkan logging debug untuk komponen Edge.

Lihat Mengaktifkan logging debug untuk mengetahui informasi selengkapnya.

(APIRT-4018)

Sintaks perintah dan penginstal baru untuk utilitas apigee-analytics-collector

Semua pelanggan Edge untuk Private Cloud diwajibkan mengirimkan statistik tentang traffic proxy API ke Apigee menggunakan utilitas command line apigee-analytics-collector versi Beta. Utilitas ini mengirimkan laporan volume panggilan API kembali ke Apigee.

Rilis Edge ini berisi petunjuk penginstalan dan sintaksis perintah baru untuk utilitas apigee-analytics-collector. Dalam rilis ini, Anda kini menggunakan apigee-service untuk menginstal utilitas apigee-analytics-collector, bukan npm, dan memanggil utilitas apigee-analytics-collector melalui apigee-service, bukan sebagai perintah mandiri.

Lihat Mengupload Data Traffic API ke Apigee - Rilis Beta untuk mengetahui informasi selengkapnya.

Direktori penginstalan default baru setelah update portal Layanan Developer Nginx/Postgres dari penginstalan 4.17.01 baru

Setelah mengupdate penginstalan baru 4.17.01 yang menggunakan Nginx/Postgres, direktori root berubah dari:

/opt/apigee/apigee-drupal

menjadi:

/opt/apigee/apigee-drupal/wwwroot

Layanan API

Validasi input yang lebih ketat untuk entitas

Validasi input yang lebih ketat telah diterapkan di semua entity organisasi Apigee Edge. Karakter yang diizinkan biasanya adalah huruf (semua huruf), angka, garis bawah.

Entitas yang terpengaruh meliputi:

• Organisasi
• Lingkungan
• Proxy API
• Revisi proxy API
• Nama kebijakan di proxy API
• ID konfigurasi masking rekaman aktivitas debug
• Nama resource (panggilan Java, xsl, semua resource)
• Keystore
• CRLstores
• Referensi resource
• Server target

(MGMT-3840)

Deployment tanpa periode nonaktif alur bersama

Jika ingin men-deploy alur bersama dan memastikan sedikit atau tidak ada traffic masuk yang ditolak selama deployment, Anda kini dapat menggunakan API pengelolaan deployment tanpa periode nonaktif. Prosesnya hampir sama dengan deployment tanpa periode nonaktif untuk proxy API menggunakan Management API. Satu-satunya perbedaan adalah resource API pengelolaan.

Panggilan berikut men-deploy revisi alur bersama yang ditunjukkan di URI, lalu membatalkan deployment revisi yang di-deploy sebelumnya (parameter kueri override=true memungkinkan hal ini):

curl -X POST -H "Content-type:application/x-www-form-urlencoded" \
https://api.enterprise.apigee.com/v1/o/{org_name}/environments/{env-name}/sharedflows/{shared_flow_name}/revisions/{revision_number}/deployments?"override=true" \
-u email:password

(MGMT-3485)

Monetisasi

Menghapus data monetisasi untuk organisasi

Anda mungkin ingin menghapus data monetisasi untuk organisasi Anda dalam skenario berikut:

• Menghapus organisasi Anda. Dalam hal ini, Anda harus menghapus data monetisasi sebelum Anda dapat menghapus organisasi.
• Hapus data monetisasi dari organisasi pengujian yang ingin Anda gunakan kembali. Dalam hal ini, Anda harus menyinkronkan data Apigee Edge setelah menghapus data monetisasi.

Untuk mengetahui informasi selengkapnya, lihat Menghapus data monetisasi dari organisasi Anda. (DEVRT-2581)

Menambahkan API untuk mengaktifkan monetisasi bagi organisasi

Sekarang Anda dapat menggunakan API untuk mengaktifkan monetisasi bagi organisasi.

Lihat Mengaktifkan monetisasi untuk organisasi untuk mengetahui informasi selengkapnya.

(DEVRT-2383)

Bug yang diperbaiki

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

Private Cloud 4.17.05

Cloud 17.04.12 (UI)

Cloud 17.04.05 (UI)

Cloud 17.03.29 (UI)

Cloud 17.03.15.01 (UI)

Cloud 17.03.15 (UI)

Cloud 17.03.13.02 (monetisasi)

Cloud 17.03.13.01 (monetisasi)

Cloud 17.03.13 (Pengelolaan API)

Cloud 17.03.1 (UI)

Cloud 17.02.15 (UI)

Cloud 17.02.13 (runtime API)

Cloud 17.02.13 (Pengelolaan API)

Cloud 17.01.18 (UI)

Cloud 17.01.16 (Pengelolaan API)

Cloud 17.01.16 (monetisasi)