Yeni Edge kullanıcı arayüzünü yapılandırma

Bu belgede, Apigee Edge for Private Cloud için yeni Edge kullanıcı arayüzünün nasıl yüklenip yapılandırılacağı açıklanmaktadır. 4.54.00 sürümünde, yeni Edge kullanıcı arayüzü iki RPM bileşeninden oluşur:

  • edge-management-ui: Yeni Edge kullanıcı arayüzü arka uç sunucusu.
  • edge-management-ui-static: Yeni Edge kullanıcı arayüzü ön ucu için statik web öğeleri.

Yeni Edge kullanıcı arayüzü, setup.sh komutunu aio (hepsi bir arada), sa (bağımsız) veya ms (Yönetim Sunucusu) profiliyle çalıştırdığınızda varsayılan olarak yüklenir veya ue profili kullanılarak bir düğüme bağımsız olarak yüklenebilir.

Ön koşullar

Yeni Edge kullanıcı arayüzünü Apigee Edge for Private Cloud yüklemesine yüklemeden veya yapılandırmadan önce, düğümün aşağıdaki koşulları karşıladığından emin olun:

  • Donanım ve işletim sistemi gereksinimleri:
    • 4 GB RAM
    • 2 CPU çekirdeği
    • 60 GB disk alanı
    • Edge apigee-setup yardımcı programını yükleme bölümünde açıklandığı şekilde düğüme yüklenen apigee-setup yardımcı programının 4.54.00 sürümü.
    • 3001 numaralı bağlantı noktası açık olmalıdır. Bu, yeni Edge kullanıcı arayüzüne gönderilen istekler için kullanılan varsayılan bağlantı noktasıdır. Yeni Edge kullanıcı arayüzü yapılandırma dosyasında açıklanan özellikleri kullanarak bağlantı noktasını değiştirirseniz bağlantı noktasının açık olduğundan emin olun.
  • Kimlik doğrulama:
    • Temel kimlik doğrulama (varsayılan): Varsayılan olarak etkindir (AUTH_MODE=basic). Harici bir kimlik sağlayıcı (IdP) gerektirmeden Edge Yönetim Sunucusu ve SymasLDAP kimlik bilgilerini kullanır.
    • TOA / harici IDP (isteğe bağlı): İsteğe bağlı olarak Apigee TOA'yı veya harici bir IDP'yi (ör. SAML veya OIDC) yapılandırabilirsiniz. Harici bir IdP'ye TLS üzerinden bağlanıyorsanız IdP'nizin TLS 1.2 veya sonraki sürümleri desteklemesi gerekir.

Yeni Edge kullanıcı arayüzü özellikleri hakkında daha fazla bilgi için Private Cloud için Yeni Edge kullanıcı arayüzü başlıklı makaleyi inceleyin.

Yükleme ve yapılandırmaya genel bakış

ue profilini kullanarak yeni Edge kullanıcı arayüzünü yükleme veya yeniden yapılandırma işlemi genel olarak aşağıdaki gibidir:

  • apigee-setup yardımcı programının düğüme yüklendiğinden emin olun.
  • Sessiz yapılandırma dosyası oluşturun ve ayarlarınızla değiştirin.
  • /opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile komutunu çalıştırın. Bu işlem hem edge-management-ui hem de edge-management-ui-static'i yükleyip yapılandırır.
  • http://new_edge_UI_IP:3001 adresinden giriş yapıp yeni Edge kullanıcı arayüzünü test edin.

Yönetim Sunucunuz ve yeni Edge kullanıcı arayüzü sunucunuz, yük dengeleyicide TLS boşaltma işlemi gerçekleşen bir yük dengeleyicinin arkasındaysa yapılandırmanın TLS, yük dengeleyicide sonlandırıldığında yeni Edge kullanıcı arayüzünü yapılandırma bölümünde vurgulanan özellikleri yansıttığından emin olun.

Yeni Edge kullanıcı arayüzü yapılandırma dosyası

Aşağıdaki örnekte, varsayılan temel kimlik doğrulama ile yeni Edge kullanıcı arayüzünü yüklemek ve yapılandırmak için kullanılan bir yapılandırma dosyası gösterilmektedir.

Temel kimlik doğrulama yapılandırması (varsayılan)

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

Yeni Edge kullanıcı arayüzünü yükleme veya yapılandırma

ue profilini kullanarak yeni Edge kullanıcı arayüzünü yüklemek veya yapılandırmak için:

  1. Hedef düğüme yönetici olarak giriş yapın.
  2. Edge apigee-setup yardımcı programını yükleme bölümünde açıklandığı gibi, düğüme apigee-setup yardımcı programının 4.54.00 sürümünü yükleyin.
  3. Aşağıdaki komutu çalıştırarak Yum ile önbelleğe alınmış tüm bilgileri temizleyin: 
    sudo yum clean all
  4. Yapılandırma dosyasını Yeni Edge kullanıcı arayüzü yapılandırma dosyası bölümünde açıklandığı şekilde oluşturun ve dosyanın sahibi olarak "apigee" kullanıcısını belirtin: 
    chown apigee:apigee configFile
  5. Düğümde aşağıdaki komutu çalıştırın: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile

    apigee-setup yardımcı programı, edge-management-ui ve edge-management-ui-static'yi yükleyip yapılandırır.

  6. Bir tarayıcıda aşağıdaki URL'yi açarak yeni Edge kullanıcı arayüzüne giriş yapın: 
    http://new_edge_UI_IP:3001

    new_edge_UI_IP, yeni Edge kullanıcı arayüzünü barındıran düğümün IP adresi veya ana makine adıdır.

  7. Kimlik bilgilerinizi girin.

    Yeni Edge kullanıcı arayüzü görünür. Yeni Edge kullanıcı arayüzünü kullanma hakkında bilgi için Private Cloud için Yeni Edge kullanıcı arayüzü başlıklı makaleyi inceleyin.

    Yeni Edge kullanıcı arayüzü görüntülenmiyorsa 3001 numaralı bağlantı noktasının bağlantılara açık olduğundan emin olun.

İsteğe bağlı: Kimlik doğrulama için Apigee TOA'yı yapılandırmak istiyorsanız Apigee TOA'yı yükleme ve yapılandırma ile Yeni Edge kullanıcı arayüzünde harici bir IdP'yi etkinleştirme başlıklı makalelerdeki adımları uygulayın.

Yeni Edge kullanıcı arayüzünü kaldırma

Yeni Edge kullanıcı arayüzünü bir düğümden kaldırmak için hem edge-management-ui hem de edge-management-ui-static bileşenlerini kaldırın.

Yeni Edge kullanıcı arayüzü bileşenlerini kaldırmak için:

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

Tüm Edge bileşenlerini düğümden kaldırmak için:

  1. Makinede çalışan tüm Edge hizmetlerini durdurun: 
    /opt/apigee/apigee-service/bin/apigee-all stop
  2. Yum önbelleğini temizleyin: 
    sudo yum clean all
  3. Tüm Apigee RPM'lerini kaldırın: 
    sudo rpm -e $(rpm -qa | egrep "(apigee-|edge-)")
  4. Yükleme kök dizinini kaldırın: 
    sudo rm -rf /opt/apigee