Edge Micro Gateway 설치

Apigee Edge 문서입니다.
Go to the Apigee X 문서로 이동합니다.
info

Edge Microgateway v. 2.3.x

대상

Edge Microgateway를 설치하거나 제거해야 하는 경우 이 가이드를 사용하세요.

기본 요건

  • 시스템에 Node.js 버전 4.5 LTS 이상이 설치되어 있어야 합니다. 아래의 추가 Node.js 안내를 참고하세요.
  • Windows에서는 OpenSSL을 설치하고 PATH에 추가해야 합니다.
  • Apigee Edge Private Cloud를 사용하여 Edge Microgateway로 구성하는 경우 Private Cloud 버전 4.15.07 이상을 실행해야 합니다.

Node.js 설치

시스템에 Node.js 버전 4.5 이상 이 설치되어 있어야 합니다. 다음을 실행하여 확인할 수 있습니다.

node -v

Node.js를 가져오거나 업데이트하는 방법은 여러 가지가 있습니다. 예를 들어 HomeBrew, yum을 사용하거나 Node.js 사이트에서 직접 다운로드할 수 있습니다. https://nodejs.org/download.

인터넷에 연결되어 있는 경우 Edge Microgateway 설치

이 섹션에서는 Edge Microgateway를 설치하고 기본 구성을 초기화하는 방법을 설명합니다.

  1. 다음 명령어를 사용하여 npm 으로 Edge Microgateway의 최신 버전을 설치합니다. 이 명령어는 소프트웨어를 설치하고 edgemicro 실행 파일을 경로에 배치합니다. 다음 명령어가 Edge Microgateway를 설치하는 정확한 위치를 알아보려면 Edge Microgateway는 어디에 설치되나요?를 참고하세요.
    npm install edgemicro -g

    Edge Microgateway의 특정 버전을 설치하려면 설치 명령어에 버전 번호 를 지정해야 합니다. 버전 번호를 지정하지 않으면 최신 버전이 설치됩니다. 예를 들어 버전 2.3.1을 설치하려면 다음 명령어를 사용합니다.

    npm install edgemicro@2.3.1 -g
  2. 버전 번호를 확인합니다. 예를 들어 버전 2.3.5를 설치한 경우:
    edgemicro --version
    current nodejs version is v6.1.0
    current edgemicro version is 2.3.5
  3. 이 명령어를 실행하여 홈 디렉터리에 기본 구성 파일을 만듭니다.
    edgemicro init
  4. (선택사항) default.yaml이라는 구성 파일이 하위 디렉터리인 .edgemicro의 홈 디렉터리에 배치되었습니다. 이제 이 파일 이 있는지 확인합니다.
    ls ~/.edgemicro
    default.yaml

    참고: Edge Microgateway 문서에서는 홈 디렉터리를 물결표 (~)로 나타냅니다. 이는 UNIX 바로가기입니다. Windows에서 물결표를 지원하지 않는 셸을 실행하는 경우 홈 디렉터리를 참조하는 명령어에서 물결표를 적절한 환경 변수로 대체해야 합니다. 예를 들면 %USERPROFILE%/.edgemicro입니다.

  5. Edge Microgateway 설치의 단계를 따릅니다.

Windows에서 Edge Microgateway를 서비스로 실행

Windows에서 Edge Microgateway를 서비스로 실행할 수 있습니다. 자세한 내용은 Apigee 커뮤니티의 Windows에서 Microgateway (edgemicro)의 운영 관리를 위한 권장사항을 참고하세요.

인터넷에 연결되어 있지 않은 상태에서 Edge Microgateway 를 설치할 수 있나요?

인터넷에 쉽게 액세스할 수 없는 사이트에서 관리자는 내부 네트워크에 비공개 npm 레지스트리 를 설치하고 유지보수할 수 있습니다. 비공개 npm 레지스트리 설정 안내는 이 가이드의 범위를 벗어납니다. 하지만 유용한 안내를 검색하여 찾을 수 있습니다. 비공개 npm 레지스트리가 설치되어 있으면 위에 제공된 설치 안내를 따를 수 있습니다.

시작하기

Edge Microgateway를 처음 사용하는 경우 설치를 완료한 후 Edge Microgateway 설치를 시작하는 것이 가장 좋습니다. 설정 및 구성 가이드에서는 Edge Microgateway 인스턴스를 설치, 구성, 시작, 사용하기 위해 수행해야 하는 모든 단계를 다룹니다.

Edge Microgateway는 어디에 설치되나요?

전역 옵션 (npm install -g edgemicro)과 함께 npm을 사용하면 소프트웨어가 [prefix]/lib/node_modules/edgemicro에 설치됩니다. 다음 명령어를 사용하여 [prefix] 값을 찾을 수 있습니다.

npm config get prefix

[prefix] 값은 구성할 수 있습니다. 자세한 내용은 npm-folders를 참고하세요.

Edge Microgateway 제거

Edge Microgateway를 제거해야 하는 경우 다음 단계를 따르세요.

  1. 설치 디렉터리 [prefix]/lib/node_modules/edgemicro를 삭제하거나 보관합니다. 여기서 [prefix] 는 Edge Microgateway는 어디에 설치되나요?에 설명된 npm 프리픽스입니다.
  2. 로그 파일을 삭제하거나 보관합니다. 기본적으로 edgemicro-*.log 파일은 /var/tmp/에 있지만 이 위치는 구성할 수 있습니다. '로그 파일 관리'에 설명된 대로 확실하지 않은 경우 구성 파일을 확인하세요.
  3. 런타임 구성 및 캐시 구성 파일을 삭제하거나 보관합니다.
    ~/.edgemicro/*.yaml