1.2.0 - Note di rilascio del runtime ibrido Apigee

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

Il 3 aprile 2020 abbiamo rilasciato la versione 1.2.0 del runtime di Apigee hybrid.

Upgrade in corso

Nuove funzionalità e aggiornamenti

Di seguito sono riportate le nuove funzionalità e gli aggiornamenti di questa release.

È stata aggiunta una nuova configurazione dell'host virtuale per specificare le regole di routing

La nuova funzionalità di configurazione virtualhosts risolve un problema in cui l'ordine in cui i percorsi di base venivano indirizzati a più ambienti era incerto. Per maggiori dettagli, vedi Configurare gli host virtuali. (150336519)

Release beta della policy OASValidation

La policy OASValidation (convalida della specifica OpenAPI) (beta) consente di convalidare un messaggio di richiesta o risposta in entrata in base a una specifica OpenAPI 3.0 (JSON o YAML). Per saperne di più, consulta le norme di convalida OAS (beta). (144949685)

Versione beta del supporto di WebSocket

Apigee hybrid supporta le connessioni WebSocket. I client proxy API ora possono richiedere un upgrade del protocollo da HTTP a WebSocket. Per maggiori dettagli, vedi Utilizzo di WebSocket (beta).

Accesso ai valori dei secret delle policy dai secret Kubernetes

Una nuova funzionalità ti consente di accedere ai valori archiviati in un secret Kubernetes nelle variabili di flusso del proxy. Per maggiori dettagli, vedi Archiviazione dei dati in un secret Kubernetes. (133377603)

L'elemento Apigee Operators (AO) sostituisce ADAC e ADAH

Apigee Operators (AO) crea e aggiorna le risorse Kubernetes e Istio di basso livello necessarie per eseguire il deployment e la manutenzione dell'AD. Ad esempio, il controller esegue il rilascio dei processori di messaggi. Inoltre, convalida la configurazione ApigeeDeployment prima di renderla persistente nel cluster Kubernetes. AO sostituisce Apigee Deployment Admissionhook (ADAH) e Apigee Deployment Controller (ADC). Consulta ao in Riferimento per le proprietà di configurazione. (151250559)

Sostituisci e ritira alcune proprietà di configurazione di cluster e progetti

Sono state aggiunte due nuove proprietà di configurazione: k8sCluster e gcp. Queste proprietà sostituiscono le seguenti proprietà deprecate: k8sClusterName, gcpRegion e gcpProjectID. Per maggiori dettagli, consulta Riferimento per le proprietà di configurazione. (146299599)

Espansione del volume permanente per Cassandra su Kubernetes

È stato aggiunto un processo per espandere il volume persistente utilizzato da apigee-cassandra per soddisfare le esigenze di archiviazione, senza dover aggiungere altri nodi solo per aumentare lo spazio di archiviazione. Consulta Espansione di volumi Cassandra permanenti. (138167919)

Supportare origini aggiuntive per certificati, chiavi di crittografia e service account

Sono state aggiunte nuove proprietà di configurazione che offrono maggiore flessibilità nel modo in cui specificare certificati TLS, chiavi di crittografia e chiavi dell'account di servizio. Le nuove proprietà sono elencate di seguito:

  • kmsEncryptionPath
  • kmsEncryptionSecret.key
  • kmsEncryptionSecret.name
  • cassandra.backup.serviceAccountSecretRef
  • cassandra.restore.serviceAccountSecretRef
  • envs[].cacheEncryptionPath
  • envs[].cacheEncryptionSecret.key
  • envs[].cacheEncryptionSecret.name
  • envs[].kmsEncryptionPath
  • envs[].kmsEncryptionSecret.key
  • envs[].kmsEncryptionSecret.name
  • envs[].serviceAccountSecretRefs.synchronizer
  • envs[].serviceAccountSecretRefs.udca
  • envs[].sslSecret
  • logger.serviceAccountSecretRef
  • mart.serviceAccountSecretRef
  • mart.sslSecret
  • metrics.serviceAccountSecretRef
  • synchronizer.serviceAccountSecretRef
  • udca.serviceAccountSecretRef

Per saperne di più, consulta il riferimento alle proprietà di configurazione. (145303466)

Consenti ai clienti di offuscare i dati prima di inviarli ad Analytics

È stata aggiunta una funzionalità che consente di offuscare determinati dati di analisi prima che vengano inviati al piano di gestione. Per maggiori dettagli, vedi Offuscare i dati utente per l'analisi. (142578910)

Espandi i volumi permanenti per i set con stato

È stata aggiunta una funzionalità che consente di espandere il volume permanente utilizzato da apigee-cassandra per soddisfare le esigenze di archiviazione, senza aggiungere ulteriore potenza di calcolo. Per saperne di più, consulta Espandi i volumi permanenti per i set con stato. (138167919)

Viene eseguito l'upgrade delle versioni minime supportate di GKE, Anthos e AKS

Apigee Hybrid ora supporta GKE 1.14.x, Anthos 1.2 e AKS 1.14.x. (149578101)

Supporto di TLS 1.3 per le connessioni Northbound

Due nuove proprietà di configurazione ti consentono di impostare la versione TLS minima e massima per l'ingresso: ingress.minTLSProtocolVersion e maxTLSProtocolVersion. I valori possibili sono 1.0, 1.1, 1.2 e 1.3. Per saperne di più, consulta il riferimento alle proprietà di configurazione. (117580780)

Supporto della configurazione del proxy di inoltro per il runtime ibrido

Ora è supportato il proxy di inoltro HTTP per i proxy API di cui è stato eseguito il deployment in un ambiente. Per maggiori dettagli, vedi Configurare il proxy di inoltro. (148970527)

Supportare più hostAliases per ambiente

È stata aggiunta una nuova proprietà di configurazione, envs[].hostAliases. Questa proprietà ti consente di aggiungere più alias host a un ambiente. Utilizza questo elemento anziché hostAlias, che è stato ritirato. Per maggiori dettagli, vedi Aggiungere più alias host a un ambiente. (150738495)

Consenti i modelli per i set di proprietà

È stato aggiunto un nuovo elemento <PropertySetRef> all'elemento <AssignVariable> del criterio <AssignMessage>. <PropertySetRef> ti consente di creare dinamicamente una coppia chiave/nome del set di proprietà. Questa funzionalità è disponibile solo per i proxy API di cui è stato eseguito il deployment su Apigee Hybrid. Vedi AssignVariable. (148612340)

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.

ID problema Nome componente Descrizione
147958049 Runtime È stato risolto un problema di sincronizzazione nella sequenza di avvio del runtime che a volte impediva l'avvio corretto del sincronizzatore.
149867244 Piattaforma K8S Pod apigee-cps-setup non riuscito nella configurazione multiregionale
150187652 / 149117839 Runtime Impossibile utilizzare trattini nei nomi degli ambienti.
149220463 MP pod I proxy precedentemente implementati dovevano essere nuovamente implementati.
144321144 Runtime Impossibile ricaricare i proxy con host virtuali sicuri.
147685310 Runtime Errori di inizializzazione del sincronizzatore dovuti al recupero non riuscito del token GCP durante l'inizializzazione.
151115900 Runtime Il probe interno periodico non veniva eseguito per HybridMART, il che comportava risultati falsi positivi.

Problemi noti

La tabella seguente descrive i problemi noti per questa release:

Problema Descrizione
N/D

Errore di intestazione HTTP non valida: l'ingresso Istio passa tutte le risposte di destinazione in entrata al protocollo HTTP2. Poiché l'elaboratore di messaggi ibrido supporta solo HTTP1, potresti visualizzare il seguente errore quando viene chiamato un proxy API:

http2 error: Invalid HTTP header field was received: frame type: 1, stream: 1,
   name: [:authority], value: [domain_name]

Se visualizzi questo errore, puoi eseguire una delle seguenti azioni per correggere il problema:

  • Modifica il servizio di destinazione in modo da omettere l'intestazione Host nella risposta.
  • Se necessario, rimuovi l'intestazione Host utilizzando il criterio AssignMessage nel proxy API.
144584813 Se crei una sessione di debug, ma la sessione non contiene ancora transazioni, l' API List Debug Sessions non include la sessione in questo elenco. L'API include nella risposta solo le sessioni che contengono almeno una transazione.
143659917

L'impostazione di scadenza della policy PopulateCache deve essere impostata su un valore esplicito compreso tra 1 e 30. Ad esempio:

<ExpirySettings>
  <TimeoutInSec>30</TimeoutInSec>
</ExpirySettings>
133192879

Riepilogo: si verifica una latenza molto elevata quando utilizzi l'API o la UI per ottenere lo stato di deployment della tua organizzazione. Questa latenza può comportare una risposta HTTP 204 (No Content) o HTTP 400 (Bad Request).

Soluzione alternativa: aggiorna il browser (o invia di nuovo la richiesta).