21
0
Fork 0

Ajout de doc awx

This commit is contained in:
pmarchand 2023-01-24 22:21:04 +01:00
parent 6b701f698a
commit 28ad38d944
1 changed files with 48 additions and 1 deletions

View File

@ -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 dexé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`