Edge Micro Gateway 설치

현재 Apigee Edge 문서가 표시되고 있습니다.
Apigee X 문서로 이동 정보

Edge Micro Gateway v. 2.3.x

대상

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

기본 요건

  • 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 Micro Gateway 설치

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

  1. 다음 명령어를 사용하여 npm로 Edge Micro Gateway의 최신 버전을 설치합니다. 이 명령어는 소프트웨어를 설치하고 경로에 edgemicro 실행 파일을 넣습니다. 다음 명령어로 Edge Micro Gateway를 설치하는 위치를 정확히 확인하려면 Edge Micro Gateway가 어디에 설치되어 있나요?를 참조하세요. 
    npm install edgemicro -g

    Edge Micro Gateway의 특정 버전을 설치하려면 설치 명령어에서 버전 번호를 지정해야 합니다. 버전 번호를 지정하지 않으면 최신 버전이 설치됩니다. 예를 들어 버전 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 Micro Gateway 설치 단계를 따릅니다.

Windows의 운영 에지 Micro Gateway 서비스형

Windows에서 Edge Micro Gateway를 서비스로 작동할 수 있습니다. 자세한 내용은 Apigee 커뮤니티에서 Windows용 Micro Gateway (edgemicro) 운영 관리 권장사항을 참조하세요.

인터넷 연결 없이 Edge Micro Gateway를 설치할 수 있나요?

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

시작하기

Edge Micro게이트를 처음 사용하는 경우 설치를 완료한 후 Edge Micro Gateway 설치를 시작하는 것이 가장 좋습니다. 설정 및 구성 가이드에서는 Edge Micro Gateway 인스턴스를 설치, 구성, 시작, 사용하는 데 필요한 모든 단계를 설명합니다.

Edge Micro Gateway는 어디에 설치되나요?

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

npm config get prefix

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

Edge Micro Gateway 제거

Edge Micro게이트를 삭제해야 하는 경우 다음 안내를 따르세요.

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