gantsign.gnome-proxy

Rôle Ansible : Proxy Gnome

Rôle pour configurer les paramètres de proxy pour les applications Gnome et d'autres applications qui utilisent les paramètres de proxy Gnome (comme le navigateur web Google Chrome).

Exigences

Ansible >= 2.9
- Remarque : les versions antérieures d'Ansible fonctionnent probablement mais n'ont pas été testées.
Distribution Linux
- Famille Debian
  - Ubuntu
    - Bionic (18.04)
    - Focal (20.04)
- Remarque : d'autres versions fonctionneront probablement mais n'ont pas été testées.

Variables du rôle

Les variables suivantes modifieront le comportement de ce rôle (les valeurs par défaut sont affichées ci-dessous) :

# Le mode de proxy (aucun, manuel ou automatique)
gnome_proxy_mode:

# L'URL du fichier de configuration automatique de proxy (PAC)
# Voir : https://fr.wikipedia.org/wiki/Proxy_auto-config
# https://fr.wikipedia.org/wiki/Web_Proxy_Autodiscovery_Protocol
gnome_proxy_autoconfig_url:

# Liste des noms d'hôtes / adresses IP à ne pas passer par le proxy
gnome_proxy_ignore_hosts:

# Utiliser le proxy spécifié pour tous les protocoles
gnome_proxy_use_same_proxy:

# Le nom d'hôte / adresse IP pour le proxy HTTP
gnome_proxy_http_host:

# Le port pour le proxy HTTP
gnome_proxy_http_port:

# Si le proxy HTTP nécessite une authentification
gnome_proxy_http_use_authentication:

# Le nom d'utilisateur pour accéder au proxy HTTP
gnome_proxy_http_authentication_user:

# Le mot de passe pour accéder au proxy HTTP
gnome_proxy_http_authentication_password:

# Si le proxy HTTP est activé
gnome_proxy_http_enabled:

# Le nom d'hôte / adresse IP pour le proxy HTTPS
gnome_proxy_https_host:

# Le port pour le proxy HTTPS
gnome_proxy_https_port:

# Le nom d'hôte / adresse IP pour le proxy FTP
gnome_proxy_ftp_host:

# Le port pour le proxy FTP
gnome_proxy_ftp_port:

# Le nom d'hôte / adresse IP pour le proxy SOCKS
gnome_proxy_socks_host:

# Le port pour le proxy SOCKS
gnome_proxy_socks_port:

# Répertoire où les schémas GLib sont situés
gnome_proxy_glib_schemas_directory: '/usr/share/glib-2.0/schemas'

# Nom du fichier de remplacement pour la configuration du gnome_proxy
gnome_proxy_overide_filename: '20_ansible-proxy.gschema.override'

Exemples de Playbooks

Proxy automatique

- hosts: servers
  roles:
    - role: gantsign.gnome-proxy
      gnome_proxy_mode: 'auto'
      # Gnome devrait pouvoir découvrir l'URL de configuration automatique en utilisant :
      # https://fr.wikipedia.org/wiki/Web_Proxy_Autodiscovery_Protocol
      # si la découverte automatique échoue, vous pouvez spécifier l'URL comme ci-dessous :
      gnome_proxy_autoconfig_url: 'http://wpad.example.com/wpad.dat'

Proxy manuel

- hosts: servers
  roles:
    - role: gantsign.gnome-proxy
      gnome_proxy_mode: 'manual'
      gnome_proxy_ignore_hosts:
        - 'localhost'
        - '127.0.0.0/8'
        - '::1'
      gnome_proxy_use_same_proxy: yes
      gnome_proxy_http_host: 'proxy.example.com'
      gnome_proxy_http_port: 3128
      gnome_proxy_http_enabled: yes

Autres Rôles de GantSign

Vous pouvez trouver d'autres rôles de GantSign sur Ansible Galaxy.

Développement & Tests

Ce projet utilise Molecule pour aider au développement et aux tests ; le rôle est testé unitairement à l'aide de Testinfra et pytest.

Pour développer ou tester, vous devez installer les éléments suivants :

Linux (ex. Ubuntu)
Docker
Python (y compris python-pip)
Ansible
Molecule

Comme l'installation de ce qui précède peut être délicate, ce projet inclut Molecule Wrapper. Molecule Wrapper est un script shell qui installe Molecule et ses dépendances (à part Linux) puis exécute Molecule avec la commande que vous lui passez.

Pour tester ce rôle à l'aide de Molecule Wrapper, exécutez la commande suivante depuis le répertoire racine du projet :