diff --git a/README.md b/README.md index 63819c8..5e5c3cf 100644 --- a/README.md +++ b/README.md @@ -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]