Stai visualizzando la documentazione di Apigee Edge.
Vai alla
documentazione di Apigee X. informazioni
Martedì 31 maggio 2016 abbiamo rilasciato una nuova versione di Apigee Edge per il cloud privato.
Dalla precedente release della funzionalità Edge for Private Cloud (4.16.01), sono state apportate le seguenti release che sono incluse in questa release di funzionalità:
- Cloud: 16.02.17, 16.03.02, 16.03.09 (UI), 16.03.16 (UI), 16.03.23 (UI), 16.03.30
Consulta Informazioni sulla numerazione delle release per capire come capire se una release cloud specifica è inclusa nella tua versione di Edge per il cloud privato.
Nuove funzionalità e miglioramenti
Di seguito sono riportate le nuove funzionalità e i miglioramenti di questa release. Oltre ai miglioramenti seguenti, questa release contiene anche numerosi miglioramenti a livello di usabilità, prestazioni, sicurezza e stabilità.
Per ulteriori dettagli e istruzioni, consulta la documentazione di Edge per Cloud privato.
Guide operative e all'installazione spostate online
Ora puoi accedere alla guida operativa e di installazione di Edge per Cloud privato nella versione 4.18.01.
Aggiornamenti software
Nella versione sono inclusi i seguenti aggiornamenti software:
- Java JDK 1.8: per sfruttare le ultime funzionalità di Java, questa release è compatibile con Java 1.8. Nel tuo ambiente è richiesto Oracle JDK 1.8 o OpenJDK 8.
Nell'ambito dell'aggiornamento a Java 8, alcune crittografie TLS non sono più disponibili in Oracle JDK 1.8. Per l'elenco completo, consulta la sezione "Suite di crittografia disabilitate predefinite" http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html. - Cassandra 2.1.13 - Aggiornata da Cassandra 2.0.15.
Installazione, upgrade, rollback
Di seguito è riportato un elenco di modifiche all'installazione, all'upgrade e agli script correlati. Per informazioni sull'utilizzo, consulta la documentazione di Edge per Cloud privato.
- Nuovo processo per l'aggiornamento dalla versione 4.16.01: questa release sostituisce l'utilità
apigee-migrate
con l'utilitàupdate.sh
per aggiornare l'installazione dalla versione 4.16.01 alla versione 4.16.05. Vedi Aggiornamento di Apigee Edge da 4.16.01 a 4.16.05. -
Bootstrap
bootstrap.sh
(la versione 4.16.01) è orabootstrap_4.16.05.sh
nella versione 4.16.05.- Non è più necessario specificare
uname:pword
per scaricarebootstrap_4.16.05.sh
.
- Rollback: per eseguire il rollback di un aggiornamento alla versione 4.16.05, disinstalli la versione 4.16.05 del componente e reinstalla la versione precedente. L'utilità
rollback.sh
precedente è stata rimossa. Vedi 4.16.05 Procedura di rollback. setup.sh
eupdate.sh
possono scrivere il file di log in/tmp
. Per impostazione predefinita, le utilitàsetup.sh
eupdate.sh
scrivono le informazioni di log in/opt/apigee/var/log/apigee-setup
. Se l'utente che esegue l'utilità non ha accesso a quella directory, il log viene scritto nella directory/tmp
. Se l'utente non ha accesso a/tmp
, l'utilità non riesce.- Procedura di aggiornamento dell'API BaaS: nella versione 4.16.01, dovevi reinstallare l'API BaaS per eseguirne la migrazione. La nuova utilità
update.sh
supporta l'aggiornamento dell'API BaaS. Vedi Aggiornamento di Apigee Edge da 4.16.01 a 4.16.05.
Amministrazione
Di seguito sono riportate le nuove funzionalità per l'amministrazione e la configurazione del cloud privato.
- Convalida dell'installazione
- L'utilità
apigee-validate
utilizzata per testare l'installazione del cloud privato perimetrale può ora essere eseguita dal server di gestione. In precedenza, lo script doveva essere eseguito sul processore di messaggi. Vedi Testare l'installazione. - Nome regione. La regione può essere qualsiasi nome. Nelle versioni precedenti, il nome era nel formato "dc-#", dove # era un valore intero.
- Pod gateway: i pod gateway possono avere qualsiasi nome. Nelle release precedenti, il pod doveva essere denominato "gateway".
- Amministrazione basata su script: una nuova utilità a riga di comando
apigee-adminapi.sh
consente di eseguire le stesse attività di configurazione perimetrale che esegui anche tramite chiamate all'API Edge Management. Consulta Utilizzo dell'utilità apigee-adminapi.sh. - Configurazione silenziosa SSL per l'host virtuale: quando crei un'organizzazione o un ambiente, ora puoi passare le proprietà per configurare SSL su un host virtuale. Vedi Eseguire l'onboarding di un'organizzazione.
Servizi API
Di seguito sono riportate le nuove funzionalità per i servizi API Edge, che sono state fornite nelle precedenti versioni cloud del prodotto.
Prefisso a lunghezza fissa per il logging dei messaggi syslog (Cloud 16.03.30)
Il criterio di logging dei messaggi ha un nuovo elemento <FormatMessage>
nella configurazione di Syslog. Impostando <FormatMessage>true</FormatMessage>
, i messaggi Syslog iniziano con un numero fisso di caratteri, in modo da filtrare i dati inseriti da Apigee. Per maggiori
informazioni, consulta la sezione Criterio di logging
dei messaggi. (APIRT-1398)
Carattere jolly nel percorso di base del proxy API (UI Cloud 16.03.09)
L'interfaccia utente di gestione supporta l'utilizzo di uno o più caratteri jolly /*/
nei percorsi di base dei proxy API. Ad esempio, un percorso di base /team/*/members
consente ai client di chiamare il tuo proxy con https://[host]/team/blue/members
o https://[host]/team/green/members
senza dover creare un nuovo proxy per supportare i nuovi team. Tieni presente che /**/
non è consentito. (MGMT-3154)
Concatenazione dei proxy API (Cloud 16.03.02, UI Cloud 16.03.09)
Edge supporta il concatenamento di proxy delle API locali, che consente a un proxy API di chiamare un altro proxy API di cui è stato eseguito il deployment nell'organizzazione Edge senza overhead di rete aggiuntivo. In precedenza, il concatenamento dei proxy API richiedeva una chiamata http(s) a un altro proxy API, che inoltrava la richiesta tramite un bilanciatore del carico, un router e un processore di messaggi.
Nuovi elementi LocalTargetConnection
sono disponibili su TargetEndpoint di un proxy API e ti consentono di specificare il nome di un proxy API, il nome di uno specifico ProxyEndpoint all'interno di un proxy API o semplicemente il percorso di base di una risorsa proxy dell'API locale (ad esempio /v1/myresource). L'interfaccia utente dell'editor proxy fornisce queste opzioni anche quando aggiungi o aggiorni un TargetEndpoint.
Il concatenamento di proxy è disponibile anche nelle norme relative ai callout di servizio.
Per maggiori informazioni, consulta la pagina relativa all'unione tra proxy API di Canin. I nuovi elementi LocalTargetConnection
sono elencati anche nello schema XML qui: https://github.com/apigee/api-platform-samples/blob/master/schemas/configuration/configuration_schemas.xsd.
(MGMT-3049, MGMT-3050)
Bug corretti
In questa release sono stati corretti i bug indicati di seguito. Questo elenco è destinato principalmente agli utenti che verificano se i ticket di assistenza sono stati risolti. Non è progettata per fornire informazioni dettagliate a tutti gli utenti.
Edge per Cloud privato 4.16.05
ID problema | Descrizione |
---|---|
PRC-770 | Il programma di installazione 16.01 non riesce a registrare il server standby Postgres in axgroup |
PRC-758 | L'utente con il ruolo Utente è in grado di modificare i report personalizzati |
PRC-883 | L'aggiornamento sul server Postgres con configurazione di standby master non è riuscito |
Cloud 16.03.30
ID problema | Descrizione |
---|---|
SECENG-584 | Il controllo di convalida della nuova riga tra i certificati in una catena di certificati causa problemi con alcuni certificati in produzione |
MGMT-3217 | Le chiamate all'API di gestione non vanno a buon fine se il nome KVMap termina con "keys" |
MGMT-3214 | Possono verificarsi conflitti di classe durante i callout Java, causando un errore del codice Java di un cliente |
MGMT-3185 | Errore durante l'aggiunta di amministratori dell'organizzazione a un'organizzazione |
EDGEUI-127 | Recupero di autorizzazioni insufficienti con il nuovo editor proxy |
EDGEUI-119 | Problema di timeout della sessione UI |
CORESERV-671 | Visualizzi gli errori "Nessun anello configurato; impossibile inizializzare il servizio cps" |
AXAPP-2345 | Problema relativo alla creazione di elenchi di report personalizzati AX per i clienti non CPA |
AXAPP-2302 | Il riepilogo giornaliero dei dati e delle analisi di Apigee mostra zero problemi di adozione da parte degli sviluppatori |
APIRT-2750 | Errori di traffico elevati in un'organizzazione specifica |
APIRT-2516 | Gli errori di runtime nei callout JavaScript specificano numeri di riga errati |
APIRT-2508 | Errore di uscita durante la chiamata di ascolto rapido all'interno di un callback di Vault |
APIRT-2336 | Problema Gzip con Node.js |
APIRT-1975 | Le configurazioni della maschera non funzionano per message.content |
UI Cloud 16.03.16
ID problema | Descrizione |
---|---|
MGMT-3142 | Grafici non caricati nella dashboard Analisi degli errori (correzione aggiornata) |
UI Cloud 16.03.09
ID problema | Descrizione |
---|---|
MGMT-3158 | Autorizzazioni insufficienti nella UI quando RBAC su singoli proxy viene impostato tramite l'API |
MGMT-3142 | I grafici non vengono caricati nella dashboard Analisi degli errori |
MGMT-3118 | L'interfaccia utente mostra una configurazione errata dell'host virtuale SSL per il parametro "clientAuthEnabled" |
DEVRT-2344 | Le definizioni dei report giornalieri non caricano le transazioni nell'interfaccia utente |
Cloud 16.03.02
ID problema | Descrizione |
---|---|
MGMT-3083 | L'aggiornamento automatico dei log Node.js è troppo dettagliato con i messaggi di log |
DEVRT-2275 | I piani tariffari degli attributi personalizzati mostrano solo 5 attributi anziché i 10 consentiti |
DEVRT-1275 | Nel menu a discesa Piano tariffario non vengono mostrati tutti gli sviluppatori |
DEVRT-1074 | Uno sviluppatore prepagato con saldo pari a zero genera un'eccezione NullpointerException quando viene applicato un credito |
Cloud 16.02.17
ID problema | Descrizione |
---|---|
MGMT-3083 | L'aggiornamento automatico dei log Node.js è troppo dettagliato con i messaggi di log |
MGMT-3077 | La UI genera un bundle proxy non valido da un WSDL che utilizza lo spazio dei nomi predefinito |
MGMT-1642 | Nel ruolo utente personalizzato manca l'autorizzazione "get" per le app sviluppatore |
Problemi noti
Questa release presenta i problemi noti riportati di seguito.
ID problema | Descrizione |
---|---|
APIRT-2978 |
Il router non si avvia Nginx oppure non si avvia Se il router Edge non riesce ad avviare Nginx o non si avvia affatto, come mostrato nel file /opt/apigee/var/log/edge-router/logs/system.log, elimina tutti i file nella directory /opt/nginx/conf.d e riavvia il router: > rm -f /opt/nginx/conf.d/* > /opt/apigee/apigee-service/bin/apigee-service edge-router restart |
APIRT-3364 |
Il processore di messaggi esegue ricerche DNS su IPv4 e IPv6 Se hai installato e abilitato NSCD (Name Service Cache Daemon), potresti notare che i processori di messaggi effettuano due ricerche DNS: una per IPv4 e una per IPv6. Per disattivare la ricerca DNS su IPv6:
|
PRC-1118 |
Errore durante l'esecuzione del comando "apigee-service apigee-postgresql pg-data-purge" Se esegui il comando "apigee-service apigee-postgresql pg-data-purge" e vedi un errore nel formato: ERRORE: deve essere il proprietario della relazione Modifica /opt/apigee/apigee-postgresql-4.16.05-0.0.894/lib/actions/pg-data-purge e imposta la seguente proprietà ad apigee': POSTGRES_USER=apigee |
DOC-1687 | A causa di un conflitto di dipendenze dei pacchetti noto, l'agente Katello utilizzato nel Satellite Server 6 non verrà installato correttamente sugli host Apigee Edge che eseguono il daemon Qpid. |
Payload JSON nei criteri Assegna messaggio, Callout Java e Genera errori
I criteri Assegna messaggio, Callout Java e Genera errore consentono di generare contenuti
dei messaggi utilizzando l'elemento <Set><Payload>
. All'interno di questi messaggi, puoi includere variabili i cui valori vengono compilati automaticamente in fase di esecuzione. Ad esempio, se vuoi generare la data dall'intestazione HTTP, puoi inserire {message.header.date}
nel messaggio.
Se il formato del messaggio è JSON, l'aspetto è simile al seguente:
{"The date is: " : "{message.header.date}"}
Tuttavia, puoi vedere che il formato JSON è in formato JSON. Per ovviare a questo problema, hai due opzioni:
- Esegui l'escape della parentesi graffa aperta con una barra rovesciata:
\{"The date is: " : "{message.header.date}"}
- Nella configurazione dell'elemento payload, utilizza gli attributi
variablePrefix
evariableSuffix
per indicare una variabile in un payload JSON. Ad esempio:
<Payload contentType="application/json" variablePrefix="#" variableSuffix="%">{"The date is: " : "#message.header.date%"}</Payload>
Nella prossima release di funzionalità Edge per Cloud privato, potrai utilizzare le parentesi graffe per le variabili nei messaggi JSON senza problemi. (APIRT-1160)
Il router non si avvia Nginx oppure il router non si avvia
Se il router Edge non riesce ad avviare Nginx o non si avvia affatto, come mostrato nel file /opt/apigee/var/log/edge-router/logs/system.log, elimina tutti i file nella directory /opt/nginx/conf.d e riavvia il router:
> rm -f /opt/nginx/conf.d/* > /opt/apigee/apigee-service/bin/apigee-service edge-router restart