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 for Private Cloud versi 4.19.01.

Ringkasan rilis

Tabel berikut meringkas perubahan dalam rilis ini:

Fitur Baru

Rilis ini mencakup fitur baru berikut:

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

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

Rilis yang Disertakan

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

○ Tepi:
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 for Private Cloud versi 4.17.09 tidak lagi didukung (tidak digunakan lagi).

Untuk informasi selengkapnya, lihat penghentian Apigee, penghentian, dan CPS perubahan.

Perbaikan Bug

Rilis ini mencakup perbaikan bug berikut:

○ Zookeeper tidak dihentikan oleh skrip pencadangan (122694069)
○ 'Tidak ada organisasi' halaman landing ditambahkan (120993451)
○ Menghapus laporan kustom (120682369)
○ Tab Geomap di pengalaman New Edge (120681592)
○ Opsi JVM Zookeeper (120624977)
○ Terjadi error yang belum terdefinisikan di tooltip (80187407)
○ Membuat reverse proxy melalui OpenAPI (79949124)
○ Mereset sandi yang tidak mengirimkan link (77515655)
○ Header untuk link reset sandi salah (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)
○ Cadangan Pemroses Pesan tidak mencadangkan kumpulan file yang benar (121095148)
○ Token sesi tidak valid (115278838)
○ Operasi Cassandra tidak berfungsi saat autentikasi JMX diaktifkan (113342838)
HEAD permintaan ke Node.js menargetkan hang (79993247)
○ Nama host tidak teratasi (79757554)
○ DataAccessException dalam konfigurasi multi-pusat data (76087166)
○ Kebijakan MessageLogging termasuk informasi tambahan dalam pesan log (68722102)
○ Gagal mereset sandi admin sistem (65737520)

Untuk 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 Langsung mengupgrade dari 4.18.05 → 4.19.01
Dari 4.18.01 Upgrade langsung dari 4.18.01 → 4.19.01
Dari 4.17.09 Upgrade langsung dari 4.17.09 → 4.19.01
Dari 4.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
Dari 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
Dari 4.16.01 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 menyertakan semua dalam rilis UI Edge, Pengelolaan Edge, dan Portal yang tercantum di Rilis yang Disertakan.

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

Rilis Ketersediaan Umum (GA) UI Edge

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

Untuk menggunakan UI Edge, Anda harus mengaktifkan SAML lalu menginstal UI Edge pada node miliknya sendiri.

Untuk informasi selengkapnya, lihat UI Edge untuk Cloud Pribadi.

Rilis Ketersediaan Umum (GA) Monetisasi di UI Edge

Rilis GA Monetisasi di UI pengalaman Edge Baru kini tersedia.

Kini Anda dapat mengelola semua tugas monetisasi untuk Apigee Edge untuk Private Cloud di UI pengalaman Edge Baru, termasuk hal berikut:

Dengan pengumuman ini, laporan varians monetisasi secara resmi tidak digunakan lagi. Lihat Penghentian Apigee.

apigee-monit menambahkan layanan pemulihan dan pemantauan mandiri

Apigee Edge untuk Private Cloud kini menyertakan apigee-monit, sebuah alat berbasis open source utilitas Monit. apigee-monit polling Edge secara berkala layanan; jika layanan tidak tersedia, apigee-monit akan mencoba memulai ulang layanan.

Untuk 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 menyetel hal berikut:

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

Untuk 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 UI Edge).

Untuk informasi selengkapnya, lihat Membuat host virtual menggunakan browser.

Dukungan OpenAPI v3 ditambahkan

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 pada 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 telah diperbaiki dalam rilis ini. Selain itu, mencakup semua perbaikan bug dalam rilis Edge UI, Pengelolaan Edge, dan Portal yang ditampilkan di Rilis yang Disertakan.

ID Masalah Deskripsi
122694069

Zookeeper tidak dihentikan oleh skrip pencadangan

Proses Zookeeper tidak dihentikan oleh skrip cadangan sebelum perbaikan ini dilakukan.
120993451

'Tidak ada organisasi' halaman landing ditambahkan

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

Menghapus laporan kustom

Pengguna tidak dapat menghapus laporan khusus di New Edge pengalaman yang lancar bagi developer.
120681592

Tab Geomap di pengalaman New Edge

Saat pengguna membuka tab Geomap di Pengalaman Edge baru, pengalaman New Edge menampilkan error.
120624977

Opsi JVM Zookeeper

Menyetel opsi JVM menggunakan Kode dengan Config untuk Zookeeper tidak bekerja.
80187407

Terjadi error yang belum ditetapkan di tooltip

Ketika sebuah diagram hanya memiliki satu deret waktu, tooltip menampilkan error yang tidak ditentukan.
79949124

Membuat reverse proxy melalui OpenAPI

Menggunakan OpenAPI saat membuat {i>proxy<i} tidak berfungsi.
77515655

Mereset sandi agar tidak mengirim link

Pengguna tidak menerima email saat meminta {i>link<i} untuk mengatur ulang {i>password<i} mereka.
72799769

Header salah untuk link reset sandi

Bahkan setelah pengguna menyetel 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 hal berikut:

  • Menambahkan CRLF ke akhir file metadata.xml

    ATAU

  • Menggunakan lokasi berbasis URL untuk metadata
122370980

apigee-monit tidak didukung di Amazon Linux 1

Solusi:

Tidak ada.
121095148

Pencadangan Pemroses Pesan tidak mencadangkan kumpulan file yang benar

Solusi:

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

115278838

Token sesi tidak dibatalkan

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

Solusi:

Gunakan pengalaman New Edge 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

HEAD permintaan ke target Node.js mengalami hang

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

Solusi:

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

79757554

Nama host tidak teratasi

Setelah menginstal atau mengupgrade Edge untuk Private Cloud, nama host mungkin tidak di-resolve menjadi alamatnya.

Solusi:

Untuk mengatasi masalah ini, mulai ulang komponen UI Edge:

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

DataAccessException di beberapa konfigurasi pusat data

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

DataAccessException: Error while accessing datastore;
Please retry later

Hasilnya, Server Pengelolaan mungkin tidak dimulai karena sedang mencoba terhubung ke Cassandra node di dc-1 dan dc-2. DataAccessExceptions terjadi jika node Cassandra ke bawah. Hal ini juga dapat mengakibatkan gangguan traffic API, yang membuat Pemroses Pesan melaporkan DataAccessExceptions saat mencoba mengambil KVM.

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

Solusi

Solusinya adalah dengan 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 berikut:

  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 keterangan:

    • ADMIN_EMAIL dan ADMIN_PW adalah kredensial Apigee Anda menggunakan akun layanan.
    • MS_IP dan MS_PORT adalah alamat IP dan port Server Pengelolaan angka
    • REGION adalah nama pusat data tempat Server Pengelolaan berada ditemukan.
    • GATEWAY_POD adalah nama pod, yang secara default merupakan "gateway". Anda mungkin memiliki mengubahnya menjadi nama lain, jadi periksa implementasi 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"
    }

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

  2. Ulangi langkah satu untuk setiap jenis node Cassandra: kms-datastore, dc-datastore, dan keyvaluemap-datastore. Pastikan untuk memperhatikan 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

Perlu diingat bahwa operasi ini mendaftarkan dan membatalkan pendaftaran node dari Zookeeper dan dampak pada gugus Cassandra. Untuk informasi selengkapnya tentang perintah ini, lihat Memperbarui pendaftaran datastore.

68722102

Kebijakan MessageLogging termasuk informasi tambahan dalam pesan log

Elemen FormatMessage kebijakan MessageLogging mengontrol format pesan yang dicatat dalam log. Saat FormatMessage=false, pesan yang dicatat dalam log tidak seharusnya menyertakan informasi yang dibuat 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 untuk Private Cloud 4.19.01, gunakan link berikut:

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