gantsign.gnome-proxy

Descripción general Versiones Perspectivas

Rol de Ansible: Gnome Proxy

Rol para configurar la configuración del proxy para aplicaciones Gnome y otras aplicaciones que utilizan la configuración de proxy de Gnome (como el navegador web Google Chrome).

Requisitos

Ansible >= 2.9
- Nota: es probable que versiones anteriores de Ansible funcionen, pero no han sido probadas.
Distribución de Linux
- Familia Debian
  - Ubuntu
    - Bionic (18.04)
    - Focal (20.04)
- Nota: otras versiones probablemente funcionen, pero no han sido probadas.

Variables del Rol

Las siguientes variables cambiarán el comportamiento de este rol (los valores predeterminados se muestran a continuación):

# El modo de proxy (ninguno, manual o automático)
gnome_proxy_mode:

# La URL del archivo de configuración automática de proxy (PAC)
# Ver: https://es.wikipedia.org/wiki/Proxy_auto-config
# https://es.wikipedia.org/wiki/Web_Proxy_Autodiscovery_Protocol
gnome_proxy_autoconfig_url:

# Lista de nombres de host / direcciones IP que no se deben usar como proxy
gnome_proxy_ignore_hosts:

# Usar el proxy especificado para todos los protocolos
gnome_proxy_use_same_proxy:

# El nombre de host / dirección IP para el proxy HTTP
gnome_proxy_http_host:

# El puerto para el proxy HTTP
gnome_proxy_http_port:

# Si el proxy HTTP requiere autenticación
gnome_proxy_http_use_authentication:

# El nombre de usuario utilizado para acceder al proxy HTTP
gnome_proxy_http_authentication_user:

# La contraseña utilizada para acceder al proxy HTTP
gnome_proxy_http_authentication_password:

# Si el proxy HTTP está habilitado
gnome_proxy_http_enabled:

# El nombre de host / dirección IP para el proxy HTTPS
gnome_proxy_https_host:

# El puerto para el proxy HTTPS
gnome_proxy_https_port:

# El nombre de host / dirección IP para el proxy FTP
gnome_proxy_ftp_host:

# El puerto para el proxy FTP
gnome_proxy_ftp_port:

# El nombre de host / dirección IP para el proxy SOCKS
gnome_proxy_socks_host:

# El puerto para el proxy SOCKS
gnome_proxy_socks_port:

# Directorio donde se encuentran los esquemas de GLib
gnome_proxy_glib_schemas_directory: '/usr/share/glib-2.0/schemas'

# Nombre del archivo de sobreescritura para la configuración de gnome_proxy
gnome_proxy_overide_filename: '20_ansible-proxy.gschema.override'

Ejemplos de Playbooks

Proxy automático

- hosts: servers
  roles:
    - role: gantsign.gnome-proxy
      gnome_proxy_mode: 'auto'
      # Gnome debería poder descubrir la URL de configuración automática usando:
      # https://es.wikipedia.org/wiki/Web_Proxy_Autodiscovery_Protocol
      # si la autodescubrimiento falla, puedes especificar la URL como se muestra a continuación:
      gnome_proxy_autoconfig_url: 'http://wpad.example.com/wpad.dat'

Proxy manual

- 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

Más Roles de GantSign

Puedes encontrar más roles de GantSign en Ansible Galaxy.

Desarrollo y Pruebas

Este proyecto utiliza Molecule para ayudar en el desarrollo y las pruebas; el rol se prueba unitariamente usando Testinfra y pytest.

Para desarrollar o probar, necesitarás tener instalados lo siguiente:

Linux (por ejemplo, Ubuntu)
Docker
Python (incluyendo python-pip)
Ansible
Molecule

Debido a que lo anterior puede ser complicado de instalar, este proyecto incluye Molecule Wrapper. Molecule Wrapper es un script de shell que instala Molecule y sus dependencias (aparte de Linux) y luego ejecuta Molecule con el comando que le pases.

Para probar este rol usando Molecule Wrapper, ejecuta el siguiente comando desde la raíz del proyecto: