Instala Edge Microgateway

Estás viendo la documentación de Apigee Edge.
Ir a la documentación de Apigee X.
info

Edge Microgateway v. 2.3.x

Público

Usa esta guía si necesitas instalar o desinstalar Edge Microgateway.

Requisitos previos

  • Debes tener instalada en tu sistema la versión 4.5 LTS o posterior de Node.js. Consulta las instrucciones adicionales de Node.js a continuación.
  • Windows requiere que OpenSSL esté instalado y agregado a la ruta de acceso.
  • Si usas Apigee Edge para la nube privada para configurar Edge Microgateway, debes estar ejecutando la versión 4.15.07 o posterior de la nube privada.

Cómo instalar Node.js

Debes tener instalada en tu sistema la versión 4.5 o posterior de Node.js. Para verificarlo, ejecuta lo siguiente:

node -v

Existen muchas formas de obtener o actualizar Node.js. Por ejemplo, puedes usar HomeBrew, yum o descargarlo directamente desde el sitio de Node.js: https://nodejs.org/download.

Cómo instalar Edge Microgateway si tienes conexión a Internet

En esta sección, se explica cómo instalar Edge Microgateway y cómo inicializar una configuración predeterminada.

  1. Instala la versión más reciente de Edge Microgateway con npm mediante el siguiente comando. Este comando instala el software y coloca el edgemicro ejecutable en tu ruta de acceso. Para saber exactamente dónde instala Edge Microgateway el siguiente comando, consulta ¿Dónde se instala Edge Microgateway?.
    npm install edgemicro -g

    Para instalar una versión específica de Edge Microgateway, debes especificar el número de versión en el comando de instalación. Si no especificas el número de versión, se instalará la versión más reciente. Por ejemplo, para instalar la versión 2.3.1, usa el siguiente comando.

    npm install edgemicro@2.3.1 -g
  2. Verifica el número de versión. Por ejemplo, si instalaste la versión 2.3.5:
    edgemicro --version
    current nodejs version is v6.1.0
    current edgemicro version is 2.3.5
  3. Ejecuta este comando para crear un archivo de configuración predeterminado en tu directorio principal.
    edgemicro init
  4. (Opcional) Se colocó un archivo de configuración llamado default.yaml en tu directorio principal en un subdirectorio llamado .edgemicro. Verifica ahora para asegurarte de que este archivo exista:
    ls ~/.edgemicro
    default.yaml

    Nota: En la documentación de Edge Microgateway, nos referimos al directorio principal con la tilde (~), que es un atajo de UNIX. Si usas Windows y ejecutas un shell que no admite la tilde, deberás sustituir la variable de entorno adecuada por la tilde en los comandos que hacen referencia al directorio principal. Por ejemplo: %USERPROFILE%/.edgemicro.

  5. Sigue los pasos que se indican en Cómo instalar Edge Microgateway.

Cómo operar Edge Microgateway en Windows como un servicio

Puedes operar Edge Microgateway en Windows como un servicio. Para obtener más información, consulta Best practices for operational management of Microgateway (edgemicro) on Windows en la comunidad de Apigee.

¿Puedo instalar Edge Microgateway sin conexión a Internet?

En los sitios que no tienen acceso a Internet listo, es posible que un administrador instale y mantenga un registro de npm privado en tu red interna. Las instrucciones para configurar un registro npm privado están fuera del alcance de esta guía. Sin embargo, puedes buscar y encontrar instrucciones útiles. Con un registro npm privado instalado, puedes seguir las instrucciones de instalación que se indican más arriba.

Cómo comenzar

Si es la primera vez que usas Edge Microgateway, Cómo instalar Edge Microgateway es el mejor lugar para comenzar después de completar la instalación. En la guía de configuración, se abarcan todos los pasos que debes seguir para instalar, configurar, iniciar y usar una instancia de Edge Microgateway.

¿Dónde se instala Edge Microgateway ?

Cuando usas npm con la opción global (npm install -g edgemicro), el software se instala en [prefix]/lib/node_modules/edgemicro. Puedes encontrar el valor de [prefix] con este comando:

npm config get prefix

El valor de [prefix] se puede configurar. Consulta npm-folders para obtener más información.

Cómo desinstalar Edge Microgateway

Si necesitas quitar Edge Microgateway, sigue estos pasos:

  1. Borra o archiva el directorio de instalación [prefix]/lib/node_modules/edgemicro, en el que [prefix] es el prefijo de npm como se explica en ¿Dónde se instala Edge Microgateway?
  2. Borra o archiva los archivos de registro. De forma predeterminada, los archivos edgemicro-*.log se encuentran en /var/tmp/, pero esta ubicación se puede configurar. Consulta el archivo de configuración en caso de duda, como se explica en "Administración de archivos de registro."
  3. Borra o archiva los archivos de configuración de caché y de configuración del entorno de ejecución:
    ~/.edgemicro/*.yaml