4.19.01 Edge untuk catatan rilis Private Cloud

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

Bagian ini menjelaskan Rilis Fitur Edge untuk Private Cloud versi 4.19.01.

Ringkasan rilis

Tabel berikut merangkum perubahan dalam rilis ini:

Fitur Baru

Rilis ini mencakup fitur baru berikut:

○ Rilis Ketersediaan Umum (GA) UI Edge
○ Rilis Ketersediaan Umum (GA) Monetisasi di UI Edge
apigee-monit menambahkan layanan pemulihan mandiri dan pemantauan
○ UI Edge memiliki properti konfigurasi TLS baru
○ Anda kini dapat membuat, mengedit, dan menghapus host virtual di UI Edge
○ Dukungan OpenAPI v3 telah ditambahkan
○ RedHat Enterprise Linux (RHEL) dan CentOS 7.6 kini didukung
○ Oracle Linux 7.5 kini didukung

Untuk mengetahui informasi selengkapnya tentang setiap fitur baru ini, lihat Fitur baru.

Rilis yang Disertakan

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

○ Edge:
   18.06.08
   18.06.06
   18.05.21
   18.05.10
   18.05.09
   18.04.23.00
○ Portal:
   18.11.28.00
   18.10.17.00
   18.10.09.00
   18.07.16.00
Pensiun Tidak ada
Penghentian penggunaan Apigee Edge untuk Private Cloud versi 4.17.09 tidak lagi didukung (tidak digunakan lagi).

Untuk mengetahui informasi selengkapnya, lihat Penghentian penggunaan, penghentian, dan perubahan CPS Apigee.

Perbaikan Bug

Rilis ini mencakup perbaikan bug berikut:

○ Zookeeper tidak dihentikan oleh skrip pencadangan (122694069)
○ Halaman landing 'Tidak ada organisasi' ditambahkan (120993451)
○ Menghapus laporan kustom (120682369)
○ Tab Geomap di pengalaman Edge Baru (120681592)
○ Opsi JVM Zookeeper (120624977)
○ Terjadi error yang tidak ditentukan pada tooltip (80187407)
○ Membuat proxy terbalik melalui OpenAPI (79949124)
○ Link untuk mereset sandi tidak dikirim (77515655)
○ Header yang salah untuk link reset sandi (72799769)
○ Menggunakan WSDL untuk membuat Proxy API (69550284)

Untuk mengetahui informasi selengkapnya tentang setiap perbaikan ini, lihat Perbaikan bug.

Masalah Umum

Rilis ini mencakup masalah umum berikut:

○ Format file metadata untuk penginstalan apigee-sso (135616498)
apigee-monit tidak didukung di Amazon Linux 1 (122370980)
○ Pencadangan Message Processor tidak mencadangkan kumpulan file yang benar (121095148)
○ Token sesi tidak dibatalkan (115278838)
○ Operasi Cassandra tidak berfungsi saat autentikasi JMX diaktifkan (113342838)
○ Permintaan HEAD ke target Node.js mengalami error (79993247)
○ Nama host tidak dapat diselesaikan (79757554)
○ DataAccessExceptions dalam konfigurasi multi-pusat data (76087166)
○ Kebijakan MessageLogging menyertakan informasi tambahan dalam pesan log (68722102)
○ Reset sandi admin sistem gagal (65737520)

Untuk mengetahui informasi selengkapnya tentang setiap masalah umum ini, termasuk solusinya, lihat Masalah umum.

Jalur upgrade

Tabel berikut menunjukkan jalur upgrade untuk rilis ini:

Dari 4.18.05 Upgrade langsung dari 4.18.05 → 4.19.01
Dari 4.18.01 Upgrade langsung dari 4.18.01 → 4.19.01
Mulai 17.09.2024 Upgrade langsung dari 4.17.09 → 4.19.01
Mulai 17.05 Upgrade dari 4.17.05 → 4.18.01, lalu upgrade dari 4.18.01 → 4.19.01
Dari 4.17.01 Upgrade dari 4.17.01 → 4.18.01, lalu upgrade dari 4.18.01 → 4.19.01
Mulai 4.16.09 Upgrade dari 4.16.09 → 4.18.01, lalu upgrade dari 4.18.01 → 4.19.01
Dari 4.16.05 Upgrade dari 4.16.05 → 4.18.01, lalu upgrade dari 4.18.01 → 4.19.01
Mulai 16.01.04 Upgrade dari 4.16.01 → 4.18.01, lalu upgrade dari 4.18.01 → 4.19.01
Dari 4.15.0x Upgrade dari 4.15.0x → 4.16.01, lalu upgrade dari Upgrade dari 4.16.01 → 4.18.01, lalu upgrade dari 4.18.01 → 4.19.01

Fitur baru

Bagian ini mencantumkan fitur baru dalam rilis ini. Selain itu, rilis ini mencakup semua fitur dalam rilis Edge UI, Edge Management, dan Portal yang tercantum dalam Rilis yang Disertakan.

Selain peningkatan berikut, rilis ini juga berisi beberapa peningkatan kegunaan, performa, keamanan, dan stabilitas.

Rilis Ketersediaan Umum (GA) Edge UI

UI Apigee Edge adalah layanan UI pengelolaan terbaru kami. Sebelumnya, fitur ini berada dalam versi Beta. Dengan Apigee Edge untuk Private Cloud v4.19.01, UI Edge adalah bagian dari rilis umum.

Untuk menggunakan UI Edge, Anda harus mengaktifkan SAML, lalu menginstal UI Edge di nodenya sendiri.

Untuk mengetahui informasi selengkapnya, lihat UI Edge untuk Private Cloud.

Rilis Ketersediaan Umum (GA) Monetisasi di Edge UI

Rilis GA Monetisasi di UI New Edge Experience kini tersedia.

Anda kini dapat mengelola semua tugas monetisasi untuk Apigee Edge untuk Private Cloud di UI New Edge Experience, termasuk berikut ini:

Dengan pengumuman ini, laporan varians monetisasi telah resmi dihentikan. Lihat penghentian penggunaan Apigee.

apigee-monit menambahkan layanan pemulihan mandiri dan pemantauan

Apigee Edge untuk Private Cloud kini menyertakan apigee-monit, alat yang didasarkan pada utilitas monit open source. apigee-monit secara berkala melakukan polling pada layanan Edge; jika layanan tidak tersedia, apigee-monit akan mencoba memulai ulang layanan tersebut.

Untuk mengetahui informasi tentang cara menginstal, mengonfigurasi, dan menggunakan apigee-monit, lihat Pemulihan mandiri dengan apigee-monit.

Properti konfigurasi TLS baru

UI Edge mendukung properti konfigurasi TLS baru yang dapat Anda gunakan untuk menetapkan hal berikut:

  • Protokol TLS default
  • Daftar protokol TLS yang didukung
  • Algoritma TLS yang didukung
  • Cipher TLS yang didukung

Untuk mengetahui informasi selengkapnya, lihat Menetapkan properti TLS opsional.

Membuat, mengedit, dan menghapus host virtual di UI Edge

Fungsi layanan mandiri telah diperluas sehingga Anda kini dapat membuat, mengedit, dan menghapus host virtual di browser (khusus Edge UI).

Untuk mengetahui informasi selengkapnya, lihat Membuat host virtual menggunakan browser.

Menambahkan dukungan OpenAPI v3

Rilis ini telah menambahkan dukungan untuk membuat proxy melalui OpenAPI versi 3 (khusus UI Edge).

Software yang didukung

Rilis ini mencakup perubahan berikut pada software yang didukung:

Dukungan Ditambahkan Tidak Lagi Didukung

Rilis ini menambahkan dukungan untuk platform berikut:

  • Red Hat Enterprise Linux (RHEL) 7.6
  • CentOS 7.6
  • Oracle Linux 7.6

Platform berikut tidak lagi didukung dengan rilis ini:

  • RHEL/CentOS/Oracle versi 7.3
  • RHEL/CentOS versi 6.8
  • Oracle Linux 6.7

Untuk mengetahui daftar lengkap platform yang didukung, lihat Software yang didukung dan versi yang didukung.

Perbaikan bug

Bagian ini mencantumkan bug Private Cloud yang diperbaiki dalam rilis ini. Selain itu, rilis ini mencakup semua perbaikan bug dalam rilis Edge UI, Edge Management, dan Portal yang ditampilkan di Rilis yang Disertakan.

ID Masalah Deskripsi
122694069

Zookeeper tidak dihentikan oleh skrip pencadangan

Proses Zookeeper tidak dihentikan oleh skrip pencadangan sebelum perbaikan ini.
120993451

Halaman landing'Tidak ada organisasi' ditambahkan

Developer yang login dengan pengguna yang tidak memiliki organisasi terkait tidak lagi diarahkan ke halaman yang tidak ada. Halaman landing baru telah ditambahkan untuk pengguna ini.
120682369

Menghapus laporan kustom

Pengguna tidak dapat menghapus laporan kustom di pengalaman New Edge.
120681592

Tab peta geografis di pengalaman Edge Baru

Saat pengguna membuka tab Geomap di New Edge, New Edge akan menampilkan error.
120624977

Opsi JVM Zookeeper

Menyetel opsi JVM menggunakan Code with Config untuk Zookeeper tidak berfungsi.
80187407

Terjadi error yang tidak terdefinisi pada tooltip

Jika hanya ada satu deret waktu dalam diagram, tooltip akan menampilkan error yang tidak ditentukan.
79949124

Membuat proxy terbalik melalui OpenAPI

Tombol Use OpenAPI saat membuat proxy tidak berfungsi.
77515655

Reset sandi tidak mengirimkan link

Pengguna tidak menerima email saat meminta link untuk mereset sandi mereka.
72799769

Header yang salah untuk link reset sandi

Bahkan setelah pengguna menetapkan properti trustxforwarded ke true, header permintaan yang dihasilkan tidak menggunakan HTTPS.
69550284

Menggunakan WSDL untuk membuat Proxy API

Pembuatan Proxy API gagal saat menggunakan WSDL.

Masalah umum

Tabel berikut mencantumkan masalah umum dalam rilis ini:

ID Masalah Deskripsi
135616498

Format file metadata untuk penginstalan apigee-sso

Saat menginstal apigee-sso dan menggunakan file metadata.xml, bukan URL, jika file metadata.xml tidak menyertakan baris baru (CRLF) di akhir file, file metadata.xml tidak akan dibaca sepenuhnya.

Solusi:

Untuk mengatasi masalah ini, Anda dapat melakukan salah satu tindakan berikut:

  • Tambahkan CRLF di akhir file metadata.xml

    ATAU

  • Menggunakan lokasi berbasis URL untuk metadata
122370980

apigee-monit tidak didukung di Amazon Linux 1

Solusi:

Tidak ada.
121095148

Cadangan Message Processor tidak mencadangkan kumpulan file yang benar

Solusi:

Jalankan pencadangan untuk kedua kalinya dan pencadangan akan mencadangkan kumpulan file yang benar.

115278838

Token sesi tidak dibatalkan

Token sesi tidak dibatalkan di server saat pengguna mengklik tombol Logout Apigee Edge.

Solusi:

Gunakan pengalaman Edge Baru dengan SAML.

113342838

Operasi Cassandra tidak berfungsi saat autentikasi JMX diaktifkan

Solusi:

Tambahkan nama pengguna dan sandi Anda setiap kali Anda memanggil perintah nodetool.

79993247

Permintaan HEAD ke target Node.js terhenti

Permintaan HEAD ke target Node.js dapat terhenti, sehingga koneksi tertunda.

Solusi:

Untuk mengatasi masalah ini, tentukan handler untuk permintaan HEAD agar secara eksplisit menampilkan respons kosong.

79757554

Nama host tidak dapat di-resolve

Setelah menginstal atau mengupgrade Edge untuk Private Cloud, nama host mungkin tidak dapat diselesaikan ke alamatnya.

Solusi:

Untuk mengatasi masalah ini, mulai ulang komponen Edge UI:

/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
76087166

DataAccessException dalam beberapa konfigurasi pusat data

Dalam konfigurasi beberapa pusat data, jika satu datastore tidak tersedia, Anda mungkin akan melihat error berikut:

DataAccessException: Error while accessing datastore;
Please retry later

Akibatnya, Server Pengelolaan mungkin tidak dimulai karena mencoba terhubung ke node Cassandra di dc-1 dan dc-2. DataAccessExceptions terjadi jika node Cassandra tidak aktif. Hal ini juga dapat menyebabkan gangguan traffic API, saat Pemroses Pesan melaporkan DataAccessExceptions saat mencoba mengambil KVM.

Perhatikan bahwa status yang diharapkan adalah Server Pengelolaan tidak terhubung ke komponen datastore di seluruh region.

Solusi

Solusinya adalah membatalkan pendaftaran jenis node Cassandra berikut di pusat data yang tidak tersedia, lalu mendaftarkannya kembali setelah node Cassandra tersedia lagi:

  • kms-datastore
  • dc-datastore
  • keyvaluemap-datastore

Untuk membatalkan pendaftaran dan mendaftarkan ulang jenis node Cassandra ini:

  1. Dapatkan UUID node Cassandra menggunakan perintah curl berikut:
    curl -u ADMIN_EMAIL:ADMIN_PW \
      "http://MS_IP:MS_PORT/v1/servers?region=REGION&pod=GATEWAY_POD \
      &type=CASSANDRA_NODE_TYPE"

    Dengan:

    • ADMIN_EMAIL dan ADMIN_PW adalah kredensial akun Apigee Anda.
    • MS_IP dan MS_PORT adalah alamat IP dan nomor port Server Pengelolaan.
    • REGION adalah nama pusat data tempat Server Pengelolaan berada.
    • GATEWAY_POD adalah nama pod, yang secara default adalah "gateway". Anda mungkin telah mengganti namanya menjadi sesuatu yang lain, jadi periksa penerapan Anda.
    • CASSANDRA_NODE_TYPE adalah salah satu dari kms-datastore, dc-datastore, dan keyvaluemap-datastore.

    Contoh:

    curl -u nickdanger@google.com:myP@$$w0rD
      "http://192.168.0.1:8080/v1/servers?region=dc-1&pod=gateway&type=dc-datastore"

    Respons menggunakan format berikut:

    {
      "internalIP" : "POD_IP_ADDRESS",
      "isUp" : [true|false],
      "pod" : "GATEWAY_POD",
      "reachable" : [true|false],
      "region" : "dc-1",
      "tags" : {
        "property" : [ ]
      },
      "type" : [ "kms-datastore", "dc-datastore", "keyvaluemap-datastore" ],
        "uUID" : "POD_UUID"
    }

    Contoh:

    {
      "internalIP" : "192.168.1.11",
      "isUp" : false,
      "pod" : "gateway",
      "reachable" : false,
      "region" : "dc-1",
      "tags" : {
        "property" : [ ]
      },
      "type" : "dc-datastore",
      "uUID" : "13cee956-d3a7-4577-8f0f-1694564179e4"
    }

    Catat nilai kolom uUID dalam respons. Anda akan menggunakannya untuk membatalkan pendaftaran node.

  2. Ulangi langkah pertama untuk setiap jenis node Cassandra: kms-datastore, dc-datastore, dan keyvaluemap-datastore. Pastikan untuk mencatat UUID yang ditampilkan.
  3. Batalkan pendaftaran node menggunakan perintah berikut:
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers/UUID" -X DELETE

    Dengan UUID adalah UUID yang ditampilkan dalam respons perintah sebelumnya.

  4. Ulangi langkah 3 untuk setiap UUID yang Anda kumpulkan pada langkah 1 dan 2.
  5. Daftarkan ulang node menggunakan perintah berikut:
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers -d \
      "Type=kms-datastore&Type=dc-datastore&Type=keyvaluemap-datastore& \
      Type=counter-datastore&Type=cache-datastore&InternalIP=POD_IP_ADDRESS& \
      region=REGION&pod=GATEWAY_POD" -H \
      'content-type: application/x-www-form-urlencoded' -X POST

Perhatikan bahwa operasi ini mendaftarkan dan membatalkan pendaftaran node dari Zookeeper dan tidak berdampak pada cluster Cassandra. Untuk mengetahui informasi selengkapnya tentang perintah ini, lihat Memperbarui pendaftaran datastore.

68722102

Kebijakan MessageLogging yang menyertakan informasi tambahan dalam pesan log

Elemen FormatMessage dari kebijakan MessageLogging mengontrol format pesan yang dicatat ke dalam log. Jika FormatMessage=false, pesan yang dicatat tidak boleh menyertakan informasi yang dihasilkan Apigee. Namun, meskipun Anda menetapkan FormatMessage=false, pesan log tetap menyertakan informasi berikut:

  • Skor prioritas
  • Stempel waktu

Solusi:

Tidak ada.
65737520

Gagal mereset sandi admin sistem

Mereset sandi admin sistem untuk Server Pengelolaan yang berisi karakter khusus akan gagal.

Solusi:

Tentukan sandi dalam file data yang kemudian Anda teruskan ke endpoint /users di Management API. Untuk mengetahui informasi selengkapnya, lihat Mereset sandi admin sistem.

Langkah berikutnya

Untuk mulai menggunakan Edge for Private Cloud 4.19.01, gunakan link berikut:

Penginstalan baru:
Ringkasan penginstalan baru
Penginstalan yang ada:
Jalur upgrade