Instala Edge Microgateway

Estás viendo la documentación de Apigee Edge.
Ve a la Documentación de Apigee X. información

Edge Microgateway v. 3.1.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 requiere menos de 128 MB de RAM.
  • En un contenedor, se puede usar Microgateway con un tamaño de imagen de menos de 100 MB.

Requisitos previos

  • Apigee admite versiones Active LTS o Mantenimiento LTS en Windows, macOS y Linux. Consulta Software compatible con Apigee Edge Microgateway para obtener más información.
  • Windows requiere que instales y agregues OpenSSL. a PATH.
  • Si usas Apigee Edge Private Cloud para realizar la configuración con Edge Microgateway, debes tener ejecutando la versión 4.18.01 o posterior de la Nube privada.

Instala Edge Microgateway en el siguiente caso: ¿Tienes conexión a Internet?

En esta sección, se explica cómo instalar Edge Microgateway y cómo inicializar una puerta de enlace predeterminada configuración. Si estás operando 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. Esta instala el software y pone el archivo ejecutable edgemicro en tu ruta. 
    npm install edgemicro -g

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

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

Actualiza Edge Microgateway

Para actualizar una versión de Edge Microgateway instalada anteriormente, 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.

Opera Edge Microgateway en Windows como un Servicio

Puedes usar Edge Microgateway en Windows como servicio. Para obtener detalles, consulta Prácticas recomendadas para la administración operativa de Microgateway (edgemicro) en Windows en el Comunidad de Apigee.

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

En los sitios que no tienen un buen acceso a Internet, el administrador puede instalar y mantener un registro de npm privado en tu red interna. Las instrucciones para configurar un registro privado de npm son las siguientes: fuera del alcance de esta guía; Sin embargo, puedes buscar y encontrar instrucciones útiles. Con un registro privado de npm instalado, puedes seguir las instrucciones de instalación o actualización que se proporcionan arriba.

Cómo comenzar

Si es la primera vez que usas Edge Microgateway, los recursos de configuración configurar Edge Microgateway es el mejor punto de partida después de completar el instalar. La guía de configuración abarca todos los pasos necesarios para la instalación, 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 está instalado 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 en la que está instalado el nodo. En la mayoría de los sistemas, esto 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 está Node.js. módulos se instalan de forma predeterminada y cómo configurar la ubicación de instalación.

Desinstala Edge Microgateway

Si necesitas quitar Edge Microgateway, haz lo siguiente:

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

Asistencia de Kubernetes

Puedes usar Edge Microgateway para brindar administración de APIs de Apigee a servicios que se ejecutan en un clúster de Kubernetes. Consulta la 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