gantsign.gnome-proxy

Ansible Rolle: Gnome Proxy

Rolle zur Konfiguration der Proxy-Einstellungen für Gnome-Anwendungen und andere Anwendungen, die die Gnome-Proxy-Einstellungen verwenden (wie den Google Chrome-Webbrowser).

Anforderungen

Ansible >= 2.9
- Hinweis: Frühere Versionen von Ansible werden wahrscheinlich funktionieren, wurden aber nicht getestet.
Linux-Distribution
- Debian-Familie
  - Ubuntu
    - Bionic (18.04)
    - Focal (20.04)
- Hinweis: andere Versionen werden wahrscheinlich funktionieren, wurden jedoch nicht getestet.

Rollenvariablen

Die folgenden Variablen ändern das Verhalten dieser Rolle (Standardwerte sind unten angegeben):

# Der Proxy-Modus (keiner, manuell oder automatisch)
gnome_proxy_mode:

# Die URL der Proxy-Auto-Konfigurationsdatei (PAC)
# Siehe: https://de.wikipedia.org/wiki/Proxy_auto-config
# https://de.wikipedia.org/wiki/Web_Proxy_Autodiscovery_Protocol
gnome_proxy_autoconfig_url:

# Liste der Hostnamen / IP-Adressen, die nicht über den Proxy geleitet werden sollen
gnome_proxy_ignore_hosts:

# Den angegebenen Proxy für alle Protokolle verwenden
gnome_proxy_use_same_proxy:

# Der Hostname / die IP-Adresse für den HTTP-Proxy
gnome_proxy_http_host:

# Der Port für den HTTP-Proxy
gnome_proxy_http_port:

# Ob der HTTP-Proxy eine Authentifizierung erfordert
gnome_proxy_http_use_authentication:

# Der Benutzername für den Zugriff auf den HTTP-Proxy
gnome_proxy_http_authentication_user:

# Das Passwort für den Zugriff auf den HTTP-Proxy
gnome_proxy_http_authentication_password:

# Ob der HTTP-Proxy aktiviert ist
gnome_proxy_http_enabled:

# Der Hostname / die IP-Adresse für den HTTPS-Proxy
gnome_proxy_https_host:

# Der Port für den HTTPS-Proxy
gnome_proxy_https_port:

# Der Hostname / die IP-Adresse für den FTP-Proxy
gnome_proxy_ftp_host:

# Der Port für den FTP-Proxy
gnome_proxy_ftp_port:

# Der Hostname / die IP-Adresse für den SOCKS-Proxy
gnome_proxy_socks_host:

# Der Port für den SOCKS-Proxy
gnome_proxy_socks_port:

# Verzeichnis, in dem sich GLib-Schemas befinden
gnome_proxy_glib_schemas_directory: '/usr/share/glib-2.0/schemas'

# Name der Überschreibungsdatei für die gnome_proxy-Konfiguration
gnome_proxy_overide_filename: '20_ansible-proxy.gschema.override'

Beispiel-Playbooks

Automatischer Proxy

- hosts: servers
  roles:
    - role: gantsign.gnome-proxy
      gnome_proxy_mode: 'auto'
      # Gnome sollte die Auto-Konfigurations-URL automatisch entdecken können:
      # https://de.wikipedia.org/wiki/Web_Proxy_Autodiscovery_Protocol
      # Wenn die automatische Entdeckung fehlschlägt, können Sie die URL wie folgt angeben:
      gnome_proxy_autoconfig_url: 'http://wpad.example.com/wpad.dat'

Manueller Proxy

- 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

Weitere Rollen von GantSign

Weitere Rollen von GantSign finden Sie auf Ansible Galaxy.

Entwicklung & Test

Dieses Projekt verwendet Molecule zur Unterstützung der Entwicklung und des Testens. Die Rolle wird mit Testinfra und pytest getestet.

Um zu entwickeln oder zu testen, benötigen Sie Folgendes:

Linux (z.B. Ubuntu)
Docker
Python (inkl. python-pip)
Ansible
Molecule

Da die Installation dieser Komponenten schwierig sein kann, enthält dieses Projekt den Molecule Wrapper. Der Molecule Wrapper ist ein Shell-Skript, das Molecule und seine Abhängigkeiten (außer Linux) installiert und dann Molecule mit dem Befehl ausführt, den Sie ihm übergeben.

Um diese Rolle mit dem Molecule Wrapper zu testen, führen Sie den folgenden Befehl im Projektstammverzeichnis aus: