4.17.05 - Note di rilascio di Edge per Private Cloud

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

Dalla precedente release delle funzionalità di Edge per il cloud privato, si sono verificate le seguenti release, 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.

Panoramica della release

Questa release include una serie di funzionalità degne di nota che ti aiutano a controllare e proteggere meglio le tue API, tra cui:

• I flussi condivisi supportano il deployment senza tempi di inattività.
• Ora è supportata l'eliminazione dei dati di monetizzazione per un'organizzazione.
• Altre nuove funzionalità descritte di seguito.

Per quanto riguarda il ritiro, i vault sono stati ritirati.

Il resto di questo argomento contiene i dettagli di tutte le nuove funzionalità, gli aggiornamenti e le correzioni di bug contenuti nella release.

Ritiri e deprecazioni

Le seguenti funzionalità sono state ritirate o deprecate in questa release. Per saperne di più, consulta le norme sul ritiro di Edge.

Ritirato: aggiunta di percorsi nella scheda Rendimento del proxy API

Fino a questa release, potevi passare a un proxy API nell'interfaccia utente di gestione, andare alla scheda Rendimento e creare percorsi diversi per un confronto basato su grafici nella scheda Rendimento del proxy e nella dashboard Transazioni commerciali. Questa funzionalità è stata ritirata e non è più disponibile nella UI. Per un'alternativa a questa funzionalità, consulta il seguente articolo della community Apigee: Alternativa all'API Business Transactions. (EDGEUI-902)

Ritirato: URL buildInfo per il portale Developer Services

Nelle versioni precedenti del portale, per determinare la versione del portale, aprivi il seguente URL in un browser:

http://yourportal.com/buildInfo

Nella versione 4.17.05 questo link è stato rimosso. Per determinare la versione, apri la voce di menu Report > Report sullo stato in Drupal. La versione del portale viene visualizzata nella tabella nella riga denominata Profilo di installazione.

Ritiro dell'archivio sicuro (vault) di Apigee

L'archivio sicuro Apigee, noto anche come "vault", verrà ritirato un anno dopo la data dell'annuncio di ritiro mostrata nella pagina Ritiri e ritiri. I vault, che forniscono l'archiviazione criptata di coppie chiave/valore, vengono creati con l'API di gestione e vi si accede in fase di runtime con le funzioni nel modulo Node.js apigee-access.

Anziché utilizzare l'archivio sicuro, utilizza le mappe chiave-valore (KVM) criptate, come descritto in Utilizzare le mappe chiave-valore. I KVM criptati sono sicuri quanto i vault e offrono più opzioni per la creazione e il recupero. (MGMT-3848)

Nuove funzionalità e aggiornamenti

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

Cloud privato

È stato aggiunto un nuovo parametro di configurazione SMTP obbligatorio all'installazione

Ora devi utilizzare il parametro SMTPMAILFROM nel file di configurazione dell'installazione di Edge. Questo parametro specifica l'indirizzo email utilizzato quando Edge invia email automatiche, ad esempio quando un utente richiede di reimpostare una password. Per saperne di più, consulta Installare i componenti Edge su un nodo.

(EDGEUI-1020)

Ora è possibile impostare il timeout utilizzato dalla UI Edge per le chiamate di gestione dell'API Edge

Ora puoi specificare la durata del timeout dell'API utilizzata dalla UI Edge per controllare per quanto tempo la UI attende la restituzione di una chiamata di gestione API. Le seguenti proprietà definiscono il timeout:

• conf_apigee_apigee.feature.apitimeout imposta il tempo, in secondi, durante il quale la UI attende la risposta di una chiamata al backend, indipendentemente da qualsiasi attività. Se la chiamata non viene completata entro questo periodo di tempo, l'interfaccia utente genera un errore di timeout. Il valore predefinito è 180 secondi (3 minuti).
• conf_apigee_play.ws.timeout.idle imposta per quanto tempo l'interfaccia utente attende l'attività sul server, in millisecondi. Può essere impostato sullo stesso valore di conf_apigee_apigee_apitimeout o su un valore inferiore. L'impostazione di un valore maggiore non ha alcun effetto. Il valore predefinito è 180.000 millisecondi (3 minuti).
• conf_apigee_play.ws.timeout.connection imposta per quanto tempo l'interfaccia utente attende che venga stabilita una connessione. Può essere impostato sullo stesso valore di conf_apigee_apigee_apitimeout o su un valore inferiore. L'impostazione di un valore maggiore non ha alcun effetto. Il valore predefinito è 120.000 millisecondi (2 minuti).

Per saperne di più, vedi Imposta il timeout utilizzato dall'interfaccia utente Edge per le chiamate di gestione dell'API Edge.

(EDGEUI-816)

È stato aggiunto il timeout dei nuovi tentativi del processore di messaggi ai router

È stato aggiunto un timeout in modo che i router smettano di riprovare a inviare una richiesta ai Message Processor e restituiscano un messaggio di errore.

Per saperne di più, consulta Configurazione del router per riprovare le connessioni a un processore di messaggi.

(APIRT-2912)

Aggiunta della procedura per modificare l'amministratore di sistema predefinito

Ora è inclusa la documentazione per modificare l'amministratore di sistema predefinito.

Per saperne di più, consulta Gestione di utenti, ruoli e autorizzazioni.

(DOS-4895)

È stata aggiunta la documentazione sulla separazione delle attività di installazione di Edge tra utente root e non root

La nuova documentazione descrive i passaggi per separare le attività di installazione di Edge tra utente root e non root.

Per saperne di più, consulta la Panoramica dell'installazione edge.

(DOS-4573)

Aggiunta la proprietà per impostare il nome host per i link nelle email generate

Edge invia automaticamente email in risposta a determinati eventi, ad esempio quando un utente viene aggiunto a un'organizzazione. Molte di queste email contengono un link. Ad esempio, quando un nuovo utente viene aggiunto a un'organizzazione, l'interfaccia utente Edge gli invia un'email contenente un URL di accesso nel formato:

https://domain/login

Il dominio viene determinato automaticamente da Edge ed è in genere corretto per l'organizzazione. Tuttavia, è possibile che quando l'UI Edge si trova dietro un bilanciamento del carico, il nome di dominio generato automaticamente non sia corretto. In questo caso, puoi utilizzare la proprietà conf_apigee_apigee.emails.hosturl per impostare in modo esplicito la parte del nome di dominio dell'URL generato.

Per saperne di più, consulta Impostazione del nome host per i link nelle email generate.

(EDGEUI-1044)

Impostazione dell'URL di base visualizzato dall'UI Edge per un proxy API

La UI Edge mostra l'URL di un proxy API in base alle impostazioni dell'host virtuale corrispondente alla posizione in cui viene eseguito il deployment del proxy. Questo display può includere il numero di porta del router dell'host virtuale.

Nella maggior parte dei casi, l'URL visualizzato nell'interfaccia utente di Edge è l'URL corretto per effettuare richieste esterne al proxy. Tuttavia, per alcune configurazioni, l'URL visualizzato non è corretto. Ad esempio, una qualsiasi delle seguenti configurazioni può fare in modo che l'URL visualizzato non corrisponda all'URL effettivo utilizzato per effettuare richieste esterne al proxy:

• La terminazione SSL avviene in un bilanciatore del carico
• Il mapping delle porte avviene tra un bilanciatore del carico e i router Apigee
• Un bilanciatore del carico configurato con la riscrittura del percorso

Edge per Private Cloud 4.17.05 e versioni successive supportano un attributo sull'host virtuale chiamato <BaseUrl> che consente di ignorare l'URL visualizzato dalla UI Edge. Ecco un esempio che mostra l'oggetto host virtuale con il nuovo attributo <BaseURL>. In questo esempio, il valore "http://myCo.com" viene visualizzato nell'interfaccia utente Edge:

<VirtualHost name="myVHost">
   <HostAliases>
     <HostAlias>DNS_name_or_IP:9005</HostAlias>
   </HostAliases>
   <BaseUrl>http://myCo.com</BaseUrl>
   <Interfaces/>
   <Port>9005</Port>
</VirtualHost>

Se <BaseUrl> non è impostato, l'URL predefinito visualizzato dall'interfaccia utente Edge sarà: "http://DNS_name_or_IP:9005/", mentre la configurazione dell'alias host effettivo è "http://myCo.com".

Puoi anche impostare l'URL di base quando crei un'organizzazione utilizzando la proprietà VHOST_BASEURL con l'utilità apigee-provision.

Per saperne di più, consulta Configurazione dell'accesso TLS a un'API per il cloud privato.

(EDGEUI-5008)

Aggiunta della documentazione sull'abilitazione del logging di debug

È stata aggiunta la documentazione per descrivere come attivare/disattivare il logging di debug per i componenti Edge.

Per saperne di più, consulta Attivazione della registrazione di debug.

(APIRT-4018)

Nuovo programma di installazione e sintassi dei comandi per l'utilità apigee-analytics-collector

Tutti i clienti di Edge for Private Cloud sono tenuti a inviare ad Apigee statistiche sul traffico proxy API utilizzando la versione beta dell'utilità della riga di comando apigee-analytics-collector. Questa utilità invia il report sul volume delle chiamate API ad Apigee.

Questa release di Edge contiene nuove istruzioni di installazione e sintassi dei comandi per l'utilità apigee-analytics-collector. In questa release, ora utilizzi apigee-service per installare l'utilità apigee-analytics-collector, anziché npm, e richiami l'utilità apigee-analytics-collector tramite apigee-service anziché come comando autonomo.

Per saperne di più, consulta la sezione Caricamento dei dati di traffico API su Apigee - Release beta.

Nuova directory di installazione predefinita dopo l'aggiornamento del portale Developer Services di Nginx/Postgres da una nuova installazione 4.17.01

Dopo aver aggiornato una nuova installazione della versione 4.17.01 che utilizza Nginx/Postgres, la directory principale è cambiata da:

/opt/apigee/apigee-drupal

a:

/opt/apigee/apigee-drupal/wwwroot

Servizi API

Convalida dell'input più rigorosa per le entità

È stata applicata una convalida dell'input più rigorosa a tutte le entità dell'organizzazione Apigee Edge. I caratteri consentiti sono generalmente alfabetici (tutti i casi), numeri e trattini bassi.

Le entità interessate includono:

• Organizzazioni
• Ambienti
• Proxy API
• Revisioni del proxy API
• Nomi delle policy nel proxy API
• ID configurazioni maschere di traccia di debug
• Nomi delle risorse (callout Java, xsl, tutte le risorse)
• Archivi chiavi
• CRLstores
• Riferimenti alle risorse
• Server di destinazione

(MGMT-3840)

Deployment senza tempi di inattività dei flussi condivisi

Quando vuoi eseguire il deployment di flussi condivisi e assicurarti che il traffico in entrata venga rifiutato in misura minima o nulla durante il deployment, ora puoi utilizzare un'API di gestione del deployment senza tempi di inattività. Il processo è quasi identico all'implementazione senza tempi di inattività per i proxy API utilizzando l'API Management. L'unica differenza è la risorsa API di gestione.

La seguente chiamata esegue il deployment della revisione del flusso condiviso indicata nell'URI, quindi annulla il deployment della revisione di cui è stato eseguito il deployment in precedenza (il parametro di query override=true lo consente):

curl -X POST -H "Content-type:application/x-www-form-urlencoded" \
https://api.enterprise.apigee.com/v1/o/{org_name}/environments/{env-name}/sharedflows/{shared_flow_name}/revisions/{revision_number}/deployments?"override=true" \
-u email:password

(MGMT-3485)

Monetizzazione

Eliminare i dati di monetizzazione per un'organizzazione

Potresti voler eliminare i dati di monetizzazione della tua organizzazione nei seguenti scenari:

• Elimina la tua organizzazione. In questo caso, devi eliminare i dati di monetizzazione prima di poter eliminare l'organizzazione.
• Cancella i dati di monetizzazione di un'organizzazione di test che vuoi riutilizzare. In questo caso, devi sincronizzare i dati di Apigee Edge dopo aver eliminato i dati di monetizzazione.

Per saperne di più, vedi Eliminare i dati di monetizzazione dalla tua organizzazione. (DEVRT-2581)

Aggiunta API per l'attivazione della monetizzazione per un'organizzazione

Ora puoi utilizzare un'API per attivare la monetizzazione per un'organizzazione.

Per saperne di più, consulta Attivare la monetizzazione per un'organizzazione.

(DEVRT-2383)

Bug corretti

In questa release sono stati corretti i seguenti bug. Questo elenco è principalmente destinato agli utenti che controllano se i loro ticket di assistenza sono stati risolti. Non è progettato per fornire informazioni dettagliate per tutti gli utenti.

Private Cloud 4.17.05

Cloud 17.04.12 (UI)

Cloud 17.04.05 (UI)

Cloud 17.03.29 (UI)

Cloud 17.03.15.01 (UI)

Cloud 17.03.15 (UI)

Cloud 17.03.13.02 (monetizzazione)

Cloud 17.03.13.01 (monetizzazione)

Cloud 17.03.13 (gestione delle API)

Cloud 17.03.1 (UI)

Cloud 17.02.15 (UI)

Cloud 17.02.13 (runtime API)

Cloud 17.02.13 (gestione delle API)

Cloud 17.01.18 (UI)

Cloud 17.01.16 (gestione API)

Cloud 17.01.16 (monetizzazione)