4.16.05 - Note di rilascio di Edge per Private Cloud

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

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) è ora bootstrap_4.16.05.sh nella versione 4.16.05.
    • Non è più necessario specificare uname:pword per scaricare bootstrap_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 e update.sh possono scrivere il file di log in /tmp. Per impostazione predefinita, le utilità setup.sh e update.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:

  1. Modifica /etc/nscd.conf su ogni nodo del processore di messaggi.
  2. Imposta la seguente proprietà:

    enable-cache hosts no
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 e variableSuffix 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
Indietro
4.16.05.01
Avanti
4.16.01.08