새 Edge UI 구성

이 문서에서는 프라이빗 클라우드용 Apigee Edge의 새 Edge UI를 설치하고 구성하는 방법을 설명합니다. 버전 4.54.00에서 새 Edge UI는 다음 두 가지 RPM 구성요소로 구성됩니다.

  • edge-management-ui: 새 Edge UI 백엔드 서버
  • edge-management-ui-static: 새 Edge UI 프런트엔드의 정적 웹 애셋

새 Edge UI는 setup.sh을 aio (올인원), sa (독립형) 또는 ms (Management Server) 프로필과 함께 실행할 때 기본적으로 설치되거나 ue 프로필을 사용하여 노드에 독립적으로 설치할 수 있습니다.

기본 요건

프라이빗 클라우드용 Apigee Edge 설치에서 새 Edge UI를 설치하거나 구성하기 전에 노드가 다음 요구사항을 충족하는지 확인하세요.

  • 하드웨어 및 OS 요구사항:
    • 4GB RAM
    • CPU 코어 2개
    • 60GB 디스크 공간
    • Edge apigee-setup 유틸리티 설치에 설명된 대로 노드에 설치된 apigee-setup 유틸리티의 4.54.00 버전
    • 포트 3001이 열려 있어야 합니다. 이는 새 Edge UI에 대한 요청에 사용되는 기본 포트입니다. 새 Edge UI 구성 파일 에 설명된 속성을 사용하여 포트를 변경하는 경우 해당 포트가 열려 있는지 확인하세요.
  • 인증:
    • 기본 인증 (기본값): 기본적으로 사용 설정됩니다 (AUTH_MODE=basic). 외부 ID 공급업체 (IDP)가 필요하지 않고 Edge 관리 서버 및 SymasLDAP 사용자 인증 정보를 사용합니다.
    • SSO / 외부 IDP (선택사항): Apigee SSO 또는 외부 IDP (예: SAML 또는 OIDC)를 선택적으로 구성할 수 있습니다. TLS를 통해 외부 IDP에 연결하는 경우 IDP는 TLS v1.2 이상을 지원해야 합니다.

새 Edge UI 기능에 대한 자세한 내용은 프라이빗 클라우드용 새 Edge UI를 참고하세요.

설치 및 구성 개요

개략적으로 ue 프로필을 사용하여 새 Edge UI를 설치하거나 재구성하는 프로세스는 다음과 같습니다.

  • apigee-setup 유틸리티가 노드에 설치되어 있는지 확인합니다.
  • 자동 구성 파일을 만들고 설정을 사용하여 수정합니다.
  • /opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile을 실행합니다. 이렇게 하면 edge-management-ui과 edge-management-ui-static이 모두 설치되고 구성됩니다.
  • http://new_edge_UI_IP:3001에서 새 Edge UI에 로그인하고 테스트합니다.

관리 서버와 새 Edge UI 서버가 부하 분산기에서 TLS 오프로딩 이 발생하는 부하 분산기 뒤에 있는 경우 구성이 부하 분산기에서 TLS가 종료될 때 새 Edge UI 구성에 강조 표시된 속성 을 반영하는지 확인합니다.

새 Edge UI 구성 파일

다음 예에서는 기본 기본 인증으로 새 Edge UI 를 설치하고 구성하기 위한 구성 파일을 보여줍니다.

기본 인증 구성 (기본값)

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

새 Edge UI 설치 또는 구성

ue 프로필을 사용하여 새 Edge UI를 설치하거나 구성하려면 다음 단계를 따르세요.:

  1. 관리자로 대상 노드에 로그인합니다.
  2. Edge apigee-setup 유틸리티 설치에 설명된 대로 노드에 apigee-setup 유틸리티의 4.54.00 버전을 설치합니다.
  3. 다음 명령어를 실행하여 Yum으로 캐시된 모든 정보를 정리합니다. 
    sudo yum clean all
  4. 새 Edge UI 구성 파일에 설명된 대로 구성 파일을 만들고 "apigee" 사용자가 소유하는지 확인합니다. 
    chown apigee:apigee configFile
  5. 노드에서 다음 명령어를 실행합니다. 
    /opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile

    apigee-setup 유틸리티는 edge-management-ui와 edge-management-ui-static를 설치하고 구성합니다.

  6. 브라우저에서 다음 URL을 열어 새 Edge UI에 로그인합니다. 
    http://new_edge_UI_IP:3001

    여기서 new_edge_UI_IP는 새 Edge UI를 호스팅하는 노드의 IP 주소 또는 호스트 이름입니다.

  7. 사용자 인증 정보를 입력합니다.

    새 Edge UI가 표시됩니다. 새 Edge UI 사용에 대한 자세한 내용은 프라이빗 클라우드용 새 Edge UI를 참고하세요.

    새 Edge UI가 표시되지 않으면 포트 3001이 연결에 열려 있는지 확인합니다.

선택사항: 인증을 위해 Apigee SSO를 구성하려면 Apigee SSO 설치 및 구성 및 새 Edge UI에서 외부 IDP 사용 설정의 단계를 따르세요.

새 Edge UI 제거

노드에서 새 Edge UI를 제거하려면 edge-management-ui 구성요소와 edge-management-ui-static 구성요소를 모두 제거합니다.

새 Edge UI 구성요소를 제거하려면 다음 단계를 따르세요.

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

노드에서 모든 Edge 구성요소를 제거하려면 다음 단계를 따르세요.

  1. 머신에서 실행 중인 모든 Edge 서비스를 중지합니다. 
    /opt/apigee/apigee-service/bin/apigee-all stop
  2. yum 캐시를 지웁니다. 
    sudo yum clean all
  3. 모든 Apigee RPM을 제거합니다. 
    sudo rpm -e $(rpm -qa | egrep "(apigee-|edge-)")
  4. 설치 루트 디렉터리를 제거합니다. 
    sudo rm -rf /opt/apigee