Instala Edge Microgateway

Estás consultando la documentación de Apigee Edge.
Consulta la documentación de Apigee X.
Información

Edge Microgateway v. 2.3.x

Público

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

Requisitos previos

  • Debes tener instalado 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 se instale y se agregue a PATH.
  • Si usas la nube privada de Apigee Edge para configurar con Edge Microgateway, debes ejecutar la versión 4.15.07 o una posterior de la nube privada.

Cómo instalar Node.js

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

node -v

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

Instala Edge Microgateway si tienes una 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. Con este comando, se instala el software y se coloca el archivo ejecutable edgemicro en tu ruta de acceso. Para saber dónde se instala Edge Microgateway con 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, usa el siguiente comando para instalar la versión 2.3.1.

    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 el directorio principal de un subdirectorio llamado .edgemicro. Ahora, verifica que el archivo exista:
    ls ~/.edgemicro
    default.yaml
    

    Nota: En los documentos de Edge Microgateway, nos referimos al directorio principal con la virgulilla (~), que es un acceso directo de UNIX. En Windows, y ejecutas una shell que no admite virgulillas, deberás sustituir la variable de entorno adecuada por la virgulilla en los comandos que hagan referencia al directorio principal. Por ejemplo: %USERPROFILE%/.edgemicro.

  5. Sigue los pasos que se indican en Instala Edge Microgateway.

Cómo operar Edge Microgateway en Windows como servicio

Puedes operar Edge Microgateway en Windows como servicio. Para obtener más información, consulta Prácticas recomendadas para la administración operativa de Microgateway (edgemicro) en Windows en la comunidad de Apigee.

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

En los sitios que no tienen un 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 proporcionaron anteriormente.

Primeros pasos

Si eres nuevo en Edge Microgateway, la instalación de Edge Microgateway es el mejor lugar para comenzar después de completar la instalación. En la guía de configuración, se abordan todos los pasos que debes realizar para instalar, configurar, iniciar y usar una instancia de Edge Microgateway.

¿Dónde está instalado Edge Microgateway?

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

npm config get prefix

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

Desinstala 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 [prefijo] es el prefijo de npm, como se explica en ¿Dónde está instalado 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. Verifica el archivo de configuración si tienes dudas, como se explica en "Administra archivos de registro".
  3. Borra o archiva los archivos de configuración del entorno de ejecución y de la caché:
    ~/.edgemicro/*.yaml