Instala Edge Microgateway

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

Edge Microgateway v. 3.3.x

En este tema, se explica cómo instalar o desinstalar Edge Microgateway.

Requisitos mínimos de hardware

Edge Microgateway requiere la siguiente configuración de hardware mínima:

  • En una máquina virtual (VM), Edge Microgateway requiere un mínimo de 1 núcleo y al menos 256 MB de RAM. El proceso de Edge Microgateway ocupa menos de 128 MB de RAM.
  • En un contenedor, Microgateway se puede usar con un tamaño de imagen inferior a 100 MB.

Requisitos previos

  • Apigee admite versiones Active LTS o Mantenimiento LTS en Windows, macOS y Linux. Consulta Software compatible con Apigee Edge Microgateway a fin de obtener más informació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.18.01 o una posterior de la nube privada.

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. Si operas sin conexión a Internet, consulta ¿Puedo instalar Edge Microgateway sin conexión a Internet?.

  1. Instala la versión más reciente de Edge Microgateway con npm como se indica a continuación. Con este comando, se instala el software y se coloca el ejecutable edgemicro en tu ruta de acceso.
    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 3.1.5.

    npm install edgemicro@3.1.5 -g
    
  2. Verifica el número de versión. Por ejemplo, si instalaste la versión 3.1.5:
    edgemicro --version
    current nodejs version is v12.5.0
    current edgemicro version is 3.1.5
    
  3. Sigue los pasos de configuración que se indican en Configura y configura Edge Microgateway.

Actualiza Edge Microgateway

Para actualizar una versión de Edge Microgateway instalada con anterioridad, consulta Actualiza Edge Microgateway si tienes una conexión a Internet.

Apigee recomienda que pruebes tu configuración existente con la versión nueva antes de actualizar tu entorno de producción.

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 o actualización que se proporcionaron anteriormente.

Primeros pasos

Si es la primera vez que usas Edge Microgateway, el mejor lugar para comenzar después de completar la instalación es Configura y configura Edge Microgateway. 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

La configuración del prefijo se establece de forma predeterminada en la ubicación en la que se instala el nodo. En la mayoría de los sistemas, es /usr/local. En Windows, es %AppData%\npm. El valor de [prefix] se puede configurar. Consulta npm-folders para obtener más información sobre dónde se instalan los módulos de Node.js de forma predeterminada y cómo configurar la ubicación de instalació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 de Edge Microgateway si tienes dudas.
  3. Borra o archiva los archivos de configuración del entorno de ejecución y de la caché:
    ~/.edgemicro/*.yaml
    

Asistencia de Kubernetes

Puedes usar Edge Microgateway a fin de proporcionar administración de API de Apigee para servicios que se ejecutan en un clúster de Kubernetes. Consulta Integra Edge Microgateway en la descripción general de Kubernetes.

Compatibilidad con Docker

Ahora puedes descargar la versión más reciente de Edge Microgateway como una imagen de Docker:

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