Installer Edge Microgateway

<ph type="x-smartling-placeholder"></ph> Vous consultez la documentation Apigee Edge.
Accédez à la page Documentation sur Apigee X. En savoir plus

Edge Microgateway version 3.0.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 (VM), Edge Microgateway nécessite au minimum un cœur et au moins au moins 256 Mo de RAM. Le processus Edge Microgateway lui-même utilise moins de 128 Mo de RAM.
• Sur un conteneur, Microgateway peut être utilisé avec une taille d'image inférieure à 100 Mo.

Prérequis

• Vous devez disposer de Node.js version 8.x LTS ou 12.x. installé sur votre système. Vous pouvez vérifier la version en exécutant la commande suivante:

  node -v
  v12.5.0
  

• Windows nécessite l'installation et l'ajout d'OpenSSL. vers PATH.
• Si vous utilisez le cloud privé Apigee Edge pour effectuer une configuration avec Edge Microgateway, vous devez être exécutant Private Cloud version 4.18.01 ou ultérieure.

Installez Edge Microgateway si tu as une connexion Internet

Cette section explique comment installer Edge Microgateway et initialiser une passerelle par défaut configuration. Si vous travaillez sans connexion Internet, consultez Puis-je installer Edge Microgateway sans connexion Internet ?

1. Installez la dernière version d'Edge Microgateway avec npm comme suit. Ce installe le logiciel et place l'exécutable edgemicro. sur votre chemin.

   npm install edgemicro -g
   

   Pour installer une version spécifique d'Edge Microgateway, vous devez spécifier le version number 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 version 2.5.7, utilisez la commande suivante.

   npm install edgemicro@3.0.2 -g
   

2. Vérifiez le numéro de version. Par exemple, si vous avez installé la version 3.0.2:

   edgemicro --version
   current nodejs version is v12.5.0
   current edgemicro version is 3.0.2
   

3. Suivez les étapes d'installation et de configuration décrites dans la section Configuration et la configuration d'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 la nouvelle version avant de mettre à niveau votre environnement de production.

L'utilisation d'Edge Microgateway sous Windows Service

Vous pouvez utiliser Edge Microgateway sous Windows en tant que service. Pour plus d'informations, voir Bonnes pratiques de gestion opérationnelle de Microgateway (edgemicro) sous Windows sur le Communauté Apigee.

Puis-je installer Edge Microgateway sans connexion Internet ?

Sur les sites qui ne disposent pas d'un accès à Internet, un administrateur peut installer et gérer un registre npm privé ; sur votre réseau interne. Pour configurer un registre npm privé, suivez les instructions ci-dessous. n'entrent pas dans le cadre de ce guide. Cependant, vous pouvez rechercher et trouver des instructions utiles. Avec un dans votre registre npm privé, suivez les instructions d'installation ou de mise à niveau fournies. ci-dessus.

Premiers pas

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

Emplacement 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 trouverez la valeur de [prefix] par 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 /usr/local Sous Windows, il s'agit de %AppData%\npm. La valeur [prefix] est configurable. Consultez la page npm-folders pour en savoir plus sur l'emplacement où Node.js modules sont installés par défaut et comment configurer l’emplacement d’installation.

Désinstaller Edge Microgateway

Si vous devez supprimer Edge Microgateway:

1. Supprimer ou archiver le répertoire d'installation [prefix]/lib/node_modules/edgemicro, où [préfixe] correspond à npm comme expliqué dans la section Où Edge Microgateway est-il installé ?
2. <ph type="x-smartling-placeholder"></ph> Supprimez ou archivez les fichiers journaux. Par défaut, edgemicro-*.log fichiers se trouvent dans /var/tmp/, mais cet emplacement peut être configuré. Chèque le fichier de configuration Edge Microgateway, en cas de doute.
3. Supprimez ou archivez les fichiers de configuration de l'environnement d'exécution et de mise en cache:

   ~/.edgemicro/*.yaml
   

Compatibilité avec Kubernetes

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

Compatibilité avec Docker

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

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