Instala Edge Microgateway

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

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 mínima de hardware:

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

Instala 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. 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 de la siguiente manera. Este comando instala el software y 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, para instalar la versión 3.1.5, usa el siguiente comando. 

    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 en Configura Edge Microgateway.

Actualiza Edge Microgateway

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

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

Opera Edge Microgateway en Windows como un servicio

Puedes operar 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 o actualización que se indican más arriba.

Cómo comenzar

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

La configuración del prefijo se establece de forma predeterminada en la ubicación donde se instala el nodo. En la mayoría de los sistemas, es /usr/local. En Windows, es %AppData%\npm. El valor de [prefix] es configurable. 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 [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 es configurable. Si tienes dudas, consulta el archivo de configuración de Edge Microgateway.
  3. Borra o archiva los archivos de configuración de caché y de configuración del entorno de ejecución: 
    ~/.edgemicro/*.yaml

Compatibilidad con Kubernetes

Puedes usar Edge Microgateway para proporcionar administración de API de Apigee para los servicios que se ejecutan en un clúster de Kubernetes. Consulta Descripción general de la integración de Edge Microgateway con 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