Configurer la nouvelle interface utilisateur Edge

Ce document explique comment installer et configurer la nouvelle interface utilisateur Edge pour Apigee Edge pour un cloud privé. Dans la version 4.54.00, la nouvelle interface utilisateur Edge se compose de deux composants RPM :

  • edge-management-ui : serveur backend de la nouvelle interface utilisateur Edge.
  • edge-management-ui-static : éléments Web statiques pour le frontend de la nouvelle interface utilisateur Edge.

La nouvelle interface utilisateur Edge est installée par défaut lorsque vous exécutez setup.sh avec le aio (tout-en-un), sa (autonome) ou ms (serveur de gestion). Vous pouvez également l'installer indépendamment sur un nœud à l'aide du profil ue.

Prérequis

Avant d'installer ou de configurer la nouvelle interface utilisateur Edge dans une installation Apigee Edge for Private Cloud, assurez-vous que le nœud répond aux exigences suivantes :

  • Configuration matérielle et système d'exploitation requises :
  • Authentification :
    • Authentification de base (par défaut) : activée par défaut (AUTH_MODE=basic). Utilise les identifiants du serveur de gestion Edge et de SymasLDAP sans nécessiter de fournisseur d'identité externe.
    • SSO / fournisseur d'identité externe (facultatif) : vous pouvez éventuellement configurer l'authentification unique Apigee ou un fournisseur d'identité externe (tel que SAML ou OIDC). Si vous vous connectez à un fournisseur d'identité externe via TLS, celui-ci doit être compatible avec TLS v1.2 ou une version ultérieure.

Pour en savoir plus sur les fonctionnalités de la nouvelle interface utilisateur Edge, consultez La nouvelle interface utilisateur Edge pour un cloud privé.

Présentation de l'installation et de la configuration

De manière générale, le processus d'installation ou de reconfiguration de la nouvelle interface utilisateur Edge à l'aide du ue profil est le suivant :

  • Assurez-vous que l'utilitaire apigee-setup est installé sur le nœud.
  • Créez un fichier de configuration silencieux et modifiez-le avec vos paramètres.
  • Exécutez /opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile. Cela installe et configure edge-management-ui et edge-management-ui-static.
  • Connectez-vous et testez la nouvelle interface utilisateur Edge à l'adresse http://new_edge_UI_IP:3001.

Si votre serveur de gestion et votre serveur de nouvelle interface utilisateur Edge se trouvent derrière un équilibreur de charge avec déchargement TLS se produisant au niveau de l'équilibreur de charge, assurez-vous que la configuration reflète les propriétés mises en évidence dans Configurer la nouvelle interface utilisateur Edge lorsque TLS se termine sur l'équilibreur de charge.

Fichier de configuration de la nouvelle interface utilisateur Edge

L'exemple suivant montre un fichier de configuration pour l'installation et la configuration de la nouvelle interface utilisateur Edge avec l'authentification de base par défaut.

Configuration de l'authentification de base (par défaut)

# 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>"

Installer ou configurer la nouvelle interface utilisateur Edge

Pour installer ou configurer la nouvelle interface utilisateur Edge à l'aide du profil ue :

  1. Connectez-vous au nœud cible en tant qu'administrateur.
  2. Installez la version 4.54.00 de l'utilitaire apigee-setup sur le nœud, comme décrit dans Installer l'utilitaire apigee-setup Edge.
  3. Nettoyez toutes les informations mises en cache avec Yum en exécutant la commande suivante : 
    sudo yum clean all
  4. Créez le fichier de configuration comme décrit dans Fichier de configuration de la nouvelle interface utilisateur Edge et assurez-vous qu'il appartient à l'utilisateur "apigee" : 
    chown apigee:apigee configFile
  5. Sur le nœud, exécutez la commande suivante : 
    /opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile

    L'utilitaire apigee-setup installe et configure edge-management-ui et edge-management-ui-static.

  6. Connectez-vous à la nouvelle interface utilisateur Edge en ouvrant l'URL suivante dans un navigateur : 
    http://new_edge_UI_IP:3001

    Où new_edge_UI_IP correspond à l'adresse IP ou au nom d'hôte du nœud hébergeant la nouvelle interface utilisateur Edge.

  7. Saisissez vos identifiants.

    La nouvelle interface utilisateur Edge s'affiche. Pour savoir comment utiliser la nouvelle interface utilisateur Edge, consultez La nouvelle interface utilisateur Edge pour un cloud privé.

    Si la nouvelle interface utilisateur Edge ne s'affiche pas, assurez-vous que le port 3001 est ouvert pour les connexions.

Facultatif : Si vous souhaitez configurer l'authentification unique Apigee pour l' authentification, suivez les étapes décrites dans Installer et configurer l'authentification unique Apigee et Activer un fournisseur d'identité externe sur la nouvelle interface utilisateur Edge.

Désinstaller la nouvelle interface utilisateur Edge

Pour désinstaller la nouvelle interface utilisateur Edge d'un nœud, désinstallez les composants edge-management-ui et edge-management-ui-static.

Pour désinstaller les composants de la nouvelle interface utilisateur Edge :

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

Pour supprimer tous les composants Edge du nœud :

  1. Arrêtez tous les services Edge en cours d'exécution sur la machine : 
    /opt/apigee/apigee-service/bin/apigee-all stop
  2. Effacez le cache yum : 
    sudo yum clean all
  3. Supprimez tous les RPM Apigee : 
    sudo rpm -e $(rpm -qa | egrep "(apigee-|edge-)")
  4. Supprimez le répertoire racine d'installation : 
    sudo rm -rf /opt/apigee