Configura la nuova UI di Edge

Questo documento descrive come installare e configurare la nuova UI di Edge per Apigee Edge per Private Cloud. Nella versione 4.54.00, la nuova UI di Edge è costituita da due componenti RPM:

  • edge-management-ui: il server di backend della nuova UI di Edge.
  • edge-management-ui-static: gli asset web statici per il frontend della nuova UI di Edge.

La nuova UI di Edge viene installata per impostazione predefinita quando esegui setup.sh con il aio (all-in-one), sa (standalone) o ms (Management Server) oppure può essere installata in modo indipendente su un nodo utilizzando il profilo ue.

Prerequisiti

Prima di installare o configurare la New Edge UI in un'installazione di Apigee Edge for Private Cloud, assicurati che il nodo soddisfi i seguenti requisiti:

  • Requisiti hardware e del sistema operativo:
    • 4 GB di RAM
    • 2 core della CPU
    • 60 GB di spazio su disco
    • La versione 4.54.00 dell'utilità apigee-setup installata sul nodo come descritto in Installare l'utilità apigee-setup di Edge.
    • La porta 3001 deve essere aperta. Questa è la porta predefinita utilizzata per le richieste alla nuova UI di Edge. Se modifichi la porta utilizzando le proprietà descritte in File di configurazione della nuova UI di Edge, assicurati che la porta sia aperta.
  • Autenticazione:
    • Autenticazione di base (impostazione predefinita): abilitata per impostazione predefinita (AUTH_MODE=basic). Utilizza le credenziali di Edge Management Server e SymasLDAP senza richiedere un provider di identità (IdP) esterno.
    • SSO / IdP esterno (facoltativo): puoi configurare facoltativamente Apigee SSO o un IdP esterno (ad esempio SAML o OIDC). Se ti connetti a un IdP esterno tramite TLS, l'IdP deve supportare TLS v1.2 o versioni successive.

Per ulteriori informazioni sulle funzionalità della nuova UI di Edge, consulta La nuova UI di Edge per Private Cloud.

Panoramica dell'installazione e della configurazione

A livello generale, la procedura per installare o riconfigurare la nuova UI di Edge utilizzando il ue profilo è la seguente:

  • Assicurati che l'utilità apigee-setup sia installata sul nodo.
  • Crea un file di configurazione silenzioso e modificalo con le tue impostazioni.
  • Esegui /opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile. Vengono installati e configurati sia edge-management-ui sia edge-management-ui-static.
  • Accedi e testa la nuova UI di Edge all'indirizzo http://new_edge_UI_IP:3001.

Se il server Management Server e il server della nuova UI di Edge si trovano dietro un bilanciatore del carico con la terminazione TLS sul bilanciatore del carico, assicurati che la configurazione rifletta le proprietà evidenziate in Configurare la nuova UI di Edge quando TLS termina sul bilanciatore del carico.

File di configurazione della nuova UI di Edge

L'esempio seguente mostra un file di configurazione per l'installazione e la configurazione della nuova UI di Edge con l'autenticazione di base predefinita.

Configurazione dell'autenticazione di base (impostazione predefinita)

# IP of the Edge Management Server.
IP1=management_server_IP

# IP of the New Edge UI node (can be the same as IP1 or a separate node).
IP2=new_edge_UI_server_IP

# Edge sys admin credentials.
ADMIN_EMAIL=your@email.com
APIGEE_ADMINPW=your_password    # If omitted, you are prompted for it.

# Edge Management Server information.
APIGEE_PORT_HTTP_MS=8080
MSIP=$IP1
MS_SCHEME=http

#
# New Edge UI configuration.
#
MANAGEMENT_UI_PORT=3001
MANAGEMENT_UI_IP=$IP2
MANAGEMENT_UI_APP_ENV=OPDK
MANAGEMENT_UI_SCHEME=http
MANAGEMENT_UI_PUBLIC_URIS=$MANAGEMENT_UI_SCHEME://$MANAGEMENT_UI_IP:$MANAGEMENT_UI_PORT

# Authentication mode (basic is default)
AUTH_MODE=basic

## SMTP Configuration
SKIP_SMTP=n       # Skip now and configure later by specifying "y".
SMTPHOST=smtp.example.com
SMTPUSER=your@email.com
SMTPPASSWORD=your_email_password
SMTPSSL=y
SMTPPORT=465      # If no SSL, use a different port, such as 25.
SMTPMAILFROM="My Company <myco@company.com>"

Installare o configurare la nuova UI di Edge

Per installare o configurare la nuova UI di Edge utilizzando il profilo ue:

  1. Accedi al nodo di destinazione come amministratore.
  2. Installa la versione 4.54.00 dell'utilità apigee-setup sul nodo, come descritto in Installare l'utilità apigee-setup di Edge.
  3. Pulisci tutte le informazioni memorizzate nella cache con Yum eseguendo il seguente comando: 
    sudo yum clean all
  4. Crea il file di configurazione come descritto in File di configurazione della nuova UI di Edge e assicurati che sia di proprietà dell"utente "apigee": 
    chown apigee:apigee configFile
  5. Sul nodo, esegui il seguente comando: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile

    L'utilità apigee-setup installa e configura edge-management-ui e edge-management-ui-static.

  6. Accedi alla nuova UI di Edge aprendo il seguente URL in un browser: 
    http://new_edge_UI_IP:3001

    Dove new_edge_UI_IP è l'indirizzo IP o il nome host del nodo che ospita la nuova UI di Edge.

  7. Inserisci le tue credenziali.

    Viene visualizzata la nuova UI di Edge. Per informazioni sull'utilizzo della nuova UI di Edge, consulta La nuova UI di Edge per cloud privato.

    Se la nuova UI di Edge non viene visualizzata, assicurati che la porta 3001 sia aperta per le connessioni.

Facoltativo: se vuoi configurare Apigee SSO per l' autenticazione, segui i passaggi descritti in Installare e configurare Apigee SSO e Abilitare un IdP esterno nella nuova UI di Edge.

Disinstallare la nuova UI di Edge

Per disinstallare la nuova UI di Edge da un nodo, disinstalla i componenti edge-management-ui e edge-management-ui-static.

Per disinstallare i componenti della nuova UI di Edge:

/opt/apigee/apigee-service/bin/apigee-service edge-management-ui uninstall
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui-static uninstall

Per rimuovere tutti i componenti di Edge dal nodo:

  1. Arresta tutti i servizi Edge in esecuzione sulla macchina: 
    /opt/apigee/apigee-service/bin/apigee-all stop
  2. Cancella la cache di yum: 
    sudo yum clean all
  3. Rimuovi tutti gli RPM di Apigee: 
    sudo rpm -e $(rpm -qa | egrep "(apigee-|edge-)")
  4. Rimuovi la directory principale di installazione: 
    sudo rm -rf /opt/apigee