Installer Edge Microgateway

Vous consultez la documentation Apigee Edge.
Accédez à la documentation**Apigee X**.
info

Edge Microgateway v. 3.3.x

Cet article explique comment installer ou désinstaller Edge Microgateway.

Configuration matérielle minimale requise

Edge Microgateway nécessite la configuration matérielle minimale suivante :

  • Sur une machine virtuelle, Edge Microgateway nécessite au moins un cœur et 256 Mo de RAM. Le processus Edge Microgateway lui-même nécessite moins de 128 Mo de RAM.
  • Sur un conteneur, Microgateway peut être utilisé avec une taille d'image inférieure à 100 Mo.

Prérequis

  • Apigee est compatible avec les versions Active LTS ou Maintenance LTS sur Windows, macOS et Linux. Pour en savoir plus, consultez Logiciels compatibles avec Apigee Edge Microgateway.
  • Windows nécessite l'installation d'OpenSSL et son ajout au PATH.
  • Si vous utilisez Apigee Edge Private Cloud pour configurer Edge Microgateway, vous devez être exécuter la version 4.18.01 ou une version ultérieure de Private Cloud.

Installer Edge Microgateway si vous disposez d'une connexion Internet

Cette section explique comment installer Edge Microgateway et initialiser une configuration par défaut. Si vous n'avez pas de connexion Internet, consultez Puis-je installer Edge Microgateway sans connexion Internet ?.

  1. Installez la dernière version d'Edge Microgateway avec npm comme suit. Cette commande installe le logiciel et place l'exécutable edgemicro dans votre chemin d'accès.
    npm install edgemicro -g

    Pour installer une version spécifique d'Edge Microgateway, vous devez spécifier le numéro de version dans la commande d'installation. Si vous ne spécifiez pas le numéro de version, la dernière version sera installée. Par exemple, pour installer la version 3.1.5, utilisez la commande suivante.

    npm install edgemicro@3.1.5 -g
  2. Vérifiez le numéro de version. Par exemple, si vous avez installé la version 3.1.5 :
    edgemicro --version
    current nodejs version is v12.5.0
    current edgemicro version is 3.1.5
  3. Suivez les étapes de configuration décrites dans Configurer Edge Microgateway.

Mettre à niveau Edge Microgateway

Pour mettre à niveau une version précédemment installée d'Edge Microgateway, consultez Mettre à niveau Edge Microgateway si vous disposez d'une connexion Internet.

Apigee vous recommande de tester votre configuration existante avec la nouvelle version avant de mettre à niveau votre environnement de production.

Exécuter Edge Microgateway sur Windows en tant que service

Vous pouvez exécuter Edge Microgateway sur Windows en tant que service. Pour en savoir plus, consultez les bonnes pratiques pour la gestion opérationnelle de Microgateway (edgemicro) sur Windows sur la communauté Apigee.

Puis-je installer Edge Microgateway sans connexion Internet ?

Sur les sites qui ne disposent pas d'un accès Internet prêt à l'emploi, un administrateur peut installer et gérer un registre npm privé sur votre réseau interne. Les instructions de configuration d'un registre npm ne sont pas abordées dans ce guide . Toutefois, vous pouvez rechercher et trouver des instructions utiles. Une fois le registre npm privé installé, vous pouvez suivre les instructions d'installation ou de mise à niveau données ci-dessus.

Premiers pas

Si vous n'avez jamais utilisé Edge Microgateway, la page Configurer Edge Microgateway est le meilleur point de départ une fois l'installation terminée. Le guide de configuration couvre toutes les étapes à suivre pour installer, configurer, démarrer et utiliser une instance d'Edge Microgateway.

Où Edge Microgateway est-il installé ?

Lorsque vous utilisez npm avec l'option globale (npm install -g edgemicro), le logiciel est installé dans [prefix]/lib/node_modules/edgemicro. Vous pouvez trouver la valeur de [prefix] avec la commande suivante :

npm config get prefix

La configuration du préfixe est définie par défaut sur l'emplacement où le nœud est installé. Sur la plupart des systèmes, il s'agit de /usr/local. Sous Windows, il s'agit de %AppData%\npm. La valeur de [prefix] est configurable. Pour en savoir plus sur l'emplacement d'installation par défaut des modules Node.js et sur la configuration de l'emplacement d'installation, consultez npm-folders.

Désinstaller Edge Microgateway

Si vous devez supprimer Edge Microgateway :

  1. Supprimez ou archivez le répertoire d'installation [prefix]/lib/node_modules/edgemicro, où [prefix] est le préfixe npm comme expliqué dans Où Edge Microgateway est-il installé ?
  2. Supprimez ou archivez les fichiers journaux. Par défaut, edgemicro-*.log fichiers se trouvent dans /var/tmp/, mais cet emplacement est configurable. En cas de doute, consultez le fichier de configuration d'Edge Microgateway.
  3. Supprimez ou archivez les fichiers de configuration de l'environnement d'exécution et du cache :
    ~/.edgemicro/*.yaml

Compatibilité avec Kubernetes

Vous pouvez utiliser Edge Microgateway pour fournir une gestion des API Apigee pour les services exécutés dans un cluster Kubernetes. Consultez la présentation de l'intégration d'Edge Microgateway à Kubernetes.

Compatibilité avec Docker

Vous pouvez désormais télécharger la dernière version d'Edge Microgateway en tant qu'image Docker :

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