fix: Rewrite the readme
This commit is contained in:
parent
6ad04fa8eb
commit
ff07b53990
68
README.md
68
README.md
@ -4,25 +4,26 @@ Rôle de déploiement de podman.
|
|||||||
|
|
||||||
## Pré-requis
|
## Pré-requis
|
||||||
|
|
||||||
Ce rôle créer un utilisateur à l'aide de ce rôle qu'il faut donc installé lors de l'exécution d'un playbook.<br>
|
Ce rôle créer un utilisateur dédié via [cet autre rôle](https://gitea.ykn.fr/ansible/role_users) dont il est dépendant.
|
||||||
Afin d'installer les deux rôles dans un playbook :
|
L'utilisation de ce rôle et de sa dépendance dans un playbook nécessite d'utilise ansible-galaxy en lui indiquant un fichier dont le contenu est le suivant :
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
$ cd playbook_podman
|
$ cd playbook_podman
|
||||||
$ tee <<EOF
|
$ tee requirements.yml <<EOF
|
||||||
---
|
---
|
||||||
|
|
||||||
- name: users
|
roles:
|
||||||
scm: git
|
- name: users
|
||||||
src: ssh://gitea@git.ykn.fr:12393/ansible/role_users.git
|
scm: git
|
||||||
version: alpha
|
src: ssh://gitea@git.ykn.fr:12393/ansible/role_users.git
|
||||||
|
version: alpha
|
||||||
|
|
||||||
- name: podman
|
- name: podman
|
||||||
scm: git
|
scm: git
|
||||||
src: ssh://gitea@git.ykn.fr:12393/ansible/role_podman.git
|
src: ssh://gitea@git.ykn.fr:12393/ansible/role_podman.git
|
||||||
version: alpha
|
version: alpha
|
||||||
EOF
|
EOF
|
||||||
$ ansible-galaxy install -fr requirements_roles.yml
|
$ ansible-galaxy install -fr requirements.yml
|
||||||
```
|
```
|
||||||
|
|
||||||
## Variables
|
## Variables
|
||||||
@ -31,4 +32,45 @@ $ ansible-galaxy install -fr requirements_roles.yml
|
|||||||
|
|
||||||
Définition des conteneurs à déployer.
|
Définition des conteneurs à déployer.
|
||||||
|
|
||||||
<span style="text-decoration: underline">Valeur par défaut:</span> aucune
|
<span style="text-decoration: underline">Valeur par défaut:</span> *aucune*
|
||||||
|
|
||||||
|
## Utilisation
|
||||||
|
|
||||||
|
Définir la variable `podman_containers` dans un fichier sous `host_vars` ou `group_vars` :
|
||||||
|
|
||||||
|
```bash
|
||||||
|
$ tee host_vars/lxd_podman_host.yml <<EOF
|
||||||
|
---
|
||||||
|
|
||||||
|
podman_containers:
|
||||||
|
- image: docker.io/wallabag/wallabag:latest
|
||||||
|
name: wallbag
|
||||||
|
userns: keep-id
|
||||||
|
volumes:
|
||||||
|
- wallbag-data:/var/www/wallabag/data
|
||||||
|
- wallbag-image:/var/www/wallabag/web/assets/images
|
||||||
|
ports:
|
||||||
|
- 80:80/tcp
|
||||||
|
environment_vars:
|
||||||
|
- SYMFONY__ENV__DOMAIN_NAME=https://wallbag.ykn.fr
|
||||||
|
```
|
||||||
|
|
||||||
|
Il est également possible de définir l'utilisateur via la variable `user`, comme ceci :
|
||||||
|
|
||||||
|
```bash
|
||||||
|
$ tee host_vars/lxd_podman_host.yml <<EOF
|
||||||
|
---
|
||||||
|
|
||||||
|
podman_containers:
|
||||||
|
- image: docker.io/wallabag/wallabag:latest
|
||||||
|
name: wallbag
|
||||||
|
user: un_utilisateur
|
||||||
|
userns: keep-id
|
||||||
|
volumes:
|
||||||
|
- wallbag-data:/var/www/wallabag/data
|
||||||
|
- wallbag-image:/var/www/wallabag/web/assets/images
|
||||||
|
ports:
|
||||||
|
- 80:80/tcp
|
||||||
|
environment_vars:
|
||||||
|
- SYMFONY__ENV__DOMAIN_NAME=https://wallbag.ykn.fr
|
||||||
|
```
|
||||||
|
Loading…
Reference in New Issue
Block a user