4.16.05 - Note di rilascio di Edge per Private Cloud

Stai visualizzando la documentazione di Apigee Edge.
Vai alla sezione Documentazione di Apigee X.
Informazioni

Martedì 31 maggio 2016 abbiamo rilasciato una nuova versione di Apigee Edge per il cloud privato.

Dalla precedente release delle funzionalità Edge per il cloud privato (4.16.01), le seguenti release si sono verificati e sono inclusi in questa versione:

Vedi Informazioni sulla release numerazione per capire come capire se una specifica release cloud è incluso nella tua versione di Edge per il cloud privato.

Nuove funzionalità e miglioramenti

Di seguito sono riportate le nuove funzioni e i miglioramenti di questa release. Oltre a quanto segue miglioramenti, questa release contiene inoltre diverse caratteristiche di usabilità, prestazioni, sicurezza e miglioramenti.

Per ulteriori dettagli e istruzioni, consulta la documentazione di Edge per il cloud privato.

Installazione e Guide operative spostate online

Ora puoi accedere alla guida operativa e di installazione di Edge per il cloud privato alla versione 4.18.01.

Aggiornamenti software

Nella release sono inclusi i seguenti aggiornamenti software:

  • Java JDK 1.8. Per sfruttare le ultime funzionalità di Java, questo è compatibile con Java 1.8. In Oracle JDK 1.8 o OpenJDK 8 è richiesto del tuo ambiente.
    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 disattivate predefinite" 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 agli script di installazione, upgrade e relativi script. Per informazioni in uso, consulta la documentazione di Edge per il cloud privato.

  • Nuova procedura di aggiornamento dalla versione 4.16.01. Questa release sostituisce la apigee-migrate con l'utilità update.sh per aggiornare installazione dalla versione 4.16.01 alla 4.16.05. Vedi Aggiornare Apigee Edge 4.16.01 in 4.16.05.
  • Bootstrap
      .
    • bootstrap.sh (la versione 4.16.01) è ora bootstrap_4.16.05.sh nella versione 16.4.05.
    • Non è più necessario specificare uname:pword per il download bootstrap_4.16.05.sh.
  • Rollback - Per eseguire il rollback di un aggiornamento alla versione 4.16.05, devi disinstallare il 4.16.05 del componente e reinstallare la versione precedente. La precedente L'utilità rollback.sh è stata rimossa. Vedi 4.16.05 Processo di rollback.
  • setup.sh e update.sh possono scrivere il file di log in /tmp: per impostazione predefinita, i setup.sh e Le utilità update.sh scrivono informazioni di log a /opt/apigee/var/log/apigee-setup. Se l'utente che esegue l'utilità non se ha accesso a quella directory, scrive il log nella directory /tmp. Se l'utente non ha accesso a /tmp, l'utilità non riesce.
  • Procedura di aggiornamento delle API BaaS: nella release 4.16.01 dovevi reinstalla API BaaS per eseguirne la migrazione. La nuova utilità update.sh supporta aggiornare l'API BaaS in corso. Vedi Aggiornare Apigee Edge 4.16.01 in 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 il tuo Edge Private Cloud l'installazione può ora essere eseguita dal server di gestione. In precedenza, lo script doveva essere eseguito del processore di messaggi. Consulta la sezione Testare installare.
  • Nome regione. La regione può essere qualsiasi nome. Nelle versioni precedenti, il nome nel formato "dc-#", dove # rappresenta un valore intero.
  • Pod gateway: i pod del gateway possono avere qualsiasi nome. Nelle release precedenti, doveva essere chiamato "gateway".
  • Amministrazione basata su script - A la nuova utilità a riga di comando apigee-adminapi.sh consente di eseguire le stesse Attività di configurazione perimetrale che esegui tramite chiamate all'API Edge Management. Consulta Utilizzo del Utilità apigee-adminapi.sh.
  • Configurazione silenziosa SSL per l'host virtuale: quando crei un'organizzazione o , 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 nel cloud precedente più versioni 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> in la configurazione Syslog. Di impostazione di <FormatMessage>true</FormatMessage>, messaggi Syslog iniziano con un numero fisso di caratteri, che ti consente di filtrare i dati inseriti da Apigee. Per ulteriori informazioni informazioni, consulta la sezione Messaggi Criterio di logging. (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 /*/ nel proxy API percorsi di base. 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 nuovi team. Tieni presente che la funzionalità /**/ non è consentita. (MGMT-3154)

concatenamento del proxy API (Cloud 16.03.02, Cloud 16.03.09 UI)

Edge supporta il concatenamento dei proxy API locali, che consente a un proxy API di chiamare un altro proxy API con deployment nella tua organizzazione Edge senza overhead di rete aggiuntivo. In precedenza, il proxy API Per il concatenamento è stata necessaria una chiamata http(s) a un altro proxy API, che ha inoltrato la richiesta tramite una bilanciatore del carico, router e processore di messaggi.

I nuovi elementi LocalTargetConnection sono disponibili nel proxy API TargetEndpoint, che consente di specificare un nome proxy API, il nome di un ProxyEndpoint specifico all'interno di un proxy API o semplicemente il percorso di base di una risorsa proxy API locale (come /v1/miarisorsa). L'interfaccia utente dell'editor proxy offre queste opzioni anche quando aggiungi o aggiorni Endpoint di destinazione.

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

Per ulteriori informazioni, consulta Chaining API Proxy insieme. Anche i nuovi elementi LocalTargetConnection sono elencati nel file XML schema 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 riportati di seguito. Questo elenco è destinato principalmente agli utenti che controllano per vedere se i ticket di assistenza sono stati risolti. Non è progettato per fornire informazioni dettagliate informazioni per tutti gli utenti.

Edge per 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 gruppo1
PRC-758 L'utente con il ruolo Utente è in grado di modificare i report personalizzati
PRC-883 L'aggiornamento sul server Postgres con la configurazione master-standby è non riuscito

Cloud 16.03.30

ID problema Descrizione
SECENG-584 Il controllo di convalida per la nuova riga tra i certificati di 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 durante i callout Java che causano la non riuscito
MGMT-3185 Errore durante l'aggiunta degli amministratori dell'organizzazione a un'organizzazione
EDGEUI-127 Ottenere autorizzazioni insufficienti con il nuovo editor proxy
EDGEUI-119 Problema di timeout della sessione della UI
CORESERV-671 Viene visualizzato il messaggio "Nessun squillo configurato; Impossibile inizializzare il servizio cps" errori
AXAPP-2345 Problema durante la creazione dell'elenco di report personalizzati AX per i clienti non CPA
AXAPP-2302 Il riepilogo giornaliero delle analisi di Apigee mostra zero risultati nella sezione Sviluppatore adozione
APIRT-2750 Errori di traffico elevati in un'organizzazione specifica
APIRT-2516 Gli errori di runtime nei callout JavaScript specificano una riga errata numeri
APIRT-2508 Errore di uscita durante la chiamata dell'ascolto express all'interno di un callback di Vault
APIRT-2336 Problema di Gzip con Node.js
APIRT-1975 Configurazioni maschera non funzionanti per message.content

UI Cloud 16.03.16

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

UI Cloud 16.03.09

ID problema Descrizione
MGMT-3158 Autorizzazioni insufficienti nella UI quando viene impostato RBAC sui singoli proxy l'API
MGMT-3142 I grafici non vengono caricati nella dashboard di Error Analysis
MGMT-3118 L'interfaccia utente mostra la configurazione errata dell'host virtuale SSL per "clientAuthEnabled" parametro
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 di Node.js è troppo dettagliato con i messaggi di log
DEVRT-2275 I piani tariffari degli attributi personalizzati mostrano solo cinque attributi anziché i dieci consentito
DEVRT-1275 Non tutti gli sviluppatori vengono visualizzati nel menu a discesa Piano tariffario
DEVRT-1074 Lo sviluppatore prepagato con saldo pari a zero genera NullpointerException quando il credito è applicata

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 il valore predefinito spazio dei nomi
MGMT-1642 Nel ruolo utente personalizzato manca "get" autorizzazione per le app sviluppatore

Problemi noti

Questa release presenta i seguenti problemi noti.

ID problema Descrizione
APIRT-2978

Il router non riesce ad avviare Nginx o il router non si avvia

Se il router perimetrale non avvia Nginx o non si avvia affatto, come mostrato /opt/apigee/var/log/edge-router/logs/system.log quindi 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 noterai che i processori di messaggi effettuano 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à:

    attiva host della cache No
PRC-1118

Errore durante l'esecuzione di "apigee-service apigee-postgresql pg-data-purge" comando

Se esegui "apigee-service apigee-postgresql pg-data-purge" e il comando viene visualizzato un errore nel modulo:

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à su 'apigee':

POSTGRES_USER=apigee

DOC-1687 A causa di un conflitto noto di dipendenza dal pacchetto, l'agente Katello utilizzato in Satellite. Server 6 non verrà installato correttamente sugli host Apigee Edge che eseguono Qpid daemon.

payload JSON in Assegna i criteri Messaggio, Callout Java e Incremento di errore

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

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

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

Tuttavia, puoi notare che il formato JSON non è valido. Per ovviare a questo problema, hai due opzioni:

  • Utilizza una barra rovesciata per far precedere la parentesi graffa di apertura:
    \{"The date is: " : "{message.header.date}"}
    
  • Nella configurazione dell'elemento payload, utilizza variablePrefix e variableSuffix per indicare una variabile in un payload JSON. Per 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 parentesi graffe per variabili nei messaggi JSON senza problemi. (APIRT-1160)

Il router non riesce ad avviare Nginx o Il router non si avvia

Se il router perimetrale non avvia Nginx o non si avvia affatto, come mostrato in /opt/apigee/var/log/edge-router/logs/system.log quindi 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