Note di rilascio della versione 4.50.00 di Edge per Private Cloud

Stai visualizzando la documentazione di Apigee Edge.
Consulta la documentazione di Apigee X.
info

Questa sezione descrive la versione 4.50.00 della release delle funzionalità di Edge for Private Cloud.

Riepilogo della release

La seguente tabella riassume le modifiche apportate a questa release:

Nuove funzionalità

Questa release include le nuove funzionalità seguenti:

○ Informazioni sulla connessione TLS ora disponibili nei proxy API
○ Upgrade di Zookeeper
○ Disponibilità del portale Drupal 8 e fine del ciclo di vita di Drupal 7

Per ulteriori informazioni su ciascuna di queste nuove funzionalità, consulta la sezione Nuove funzionalità.

Compatibilità con le versioni precedenti In questa versione di Apigee Edge for Private Cloud sono stati introdotti i seguenti problemi che influiscono sulla compatibilità con le versioni precedenti:
     
  • A causa della correzione del problema 132443137 (come descritto nelle note di rilascio di Public Cloud 19.03.01), i processori di messaggi ora ignorano le intestazioni che iniziano con X-Apigee-*. Di conseguenza, devi eseguire il refactoring di qualsiasi codice che utilizzi le intestazioni X-Apigee-* e sostituirle con quelle supportate.
  • Il nome dei file di log di Cassandra è cambiato. Ora è:

    /opt/apigee/var/log/apigee-cassandra/system.log
Uscite incluse

Dall'ultima release delle funzionalità di Edge per il cloud privato, sono state rilasciate le seguenti versioni e sono incluse in questa release:

○ Edge:
   20.04.06 (runtime, API Mgmt, Monetization Mgmt)
   20.03.27 (UI)
   20.03.16 (Edge Analytics)
   20.03.11 (UI)
   20.02.27 (API Monitoring)
   20.02.24 (UI)
   20.02.03 (API Monitoring)
   20.01.29 (UI)
   20.01.22 (UI)
   20.01.06 (API Mgmt/Runtime)
○ Edge (continua):
   20.01.06 (UI)
   19.11.13 (report sulla sicurezza delle API)
   19.10.01 (UI)
   19.09.26 (UI/portale Edge)
   19.08.27 (UI)
   19.08.15 (report sulla sicurezza delle API)
   19.07.29 (UI)
○ Portal:
   20.05.27.00
   20.04.13.00
   20.03.20.00
   19.12.20.00
   19.11.21.00
   19.09.25.00
Ritiri Nessuno
Ritiri

Con il rilascio della versione 4.50.00:

  • 4.18.05: la versione 4.18.05 di Apigee Edge for Private Cloud è ora ritirata.

Le funzionalità ritirate in questa release includono:

  • Supporto di proxy Node.js e Secure Vaults
  • Supporto dei criteri OAuth v1
  • Supporto per la policy di limitazione della frequenza simultanea
  • Supporto per l'adattatore Apigee per Istio
  • Supporto della funzionalità di accesso in anteprima di Teams

Per informazioni più dettagliate sui ritiri, incluse le tempistiche di rimozione, consulta Ritiri e chiusure di Apigee.

Correzioni di bug

Questa release include le seguenti correzioni di bug:

○ Il processore di messaggi non riesce a caricare gli ambienti quando i keystore sono configurati con nomi o alias simili. (154428338)
○ Conflitto di dipendenze QPid durante l'installazione della patch (152574421)
○ Il limite di memoria della cache non rispetta le dimensioni massime della cache L1 (151449163)
○ Gli script di backup non vanno a buon fine (150710952)
○ Il server QPid invia messaggi di log aggiuntivi (148231209)
○ Il backup di Postgresql non memorizza le informazioni SSO (147458330)
○ La versione di apigee-nginx non è stata aggiornata. (146872858)
○ Il messaggio "Prova la nuova UI" non viene più visualizzato (145419621)
○ Vulnerabilità dell'API Apigee SmartDocs (145340106)
○ Lo script di backup di Postgres non va a buon fine (145254693)
○ Varie correzioni di sicurezza (142150706)
○ Tasso elevato di timeout dal router al processore di messaggi (138107618)
○ Errore dello script di configurazione SSO (135616498)
○ Porte JMX (132044907)
○ Errori 404 intermittenti per il traffico di runtime a causa di una condizione di competizione (130653816)
○ Corruzione di OpenLDAP durante l'upgrade (120799182)
○ DataAccessException in configurazioni di più data center (76087166)
○ FormatMessage impostato su false nel criterio MessageLogging non funziona (68722102)

Per saperne di più su ciascuna di queste correzioni, consulta la sezione Correzioni di bug.

Problemi noti

Questa release include i seguenti problemi noti:

○ Convalida JWT non riuscita (159788170)
○ Perdita di memoria dei server di valutazione Mint (137865184)
apigee-monit non supportato su Amazon Linux 1 (122370980)
○ Il backup del processore di messaggi non esegue il backup del set corretto di file (121095148)
○ Aumento del rapporto di fallimento della cache dopo l'upgrade (160109014)
○ Risposta HTTP 408 per la richiesta GET con corpo vuoto e Content-Encoding: gzip. (159858015)

Per ulteriori informazioni su ciascuno di questi problemi noti, incluse le soluzioni alternative, vedi Problemi noti.

Percorsi di upgrade

La tabella seguente mostra i percorsi di upgrade per questa release:

A partire dalla versione 4.19.01 o 4.19.06 Upgrade diretto dalla versione 4.19.01/4.19.06 alla 4.50.00
A partire dalla versione 4.18.05 Esegui l'upgrade diretto dalla versione 4.18.05 alla 4.50.00

Nuove funzionalità

Questa sezione elenca le nuove funzionalità di questa release. Inoltre, questa release include tutte le funzionalità delle release dell'interfaccia utente Edge, di Edge Management e del portale elencate in Release incluse.

Oltre ai seguenti miglioramenti, questa release contiene anche diversi miglioramenti di usabilità, prestazioni, sicurezza e stabilità.

Informazioni sulla connessione TLS ora disponibili nei proxy API

Durante una richiesta a un proxy API tramite un host virtuale che supporta TLS, Edge può acquisire informazioni sulla connessione TLS. Il proxy API ora può accedere a queste informazioni tramite le variabili di flusso per eseguire analisi e convalide aggiuntive. Per saperne di più, consulta Accesso alle informazioni sulla connessione TLS in un proxy API.

Upgrade di Zookeeper

Questa release contiene Zookeeper 3.4.14.

Disponibilità del portale Drupal 8 e fine del ciclo di vita di Drupal 7

Drupal 8 ha sostituito Drupal 7 come portale per sviluppatori consigliato da Apigee per Private Cloud. Poiché il supporto a lungo termine di Drupal 7 terminerà a novembre 2021, i moduli Apigee per Drupal 7 non saranno più supportati a partire da novembre 2021. Sebbene ancora disponibili, gli script di installazione/upgrade per Drupal 7 non devono più essere utilizzati e verranno rimossi in una release futura.

Per informazioni sui moduli Drupal 8 che si integrano con Apigee, consulta: Creazione del portale utilizzando Drupal 8.

Software supportati

Questa release include le seguenti modifiche al software supportato:

Supporto aggiunto Non più supportato

Questa release aggiunge il supporto per le seguenti piattaforme:

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

Le seguenti piattaforme non sono più supportate con questa release:

  • Red Hat Enterprise Linux (RHEL) 6.10
  • CentOS 6.10
  • Oracle Linux 6.9

Per un elenco completo delle piattaforme supportate, consulta Software e versioni supportati.

Correzioni di bug

Questa sezione elenca i bug di Private Cloud corretti in questa release. Inoltre, questa release include tutte le correzioni di bug nelle release dell'interfaccia utente Edge, di Edge Management e del portale mostrate in Release incluse.

ID problema Descrizione
154428338

Il processore di messaggi non riesce a caricare gli ambienti quando i keystore sono configurati con nomi o alias simili.

Abbiamo risolto un conflitto di ricerca regex durante il caricamento di keystore con convenzioni di denominazione simili. Ciò impediva al processore di messaggi di caricare gli ambienti associati al keystore o di avviarsi quando venivano restituiti più keystore in conflitto durante la ricerca.
152574421

Conflitto di dipendenza QPid durante l'installazione della patch

Ora è installata la versione corretta di QPid.
151449163

Il limite della memoria cache non rispetta le dimensioni massime della cache L1

Il limite di memoria cache ora rispetta le dimensioni massime della cache L1.
150710952

Script di backup non riusciti

La procedura di backup è stata aggiornata in base agli script di backup aggiornati.
148231209

Il server QPid invia messaggi di log aggiuntivi

Il server QPid non invia più messaggi di log aggiuntivi.
147458330

Il backup di PostgreSQL non memorizza le informazioni SSO

Il backup di PostgreSQL ora memorizza le informazioni SSO.
146872858

La versione di apigee-nginx non è stata eseguita l'upgrade.

La versione di apigee-nginx è stata aggiornata correttamente.
145419621

Il messaggio "Prova la nuova UI" non viene più visualizzato

L'interfaccia utente non mostra più il messaggio "Prova la nuova UI".
145340106

Vulnerabilità dell'API Apigee SmartDocs

Proxy Apigee SmartDocs aggiornato per risolvere la vulnerabilità di sicurezza. Per ulteriori informazioni e i passaggi richiesti, consulta la procedura di installazione di Smart Docs.
145254693

Lo script di backup di Postgres non va a buon fine

Lo script di backup di Postgres ora funziona correttamente.
142150706

Diverse correzioni relative alla sicurezza

Correzioni per problemi di sicurezza, incluso il problema n. 111390246.
138107618

Tasso elevato di timeout da router a processore di messaggi

Il problema è stato risolto.
135616498

Errore dello script di configurazione SSO

È stato risolto un problema per cui l'utilizzo di URL con schema file causava l'errore dello script di configurazione SSO.
132044907

Porte JMX

Le porte JMX non devono essere aperte all'accesso esterno, ma solo ai server interni.
130653816

Errori 404 intermittenti per il traffico di runtime a causa di una race condition

È stata corretta una race condition durante il bootstrap di MP che ha portato al mancato deployment corretto di alcuni proxy.
120799182

Corruzione di OpenLDAP durante l'upgrade

Il problema è stato risolto.
76087166

DataAccessException in configurazioni di più data center

Nelle configurazioni con più data center, se un datastore non è più disponibile, non viene più visualizzato l'errore DataAccessException.
68722102

L'opzione FormatMessage impostata su false nel criterio MessageLogging non funziona

Ora puoi impostare FormatMessage su false nel criterio MessageLogging.

Problemi noti

La tabella seguente elenca i problemi noti in questa release:

ID problema Descrizione
159788170

La convalida JWT non va a buon fine

La convalida JWT non riesce per le chiavi RSA di dimensioni inferiori a 2048 bit.

Soluzione temporanea:

Assicurati che le chiavi siano di almeno 2048 bit.
137865184

Perdita di memoria dei server di valutazione Mint

Quando una nuova istanza Qpid viene registrata in un gruppo mx, le code vengono create senza consumer, il che comporta un aumento della profondità della coda fino a quando non vengono utilizzate tutte le risorse disponibili.

Soluzione temporanea:

Nessuno.
122370980

apigee-monit non supportato su Amazon Linux 1

Soluzione temporanea:

Nessuno.
121095148

Il backup del processore di messaggi non esegue il backup del set corretto di file

Soluzione temporanea:

Esegui il backup una seconda volta e dovrebbe eseguire il backup del set corretto di file.

160109014

Aumento del rapporto di fallimento della cache dopo l'upgrade

Dopo l'upgrade alla release 4.50.00, i proxy potrebbero mostrare un rapporto di fallimento della cache più elevato. Questi errori potrebbero essere accompagnati da un aumento dei messaggi di errore nei log MP, ad esempio:

InvalidClassException when fetching cps cache entry from second level - com.apigee.jsonparser.LinkedJSONObject; local class incompatible: stream classdesc serialVersionUID = -8575741446425131573, local class serialVersionUID = 752634431212433936. Considering it as cache miss.

Soluzione temporanea:

Nessuno. Si prevede che la percentuale successi cache si stabilizzi nel tempo.

159858015

Risposta HTTP 408 per la richiesta GET con corpo vuoto e Content-Encoding: gzip.

Un client API riceverà una risposta 408 Timeout quando effettua una richiesta GET con l'intestazione Content-Encoding: gzip e un corpo della richiesta vuoto.

Soluzione temporanea:

Ometti l'intestazione Content-Encoding quando esegui richieste GET con un corpo vuoto.

Passaggio successivo

Per iniziare a utilizzare Edge for Private Cloud 4.50.00, utilizza i seguenti link:

Nuove installazioni:
Panoramica della nuova installazione
Installazioni esistenti:
Percorsi di upgrade