From 3c39c798b0a8651603a9da7add56323ff2482d12 Mon Sep 17 00:00:00 2001 From: Valentin Lab Date: Wed, 14 Jul 2021 08:48:43 +0200 Subject: [PATCH] fix: doc: rewrite of last paragraph in less casual style Signed-off-by: Valentin Lab --- README.org | 33 ++++++++++++++++++++------------- 1 file changed, 20 insertions(+), 13 deletions(-) diff --git a/README.org b/README.org index fd1b50d..29b9e81 100644 --- a/README.org +++ b/README.org @@ -950,16 +950,23 @@ compose --debug up odoo frontend * Comment ça marche -La surcouche =compose= est là pour créer un =docker-compose.yml= et le -lancer tout a fait normalement. Le long du chemin, il peut aussi -préparer des trucs utiles si c'est nécessaire. - -Il part du =compose.yml= et accède aux définitions en yaml des charms à déployer -et qui sont dans /srv/charms ... (qui en fait sont dans =/opt/apps/0k-charms=). - -Chaque charm possède une définition générale (le =metadata.yml=) qui peut aussi -injecter des trucs dans le =docker-compose.yml= final. - -Et puis il y a des =hooks=, qui sont juste des scripts bash qui sont -lancés avec des infos dans des variables d'environment, qui vont généralement -créer des trucs à l'init ou lors de liaison avec d'autres charms. +La surcouche =compose= a pour responsabilité de: +- créer graduellement un =docker-compose.yml= et lancer =docker-compose=. + - à partir des *charms* qui factorisent les parties réutilisables + - et à partir du =compose.yml= qui offre une interface plus haut niveau + et permet d'exprimer plus succintement les intentions de déploiement sans + entrer dans la logique technique de l'implémentation des services. +- lancer des executable et des instructions au fur et à mesure si nécessaire. + +Il part du =compose.yml= et accède aux définitions en yaml des charms +à déployer et qui sont dans /srv/charms ... (qui en fait sont dans +=/opt/apps/0k-charms=). + +Chaque charm possède une définition générale (le =metadata.yml=) qui +permet également l'injection d'élément dans le =docker-compose.yml= +final. + +Et puis il y a des =hooks= : des scripts bash lancés avec des +information contextuelle dans des variables d'environment, et qui vont +généralement mettre en place des services à l'initialisation ou pour +s'assurer de la bonne liaison entre les services.