Estás viendo la documentación de Apigee Edge.
Ir a la
documentación de Apigee X. info
Edge Microgateway v. 2.4.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 ejecutar la versión 4.16.01 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.
- Instala la versión más reciente de Edge Microgateway
con
npmmediante el siguiente comando. Este comando instala el software y coloca eledgemicroejecutable en tu ruta de acceso. Consulta también ¿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
- 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
- Ejecuta este comando para crear un archivo de configuración predeterminado en tu directorio principal.
edgemicro init
- (Opcional) Se colocó un archivo de configuración llamado
default.yamlen 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. - Sigue los pasos que se indican en Cómo configurar Edge Microgateway.
Cómo ejecutar Edge Microgateway en Windows como un servicio
Puedes ejecutar Edge Microgateway en Windows como un servicio. Para obtener más detalles, 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 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 configurar 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:
- 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? - Borra o archiva los archivos de registro. De
forma predeterminada, los archivos
edgemicro-*.logse 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." - Borra o archiva los archivos de configuración de caché y de configuración del entorno de ejecución:
~/.edgemicro/*.yaml