Difference between revisions of "OpenAPI OAR"
Jump to navigation
Jump to search
(Created page with "=Objectif= Il s'agit de créer une REST API suivant la spécification https://en.wikipedia.org/wiki/OpenAPI_Specification OpenAPI pour le gestionaire de tâches et de ressour...") |
|||
Line 1: | Line 1: | ||
=Objectif= |
=Objectif= |
||
− | Il s'agit de créer une REST API suivant la spécification https://en.wikipedia.org/wiki/OpenAPI_Specification OpenAPI pour le gestionaire de tâches et de ressources http://oar.imag.fr/ OAR. |
+ | Il s'agit de créer une REST API suivant la spécification [https://en.wikipedia.org/wiki/OpenAPI_Specification OpenAPI] pour le gestionaire de tâches et de ressources [http://oar.imag.fr/ OAR]. |
Cette spécification permet de produire et maintenir des services web robustes et bien définier. Par exemple l'orchestrateur de containers Kubernetes dispose d'un API suivant cette spécification https://kubernetes.io/docs/concepts/overview/kubernetes-api/#api-specification |
Cette spécification permet de produire et maintenir des services web robustes et bien définier. Par exemple l'orchestrateur de containers Kubernetes dispose d'un API suivant cette spécification https://kubernetes.io/docs/concepts/overview/kubernetes-api/#api-specification |
||
Revision as of 13:32, 14 January 2021
Objectif
Il s'agit de créer une REST API suivant la spécification OpenAPI pour le gestionaire de tâches et de ressources OAR. Cette spécification permet de produire et maintenir des services web robustes et bien définier. Par exemple l'orchestrateur de containers Kubernetes dispose d'un API suivant cette spécification https://kubernetes.io/docs/concepts/overview/kubernetes-api/#api-specification
Le logiciel OAR dispose déjà d'une Rest API qui servira de base de travail:
- Documentation REST API d'OAR http://oar.imag.fr/docs/latest/user/api.html
- http://oar.imag.fr/oar_3
- Code de la rest api version 3: https://github.com/oar-team/oar3/tree/master/oar/rest_api
Les contraintes technologigues
- https://github.com/OpenAPITools/openapi-generator
- https://openapi-generator.tech/
- Python 3
- Python Flask
Plan de travail et indications
- Prise en main de l'approche OpenAPI (modification de l'exemple Petstore et génération de du server)
- Utilisation d'un éditeur de specfication d'OpenAPI (https://github.com/swagger-api/swagger-editor ?)
- Generatoion d'un (mock) server Python Flash via le générateur openapi-generator
- étude problématique d'authentification, utilisation de la méthode HTTP patch
- étude le l'API / choix de Kubernetes