Refresh README

This commit is contained in:
William Hirigoyen 2023-09-15 10:13:52 +02:00
parent 48e79bd48c
commit 4f67259648

View file

@ -1,15 +1,15 @@
# Ansible-public
This repository contains some stuff related to Ansible (except roles, that are in an [https://forge.evolix.org/projects/ansible-roles/repository](ansible-roles repository)".
This repository contains some stuff related to Ansible (except roles, that are in our [`ansible-roles` repository](https://forge.evolix.org/projects/ansible-roles/repository).
One the main part is our Evolinux playbook, that we use to customize a Linux Debian server.
The main part is our Evolinux playbook, that we use to customize a Linux Debian server.
It also contains our conventions for Ansible.
For beginners, you can read the topic [https://wiki.evolix.org/HowtoAnsible](HowtoAnsible).
## Evolinux
To set up a server according to "The Evolix Way", you have to install a Debian Linux stable (currently Jessie, v8.7).
To set up a server according to "The Evolix Way", you have to install the current Debian stable version.
### Prerequisites
@ -22,7 +22,7 @@ We recommend using Debian with the "netinst" CD image, here are some key setting
We recommend to install only the minimum packages. At the "tasksel" step, choose only the **SSH server** item.
### evolinux.yml playbook
### `evolinux.yml` playbook
When the server is installed and rebooted, with a functioning SSH access, make sure that those packages are installed, for Ansible to be able to run.
@ -35,7 +35,7 @@ You can customize the playbook or add command line options to specify with user
With some roles, you'll have to populate the `vars/main.yml` file with values required by the "admin-users" and "evolinux-base" roles. You should refer to their respective documentation.
You'll also need to confighure Ansible to include the location of the "ansible-roles" path in the `roles_path` value. We recommend using `$HOME/.ansible.cfg` with this :
You'll also need to configure Ansible to include the location of the "ansible-roles" path in the `roles_path` value. We recommend using `$HOME/.ansible.cfg` with this :
```
[defaults]