4.16.05 - Note di rilascio di Edge per Private Cloud

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

Martedì 31 maggio 2016 abbiamo rilasciato una nuova versione di Apigee Edge per Private Cloud.

Dalla precedente release delle funzionalità di Edge per il cloud privato (4.16.01), sono state rilasciate le seguenti versioni, che sono incluse in questa release delle funzionalità:

Consulta la sezione Informazioni sulla numerazione delle release per capire come determinare se una specifica release cloud è 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 diversi miglioramenti di usabilità, prestazioni, sicurezza e stabilità.

Per ulteriori dettagli e istruzioni, consulta la documentazione di Edge for Private Cloud.

Guide all'installazione e all'utilizzo spostate online

Ora puoi accedere alla guida all'installazione e alle operazioni di Edge for Private Cloud alla versione 4.18.01.

Aggiornamenti software

La release include i seguenti aggiornamenti software:

  • Java JDK 1.8: per sfruttare le funzionalità Java più recenti, 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 cifrature TLS non sono più disponibili in Oracle JDK 1.8. Per l'elenco completo, consulta la sezione "Default Disabled Cipher Suites" (Suite di crittografia disattivate per impostazione predefinita) http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.
  • Cassandra 2.1.13: aggiornamento dalla versione 2.0.15 di Cassandra.

Installazione, upgrade, rollback

Di seguito è riportato un elenco delle modifiche apportate agli script di installazione, upgrade e correlati. Per informazioni sull'utilizzo, consulta la documentazione di Edge for Private Cloud.

  • Nuova procedura di 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 4.16.05. Consulta Aggiorna Apigee Edge 4.16.01 alla versione 4.16.05.
  • Bootstrap
    • bootstrap.sh (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, disinstalla 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 questa directory, scrive il log nella directory /tmp. Se l'utente non ha accesso a /tmp, l'utilità non funziona.
  • Procedura di aggiornamento di API BaaS: nella release 4.16.01, era necessario reinstallare API BaaS per eseguirne la migrazione. La nuova utilità update.sh supporta l'aggiornamento in loco di API BaaS. Consulta Aggiorna Apigee Edge 4.16.01 alla versione 4.16.05.

Amministrazione

Di seguito sono riportate le nuove funzionalità per l'amministrazione e la configurazione di Private Cloud.

  • Convalida dell'installazione - L'utilità apigee-validate utilizzata per testare l'installazione di Edge Private Cloud ora può essere eseguita dal server di gestione. In precedenza, lo script doveva essere eseguito sul processore di messaggi. Consulta Testare l'installazione.
  • Nome regione: la regione può avere 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 versioni 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 di Edge che esegui effettuando chiamate all'API Edge Management. Consulta Utilizzo dell'utilità apigee-adminapi.sh.
  • Configurazione silenziosa SSL dell'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 Edge API Services, che sono state implementate nelle versioni cloud precedenti del prodotto.

Prefisso a lunghezza fissa per la registrazione dei messaggi syslog (Cloud 16.03.30)

La policy Registrazione messaggi ha un nuovo elemento <FormatMessage> nella configurazione Syslog. Se imposti <FormatMessage>true</FormatMessage>, i messaggi Syslog iniziano con un numero fisso di caratteri, il che ti consente di filtrare i dati inseriti da Apigee. Per saperne di più, consulta le norme di logging dei messaggi. (APIRT-1398)

Carattere jolly nel percorso di base del proxy API (interfaccia utente Cloud 16.03.09)

L'UI di gestione supporta l'utilizzo di uno o più caratteri jolly /*/ nei percorsi di base del 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 che tu debba creare un nuovo proxy per supportare nuovi team. Tieni presente che /**/ non è consentito. (MGMT-3154)

Concatenamento dei proxy API (Cloud 16.03.02, UI Cloud 16.03.09)

Edge supporta il concatenamento dei proxy API locali, che consente a un proxy API di chiamare un altro proxy API di cui è stato eseguito il deployment nella tua organizzazione Edge senza sovraccarico 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 bilanciamento del carico, un router e un processore di messaggi.

Nel TargetEndpoint di un proxy API sono disponibili nuovi elementi LocalTargetConnection, che ti consentono di specificare un nome di proxy API, il nome di un ProxyEndpoint specifico all'interno di un proxy API o semplicemente il percorso di base a una risorsa proxy API locale (ad esempio /v1/myresource). La UI dell'editor proxy fornisce anche queste opzioni quando aggiungi o aggiorni un TargetEndpoint.

Il concatenamento dei proxy è disponibile anche nelle policy di callout del servizio.

Per saperne di più, consulta Concatenare i proxy API. 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 seguenti bug. Questo elenco è destinato principalmente agli utenti che controllano se i loro ticket di assistenza sono stati risolti. Non è progettato per fornire informazioni dettagliate per tutti gli utenti.

Edge for Private Cloud 4.16.05

ID problema Descrizione
PRC-770 Il programma di installazione 16.01 non riesce a registrare il server di standby Postgres in axgroup
PRC-758 L'utente con il ruolo Utente può modificare i report personalizzati
PRC-883 L'aggiornamento del server Postgres con configurazione master-standby non va a buon fine

Cloud 16.03.30

ID problema Descrizione
SECENG-584 Il controllo di convalida per l'interruzione di 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 di KVMap termina con "keys"
MGMT-3214 I conflitti di classe possono verificarsi durante le chiamate Java, causando l'errore del codice Java di un cliente
MGMT-3185 Errore durante l'aggiunta di amministratori dell'organizzazione a un'organizzazione
EDGEUI-127 Ottenere autorizzazioni insufficienti con il nuovo editor proxy
EDGEUI-119 Problema di timeout della sessione dell'interfaccia utente
CORESERV-671 Visualizzazione di errori "No rings configured; Cannot initialize cps service" (Nessun anello configurato; impossibile inizializzare il servizio cps)
AXAPP-2345 Problema nella visualizzazione dei report personalizzati AX per i clienti non CPS
AXAPP-2302 Il riepilogo giornaliero di Apigee Analytics mostra zero in adozione da parte degli sviluppatori
APIRT-2750 Numero elevato di errori di traffico 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 del vault
APIRT-2336 Problema di Gzip con Node.js
APIRT-1975 Le configurazioni di mascheramento non funzionano per message.content

UI di Cloud 16.03.16

ID problema Descrizione
MGMT-3142 I grafici non vengono caricati nella dashboard Analisi errori (correzione aggiornata)

UI di Cloud 16.03.09

ID problema Descrizione
MGMT-3158 Autorizzazioni insufficienti nella UI quando il controllo dell'accesso basato sui ruoli sui singoli proxy viene impostato tramite l'API
MGMT-3142 I grafici non vengono caricati nella dashboard Analisi errori
MGMT-3118 L'interfaccia utente mostra una configurazione dell'host virtuale SSL errata per il parametro "clientAuthEnabled"
DEVRT-2344 Le definizioni dei report di un solo giorno non caricano le transazioni nell'interfaccia utente

Cloud 16.03.02

ID problema Descrizione
MGMT-3083 L'aggiornamento automatico dei log di Node.js è troppo dettagliato con i messaggi di log
DEVRT-2275 I piani tariffari con attributi personalizzati mostrano solo 5 attributi anziché i 10 consentiti
DEVRT-1275 Non tutti gli sviluppatori vengono visualizzati nel menu a discesa Piano tariffario
DEVRT-1074 Lo sviluppatore prepagato con saldo zero genera NullpointerException quando viene applicato il credito

Cloud 16.02.17

ID problema Descrizione
MGMT-3083 L'aggiornamento automatico dei log di Node.js è troppo dettagliato con i messaggi di log
MGMT-3077 L'interfaccia utente genera un bundle proxy non valido da un WSDL che utilizza lo spazio dei nomi predefinito
MGMT-1642 Al ruolo utente personalizzato manca l'autorizzazione "get" per le app per sviluppatori

Problemi noti

Questa release presenta i seguenti problemi noti.

ID problema Descrizione
APIRT-2978

Impossibile avviare Nginx o il router

Se Edge Router 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 la ricerca DNS su IPv4 e IPv6

Se hai installato e attivato NSCD (Name Service Cache Daemon), potresti notare che i processori di messaggi eseguono due ricerche DNS: una per IPv4 e una per IPv6.

Per disattivare la ricerca DNS su IPv6:

  1. Su ogni nodo processore di messaggi, modifica /etc/nscd.conf.
  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 visualizzi un errore nel formato:

ERRORE: devi 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à su "apigee":

POSTGRES_USER=apigee
DOC-1687 A causa di un conflitto noto di dipendenze dei pacchetti, l'agente Katello utilizzato in Satellite Server 6 non verrà installato correttamente sugli host Apigee Edge che eseguono il daemon Qpid.

Payload JSON nelle policy Assegna messaggio, Callout Java e Genera errore

I criteri Assegna messaggio, Callout Java e Genera errore ti consentono di generare contenuti dei messaggi utilizzando l'elemento <Set><Payload>. Nell'ambito di questi messaggi, puoi includere variabili i cui valori vengono compilati automaticamente in fase di runtime. Ad esempio, se vuoi restituire la data dall'intestazione HTTP, puoi inserire {message.header.date} nel messaggio.

Se il formato del messaggio è JSON, l'aspetto sarebbe simile al seguente:

{"The date is: " : "{message.header.date}"}

Tuttavia, puoi vedere che il JSON non è valido. Per risolvere il 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 delle funzionalità di Edge per il cloud privato, potrai utilizzare le parentesi graffe per le variabili nei messaggi JSON senza problemi. (APIRT-1160)

Il router non riesce ad avviare Nginx o Il router non riesce ad avviarsi

Se Edge Router 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