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 for Private Cloud, 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 release cloud specifica è inclusa nella tua versione di Edge for Private Cloud.

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 nell'interfaccia utente. 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) Apigee

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

Anziché utilizzare l'archivio sicuro, utilizza le mappe chiave-valore (KVM) criptate, come descritto in Utilizzo delle 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 seguenti miglioramenti, questa release contiene anche diversi miglioramenti di usabilità, prestazioni, sicurezza e stabilità.

Cloud privato

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 delle 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, in cui 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ù, consulta Impostare il timeout utilizzato dalla UI Edge per le chiamate di gestione API Edge.

(EDGEUI-816)

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 processori di messaggi e restituiscano un messaggio di errore.

Per saperne di più, consulta la sezione 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ù, vedi Gestire utenti, ruoli e autorizzazioni.

(DOS-4895)

Aggiunta 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 l'utente root e l'utente non root.

Per saperne di più, consulta la Panoramica dell'installazione di 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 la UI Edge si trova dietro un bilanciamento del carico, il nome di dominio generato automaticamente sia errato. 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 Impostare il nome host per i link nelle email generate.

(EDGEUI-1044)

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

La UI di 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, nell'interfaccia utente Edge viene visualizzato il valore "http://myCo.com":

<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, il valore predefinito, l'URL predefinito visualizzato dall'interfaccia utente Edge verrà visualizzato come: "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 di 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 release beta dell'utilità a 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 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 l'aggiornamento di una nuova installazione della versione 4.17.01 che utilizza Nginx/Postgres, la directory principale è stata modificata 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 in genere alfabetici (tutti i casi), numeri e trattini bassi.

Le entità interessate includono:

• Organizzazioni
• Ambienti
• Proxy API
• Revisioni del proxy API
• Nomi dei criteri nel proxy API
• ID configurazione maschera di traccia di debug
• Nomi delle risorse (callout Java, xsl, tutte le risorse)
• Archivi delle 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 venga rifiutato poco o nessun traffico in entrata durante il deployment, ora puoi utilizzare un'API di gestione del deployment senza tempi di inattività. La procedura è quasi identica al deployment 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ù, vedi Attivare la monetizzazione per un'organizzazione.

(DEVRT-2383)

Bug corretti

In questa release sono stati corretti i seguenti bug. Questo elenco è destinato principalmente agli utenti che vogliono verificare 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 (API Management)

Cloud 17.03.1 (UI)

Cloud 17.02.15 (UI)

Cloud 17.02.13 (runtime API)

Cloud 17.02.13 (API management)

Cloud 17.01.18 (UI)

Cloud 17.01.16 (gestione delle API)

Cloud 17.01.16 (monetizzazione)