Note di rilascio di Edge per Private Cloud 4.19.01

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

Questa sezione descrive la versione 4.19.01 della release delle funzionalità di Edge per il cloud privato.

Riepilogo della release

La tabella riportata di seguito riassume le modifiche apportate a questa release:

Nuove funzionalità

Questa release include le nuove funzioni seguenti:

○ Release di disponibilità generale (GA) della UI Edge
○ Release di disponibilità generale (GA) della monetizzazione nell'interfaccia utente Edge
apigee-monit aggiunge i servizi di riparazione automatica e monitoraggio
○ La UI Edge ha nuove proprietà di configurazione TLS
○ Ora puoi creare, modificare ed eliminare gli host virtuali nella UI di Edge
○ Supporto di OpenAPI v3 aggiunto
○ Ora sono supportati RedHat Enterprise Linux (RHEL) e CentOS 7.6
○ Ora Oracle Linux 7.5 è supportato

Per ulteriori informazioni su ciascuna di queste nuove funzionalità, vedi Nuove funzionalità.

Release incluse

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

○ Edge:
18.06.08
18.06.06
18.05.21
18.05.10
18.05.09
18.04.23.00
○ Portale:
18.11.28.00
18.10.17.00
18.10.09.00
18.07.16.00
Pensioni Nessuno
Deprecazioni La versione 4.17.09 di Apigee Edge per il cloud privato non è più supportata (deprecata).

Per ulteriori informazioni, vedi Ritiri, ritiri e CPS di Apigee modifiche.

Correzioni di bug

Questa release include le seguenti correzioni di bug:

○ Zookeeper non è stato interrotto dallo script di backup (122694069)
○ "Nessuna organizzazione" pagina di destinazione aggiunta (120993451)
○ Eliminazione di report personalizzati (120682369)
○ Scheda Mappa geografica nella nuova esperienza Edge (120681592)
○ Opzioni JVM Zookeeper (120624977)
○ Si sono verificati errori non definiti nelle descrizioni comando (80187407)
○ Creazione di proxy inversi tramite OpenAPI (79949124)
○ La reimpostazione delle password non invia link (77515655)
○ Intestazioni errate per i link di reimpostazione della password (72799769)
○ Utilizzo di WSDL per creare proxy API (69550284)

Per ulteriori informazioni su ciascuna di queste correzioni, vedi Correzioni di bug.

Problemi noti

Questa release include i seguenti problemi noti:

○ Formato file di metadati per installazione apigee-sso (135616498)
apigee-monit non supportato su Amazon Linux 1 (122370980)
○ Il backup del processore di messaggi non esegue il backup del set di file corretto (121095148)
○ Token di sessione non invalidati (115278838)
○ Le operazioni di Cassandra non funzionano quando è abilitata l'autenticazione JMX (113342838)
○ Blocco delle richieste HEAD alle destinazioni Node.js (79993247)
○ Nomi host che non vengono risolti (79757554)
○ DataAccessEccezioni nelle configurazioni di più data center (76087166)
○ Criterio MessageLogging, incluse informazioni aggiuntive nel messaggio di log (68722102)
○ La reimpostazione della password dell'amministratore di sistema non riesce (65737520)

Per ulteriori informazioni su ciascuno di questi problemi noti, incluse le soluzioni alternative, vedi Problemi noti.

Percorsi di upgrade

La tabella seguente mostra i percorsi di upgrade per questa release:

Dal 18/04/05 Upgrade diretto dal 18/04/05 → 19/04/01
Dal 18.4.01 Upgrade diretto dal 18/04/01 → 19/04/01
Dal 17/04/09 Upgrade diretto dal 17/04/09 → 19/04/01
Dal 17.04.05 Esegui l'upgrade da 4.17.05 → 4.18.01, quindi esegui l'upgrade dalla versione 18.4.01 → 19.04.01
Dal 17/04/01 Esegui l'upgrade da 4.17.01 → 4.18.01, quindi esegui l'upgrade dalla versione 18.4.01 → 19.04.01
Dal 16/04/09 Upgrade da 4.16.09 → 4.18.01, quindi esegui l'upgrade dalla versione 18.4.01 → 19.04.01
Dal 16/04/05 Esegui l'upgrade da 4.16.05 → 4.18.01, quindi esegui l'upgrade dalla versione 18.4.01 → 19.04.01
Dal 16/04/01 Esegui l'upgrade da 4.16.01 → 4.18.01, quindi esegui l'upgrade dalla versione 18.4.01 → 19.04.01
Da 4.15.0x Esegui l'upgrade da 4.15.0x → 4.16.01, quindi esegui l'upgrade da Upgrade dalla 4.16.01 → 4.18.01, quindi esegui l'upgrade dalla versione 18.4.01 → 19.4.01

Nuove funzionalità

In questa sezione sono elencate le nuove funzioni di questa release. Inoltre, questa release include tutti dell'interfaccia utente di Edge, di Edge Management e delle release del portale elencate in Release incluse.

Oltre ai miglioramenti riportati di seguito, questa release contiene anche diverse funzioni di usabilità, miglioramenti a prestazioni, sicurezza e stabilità.

Release di disponibilità generale (GA) dell'interfaccia utente Edge

La UI di Apigee Edge è il nostro più recente servizio di UI di gestione. In precedenza, era a in versione beta. Con la versione 4.19.01 di Apigee Edge per il cloud privato, la UI Edge fa parte della release generale.

Per utilizzare la UI Edge, devi abilitare SAML e installare la UI Edge sul relativo nodo.

Per ulteriori informazioni, vedi L'UI Edge per Cloud privato.

Release di disponibilità generale (GA) della monetizzazione nell'interfaccia utente di Edge

È ora disponibile la versione GA della funzionalità Monetizzazione nell'interfaccia utente della nuova esperienza Edge.

Ora puoi gestire tutte le attività di monetizzazione per Apigee Edge per il cloud privato nella UI della nuova esperienza Edge, tra cui: le seguenti:

Con questo annuncio, i report sulle variazioni della monetizzazione sono stati ufficialmente ritirati. Consulta Ritiri di Apigee.

apigee-monit aggiunge servizi di auto-guarigione e monitoraggio

Apigee Edge per il cloud privato ora include apigee-monit, uno strumento basato sull'open source utilità di monitoraggio. apigee-monit esegue periodicamente il polling di Edge servizi; se un servizio non è disponibile, apigee-monit tenta di riavviarlo.

Per informazioni sull'installazione, la configurazione e l'utilizzo di apigee-monit, vedi Riparazione automatica con apigee-monit.

Nuove proprietà di configurazione TLS

La UI Edge supporta le nuove proprietà di configurazione TLS che puoi utilizzare per impostare quanto segue:

  • Protocollo TLS predefinito
  • Elenco dei protocolli TLS supportati
  • Algoritmi TLS supportati
  • Crittografia TLS supportata

Per ulteriori informazioni, vedi Impostazione di proprietà TLS facoltative.

Crea, modifica ed elimina host virtuali nella UI di Edge

La funzionalità self-service è stata ampliata per consentirti di creare, modificare ed eliminare host virtuali in un browser (solo UI Edge).

Per ulteriori informazioni, vedi Crea un host virtuale utilizzando un browser.

Supporto di OpenAPI v3 aggiunto

In questa release è stato aggiunto il supporto per la creazione di un proxy tramite OpenAPI versione 3 (solo per Edge UI).

Software supportato

Questa release include le seguenti modifiche al software supportato:

Supporto aggiunto Non più supportato

Questa release aggiunge il supporto per le seguenti piattaforme:

  • Red Hat Enterprise Linux (RHEL) 7.6
  • CentOS 7.6
  • Oracle Linux 7.6

Le seguenti piattaforme non sono più supportate con questa release:

  • RHEL/CentOS/Oracle versione 7.3
  • RHEL/CentOS versione 6.8
  • Oracle Linux 6.7

Per un elenco completo delle piattaforme supportate, vedi Software supportati e versioni supportate.

Correzioni di bug

In questa sezione sono elencati i bug del cloud privato risolti in questa release. Inoltre, questo include tutte le correzioni di bug nell'UI di Edge, in Edge Management e nelle release del portale mostrate in Release incluse.

ID problema Descrizione
122694069

Zookeeper non è stato interrotto dallo script di backup

Il processo Zookeeper non era interrotta dallo script di backup prima di questa correzione.
120993451

"Nessuna organizzazione" pagina di destinazione aggiunta

Sviluppatori che accedono con un utente a cui non è associata alcuna organizzazione non vengono più inviati a una pagina che non esiste. R per questi utenti è stata aggiunta una nuova pagina di destinazione.
120682369

Eliminare i report personalizzati

Gli utenti non possono eliminare i report personalizzati nel nuovo Edge un'esperienza senza intervento manuale.
120681592

Scheda Mappa geografica nella nuova esperienza Edge

Quando gli utenti sono arrivati alla scheda Mappa geografica nel Nuova esperienza Edge, la nuova esperienza Edge ha generato un errore.
120624977

Opzioni JVM di Zookeeper

Impostazione delle opzioni JVM utilizzando Codice con configurazione per Zookeeper non funzionava.
80187407

Si sono verificati errori non definiti nelle descrizioni comando

Quando un grafico aveva una sola serie temporale, le descrizioni comando generavano errori non definiti.
79949124

Creazione di proxy inversi tramite OpenAPI

La sezione Usa OpenAPI durante la creazione dei proxy non funzionava.
77515655

Reimpostare le password senza inviare link

Gli utenti non ricevevano email quando richiedendo un link per reimpostare le password.
72799769

Intestazioni errate per i link di reimpostazione della password

Anche dopo che un utente ha impostato il parametro trustxforwarded in true, le intestazioni delle richieste risultanti non utilizzavano HTTPS.
69550284

Utilizzo di WSDL per creare proxy API

La generazione del proxy API non riusciva durante l'utilizzo WSDL.

Problemi noti

Nella tabella seguente sono elencati i problemi noti di questa release:

ID problema Descrizione
135616498

Formato file di metadati per installazione apigee-sso

Quando installi apigee-sso e utilizzi un file metadata.xml anziché un URL, se il file metadata.xml non include una nuova riga (CRLF) alla fine del file, il file metadata.xml non viene letto completamente.

Soluzione:

Per aggirare il problema, puoi procedere in uno dei seguenti modi:

  • Aggiungi un CRLF alla fine del file metadata.xml

    OPPURE

  • Utilizza una posizione basata su URL per i metadati
122370980

apigee-monit non supportato su Amazon Linux 1

Soluzione:

Nessuno.
121095148

Il backup del processore di messaggi non esegue il backup del set di file corretto

Soluzione:

Esegui il backup una seconda volta. Il backup dovrebbe essere del set di file corretto.

115278838

Token di sessione non invalidati

I token di sessione non vengono invalidati sul server quando l'utente fa clic sul pulsante di disconnessione di Apigee Edge.

Soluzione:

Utilizza la nuova esperienza Edge con SAML.

113342838

Le operazioni di Cassandra non funzionano quando l'autenticazione JMX è abilitata

Soluzione:

Aggiungi il tuo nome utente e la tua password ogni volta che richiami il comando nodetool.

79993247

Blocco di HEAD richieste alle destinazioni Node.js

Le richieste HEAD a una destinazione Node.js possono bloccarsi, lasciando le connessioni in attesa.

Soluzione:

Per aggirare il problema, definisci un gestore per le richieste HEAD che restituisca una risposta vuota in modo esplicito.

79757554

I nomi host non vengono risolti

Dopo l'installazione o l'upgrade di Edge per il cloud privato, i nomi host potrebbero non risolversi nei loro indirizzi.

Soluzione:

Per risolvere il problema, riavvia il componente UI Edge:

/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
76087166

DataAccessException in più configurazioni di data center

In più configurazioni di data center, se un datastore non è più disponibile, potresti notare il seguente errore:

DataAccessException: Error while accessing datastore;
Please retry later

Il risultato è che il server di gestione potrebbe non avviarsi perché sta tentando di connettersi a Cassandra in dc-1 e dc-2. DataAccessExceptions si verifica se un nodo Cassandra è verso il basso. Ciò potrebbe causare un'interruzione del traffico delle API, per le quali i processori di messaggi segnalano DataAccessExceptions durante il tentativo di recuperare le KVM.

Tieni presente che lo stato previsto prevede che il server di gestione non si connetta ai componenti del datastore tra regioni diverse.

Soluzione alternativa

La soluzione alternativa è annullare la registrazione dei seguenti tipi di nodi Cassandra nel data center non disponibile e poi registrali di nuovo quando i nodi Cassandra saranno di nuovo disponibili:

  • kms-datastore
  • dc-datastore
  • keyvaluemap-datastore

Per annullare la registrazione e ripetere la registrazione di questi tipi di nodi Cassandra:

  1. Ottieni gli UUID dei nodi Cassandra utilizzando il seguente comando curl:
    curl -u ADMIN_EMAIL:ADMIN_PW \
      "http://MS_IP:MS_PORT/v1/servers?region=REGION&pod=GATEWAY_POD \
      &type=CASSANDRA_NODE_TYPE"

    Dove:

    • ADMIN_EMAIL e ADMIN_PW sono le credenziali della tua piattaforma Apigee .
    • MS_IP e MS_PORT sono l'indirizzo IP e la porta del server di gestione numero.
    • REGION è il nome del data center in cui si trova il server di gestione individuarlo.
    • GATEWAY_POD è il nome del pod, che per impostazione predefinita è "gateway". Potresti avere è stato rinominato diversamente, quindi controlla l'implementazione.
    • CASSANDRA_NODE_TYPE è uno di kms-datastore, dc-datastore, e keyvaluemap-datastore.

    Ad esempio:

    curl -u nickdanger@google.com:myP@$$w0rD
      "http://192.168.0.1:8080/v1/servers?region=dc-1&pod=gateway&type=dc-datastore"

    La risposta utilizza il seguente formato:

    {
      "internalIP" : "POD_IP_ADDRESS",
      "isUp" : [true|false],
      "pod" : "GATEWAY_POD",
      "reachable" : [true|false],
      "region" : "dc-1",
      "tags" : {
        "property" : [ ]
      },
      "type" : [ "kms-datastore", "dc-datastore", "keyvaluemap-datastore" ],
        "uUID" : "POD_UUID"
    }

    Ad esempio:

    {
      "internalIP" : "192.168.1.11",
      "isUp" : false,
      "pod" : "gateway",
      "reachable" : false,
      "region" : "dc-1",
      "tags" : {
        "property" : [ ]
      },
      "type" : "dc-datastore",
      "uUID" : "13cee956-d3a7-4577-8f0f-1694564179e4"
    }

    Prendi nota dei valori del campo uUID nella risposta. Le utilizzerai per annullare la registrazione dei nodi.

  2. Ripeti il primo passaggio per ciascun tipo di nodo Cassandra: kms-datastore. dc-datastore e keyvaluemap-datastore. Prendi nota delle UUID restituiti.
  3. Annulla la registrazione dei nodi utilizzando il comando seguente:
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers/UUID" -X DELETE

    Dove UUID è l'UUID restituito nella risposta del comando precedente.

  4. Ripeti il passaggio 3 per ogni UUID raccolto nei passaggi 1 e 2.
  5. Registra di nuovo i nodi utilizzando il comando seguente:
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers -d \
      "Type=kms-datastore&Type=dc-datastore&Type=keyvaluemap-datastore& \
      Type=counter-datastore&Type=cache-datastore&InternalIP=POD_IP_ADDRESS& \
      region=REGION&pod=GATEWAY_POD" -H \
      'content-type: application/x-www-form-urlencoded' -X POST

Tieni presente che queste operazioni registrano e annullano la registrazione dei nodi da Zookeeper e non hanno un impatto sul cluster Cassandra. Per ulteriori informazioni su questi comandi, vedi Aggiorna le registrazioni dei datastore.

68722102

Criterio MessageLogging, incluse informazioni aggiuntive nel messaggio di log

L'elemento FormatMessage del criterio MessageLogging controlla il formato del messaggio registrato. Quando FormatMessage=false, il messaggio registrato non dovrebbe includere informazioni generate da Apigee. Tuttavia, anche se imposti FormatMessage=false, il messaggio di log include comunque le seguenti informazioni:

  • Il punteggio di priorità
  • Il timestamp

Soluzione:

Nessuno.
65737520

La reimpostazione della password dell'amministratore di sistema non va a buon fine

La reimpostazione della password dell'amministratore di sistema per il server di gestione che contiene caratteri speciali avrà esito negativo.

Soluzione:

Definisci la password in un file di dati che poi passerai all'endpoint /users nell'API di gestione. Per ulteriori informazioni, vedi Reimpostazione della password dell'amministratore di sistema.

Passaggio successivo

Per iniziare a utilizzare Edge per il cloud privato 4.19.01, usa i seguenti link:

Nuove installazioni:
Panoramica della nuova installazione
Installazioni esistenti:
Percorsi di upgrade