From 28ad38d9446ab826219bd75c27835e2b74df96a4 Mon Sep 17 00:00:00 2001 From: pmarchand Date: Tue, 24 Jan 2023 22:21:04 +0100 Subject: [PATCH] Ajout de doc awx --- HowtoAWX.md | 49 ++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 48 insertions(+), 1 deletion(-) diff --git a/HowtoAWX.md b/HowtoAWX.md index d7f67bbe..e3462839 100644 --- a/HowtoAWX.md +++ b/HowtoAWX.md @@ -15,12 +15,49 @@ title: How to AWX À partir de 18.0 il est recommandé de l'installer à travers [AWX Operator](https://github.com/ansible/awx-operator) qui dépend de kubernetes. Il est aussi possible d'utiliser une image docker. -Une interface de ligne de commande peut ensuite être installé directement sur l'hôte +### Docker + +Copier le dépôt sur le serveur a partir d'une version stable: https://github.com/ansible/awx/releases/tag + +Il faudra installer les paquets suivants: + + - `python3` + - `python3-venv` + - `python3-setuptools-scm` + - `python3-psycopg2` + - `ansible` + - `docker-compose` + +Le dépôt devra appartenir a l'usager exécutant, il faut s'assurer que les programmes dans le dossier tools ont bien un droit d’exécution. (Faire attention a noexec qui peut remonter jusqu'au conteneur dans certains cas) + +Une fois les prérequis installée et les permissions bien appliquée, on peut continuer avec l'installation: + +La documentation complète se situe ici: https://github.com/ansible/awx/blob/devel/tools/docker-compose/README.md + +`` +make docker-compose-build +make docker-compose +`` + +Suite a la complétion, on peut lancer dans un autre terminal: + +`` +docker exec tools_awx_1 make clean-ui ui-devel +`` + +On peut ensuite accéder a l'interface sur `https://localhost:8043/#/home` + + +### CLI + +Une interface de ligne de commande peut aussi être installé directement sur l'hôte ``` pip3 install awxkit ``` +### Doc + La documentation peut être installé en local ``` @@ -32,3 +69,13 @@ Serving HTTP on 0.0.0.0 port 8000 (http://0.0.0.0:8000/) .. ``` ## Configuration + +### Creer un nouvel admin + +``` +docker exec -ti tools_awx_1 awx-manage createsuperuser +``` + +### Utiliser un postgres externe + +Il faut aller indiquer le postgres desiree dans les variables de `tools/docker-compose/inventory` \ No newline at end of file