gantsign.gnome-proxy

Ansible Rola: Gnome Proxy

Rola do konfigurowania ustawień proxy dla aplikacji Gnome i innych aplikacji, które korzystają z ustawień proxy Gnome (np. przeglądarka internetowa Google Chrome).

Wymagania

Ansible >= 2.9
- Uwaga: wcześniejsze wersje Ansible mogą działać, ale nie były testowane.
Dystrybucja Linuxa
- Rodzina Debian
  - Ubuntu
    - Bionic (18.04)
    - Focal (20.04)
- Uwaga: inne wersje mogą działać, ale nie były testowane.

Zmienne Roli

Poniższe zmienne zmienią działanie tej roli (domyślne wartości przedstawione poniżej):

# Tryb proxy (brak, ręczny lub automatyczny)
gnome_proxy_mode:

# URL pliku konfiguracyjnego proxy (PAC)
# Zobacz: https://en.wikipedia.org/wiki/Proxy_auto-config
# https://en.wikipedia.org/wiki/Web_Proxy_Autodiscovery_Protocol
gnome_proxy_autoconfig_url:

# Lista nazw hostów / adresów IP, które nie powinny korzystać z proxy
gnome_proxy_ignore_hosts:

# Użyj określonego proxy dla wszystkich protokołów
gnome_proxy_use_same_proxy:

# Nazwa hosta / adres IP dla proxy HTTP
gnome_proxy_http_host:

# Port dla proxy HTTP
gnome_proxy_http_port:

# Czy proxy HTTP wymaga uwierzytelnienia
gnome_proxy_http_use_authentication:

# Nazwa użytkownika używana do uzyskania dostępu do proxy HTTP
gnome_proxy_http_authentication_user:

# Hasło używane do uzyskania dostępu do proxy HTTP
gnome_proxy_http_authentication_password:

# Czy proxy HTTP jest włączone
gnome_proxy_http_enabled:

# Nazwa hosta / adres IP dla proxy HTTPS
gnome_proxy_https_host:

# Port dla proxy HTTPS
gnome_proxy_https_port:

# Nazwa hosta / adres IP dla proxy FTP
gnome_proxy_ftp_host:

# Port dla proxy FTP
gnome_proxy_ftp_port:

# Nazwa hosta / adres IP dla proxy SOCKS
gnome_proxy_socks_host:

# Port dla proxy SOCKS
gnome_proxy_socks_port:

# Katalog, w którym znajdują się schematy GLib
gnome_proxy_glib_schemas_directory: '/usr/share/glib-2.0/schemas'

# Nazwa pliku nadpisania dla konfiguracji gnome_proxy
gnome_proxy_overide_filename: '20_ansible-proxy.gschema.override'

Przykładowe Playbooki

Automatyczne proxy

- hosts: serwery
  roles:
    - role: gantsign.gnome-proxy
      gnome_proxy_mode: 'auto'
      # Gnome powinien być w stanie odkryć URL autokonfiguracji używając:
      # https://en.wikipedia.org/wiki/Web_Proxy_Autodiscovery_Protocol
      # jeśli autoodkrywanie się nie powiedzie, możesz podać URL poniżej:
      gnome_proxy_autoconfig_url: 'http://wpad.example.com/wpad.dat'

Ręczne proxy

- hosts: serwery
  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

Więcej Ról od GantSign

Więcej ról od GantSign znajdziesz na Ansible Galaxy.

Rozwój i Testowanie

Ten projekt korzysta z Molecule w celu wspierania rozwoju i testów; rola jest testowana jednostkowo przy użyciu Testinfra i pytest.

Aby rozwijać lub testować, musisz mieć zainstalowane:

Linux (np. Ubuntu)
Docker
Python (w tym python-pip)
Ansible
Molecule

Ponieważ powyższe może być trudne do zainstalowania, ten projekt zawiera Molecule Wrapper. Molecule Wrapper to skrypt powłoki, który instaluje Molecule i jego zależności (oprócz Linuxa), a następnie wykonuje Molecule z poleceniem, które mu przekażesz.

Aby przetestować tę rolę za pomocą Molecule Wrapper, uruchom następujące polecenie z głównego katalogu projektu: