Manipulation de fichiers sur les hôtes

Appliquer les ACL de fichiers

Le module ACL permet de définir ou de récupérer les informations ACL (Access Control List ou en français Liste de Contrôle d’Accès) d’un fichier.

Le paramètre state a trois valeurs possibles :

Exemple

Sur l’hôte server2 deux fichiers data.txt et info.txt sont présents dans le répertoire de base (/home/fred) du compte utilisateur fred.

L’objectif est de :

--- 
- name: Module FILES - ACL 
  hosts: server2 
 
  tasks: 
  - name: Définir les permissions RW pour fred 
    acl: 
      path: /home/fred/data.txt 
      entity: fred 
      etype: user 
      permissions: rw 
      state: present 
 
  - name: Supprimer les ACL pour fred 
    acl: 
      path: /home/fred/info.txt 
      entity:...

Modifier l’horodatage des fichiers

Manuellement, c’est la commande touch qui est utilisée pour modifier l’horodatage (timestamp) de dernier accès et de dernière modification d’un fichier. Cette commande permet également de créer un fichier vide.

Ansible, quant à lui, s’assure que l’utilisateur propriétaire, le groupe et les autorisations du fichier sont définis.

Exemple

Créez un fichier readme.txt dans le dossier /root sur les machines appartenant au groupe servers. L’utilisateur propriétaire sera john et le groupe propriétaire sera users. Les permissions de ce fichiers seront définies à 0640 :

--- 
- name: Module FILES - touch 
  hosts: servers 
 
  tasks: 
  - name: Touch a file and set permissions 
    file: 
      path: /root/readme.txt 
      owner: john 
      group: users 
      mode: 0640 
      state: touch 

Dans un terminal, constatez le résultat :

[root@server2 ~]# ll /root/readme.txt 
-rw-r-----. 1 john users 0  14 janv. 16:39 /root/readme.txt 
[root@server2 ~]# 

La gestion des attributs de fichier peut s’effectuer grâce à plusieurs modules. Il est utile parfois de se documenter avec la commande...

Copie de fichiers

--- 
- name: Module FILES - copy 
  hosts: server2 
 
  tasks: 
  - name: Copie du fichier prog.conf 
    copy: 
      src: ~/workspace/prog.conf 
      dest: /opt/app/prog.conf 
      owner: root 
      group: root 
      mode: u=rw,g=r,o=r 

tasks: 
- name: Copie du fichier prog.conf 
  copy: 
    src: ~/workspace/prog.conf 
    dest: /opt/app/prog.conf 
    owner: root 
    group: root 
    mode: 0644 
    force : no 

[root@server1 ~]# ansible-doc copy 
 
 
**** sortie tronquée **** 
 
 
= dest 
   ...

Déplacement et renommage des fichiers

Vous avez sans doute constaté dans le tableau au début de ce chapitre que la bibliothèque de modules files ne fournit pas de modules qui permettraient de déplacer ou de renommer des fichiers.

Cette section présente deux possibilités.

Première possibilité

En utilisant le module command et la commande mv du système d’exploitation Linux.

Exemple

Nous voulons déplacer le fichier /home/fred/data.txt dans le dossier /home/fred/old/ si le fichier est existant.

--- 
- name: Module command - déplacer/renommer un fichier 
  hosts: server2 
  vars: 
    fic_src: /home/fred/data.txt 
    fic_dest: /home/fred/old/ 
 
  tasks: 
  - name: Fichier existe ou pas 
    stat: 
      path: "{{ fic_src }}" 
    register: resultat 
 
- name: deplacer fichier si existe 
    command: mv "{{ fic_src }}" "{{ fic_dest }}" 
    when: resultat.stat.exists == True 

Seconde possibilité

En utilisant le module copy pour copier le fichier vers une destination souhaitée. Puis, en utilisant le module file pour supprimer la source de la copie.

Exemple

En reprenant l’objectif de l’exemple précédent :...

Recherche de fichiers

Le module find permet de rechercher un ou plusieurs fichiers sur les hôtes gérés. 

Dans le tableau suivant, vous trouverez les paramètres les plus courants de ce module. D’ailleurs, vous trouverez des similitudes avec la commande find du shell Linux.

Informations sur l’état d’un fichier

Le module stat est similaire à la commande qui porte le même nom.

Exemple

Vérifier que le dossier /root/database sur l’hôte server2 existe.

D’abord, le module stat va récupérer les faits de ce dossier. La variable ret va capturer le résultat.

Le module debug affiche le message "Chemin inexistant" si la condition définie avec la clause when « ret.stat.isdir is not defined » est vraie.

Nous utilisons une seconde fois ce module pour afficher le message "Chemin existant" si la condition définie avec la clause when « ret.stat.isdir is defined » est vraie.

--- 
- name: Module FILES - stat 
  hosts: server2 
 
  tasks: 
  - name: Tester si le dossier existe 
    stat: 
      path: /root/database 
    register: ret 
 
  - debug: 
      msg: "Chemin inexistant" 
    when: ret.stat.isdir is not defined 
 
  - debug: 
      msg: "Chemin existant" 
   ...

Manipulation d’archives

Cette section va démontrer comment créer et extraire des fichiers d’une archive comme vous le feriez manuellement avec la commande tar.

--- 
- name: Module archive 
  hosts: server2 
 
# Creation archive bz2 des fichiers /opt/app/* 
# en excluant le dossier /opt/app/images 
  tasks: 
  - name: Creation archive 
    archive: 
      path: /opt/app/* 
      dest: /root/app.tar.bz2 
      exclude_path: /opt/app/images 
      format: bz2 

Modification de fichiers

Pour modifier le contenu d’un fichier, ces trois modules sont disponibles :

--- 
- name: Module FILES - lineinfile 
  hosts: servers 
 
  tasks: 
  - name: Verifier que SELinux est en mode enforcing 
    lineinfile: 
      path: /etc/selinux/config 
      regexp: '^SELINUX=' 
      line: SELINUX=enforcing 

Modifications de contexte de fichier SELinux

Le module file se comporte comme la commande chcon lors de la définition des contextes de fichier. Par conséquent, les modifications apportées avec ce module pourraient être annulées de manière inattendue en exécutant la commande restorecon.

Après avoir défini le contexte avec le module file, vous pouvez utiliser le module sefcontext de la bibliothèque de modules system afin de mettre à jour la politique SELinux. Ces manipulations sont similaires à l’utilisation de la commande semanage fcontext.

Les paquets suivants sont nécessaires pour l’hôte qui exécute ce module :

Exemple

Créer un dossier /common sur l’hôte server2 pour une utilisation future de SAMBA. SELinux est, sur cette machine cible, en mode enforcing.

Faisons manuellement la manipulation avant de concevoir le playbook. Il est nécessaire, tout d’abord, de définir quatre valeurs booléennes SELinux. Par exemple :

[root@server2 /]# setsebool -P samba_enable_home_dirs on 
[root@server2 /]# setsebool -P use_samba_home_dirs on 
[root@server2 /]# setsebool -P samba_export_all_ro on 
[root@server2 /]# setsebool -P samba_export_all_rw on 

Pour vérifier, utilisez la commande getsebool :

[root@server2 /]# getsebool -a | grep...

Modèles JINJA2

{# mon commentaire #} 

{% expression %} 

{{ adresse_IP }} 

tasks: 
 - name: template render 
    template: 
      src: fichier_modele.j2 
      dest: /home/bob/data/fichier_rendu.txt