tuto-ansible: ansible done
This commit is contained in:
parent
98593ea3cb
commit
b786830dc8
@ -3,16 +3,241 @@
|
|||||||
Automatiser la configuration de son SI
|
Automatiser la configuration de son SI
|
||||||
=======================================
|
=======================================
|
||||||
|
|
||||||
|
Aujourd'hui, vous n'avez qu'une seule machine à administrer, et déjà, j'ai pu
|
||||||
|
entendre des soupirs lorsque vous avez dû configurer ENCORE CE RÉSEAU DE
|
||||||
|
*$&*%#. Imaginez maintenant que vous ayez à en administrer 10, 100, 1000 ou
|
||||||
|
encore davantage !
|
||||||
|
|
||||||
|
Comme tout bon ~~paresseux~~ sys. admin qui se respecte, sans plus attendre,
|
||||||
|
vous allez vouloir automatiser toutes ces actions rébarbatives. Comme de très
|
||||||
|
nombreuses personnes sont passées par là avant vous, il existe un grand nombre
|
||||||
|
de solutions pour gérer les configurations d'un parc de machines. Parmi les
|
||||||
|
plus connues, citons : [Puppet](https://puppet.com/),
|
||||||
|
[Chef](http://www.chef.io/), [SaltStack](https://saltstack.com/) ou encore
|
||||||
|
[Ansible](https://www.ansible.com/).
|
||||||
|
|
||||||
|
|
||||||
Introduction à Ansible
|
Introduction à Ansible
|
||||||
----------------------
|
----------------------
|
||||||
|
|
||||||
Présentation du résultat attendu
|
Ansible est une solution de gestion de configuration. Basé sur
|
||||||
--------------------------------
|
[Python](https://www.python.org/) et
|
||||||
|
[YAML](http://www.yaml.org/spec/1.2/spec.html), sa principale particularité est
|
||||||
|
de ne pas nécessité de daemon sur les machines qu'il va gérer : tout se fait
|
||||||
|
exclusivement via SSH, à partir de la machine d'un administrateur, possédant
|
||||||
|
Ansible.
|
||||||
|
|
||||||
Mon premier rôle
|
Son installation est très simple, car les dépendances sont minimes et l'outil
|
||||||
|
n'a pas besoin de base de données pour fonctionner : tout va se faire à partir
|
||||||
|
d'une arborescence de fichiers, qui sera gérée par Git.
|
||||||
|
|
||||||
|
Commencez par installer Ansible, sur une machine distincte de la machine
|
||||||
|
virtuelle démarrée : la machine hôte sera parfaitement adaptée à cette tâche,
|
||||||
|
d'autant plus que l'installation de la plate-forme est propre et légère : vous
|
||||||
|
ne risquez pas de vous retrouver avec une usine à gaz impossible à retirer.
|
||||||
|
|
||||||
|
[Consultez la procédure d'installation pour votre distribution ici](http://docs.ansible.com/ansible/latest/intro_installation.html).
|
||||||
|
|
||||||
|
|
||||||
|
Résultat attendu
|
||||||
----------------
|
----------------
|
||||||
|
|
||||||
- Pérenniser les étapes faites précédemment :
|
À la fin de cette partie, vous devez être en mesure de pouvoir déployer une
|
||||||
- création de l'utilisateur
|
nouvelle machine, identique à celle que vous venez de configurer, à partir
|
||||||
- recopier les fichiers
|
d'une ISO et d'un nouveau disque.
|
||||||
- Installation des packages mini
|
|
||||||
|
Maintenant que vous savez vous connecter au réseau et formater un disque, vous
|
||||||
|
pouvez ajouter les options `adlin.format=/dev/sda` et `adlin.net=easy` à la
|
||||||
|
ligne de commande du noyau afin de, respectivement, formater le disque
|
||||||
|
`/dev/sda` si la partition racine n'est pas trouvée, et obtenir une adresse IP
|
||||||
|
par DHCP. Vous pourrez ainsi très facilement tester vos recettes.
|
||||||
|
|
||||||
|
|
||||||
|
Mon première commande
|
||||||
|
---------------------
|
||||||
|
|
||||||
|
### Inventaire
|
||||||
|
|
||||||
|
Comme il sera bientôt question de maintenir plusieurs machines, la première
|
||||||
|
chose à faire consiste à les inventorier.
|
||||||
|
|
||||||
|
Commençons par créer un répertoire, qui contiendra l'ensemble de nos
|
||||||
|
configurations à destination d'Ansible. Dans ce répertoire, créons un fichier
|
||||||
|
d'inventaires `hosts`, contenant l'IP de notre machine :
|
||||||
|
|
||||||
|
<div lang="en-US">
|
||||||
|
```yaml
|
||||||
|
all:
|
||||||
|
hosts:
|
||||||
|
192.168.0.106
|
||||||
|
```
|
||||||
|
</div>
|
||||||
|
|
||||||
|
Vous pouvez lancer une autre machine virtuelle à ce stade et ajouter son IP sur
|
||||||
|
une nouvelle ligne du fichier `hosts`.
|
||||||
|
|
||||||
|
Plus tard, c'est dans ce fichier que vous pourrez créer des groupes de machines
|
||||||
|
(par exemple pour regrouper les serveurs web, les bases de données, etc.) ou
|
||||||
|
donner des caractéristiques spécifiques à vos machines.
|
||||||
|
|
||||||
|
|
||||||
|
### `ping`
|
||||||
|
|
||||||
|
Lancez ensuite la commande suivante :
|
||||||
|
|
||||||
|
<div lang="en-US">
|
||||||
|
```
|
||||||
|
42sh$ ansible --inventory-file hosts all --module-name ping --user root --ask-pass
|
||||||
|
192.168.0.106 | SUCCESS => {
|
||||||
|
"changed": false,
|
||||||
|
"ping": "pong"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
</div>
|
||||||
|
|
||||||
|
Vous devriez avoir un retour similaire à celui-ci, indiquant simplement que la
|
||||||
|
connexion a bien été effectuée et que le nécessaire est bien installé sur la
|
||||||
|
machine distance.
|
||||||
|
|
||||||
|
|
||||||
|
### Confort
|
||||||
|
|
||||||
|
Une des premières choses que nous devrions faire, est d'installer notre clef
|
||||||
|
SSH sur les machines, pour éviter d'avoir à taper le mot de passe à chaque
|
||||||
|
test.
|
||||||
|
|
||||||
|
Si vous avez bien suivi jusqu'ici, vous savez qu'il ne faut pas utiliser le
|
||||||
|
compte `root` directement ! Pas d'inquiétude, tout est prévu dans Ansible :
|
||||||
|
retirer l'option `--user root` si votre nom d'utilisateur local est identique
|
||||||
|
que celui dans la machine virtuelle, ou adaptez l'option en conséquence.
|
||||||
|
|
||||||
|
Et ajoutez les options `--become` et `--ask-become-pass` (utilisez `--sudo` et
|
||||||
|
`--ask-sudo-pass` pour les vieilles versions) :
|
||||||
|
|
||||||
|
<div lang="en-US">
|
||||||
|
```
|
||||||
|
ansible --inventory-file hosts all -m ping -u bruce --become --ask-become-pass
|
||||||
|
```
|
||||||
|
</div>
|
||||||
|
|
||||||
|
|
||||||
|
### Les modules
|
||||||
|
|
||||||
|
Les modules Ansible ont généralement deux missions distinctes :
|
||||||
|
|
||||||
|
- récupérer des informations en allant les extraire sur chaque machine ;
|
||||||
|
- pousser des nouvelles informations pour atteindre un état précis.
|
||||||
|
|
||||||
|
Lorsque les informations récupérées montrent que l'état est déjà atteint,
|
||||||
|
aucune modification n'est faite sur la machine, on parle d'idempotence.
|
||||||
|
|
||||||
|
À noter cependant que lorsque l'on retire un état de notre recette, il est
|
||||||
|
conservé tel quel sur la machine. Par exemple, si un utilisateur `toto` est
|
||||||
|
créé suite à l'application d'une recette décrivant l'utilisateur `toto` ; si
|
||||||
|
l'on supprime la description, l'utilisateur ne sera pas supprimé des machines
|
||||||
|
sur lequel la recette aura été appliquée. Pour qu'il soit supprimé, il faut
|
||||||
|
modifier la description pour signaler que cet utilisateur ne doit pas
|
||||||
|
exister. À l'application de cette nouvelle recette, si un tel utilisateur est
|
||||||
|
trouvé, il sera donc supprimé.
|
||||||
|
|
||||||
|
|
||||||
|
### Collecte du mercredi
|
||||||
|
|
||||||
|
Parmi les modules de base, le module `setup` permet de récupérer un grand
|
||||||
|
nombre de caractéristiques de la machine distance, voyez plutôt :
|
||||||
|
|
||||||
|
<div lang="en-US">
|
||||||
|
```
|
||||||
|
ansible -i hosts all -m setup
|
||||||
|
```
|
||||||
|
</div>
|
||||||
|
|
||||||
|
Les informations récupérées (quelque soit le module), sont ensuite accessible
|
||||||
|
dans des variables afin de permettre de compléter des modèles ou pour faire de
|
||||||
|
l'exécution conditionnelle d'état (par exemple on pourra utiliser la variable
|
||||||
|
`ansible_facts.ansible_distribution` pour distinguer les gestionnaires de
|
||||||
|
paquets).
|
||||||
|
|
||||||
|
|
||||||
|
Ma première recette
|
||||||
|
-------------------
|
||||||
|
|
||||||
|
Un livre de recettes (*playbook* dans le vocabulaire d'Ansible), regroupe les
|
||||||
|
descriptions des états que l'on souhaite obtenir sur un groupe de machines données.
|
||||||
|
|
||||||
|
Par exemple, voici à quoi pourrait ressembler un tel recueil :
|
||||||
|
|
||||||
|
<div lang="en-US">
|
||||||
|
```yaml
|
||||||
|
---
|
||||||
|
- hosts: webservers
|
||||||
|
remote_user: root
|
||||||
|
|
||||||
|
tasks:
|
||||||
|
- name: ensure nginx is at the latest version
|
||||||
|
apt: name=nginx state=latest
|
||||||
|
- name: write the apache config file
|
||||||
|
template: src=/srv/httpd.j2 dest=/etc/httpd.conf
|
||||||
|
|
||||||
|
- hosts: databases
|
||||||
|
remote_user: root
|
||||||
|
|
||||||
|
tasks:
|
||||||
|
- name: ensure postgresql is at the latest version
|
||||||
|
yum: name=postgresql state=latest
|
||||||
|
- name: ensure that postgresql is started
|
||||||
|
service: name=postgresql state=started
|
||||||
|
```
|
||||||
|
</div>
|
||||||
|
|
||||||
|
On filtre d'abord sur les hôtes concernés par la configuration, on donne
|
||||||
|
ensuite des paramètres qui seront utilisées pour chaque tâche et enfin on
|
||||||
|
décrit les tâches.
|
||||||
|
|
||||||
|
Le guide de référence pour connaître toutes les syntaxes possibles est
|
||||||
|
disponible dans [la documentation
|
||||||
|
d'Ansible](http://docs.ansible.com/ansible/latest/playbooks.html).
|
||||||
|
|
||||||
|
|
||||||
|
### Exécution d'un *Playbook*
|
||||||
|
|
||||||
|
Placer le contenu dans un fichier YAML, par exemple `playbook.yml`, non loin du
|
||||||
|
fichier `hosts` créé à la section précédentes, puis lancez :
|
||||||
|
|
||||||
|
<div lang="en-US">
|
||||||
|
```
|
||||||
|
ansible-playbook -i hosts playbook.yml
|
||||||
|
```
|
||||||
|
</div>
|
||||||
|
|
||||||
|
|
||||||
|
### Coup de pouce
|
||||||
|
|
||||||
|
Voici à quoi ressemblerait votre premier playbook créant l'utilisateur
|
||||||
|
`adeline` :
|
||||||
|
|
||||||
|
<div lang="en-US">
|
||||||
|
```yaml
|
||||||
|
---
|
||||||
|
- hosts: all
|
||||||
|
remote_user: root
|
||||||
|
|
||||||
|
tasks:
|
||||||
|
- name: ensure adeline as an account
|
||||||
|
user:
|
||||||
|
name: adeline
|
||||||
|
state: present
|
||||||
|
shell: /bin/fish
|
||||||
|
groups: sudo
|
||||||
|
append: yes
|
||||||
|
```
|
||||||
|
</div>
|
||||||
|
|
||||||
|
La création de l'utilisateur se fait à l'aide du module
|
||||||
|
[`user`](http://docs.ansible.com/ansible/latest/user_module.html).
|
||||||
|
|
||||||
|
À vous maintenant, à l'aide [des modules à votre
|
||||||
|
disposition](http://docs.ansible.com/ansible/latest/modules_by_category.html)
|
||||||
|
de copier vos fichiers de configuration à leur place et avec les bons droits
|
||||||
|
(`authorized_keys`, `.bashrc`, ...). Installez également les paquets que vous
|
||||||
|
aviez installé à la main (client DHCP, `htop`, ...).
|
||||||
|
|||||||
Reference in New Issue
Block a user