Installation de l'APIM de Gravitee

Qu'est-ce que Gravitee ?

Pour faire simple, Gravitee est un outil de gestion d’API. Il se base sur une interface web utilisateur assez simple et intuitive. Pour ce qui est du serveur, Gravitee va utiliser Elasticsearch et une base de données MongoDB.

Pour ce qui est du côté client, l’interface de management (APIM) est simple et rapide. Elle facilite grandement la gestion des APIs.

Installation de l'APIM de Gravitee

Pour gérer les applications que l’on peut avoir en lien avec les APIs, nous avons aussi accès à un portail de gestion, qui lui aussi est très simple d’utilisation.

Installation de l'APIM de Gravitee

Mise en place de l'APIM de Gravitee

Tout d’abord, nous allons commencer par installer les prérequis pour pouvoir faire l’installation complète sans problème.

JDK (Java Development Kit)

Tout d’abord, nous allons commencer par installer Java. L’APIM Gravitee requiert au moins la version 11 de JDK. On va donc prendre la dernière version en date disponible.

Installation de l'APIM de Gravitee

Une fois JDK téléchargé, il faudra ajouter une variable dans les variables d’environnement de votre PC, comme ceci :

Installation de l'APIM de Gravitee

Une fois ceci fait, nous allons redémarrer le PC pour qu’il prenne en compte la nouvelle variable.

Puis pour tester que Java est bien installé, ouvrez un terminal et tapez la commande :

java –version

Mongo DB

Dans un second temps, il sera nécessaire d’avoir MongoDB car c’est la base de données utilisé par Gravitee. Pour l’installer, il faudra prendre la version actuelle, ici la 5.0.9.

Installation de l'APIM de Gravitee

Elasticsearch

Pour finir dans les prérequis, il sera obligatoire aussi d’avoir elasticsearch et de télécharger une version compatible à l’APIM Gravitee c’est-à-dire la 7.17.4.

Installation de l'APIM de Gravitee

Télécharger le fichier Zip

Juste avant de faire cela, il va falloir créer dans les documents un fichier Gravitee par exemple.

Fichier zip

Il faudra ensuite télécharger le fichier zip contenant tous les services de l’APIM (Gateway, Console, API et Portail). Une fois ceci fait, il faudra dézipper le fichier que l’on vient de prendre dans celui que l’on à créé auparavant. Il faudra également y glisser le fichier dézippé d’Elastic.

Les services APIM

Elastic

Pour lancer Elasticsearch, il faudra se rendre dans un terminal Visual Studio Code ou un invite de commande simple, et se rendre dans le fichier en question en utilisant la commande suivante :

cd \gravitee\elasticsearch-7.17.4.\bin

Puis celle-ci :

: ./elasticsearch.bat

Elasticsearch est lancé !

APIM Gateway

Pour lancer la Gateway, c’est un peu le même principe : il faudra se mettre dans le fichier en question. Avec les deux commandes suivantes on se mettra dans le dossier puis on lancera la Gateway.

Installation de l'APIM de Gravitee

Pour vérifier que tout fonctionne bien on va se rendre sur l’adresse :

Installation de l'APIM de Gravitee

Celle-ci devrait normalement renvoyer : No context-path matches the request URI. Donc tout fonctionne bien !

APIM API

Pour lancer l’API, il faudra se mettre dans le fichier en question. Avec les deux commandes suivantes on se mettra dans le dossier puis on lancera l’API.

Installation de l'APIM de Gravitee

Pour vérifier que tout fonctionne bien on va se rendre sur l’adresse :

Installation de l'APIM de Gravitee

Celle-ci devrait normalement renvoyer : [ ]

APIM Console

Pour la console c’est un peu différent, c’est un serveur que nous avons besoin de lancer. Il suffira de lancer les commandes suivantes :

Installation de l'APIM de Gravitee

La console sera donc lanceée sur l’adresse :

Installation de l'APIM de Gravitee

Pour se connecter en tant qu’admin, les identifiants sont admin/admin.

APIM Portail

Pour finir, pour le portail de l'APIM, il y aura juste le serveur à installer et à lancer.

Installation de l'APIM de Gravitee

Pour vérifier si tout fonctionne bien on se rendra sur l’adresse :

Installation de l'APIM de Gravitee

et on aura accès au portail une fois que l’on aura rentré nos identifiants (idem que pour la console).

Une fois que toutes ces étapes auront été respectées, l’APIM est installé. Vous pouvez commencer à manipuler et exposer vos API.

Vous souhaitez bénéficier d'experts Gravitee, de développeurs Gravitee, ou d'une formation sur Gravitee ? Rendez vous sur la page Contact