Switch to English for documentation and comments

This commit is contained in:
Jérémy Lecour 2016-09-30 09:48:41 +02:00 committed by Jérémy Lecour
parent 452df44f03
commit 953c27a866
9 changed files with 77 additions and 79 deletions

View File

@ -1,13 +1,13 @@
# apt-upgrade
Mise à jour des paquets APT.
Upgrades Debian packages
## Taches
## Tasks
L'ensemble des actions est dans le fichier `tasks/main.yml`
Everything is in the `tasks/main.yml` file.
## Variables possibles
## Available variables
* `apt_upgrade_mode` : indique le type de mise à jour, `safe` par défaut (cf. http://docs.ansible.com/ansible/apt_module.html#options)
* `apt_upgrade_mode` : kind of upgrade to do (cf. http://docs.ansible.com/ansible/apt_module.html#options)
Le choix peut se faire dans un fichier de variables (par exemple `vars/main.yml`) ou bien lors de l'appel du rôle (`- { role: apt-upgrade, apt_upgrade_mode: safe }`)
Choice of upgrade mode can be set in a variables file (ex. `vars/main.yml`) or when invoking the role (`- { role: apt-upgrade, apt_upgrade_mode: safe }`).

View File

@ -1,5 +1,5 @@
---
- name: Debian is up-to-date
- name: Ensure Debian is up-to-date
apt:
update_cache: yes
upgrade: "{{ apt_upgrade_mode | default('safe') }}"

View File

@ -1,14 +1,14 @@
# monit
Installation de Monit et ajout d'une configuration personnalisée.
Install Monit.
## Taches
## Tasks
L'ensemble des actions est dans le fichier `tasks/main.yml`
Everything is in the `tasks/main.yml` file.
## Variables possibles
## Available variables
* `monit_daemon_time` : délai d'exécution des vérifications (en secondes)
* `monit_httpd_enable` : activation du serveur http intégré (`true`/`false`)
* `monit_httpd_port` : port d'écoute pour le serveur http
* `monit_httpd_allow_items` : liste des IP/hosts autorisés à se connecter
* `monit_daemon_time` : execution frequency (in seconds) ;
* `monit_httpd_enable` : integrated http server enabled or not ;
* `monit_httpd_port` : TCP port of http server ;
* `monit_httpd_allow_items` : IP/hosts allow to conenct to http server.

View File

@ -1,11 +1,11 @@
# munin
Installation de Munin et changement de quelques plugins.
Install Munin and enables/diables some default plugins.
## Taches
## Tasks
L'ensemble des actions est dans le fichier `tasks/main.yml`
Everything is in the `tasks/main.yml` file.
## Variables possibles
## Available variables
Les seules variables sont liées au hostname (court et complet) qui sont simplement déduites des facts.
The only variables are related to the hostname (short and fully qualified) and are derived from gathered facts.

View File

@ -1,29 +1,27 @@
# mysql
Installation de MySQL, une configuration type Evolix et quelques outils.
Install MySQL
## Taches
## Tasks
Les taches sont éclatées dans différents fichiers, inclus dans `tasks/main.yml` :
Tasks are extracted in several files, included in `tasks/main.yml` :
* `packages.yml` : installation des paquets
* `users.yml` : remplacement de l'utilisateur `root` par `mysqladmin`
* `config.yml` : copie des configurations
* `datadir.yml` : configuration du dossier de travail
* `tmpdir.yml` : configuration du dossier temporaire
* `nrpe.yml` : utilisateur `nrpe` pour checks Nagios
* `munin.yml` : activation des plugins Munin
* `log2mail.yml` : recettes log2mail
* `utils.yml` : installation d'outils utiles
* `packages.yml` : packages installation ;
* `users.yml` : replacement of `root` user by `mysqladmin` user ;
* `config.yml` : configurations ;
* `datadir.yml` : data directory customization ;
* `tmpdir.yml` : temporary directory customization ;
* `nrpe.yml` : `nrpe` user for Nagios checks ;
* `munin.yml` : Munin plugins ;
* `log2mail.yml` : log2mail patterns ;
* `utils.yml` : useful tools.
## Variables possibles
## Available variables
Les seules variables sont liées au hostname (court et complet) qui sont simplement déduites des facts.
* `mysql_replace_root_with_mysqladmin`: switch from `root` to `mysqladmin` user or not ;
* `mysql_thread_cache_size`: number of threads for the cache ;
* `mysql_innodb_buffer_pool_size`: amount of RAM dedicated to InnoDB ;
* `mysql_custom_datadir`: custom datadir
* `mysql_custom_tmpdir`: custom tmpdir.
* `mysql_replace_root_with_mysqladmin`: remplacement de `root` par `mysqladmin` `true` par défaut
* `mysql_thread_cache_size`: nombre de threads pour le cache nombre de vCPU par défaut
* `mysql_innodb_buffer_pool_size`: taille du buffer InnoDB 30% de la RAM installée par défaut
* `mysql_custom_datadir`: le dossier de travail personnalisé
* `mysql_custom_tmpdir`: le dossier temporaire personnalisé
NB : le changement de _datadir_ peut se faire plusieurs fois, tant qu'on ne revient pas vers la valeur par défaut (car une fois déplacé un lien symbolique est créé au point de départ).
NB : changing the _datadir_ location can be done multiple times, as long as it is not restored to the default initial location, (because a symlink is created and can't be switched back, yet).

View File

@ -1,22 +1,22 @@
# munin
Installation de Rbenv, Ruby et des gems par défaut.
Install Rbenv, Ruby and some default gems.
## Taches
## Tasks
L'ensemble des actions est dans le fichier `tasks/main.yml`
Everything is in the `tasks/main.yml` file.
## Variables possibles
## Available variables
Les seules variables sont liées au hostname (court et complet) qui sont simplement déduites des facts.
* `rbenv_version`: version de Rbenv à installer, `v1.0.0` par défaut
* `rbenv_ruby_version`: version de Ruby à installer, `2.3.1` par défaut
* `rbenv_root`: dossier d'installation, `~/.rbenv` par défaut
* `rbenv_repo`: source Git pour Rbenv
* `rbenv_plugins`: liste des plugins Rbenv à installer
* `rbenv_version`: Rbenv version to install ;
* `rbenv_ruby_version`: Ruby version to install ;
* `rbenv_root`: install path for Rbenv ;
* `rbenv_repo`: repository location ;
* `rbenv_plugins`: list of Rbenv plugins to install.
Le rôle doit être ajouté en indiquant l'utilisateur concerné :
The role must be specified with a `username` variable :
```
roles:

View File

@ -1,6 +1,6 @@
---
- name: install rbenv dependencies
- name: Rbenv dependencies are installed
apt:
pkg: '{{ item }}'
install_recommends: no
@ -19,7 +19,7 @@
- rbenv
- packages
- name: checkout rbenv_repo for {{ username }}
- name: Rbenv repository is checked out for {{ username }}
git:
repo: '{{ rbenv_repo }}'
dest: '{{ rbenv_root }}'
@ -31,7 +31,7 @@
tags:
- rbenv
- name: create plugins directory for {{ username }}
- name: plugins directory for {{ username }}
file:
path: '{{ rbenv_root }}/plugins'
state: directory
@ -40,7 +40,7 @@
tags:
- rbenv
- name: install plugins for {{ username }}
- name: plugins are installed for {{ username }}
git:
repo: '{{ item.repo }}'
dest: '{{ rbenv_root }}/plugins/{{ item.name }}'
@ -54,7 +54,7 @@
tags:
- rbenv
- name: Init rbenv in profile for {{ username }}
- name: Rbenv is initialized in profile for {{ username }}
become_user: "{{ username }}"
blockinfile:
dest: '~{{ username }}/.profile'
@ -63,7 +63,7 @@
eval "$(rbenv init -)"
marker: "# {mark} ANSIBLE MANAGED RBENV INIT"
- name: set default-gems for {{ username }}
- name: default gems are installed for {{ username }}
copy:
src: default-gems
dest: '{{ rbenv_root }}/default-gems'
@ -72,7 +72,7 @@
tags:
- rbenv
- name: set gemrc for {{ username }}
- name: gemrc for {{ username }}
copy:
src: gemrc
dest: ~/.gemrc
@ -81,7 +81,7 @@
tags:
- rbenv
- name: check ruby {{ rbenv_ruby_version }} installed for {{ username }}
- name: is Ruby {{ rbenv_ruby_version }} available for {{ username }} ?
shell: /bin/bash -lc "rbenv versions | grep {{ rbenv_ruby_version }}"
become_user: "{{ username }}"
register: ruby_installed
@ -91,7 +91,7 @@
tags:
- rbenv
- name: install ruby {{ rbenv_ruby_version }} for {{ username }}
- name: Ruby {{ rbenv_ruby_version }} is available for {{ username }}
shell: /bin/bash -lc "TMPDIR=~/tmp rbenv install {{ rbenv_ruby_version }}"
become_user: "{{ username }}"
when: ruby_installed.rc != 0
@ -99,7 +99,7 @@
tags:
- rbenv
- name: check if user ruby version is {{ rbenv_ruby_version }} for {{ username }}
- name: is Ruby {{ rbenv_ruby_version }} selected for {{ username }} ?
shell: /bin/bash -lc "rbenv version | cut -d ' ' -f 1 | grep -Fx '{{ rbenv_ruby_version }}'"
become_user: "{{ username }}"
register: ruby_selected
@ -109,7 +109,7 @@
tags:
- rbenv
- name: set ruby {{ rbenv_ruby_version }} for {{ username }}
- name: select Ruby {{ rbenv_ruby_version }} for {{ username }}
shell: /bin/bash -lc "rbenv global {{ rbenv_ruby_version }} && rbenv rehash"
become_user: "{{ username }}"
when: ruby_selected.rc != 0

View File

@ -1,23 +1,23 @@
# munin
Installation de Redis.
Install Redis with sensible configuration.
Rôle basé sur https://github.com/geerlingguy/ansible-role-redis
This role is based on https://github.com/geerlingguy/ansible-role-redis
## Taches
## Tasks
L'ensemble des actions est dans le fichier `tasks/main.yml`
Everything is in the `tasks/main.yml` file.
## Variables possibles
## Available variables
Les variables principales sont :
Main variables are :
* `redis_daemon`: nom du processus
* `redis_conf_path`: emplacement du fichier de config
* `redis_port`: port TCP d'écoute
* `redis_bind_interface`: IP d'écoute
* `redis_unixsocket`: socket Unix écouté
* `redis_loglevel`: verbosité des logs
* `redis_logfile`: emplacement du fichier de log
* `redis_daemon`: name of the process ;
* `redis_conf_path`: config file location ;
* `redis_port`: listening TCP port ;
* `redis_bind_interface`: listening IP address ;
* `redis_unixsocket`: Unix socket ;
* `redis_loglevel`: log verbosity ;
* `redis_logfile`: log file location.
La liste complète est disponible dans `defaults/main.yml`.
The full list of variables (with default values) can be found in `defaults/main.yml`.

View File

@ -1,5 +1,5 @@
---
- name: Ensure redis is installed.
- name: Redis is installed.
apt:
name: redis-server
state: installed
@ -7,7 +7,7 @@
- redis
- packages
- name: Ensure Redis is configured.
- name: Redis is configured.
template:
src: redis.conf.j2
dest: "{{ redis_conf_path }}"
@ -16,7 +16,7 @@
tags:
- redis
- name: Ensure redis is running and enabled on boot.
- name: Redis is running and enabled on boot.
service:
name: "{{ redis_daemon }}"
enabled: yes