Edge 설치 개요

Private Cloud용 Edge v4.19.01

일반적인 Edge 설치는 여러 노드에 분산된 Edge 구성요소로 구성됩니다. 노드에 Edge를 설치한 후 하나 이상의 Edge 구성요소를 설치하고 구성 지정할 수도 있습니다

설치 절차

노드에 Edge를 설치하는 과정은 여러 단계로 이루어집니다.

  1. 노드에서 SELinux를 사용 중지하거나 허용 모드로 설정합니다. 자세한 내용은 다음을 위한 Edge Apigee-setup 유틸리티 설치 자세히 알아보세요.
  2. Cassandra 인증을 사용 설정할지 결정합니다.
  3. Postgres에 마스터-대기 복제를 설정할지 결정합니다.
  4. 권장 토폴로지 목록에서 Edge 구성을 선택합니다. 예를 들어 단일 노드(테스트용) 또는 13개 노드(프로덕션)에 Edge를 설치할 수 있습니다. 자세한 내용은 설치 토폴로지를 참조하세요.
  5. 선택한 토폴로지의 각 노드에 Edge apigee-setup 유틸리티를 설치합니다. <ph type="x-smartling-placeholder">
      </ph>
    • Edge bootstrap_4.19.01.sh 파일을 다음 위치에 다운로드합니다. /tmp/bootstrap_4.19.01.sh
    • Edge apigee-service 유틸리티 및 종속 항목을 설치합니다.
    • Edge apigee-setup 유틸리티 및 종속 항목을 설치합니다.

      Edge Apigee-setup 유틸리티 설치를 참조하세요. 확인하세요.

  6. apigee-setup 유틸리티를 사용하여 각 유틸리티에 하나 이상의 Edge 구성요소를 설치합니다. 노드의 기본 구성을 지정합니다

    노드에 Edge 구성요소 설치하기를 참고하세요.

  7. 관리 서버 노드에서 Apigee-setup 유틸리티를 사용하여 Apigee 프로비저닝을 설치합니다. Edge 조직을 만들고 관리하는 데 사용하는 유틸리티입니다.

    자세한 내용은 조직 온보딩을 참고하세요.

  8. 설치가 완료된 후 각 노드에서 Edge UI 구성요소를 다시 시작합니다. 다음 예는 다음과 같습니다. <ph type="x-smartling-placeholder"> 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    </ph>

설치가 완료되면 이 목록 일반적인 설치 후 작업을 참조하세요.

설치를 수행할 수 있는 사용자

Apigee Edge 배포 파일은 RPM 및 종속 항목 집합으로 설치됩니다. 받는사람 Edge RPM을 설치, 제거, 업데이트하려면 명령어를 루트 사용자 또는 사용자가 실행해야 합니다. 모든 sudo 액세스 권한이 있는 사용자 전체 sudo 액세스 권한이 있는 사용자는 작업을 수행할 수 있는 sudo 액세스 권한을 가짐 루트와 동일한 연산을 실행합니다.

다음 명령어 또는 스크립트를 실행하려는 모든 사용자는 루트이거나 사용자여야 합니다. 전체 sudo 액세스 권한이 있는 경우:

  • apigee-service 유틸리티: <ph type="x-smartling-placeholder">
      </ph>
    • apigee-service 명령어: install, uninstall, update
    • Apigee-all 명령어: install, uninstall, update
  • setup.sh 스크립트를 사용하여 Edge 구성요소를 설치합니다. 단, 'apigee-service install' 필요한 RPM을 설치합니다. 다음 루트 또는 전체 sudo를 사용하세요. 액세스할 수 있습니다.)
  • Edge 구성요소를 업데이트하는 update.sh 스크립트

또한 Edge 설치 프로그램이 시스템에 'apigee'라는 새 사용자를 만듭니다. 다양한 Edge 명령어 'Apigee'로 실행하려면 sudo를 호출하세요. 있습니다.

위에 표시된 명령어 이외의 다른 모든 명령어를 실행하려는 모든 사용자는 'apigee'에 대한 전체 sudo 액세스 권한 있습니다. 이러한 명령어에는 다음이 포함됩니다.

  • 다음을 포함한 apigee-service 유틸리티 명령어: <ph type="x-smartling-placeholder">
      </ph>
    • apigee-service 명령어(예: start, stop, restart, configure)
    • Apigee-all 명령어(예: start, stop, restart, configure)

'apigee'에 대한 전체 sudo 액세스 권한이 있는 사용자 만들기 사용자

'Apigee'에 대한 전체 sudo 액세스 권한을 갖도록 사용자를 구성하려면 다음 안내를 따르세요. 'visudo'를 사용합니다. 명령어를 사용하여 sudoers 파일을 수정하여 추가합니다.

installUser        ALL=(apigee)      NOPASSWD: ALL

여기서 installUser은 Edge로 작업하는 사람의 사용자 이름입니다.

구성 파일에 대한 권한 설정

Edge 명령어에서 사용하는 모든 파일 또는 리소스는 'Apigee'에 액세스할 수 있어야 합니다. 있습니다. 이 여기에는 Edge 라이선스 파일 및 모든 구성 파일이 포함됩니다.

구성 파일을 만들 때 소유자를 'apigee:apigee'로 변경할 수 있습니다. 배포가 Edge 명령어에 액세스할 수 있습니다.

  1. 편집기에서 원하는 사용자로 파일을 만듭니다.
  2. chown는 'apigee:apigee'에 대한 파일의 소유자입니다. 또는 관리자가 사용자를 변경한 경우 'Apigee'에서 Edge 서비스를 실행하는 경우 실행 중인 사용자에게 파일을 chown합니다. 사용할 수 있습니다

Edge 설치 작업을 루트 사용자와 루트가 아닌 사용자 간 분리

전체 Edge 설치 프로세스를 루트로 실행하거나 다음 권한이 있는 사용자가 실행하는 것이 가장 간단합니다. 전체 sudo 액세스 권한을 가질 수 있는데, 이는 항상 가능하지는 않습니다. 대신 포드의 루트로 수행하는 작업과 사용자가 실행하는 작업으로 'apigee'에 대한 전체 sudo 액세스 권한 있습니다.

  1. 루트에서 수행하는 작업: <ph type="x-smartling-placeholder">
      </ph>
    1. bootstrap_4.19.01.sh 파일을 다운로드하여 실행합니다. 
      curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
sudo bash /tmp/bootstrap_4.19.01.sh apigeeuser=uName apigeepassword=pWord

      이 단계에서는 apigee-service 유틸리티를 설치하고 'Apigee'를 만듭니다. 있습니다.

    2. 'Apigee'에 대한 전체 sudo 액세스 권한을 갖도록 사용자를 구성하세요. '사용자 인증 정보'를 'apigee'에 대한 전체 sudo 액세스 권한이 있는 사용자 만들기 사용자가 누구인지 알아보세요.
    3. apigee-setup 유틸리티를 설치합니다. 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    4. apigee-setup 유틸리티를 사용하여 노드에 Edge RPM을 설치합니다. 
      /opt/apigee/apigee-service/bin/apigee-service compName install

      노드에 설치하는 Edge RPM은 토폴로지에 따라 다릅니다. 목록의 사용 가능한 구성요소에는 apigee-provision, apigee-validate, apigee-zookeeper, apigee-cassandra, apigee-openldap, edge-management-server, edge-ui, edge-router, edge-message-processor, apigee-postgresql, apigee-qpidd, edge-postgres-server, edge-qpid-server이(가) 있습니다.

  2. 루트 사용자가 노드에 Edge RPM을 설치한 후 전체 sudo 액세스 권한이 있는 사용자는 'Apigee'라는 사용자가 구성 프로세스를 완료합니다. <ph type="x-smartling-placeholder">
      </ph>
    1. setup.sh 유틸리티를 사용하여 Edge 구성 완료 구성 요소만 볼 수 있습니다 명령어의 형식은 사용하는 구성 요소에 따라 사용자 인증 정보를 제공합니다 전체 목록은 다음을 참조하세요. 노드에 Edge 구성요소를 설치합니다.

      예를 들어 주키퍼와 Cassandra의 설치를 완료하려면 다음을 사용합니다. 명령어:

      /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile

      여기서 configFile는 에지 구성 파일입니다.

      또는 올인원 설치를 수행하려면 다음 명령어를 사용합니다.

      /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile

설치 구성 파일의 위치

다음 항목이 포함된 apigee-setup 유틸리티에 구성 파일을 전달해야 합니다. Edge 설치에 대한 정보를 확인하세요. 자동 설치의 유일한 요구사항은 구성 파일은 'Apigee'에서 액세스하거나 읽을 수 있어야 합니다. 있습니다. 예를 들어 노드의 /usr/local/var 또는 /usr/local/share 디렉터리에 있고 'Apigee:apigee'에 chown하세요.

에지 시스템을 제외한 구성 파일의 모든 정보가 필요합니다. 관리자 비밀번호입니다. 비밀번호를 생략하면 apigee-setup 유틸리티에 메시지가 표시됩니다. 명령줄에 입력합니다

자세한 내용은 노드에 Edge 구성요소 설치를 참고하세요.

설치 실패 처리

Edge 구성요소를 설치하는 중에 오류가 발생하면 설치 프로그램을 다시 실행하세요. 설치 프로그램은 실패를 감지한 경우 또는 나중에 구성 요소를 변경하거나 업데이트하려는 경우 설치해야 합니다

설치 또는 업그레이드 후 이 구성요소가 있는 각 노드에서 Edge UI 구성요소를 다시 시작해야 합니다. 확인할 수 있습니다

인터넷 또는 비인터넷 설치

노드에 Edge를 설치하려면 노드에서 Apigee 저장소에 액세스할 수 있어야 합니다.

  • 외부 인터넷이 연결된 노드

    외부 인터넷 연결이 있는 노드는 Apigee 저장소에 액세스하여 Edge를 설치합니다. RPM 및 종속 항목

  • 외부 인터넷 연결이 없는 노드

    외부 인터넷 연결이 없는 노드는 미러링된 버전의 Apigee에 액세스할 수 있습니다. 컨테이너 이미지를 가져올 수 있습니다 이 저장소에는 모든 Edge RPM이 포함되어 있지만 내부 저장소의 저장소에서 다른 모든 종속 항목을 사용할 수 있는지 네트워크에 속합니다.

    내부 Apigee 저장소를 만들려면 외부 인터넷이 있는 노드가 필요합니다. Edge RPM 및 종속 항목을 다운로드할 수 있습니다. kubectl apply 명령어로 다른 노드로 이동하거나 해당 노드에 액세스할 수 있도록 하면 됩니다. 사용할 수 있습니다

로컬 Edge 저장소를 사용하여 Edge 버전 유지관리

로컬 또는 미러링된 저장소를 사용하는 이유 중 하나는 노드에 Edge를 설치하기 위한 것입니다. 외부 인터넷 연결 없이 인터넷 연결을 할 수 있습니다.

<ph type="x-smartling-placeholder">

RPM 설치 종속 항목 해결

Apigee Edge 배포 파일은 RPM 파일 집합으로 설치되며 각 파일에는 자체 설치 종속 항목 체인 이러한 종속 항목의 대부분은 서드 파티에서 정의함 이러한 구성요소는 언제든지 변경될 수 있습니다. 따라서 문서에 각 종속 항목의 명시적 버전 번호가 나열되어 있지 않습니다.

인터넷 액세스가 가능한 머신에서 설치를 수행하는 경우 노드가 필요한 RPM과 종속 항목을 변경할 수 있습니다 그러나 인터넷에 연결되지 않은 노드에서 설치한다면 액세스를 사용하는 경우 일반적으로 필요한 모든 종속 항목이 포함된 내부 저장소를 설정합니다. 유일한 방법 설치를 시도하기 위해 모든 종속 항목이 로컬 저장소에 포함되도록 하려면 누락된 종속 항목을 식별하고 설치가 완료될 때까지 로컬 저장소에 복사합니다 성공합니다.

일반적인 Yum 명령어

Linux용 Edge 설치 도구는 Yum을 사용하여 구성요소를 설치하고 업데이트합니다. 이 여러 Yum 명령을 사용하여 노드에서 설치를 관리해야 합니다.

  • 모든 Yum 캐시를 삭제합니다. 
    sudo yum clean all
  • Edge 구성요소를 업데이트하는 방법: 
    sudo yum update componentName

    예를 들면 다음과 같습니다.

    sudo yum update apigee-setup
sudo yum update edge-management-server

파일 시스템 구조

Edge는 /opt/apigee 디렉터리에 모든 파일을 설치합니다.

이 가이드와 Edge 운영 가이드에서 루트 설치 디렉터리는 다음과 같이 설명되어 있습니다.

/opt/apigee

설치 시 다음 파일 시스템 구조를 사용하여 비공개용 Apigee Edge를 배포합니다. 있습니다.

로그 파일

apigee-setup 및 setup.sh 스크립트의 로그 파일은 다음과 같습니다. /tmp/setup-root.log입니다.

각 구성요소의 로그 파일은 /opt/apigee/var/log에 포함되어 있습니다. 를 참조하세요. 각 구성요소에는 자체 하위 디렉터리가 있습니다. 예를 들어 관리 콘솔의 로그에는 서버는 다음 디렉터리에 있습니다.

/opt/apigee/var/log/edge-management-server

다음 표에는 로그 파일의 위치가 나와 있습니다.

구성요소 위치

관리 서버

 /opt/apigee/var/log/edge-management-server

라우터

 /opt/apigee/var/log/edge-router

에지 라우터는 Nginx를 사용하여 구현됩니다. 추가 로그는 다음을 참고하세요.

/opt/apigee/var/log/edge-router/nginx
/opt/nginx/logs

메시지 프로세서

 /opt/apigee/var/log/edge-message-processor

Apigee Qpid 서버

 /opt/apigee/var/log/edge-qpid-server
Apigee Postgres 서버 /opt/apigee/var/log/edge-postgres-server
Edge UI /opt/apigee/var/log/edge-ui
ZooKeeper /opt/apigee/var/log/apigee-zookeeper
OpenLDAP /opt/apigee/var/log/apigee-openldap
Cassandra /opt/apigee/var/log/apigee-cassandra
퀴피드 /opt/apigee/var/log/apigee-qpidd
PostgreSQL 데이터베이스 /opt/apigee/var/log/apigee-postgresql
apigee-monit /opt/apigee/var/log/apigee-monit

데이터

구성요소 위치
관리 서버 /opt/apigee/data/edge-management-server
라우터 /opt/apigee/data/edge-router
메시지 프로세서 /opt/apigee/data/edge-message-processor
Apigee Qpid 에이전트 /opt/apigee/data/edge-qpid-server
Apigee Postgres 에이전트 /opt/apigee/data/edge-postgres-server
ZooKeeper /opt/apigee/data/apigee-zookeeper
OpenLDAP /opt/apigee/data/apigee-openldap
Cassandra /opt/apigee/data/apigee-cassandra/data
퀴피드 /opt/apigee/data/apigee-qpid/data
PostgreSQL 데이터베이스 /opt/apigee/data/apigee-postgres/pgdata
apigee-monit /opt/apigee/data/apigee-monit

설치 시 시스템 검사 사용 설정

Edge 설치 구성 파일은 다음 속성을 지원합니다.

ENABLE_SYSTEM_CHECK=y

이 속성을 "y"로 설정하면 인스톨러가 시스템이 CPU와 CPU 요구사항을 충족하는지 확인하고 메모리 요구사항 기본값은 'n'입니다. 사용 중지 확인합니다.