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 per 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 (OpenAPI Specification Validation) (beta) consente di convalidare un messaggio di richiesta o risposta in entrata rispetto a una specifica OpenAPI 3.0 (JSON o YAML). Per saperne di più, consulta Policy OASValidation (beta). (144949685)

Release 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).

Accedere ai valori dei secret delle policy dai secret di Kubernetes

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

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

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

Sostituire e ritirare 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à ritirate: k8sClusterName, gcpRegion e gcpProjectID. Per maggiori dettagli, vedi Riferimento per le proprietà di configurazione. (146299599)

Espansione del volume permanente per Cassandra su Kubernetes

È stata aggiunta una procedura per espandere il volume permanente utilizzato da apigee-cassandra per soddisfare le esigenze di archiviazione, senza dover aggiungere altri nodi solo per aumentare lo spazio di archiviazione. Vedi Espandere i volumi permanenti di Cassandra. (138167919)

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

Sono state aggiunte nuove proprietà di configurazione che offrono una maggiore flessibilità nel modo in cui specifichi i certificati TLS, le chiavi di crittografia e le chiavi degli 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 per le proprietà di configurazione. (145303466)

Consentire 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 a il piano di gestione. Per maggiori dettagli, vedi Offuscare i dati utente per l'analisi. (142578910)

Espandere i volumi permanenti per i set di 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 Espandere i volumi permanenti per i set di stato. (138167919)

Le versioni minime supportate di GKE, Anthos e AKS sono state aggiornate

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

Supportare TLS 1.3 per le connessioni in direzione nord

Due nuove proprietà di configurazione 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 per le proprietà di configurazione. (117580780)

Supportare la configurazione del proxy di inoltro per il runtime di hybrid

Il proxy di inoltro HTTP è ora supportato 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à consente di aggiungere più alias host a un ambiente. Utilizza questo elemento al posto di hostAlias, che è stato ritirato. Per maggiori dettagli, vedi Aggiungere più alias host a un ambiente. (150738495)

Consentire i modelli per i set di proprietà

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

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 a 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 il corretto avvio del sincronizzatore.
149867244 Piattaforma K8s Il pod apigee-cps-setup non riesce nella configurazione per più regioni
150187652 / 149117839 Runtime Impossibile utilizzare i trattini nei nomi degli ambienti.
149220463 Pod MP I proxy di cui è stato eseguito il deployment in precedenza dovevano essere sottoposti a un nuovo deployment.
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, generando 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é il processore di messaggi hybrid 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 la policy AssignMessage nel proxy API if necessario.
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 le sessioni nella risposta solo se la sessione contiene almeno una transazione.
143659917

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

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

Riepilogo: si verifica una latenza molto elevata quando utilizzi l'API o l'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).