Konfigurowanie nowego interfejsu Edge

Z tego dokumentu dowiesz się, jak zainstalować i skonfigurować nowy interfejs Edge w Apigee Edge dla chmury prywatnej. W wersji 4.54.00 nowy interfejs Edge składa się z 2 komponentów RPM:

  • edge-management-ui: serwer backendu nowego interfejsu Edge.
  • edge-management-ui-static: statyczne zasoby internetowe na potrzeby frontendu nowego interfejsu Edge.

Nowy interfejs Edge jest instalowany domyślnie, gdy uruchamiasz setup.sh z profilem aio (all-in-one), sa (standalone) lub ms (Management Server). Możesz też zainstalować go niezależnie na węźle za pomocą profilu ue.

Wymagania wstępne

Zanim zainstalujesz lub skonfigurujesz nowy interfejs Edge w instalacji Apigee Edge dla chmury prywatnej, upewnij się, że węzeł spełnia te wymagania:

  • Wymagania sprzętowe i systemowe:
    • 4 GB pamięci RAM
    • 2 rdzenie procesora
    • 60 GB miejsca na dysku
    • Wersja 4.54.00 narzędzia apigee-setup zainstalowana na węźle zgodnie z opisem w artykule Instalowanie narzędzia Edge apigee-setup.
    • Port 3001 musi być otwarty. Jest to domyślny port używany do żądań do nowego interfejsu Edge. Jeśli zmienisz port za pomocą właściwości opisanych w pliku konfiguracji nowego interfejsu Edge, upewnij się, że port jest otwarty.
  • Uwierzytelnianie:
    • Uwierzytelnianie podstawowe (domyślne): domyślnie włączone (AUTH_MODE=basic). Używa danych logowania do serwera zarządzania Edge i SymasLDAP bez konieczności korzystania z zewnętrznego dostawcy tożsamości.
    • Logowanie jednokrotne / zewnętrzny dostawca tożsamości (opcjonalnie): możesz opcjonalnie skonfigurować logowanie jednokrotne Apigee lub zewnętrznego dostawcę tożsamości (np. SAML lub OIDC). Jeśli łączysz się z zewnętrznym dostawcą tożsamości przez TLS, musi on obsługiwać TLS w wersji 1.2 lub nowszej.

Więcej informacji o funkcjach nowego interfejsu Edge znajdziesz w artykule Nowy interfejs Edge w chmurze prywatnej.

Omówienie instalacji i konfiguracji

Ogólnie proces instalowania lub ponownego konfigurowania nowego interfejsu Edge za pomocą profilu ue wygląda tak:

  • Upewnij się, że narzędzie apigee-setup jest zainstalowane na węźle.
  • Utwórz cichy plik konfiguracji i zmodyfikuj go za pomocą swoich ustawień.
  • Uruchom /opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile. Spowoduje to zainstalowanie i skonfigurowanie zarówno edge-management-ui, jak i edge-management-ui-static.
  • Zaloguj się i przetestuj nowy interfejs Edge pod adresem http://new_edge_UI_IP:3001.

Jeśli serwer zarządzania i serwer nowego interfejsu Edge znajdują się za systemem równoważenia obciążenia, a odciążanie TLS odbywa się w systemie równoważenia obciążenia, upewnij się, że konfiguracja odzwierciedla właściwości wyróżnione w artykule Konfigurowanie nowego interfejsu Edge, gdy zakończenie TLS następuje w systemie równoważenia obciążenia.

Plik konfiguracji nowego interfejsu Edge

Poniższy przykład pokazuje plik konfiguracji do instalowania i konfigurowania nowego interfejsu Edge z domyślnym uwierzytelnianiem podstawowym.

Konfiguracja uwierzytelniania podstawowego (domyślna)

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

Instalowanie lub konfigurowanie nowego interfejsu Edge

Aby zainstalować lub skonfigurować nowy interfejs Edge za pomocą profilu ue:

  1. Zaloguj się w węźle docelowym jako administrator.
  2. Zainstaluj na węźle narzędzie apigee-setup w wersji 4.54.00 zgodnie z opisem w artykule Instalowanie narzędzia apigee-setup Edge utility.
  3. Wyczyść wszystkie informacje w pamięci podręcznej za pomocą Yum, uruchamiając to polecenie: 
    sudo yum clean all
  4. Utwórz plik konfiguracji zgodnie z opisem w sekcji Plik konfiguracji nowego interfejsu Edge i upewnij się, że jego właścicielem jest użytkownik „apigee”: 
    chown apigee:apigee configFile
  5. Uruchom na węźle to polecenie: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile

    Narzędzie apigee-setup instaluje i konfiguruje edge-management-ui oraz edge-management-ui-static.

  6. Zaloguj się w nowym interfejsie Edge, otwierając w przeglądarce ten adres URL: 
    http://new_edge_UI_IP:3001

    gdzie new_edge_UI_IP to adres IP lub nazwa hosta węzła, w którym jest hostowany nowy interfejs Edge.

  7. Wpisz swoje dane logowania.

    Wyświetli się nowy interfejs Edge. Informacje o korzystaniu z nowego interfejsu Edge znajdziesz w artykule Nowy interfejs Edge w chmurze prywatnej.

    Jeśli nowy interfejs Edge się nie wyświetla, upewnij się, że port 3001 jest otwarty na połączenia.

Opcjonalnie: jeśli chcesz skonfigurować logowanie jednokrotne Apigee na potrzeby uwierzytelniania, wykonaj czynności opisane w sekcjach Instalowanie i konfigurowanie logowania jednokrotnego Apigee oraz Włączanie zewnętrznego dostawcy tożsamości w nowym interfejsie Edge.

Odinstalowywanie nowego interfejsu Edge

Aby odinstalować nowy interfejs Edge z węzła, odinstaluj komponenty edge-management-ui i edge-management-ui-static.

Aby odinstalować komponenty nowego interfejsu Edge:

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

Aby usunąć wszystkie komponenty Edge z węzła:

  1. Zatrzymaj wszystkie usługi Edge działające na komputerze: 
    /opt/apigee/apigee-service/bin/apigee-all stop
  2. Wyczyść pamięć podręczną yum: 
    sudo yum clean all
  3. Usuń wszystkie pakiety RPM Apigee: 
    sudo rpm -e $(rpm -qa | egrep "(apigee-|edge-)")
  4. Usuń główny katalog instalacyjny: 
    sudo rm -rf /opt/apigee