ocaml_webapp

OCAML_WEBAPP

Un exemple minimal d'un WebApp léger dans OCAML.

Il dispose d'une organisation possible de fichiers pour maximiser le partage de code entre le serveur (OCAML natif) et le client (BuckleScript). Certaines des choses partagées sont:

• React Composants, qui sont rendues côté serveur avec TYXML et hydratées avec ReasonReact
• Routes, via les routes de la bibliothèque OCAML.
• Les types d'interface de terminaison API, via la bibliothèque ATD, qui génère également automatiquement des encodeurs / décodeurs.

Potentiellement, le dossier shared peut contenir d'autres code partagés comme les fonctions de validation, le traitement des données, etc.

Commencer

Créer un commutateur local OPAM:

make create-switch

Installez dune dans le commutateur nouvellement créé:

opam install dune

Installez toutes les dépendances:

make deps

Créer un client:

 yarn webpack:dev

Créez et exécutez le serveur:

make run

Ouvrez le navigateur et allez sur http: // localhost: 3000 /.

Il est également possible de recharger à chaud pendant le développement. Pour cela, démarrez le serveur (pour pouvoir servir les demandes d'API) avec make run , exécuter BuckleScript dans yarn start , puis démarrer le serveur de développement WebPack avec yarn server .

Exécutez les bases de données localement

 docker-compose -f docker-compose.dev.yml up -d

Déploiement à Heroku

À l'heure actuelle, l'exemple permet de déployer facilement l'application sur Heroku. Les temps de construction sont plus longs qu'ils ne le devraient, mais j'espère que cela sera bientôt corrigé.

• Installez la CLI Heroku: http://toolbelt.heroku.com/
• Exécutez heroku create your_app à partir du dossier de l'application
• Définir la pile pour l'application dans container : heroku stack:set container
• git push heroku master

Ressources

• Tutoriel étonnant pour créer un webapp Ocaml léger: https://shonfeder.gitlab.io/ocaml_webapp/
• Déploiement de la raison native / OCAML avec Zeit's Now.sh: https://jaredforsyth.com/posts/deploying-native-reason-ocaml-with-now-sh//
• Déploiement du serveur OCAML sur Heroku: https://medium.com/@aleksandrasays/deploying-ocaml-server-on-eroku-f91dcac11f11