Edge Micro Gateway 설치

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

Edge Micro Gateway v. 3.3.x

이 주제에서는 Edge Micro Gateway를 설치하거나 제거하는 방법을 설명합니다.

하드웨어 최소 요구사항

Edge Micro Gateway에는 다음과 같은 최소 하드웨어 구성이 필요합니다.

  • 가상 머신 (VM)에서 Edge Micro Gateway는 코어 1개 이상과 256MB 이상의 RAM이 필요합니다. Edge Micro Gateway 프로세스 자체에 사용되는 RAM은 128MB 미만입니다.
  • 컨테이너에서는 Micro Gateway를 100MB 미만의 이미지 크기로 사용할 수 있습니다.

기본 요건

  • Apigee는 Windows, macOS, Linux에서 활성 LTS 또는 유지보수 LTS 출시 버전을 지원합니다. 자세한 내용은 Apigee Edge Micro Gateway에 지원되는 소프트웨어를 참조하세요.
  • Windows에서는 OpenSSL을 설치하고 PATH에 추가해야 합니다.
  • Apigee Edge Private Cloud를 사용하여 Edge Microgateway로 구성하는 경우 Private Cloud 버전 4.18.01 이상을 실행해야 합니다.

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

이 섹션에서는 Edge Micro Gateway를 설치하고 기본 구성을 초기화하는 방법을 설명합니다. 인터넷 연결 없이 작동하는 경우 인터넷 연결 없이 Edge Micro Gateway를 설치할 수 있나요?를 참조하세요.

  1. 다음과 같이 npm를 사용하여 Edge Micro Gateway의 최신 버전을 설치합니다. 이 명령어는 소프트웨어를 설치하고 edgemicro 실행 파일을 경로에 넣습니다. 
    npm install edgemicro -g

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

    npm install edgemicro@3.1.5 -g
  2. 버전 번호를 확인합니다. 예를 들어 버전 3.1.5를 설치한 경우: 
    edgemicro --version
current nodejs version is v12.5.0
current edgemicro version is 3.1.5
  3. Edge Micro Gateway 설정 및 구성의 설정 및 구성 단계를 따릅니다.

Edge Micro Gateway 업그레이드

이전에 설치된 Edge Micro Gateway 버전을 업그레이드하려면 인터넷에 연결된 경우 Edge Micro Gateway 업그레이드를 참조하세요.

Apigee에서는 프로덕션 환경을 업그레이드하기 전에 새 버전으로 기존 구성을 테스트할 것을 권장합니다.

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

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

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

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

시작하기

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

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

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

npm config get prefix

프리픽스 구성의 기본값은 노드가 설치된 위치입니다. 대부분의 시스템에서 /usr/local입니다. Windows에서는 %AppData%\npm입니다. [prefix]의 값은 구성 가능합니다. Node.js 모듈이 기본적으로 설치되는 위치와 설치 위치를 구성하는 방법에 대한 자세한 내용은 npm-folders를 참조하세요.

Edge Micro Gateway 제거

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

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

Kubernetes 지원

Edge Microgateway를 사용하여 Kubernetes 클러스터에서 실행되는 서비스에 대한 Apigee API 관리를 제공할 수 있습니다. Edge Micro Gateway와 Kubernetes 통합 개요를 참조하세요.

Docker 지원

이제 최신 Edge Micro Gateway 출시 버전을 Docker 이미지로 다운로드할 수 있습니다.

docker pull gcr.io/apigee-microgateway/edgemicro:latest