diff --git a/README.md b/README.md index 1be3086..48c9f63 100644 --- a/README.md +++ b/README.md @@ -1,82 +1,89 @@ # role_podman -Rôle de déploiement de podman. +Install podman and manage pods and containers. -## Pré-requis +## Pre-requisite -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. -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 -$ cd playbook_podman -$ tee requirements.yml <Default value: `["catatonit", "dbus-user-session", "passt", "podman", "podman-docker", "uidmap", "systemd-container"]` + +### podman_fix_pasta + +On bookworm, we need to fix pasta to use podman ([see here](https://github.com/containers/buildah/issues/5440#issuecomment-2028911573)). + +Default value: `false` + +### podman_user + +Users with container configuration. + +Default value: `podman` + ### podman_configure_rsyslog -Désactive les messages du programme *podman* et des programmes dans les conteneurs si ils portent le nom du conteneur. +Status of messages from the *podman* binary and from binaries in containers if they're equalto the container name. -Valeur par défaut: `true` (activé, `false` pour désactiver) +Default value: `true` + +### podman_ssh_host + +Host to be tested for instance availability. + +Default value: `{{ inventory_hostname }}` + +### podman_ssh_port + +Port to be tested for instance availability. + +Default value: `22` + +### podman_auto_update + +Status of the automatic container update service. + +Default value: `true` + +### podman_pods + +List of dictionnaries to define pods ([see ansible documentation](https://docs.ansible.com/ansible/latest/collections/containers/podman/podman_pod_module.html)). + +Default value: none ### podman_containers -Définition des conteneurs à déployer. +List of dictionnaries to define containers ([see ansible documentation](https://docs.ansible.com/ansible/latest/collections/containers/podman/podman_container_module.html#ansible-collections-containers-podman-podman-container-module)). -Valeur par défaut: *aucune* +Default value: none -## Utilisation +## Extras -Définir la variable `podman_containers` dans un fichier sous `host_vars` ou `group_vars` : +It's possible to use this role with the alvistack repository by setting the variables to the following values: -```bash -$ tee host_vars/lxd_podman_host.yml <