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

Dalla precedente release delle funzionalità di Edge for Private Cloud (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 release cloud specifica è inclusa nella tua versione di Edge for Private Cloud.

Nuove funzionalità e miglioramenti

Di seguito sono riportate le nuove funzionalità e i miglioramenti di questa release. Oltre ai seguenti miglioramenti, 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.

Le guide all'installazione e alle operazioni sono state spostate online

Ora puoi accedere alla guida all'installazione e alle operazioni di Edge per 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 da Cassandra 2.0.15.

Installazione, upgrade, rollback

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

  • Nuovo processo 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 Aggiornamento di 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. La precedente utilità rollback.sh è stata rimossa. Consulta 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, dovevi reinstallare API BaaS per eseguirne la migrazione. La nuova utilità update.sh supporta l'aggiornamento in loco di API BaaS. Consulta Aggiornamento di Apigee Edge 4.16.01 alla versione 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 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. Vedi Utilizzo dell'utilità apigee-adminapi.sh.
  • Configurazione silenziosa di SSL per 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)

Il criterio 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'interfaccia utente 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 di 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 bilanciatore 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 del proxy API, il nome di un ProxyEndpoint specifico all'interno di un proxy API o semplicemente il percorso base di una risorsa proxy API locale (ad esempio /v1/myresource). L'interfaccia utente dell'editor proxy fornisce anche queste opzioni quando aggiungi o aggiorni un TargetEndpoint.

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

Per saperne di più, consulta la sezione Concatenamento di 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 verificano 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 L'installer 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 API Management non riescono 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 Ricevere 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 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 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 Grafici non caricati nella dashboard Analisi errori
MGMT-3118 L'interfaccia utente mostra una configurazione 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

Message Processor 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 del 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, Java Callout 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 si tratta di un file JSON non valido. Per risolvere 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 delle funzionalità di Edge for Private Cloud, 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