WSO2 API Manager est une passerelle API basée sur Open Source qui permet aux équipes de développement de déployer et de surveiller les API et fournit également aux consommateurs une possibilité de s'abonner aux API et de consommer pour répondre à leurs besoins. Pourquoi quelqu'un aurait-il besoin d'un gestionnaire d'API ? Eh bien, c'est une bonne question. Imaginez une organisation exposant ses principaux processus, données et services sous forme d'API au public, et les agences ou parties externes peuvent utiliser ces API pour créer leurs applications. De cette façon, l'entreprise peut améliorer son potentiel de croissance grâce à ses API. Mais que se passe-t-il si les entreprises ont trop d'API exposées au public ? Comment vont-ils gérer ceux-ci, la sécurité, les performances, la journalisation, la surveillance, l'analyse, les politiques, etc. Les passerelles API sont censées faire cela et WSO2 API-M est l'un des produits populaires dans ce domaine. Le gestionnaire d'API facilite la gouvernance complète des API ; Création d'API, publication, gestion du cycle de vie, gestion des versions, sécurité, équilibrage de charge et basculement, monétisation et analyse. Eh bien, dans ce didacticiel, nous installerons WSO2 API Manager 4.0.0 et sur CentOS 7.9.
Prérequis :
- Au moins 4 Go de RAM et 10 Go d'espace disque. Si vous installez sur une VM, alors un minimum de 2 VCPU.
- OpenJDK. Vous devrez peut-être vérifier la compatibilité de la version avant de l'installer. Pour WSO2 version 4.0.0, vous avez besoin d'OpenJDK version 8, 11.
- Apache Ant 1.7.0 ou version ultérieure
Installation du gestionnaire d'API WSO2 sur CentOS
Installation des pré-requis :
Installer OpenJDK 11 sur CentOS
Étape 1 :préparez votre machine avec le dernier référentiel de packages
# yum update
Étape 2 :Installez OpenJDK via yum
# yum install java-11-openjdk-devel
Étape 3 :Installez OpenJRE 11
# yum install java-11-openjdk
Étape 4 :Vérifiez que Java est correctement installé
# java --version openjdk 11.0.12 2021-07-20 LTS OpenJDK Runtime Environment 18.9 (build 11.0.12+7-LTS) OpenJDK 64-Bit Server VM 18.9 (build 11.0.12+7-LTS, mixed mode, sharing)
Étape 5 :Définissez JAVA_HOME variable d'environnement
# update-alternatives --config java There are 2 programs which provide 'java'. Selection Command ----------------------------------------------- * 1 java-1.8.0-openjdk.x86_64 (/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.302.b08-0.el7_9.x86_64/jre/bin/java) + 2 java-11-openjdk.x86_64 (/usr/lib/jvm/java-11-openjdk-11.0.12.0.7-0.el7_9.x86_64/bin/java) Enter to keep the current selection[+], or type selection number: 2
Copiez le chemin de Java à partir de la sortie ci-dessus et définissez le JAVA_HOME variable dans /etc/bashrc ou /etc/bash_profile
export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-11.0.12.0.7-0.el7_9.x86_64 export PATH=$JAVA_HOME/bin:$PATH
Étape 6 :Installer Apache ANT
# wget https://github.com/wso2/product-apim/releases/download/v4.0.0/wso2am-4.0.0.zip # unzip wso2am-4.0.0.zip # mv apache-ant-1.10.11 /opt/
Étape 7 :Définissez ANT_HOME dans bashrc ou bash_profile
export ANT_HOME=/opt/apache-ant-1.10.11 export PATH=$JAVA_HOME/bin:$ANT_HOME/bin:$PATH
Vérifier la version d'Apache ANT
# ant -version Apache Ant(TM) version 1.10.11 compiled on July 10 2021
Étape 8 :Créez un nouvel utilisateur pour exécuter le gestionnaire d'API WSO2
# adduser apigw
Étape 9 :Passez à 'apigw' utilisateur et Télécharger le gestionnaire d'API
Visitez ce lien et téléchargez API Manager 4.0.
$ unzip wso2am-4.0.0.zip
Étape 10 :Définissez le nom d'hôte ou le nom de domaine à utiliser dans /etc/hosts
127.0.0.1 localhost localhost.localdomain wso2.tg.com <local_ip_address> wso2.tg.com
Remarque :N'oubliez pas de remplacer le <local_ip_address> avec une adresse IP réelle.
Étape 11 : Configurer le fichier deployment.toml
Vérifiez les configurations dans wso2am-4.0.0/repository/conf/deployment.toml . Si vous configurez WSO2 pour la toute première fois, vous n'aurez peut-être pas besoin de modifier grand-chose dans ce fichier, à l'exception de ce qui suit.
[server] hostname = "<domain_name/hostname>"
par exemple,
[server] hostname = "wso2.tg.com"
Étape 12 :Démarrez le gestionnaire d'API
N'oubliez pas de démarrer le gestionnaire d'API en tant qu'utilisateur local (apigw) et non en tant que "root".
$ ./bin/api-manager.sh
La commande ci-dessus démarrera le gestionnaire d'API en tant que processus de premier plan permettant de voir les messages et les erreurs imprimés sur stdout . En commençant au premier plan, vous pouvez voir les erreurs et les corriger si nécessaire.
Mais idéalement, le gestionnaire d'API devrait être exécuté en tant que démon en utilisant les options de démarrage et d'arrêt comme indiqué ci-dessous :
$ ./bin/api-manager.sh -start
$ ./bin/api-manager.sh -stop
$ ./bin/api-manager.sh - restart
Recherchez les fichiers journaux sous wso2am-4.0.0/repository/logs dossier.
- wso2carbon.log
- wso2-apigw-errors.log
- wso2-apigw-service.log
- audit.log
- http_access_.2021-09-08.log
Si le gestionnaire d'API ne démarre pas, alors wso2carbon.log et wso2-apigw-errors.log fournira plus d'informations.
Vérifier si API Manager fonctionne correctement.
Essayez d'accéder aux URL suivantes,
- Carbone – https://
:9443/carbon
- URL de l'éditeur :https://
:9443/publisher
- Portail des développeurs :https://
:9443/devportal
Si tout se passe bien, vous devriez pouvoir voir l'interface. Le nom d'utilisateur par défaut est "admin" et le mot de passe est "admin".
Remarque :La base de données par défaut utilisée dans WSO2 est H2. Cependant, WSO2 doit être intégré à la base de données MySQL pour les environnements de production. Nous en discuterons dans un article séparé.