rougail.rougail - Rougail

This repository contains the  rougail.rougail  Ansible collection.

This family is a namespace

  Variables

    The group variables "rougail" - Rougail

▌ 🛈 Informations                                                              
▌                                                                             
▌  basic                                                                      

┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
┃            ┃            ┃ Default    ┃            ┃ Access      ┃            ┃
┃ Variable   ┃ Descripti… ┃ value      ┃ Type       ┃ control     ┃ Validator  ┃
┡━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━━╇━━━━━━━━━━━━┩
│ variable1  │ A port     │            │  port      │  basic      │ •          │
│            │ variable.  │            │ mandatory  │             │ well-known │
│            │            │            │            │             │ ports (1   │
│            │            │            │            │             │ to 1023)   │
│            │            │            │            │             │ are        │
│            │            │            │            │             │ allowed    │
│            │            │            │            │             │ •          │
│            │            │            │            │             │ registred  │
│            │            │            │            │             │ ports      │
│            │            │            │            │             │ (1024 to   │
│            │            │            │            │             │ 49151) are │
│            │            │            │            │             │ allowed    │
│            │            │            │            │             │ • private  │
│            │            │            │            │             │ ports      │
│            │            │            │            │             │ (greater   │
│            │            │            │            │             │ than       │
│            │            │            │            │             │ 49152) are │
│            │            │            │            │             │ allowed.   │
├────────────┼────────────┼────────────┼────────────┼─────────────┼────────────┤
│ variable2  │ A port     │ 8080       │  port      │  standard   │ •          │
│            │ variable   │            │ mandatory  │             │ well-known │
│            │ with       │            │            │             │ ports (1   │
│            │ default    │            │            │             │ to 1023)   │
│            │ value.     │            │            │             │ are        │
│            │            │            │            │             │ allowed    │
│            │            │            │            │             │ •          │
│            │            │            │            │             │ registred  │
│            │            │            │            │             │ ports      │
│            │            │            │            │             │ (1024 to   │
│            │            │            │            │             │ 49151) are │
│            │            │            │            │             │ allowed    │
│            │            │            │            │             │ • private  │
│            │            │            │            │             │ ports      │
│            │            │            │            │             │ (greater   │
│            │            │            │            │             │ than       │
│            │            │            │            │             │ 49152) are │
│            │            │            │            │             │ allowed.   │
├────────────┼────────────┼────────────┼────────────┼─────────────┼────────────┤
│ variable3  │ A port     │ 8080       │  port      │  standard   │ •          │
│            │ variable   │            │ mandatory  │             │ well-known │
│            │ with       │            │            │             │ ports (1   │
│            │ integer    │            │            │             │ to 1023)   │
│            │ default    │            │            │             │ are        │
│            │ value.     │            │            │             │ allowed    │
│            │            │            │            │             │ •          │
│            │            │            │            │             │ registred  │
│            │            │            │            │             │ ports      │
│            │            │            │            │             │ (1024 to   │
│            │            │            │            │             │ 49151) are │
│            │            │            │            │             │ allowed    │
│            │            │            │            │             │ • private  │
│            │            │            │            │             │ ports      │
│            │            │            │            │             │ (greater   │
│            │            │            │            │             │ than       │
│            │            │            │            │             │ 49152) are │
│            │            │            │            │             │ allowed.   │
└────────────┴────────────┴────────────┴────────────┴─────────────┴────────────┘

  Usage

    Example Playbook with Rougail

Add to your structural file something like:

%YAML 1.2                                                                       
---                                                                             
version: 1.1                                                                    
my_rougail:                                                                     
  type: rougail                                                                 
...                                                                             

Customizing hidden variables in structure file:

%YAML 1.2                                                                       
---                                                                             
version: 1.1                                                                    
my_rougail:                                                                     
  type: rougail                                                                 
...                                                                             

▌ 🛈 Informations                                                              
▌                                                                             
▌ Do not forget to add Rougail structure file as Rougail types.               

For example you can add an YAML user data with something like:

---                                                                             
my_rougail:                                                                     
  variable1: '111'                      # A port variable                       

Add to your Play:

---                                                                             
- name: Collection | rougail.rougail.install                                    
  hosts: servers                                                                
  vars:                                                                         
    rougail: '{{ my_rougail }}'                                                 
  ansible.builtin.import_playbook: rougail.rougail.install                      

    Example Playbook without Rougail

▌ 🛈 Informations                                                              
▌                                                                             
▌ The variables will not be properly validated without Rougail.               

---                                                                             
- name: Collection | rougail.rougail.install                                    
  hosts: servers                                                                
  vars:                                                                         
    rougail:                                                                    
      variable1: '111'                # A port variable                         
  ansible.builtin.import_playbook: rougail.rougail.install