Installer Edge Microgateway

Vous consultez la documentation d'Apigee Edge.
Consultez la documentation Apigee X.
en savoir plus

Edge Microgateway version 3.1.x

Cette rubrique 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 moins un cœur et au moins 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ée avec une taille d'image inférieure à 100 Mo.

Conditions préalables

  • Apigee est compatible avec les versions Active LTS et Maintenance LTS sur Windows, macOS et Linux. Consultez la page Logiciels compatibles avec Apigee Edge Microgateway pour plus d'informations.
  • Windows nécessite l'installation d'OpenSSL et l'ajout à PATH.
  • Si vous utilisez le cloud privé Apigee Edge pour la configuration avec Edge Microgateway, vous devez exécuter le cloud privé 4.18.01 ou une version ultérieure.

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 utilisez une connexion Internet sans connexion, consultez la section 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.0, utilisez la commande suivante.

    npm install edgemicro@3.1.0 -g
    
  2. Vérifiez le numéro de version. Par exemple, si vous avez installé la version 3.1.0 :
    edgemicro --version
    current nodejs version is v12.5.0
    current edgemicro version is 3.1.0
    
  3. Suivez les étapes d'installation et de configuration de la section Installer et configurer Edge Microgateway.

Mise à niveau d'Edge Microgateway

Pour mettre à niveau une version d'Edge Microgateway précédemment installée, consultez la section 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.

Operating Edge Microgateway sur Windows en tant que service

Vous pouvez utiliser Edge Microgateway sous Windows en tant que service. Pour en savoir plus, consultez les bonnes pratiques pour la gestion opérationnelle de Microgateway (edgemicro) sous Windows dans 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, un administrateur peut installer et gérer un registre npm privé sur votre réseau interne. Les instructions pour configurer un registre npm privé sortent du cadre de ce guide. Toutefois, vous pouvez rechercher et trouver des instructions utiles. Avec un registre npm privé installé, vous pouvez suivre les instructions d'installation ou de mise à niveau ci-dessus.

Premiers pas

Si vous débutez avec Edge Microgateway, la section Configurer et configurer Edge Microgateway est le meilleur point de départ une fois l'installation terminée. Le guide de configuration et d'installation décrit 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 obtenir la valeur de [prefix] à l'aide de la commande suivante:

npm config get prefix

La configuration du préfixe correspond par défaut à 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. Consultez npm-folders pour en savoir plus sur l'emplacement par défaut des modules Node.js et sur leur configuration.

Désinstaller Edge Microgateway

Si vous devez retirer Edge Microgateway:

  1. Supprimez ou archivez le répertoire d'installation [prefix]/lib/node_modules/edgemicro, où [prefix] correspond au préfixe npm, comme expliqué dans la section Où Edge Microgateway est-elle installée ?
  2. Supprimez ou archivez les fichiers journaux. Par défaut, les fichiers edgemicro-*.log se trouvent dans /var/tmp/, mais cet emplacement peut être configuré. En cas de doute, vérifiez le fichier de configuration Edge Microgateway.
  3. Supprimez ou archivez les fichiers de configuration 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 les services exécutés dans un cluster Kubernetes. Consultez la page Présentation de l'intégration d'Edge Microgateway à 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