gnome-proxy

Роль Ansible: Gnome Proxy

Роль для настройки параметров прокси для приложений Gnome и других приложений, которые используют настройки прокси Gnome (например, веб-браузера Google Chrome).

Требования

Ansible >= 2.9
- Примечание: более ранние версии Ansible могут работать, но не были протестированы.
Дистрибутив Linux
- Семейство Debian
  - Ubuntu
    - Bionic (18.04)
    - Focal (20.04)
- Примечание: другие версии могут работать, но не были протестированы.

Переменные роли

Следующие переменные изменят поведение этой роли (значения по умолчанию показаны ниже):

# Режим прокси (нет, ручной или автоматический)
gnome_proxy_mode:

# URL файла автоматической настройки прокси (PAC)
# См.: https://en.wikipedia.org/wiki/Proxy_auto-config
# https://en.wikipedia.org/wiki/Web_Proxy_Autodiscovery_Protocol
gnome_proxy_autoconfig_url:

# Список имен хостов / IP-адресов, для которых не применять прокси
gnome_proxy_ignore_hosts:

# Использовать указанный прокси для всех протоколов
gnome_proxy_use_same_proxy:

# Имя хоста / IP-адрес для HTTP прокси
gnome_proxy_http_host:

# Порт для HTTP прокси
gnome_proxy_http_port:

# Нужна ли аутентификация для HTTP прокси
gnome_proxy_http_use_authentication:

# Имя пользователя для доступа к HTTP прокси
gnome_proxy_http_authentication_user:

# Пароль для доступа к HTTP прокси
gnome_proxy_http_authentication_password:

# Включен ли HTTP прокси
gnome_proxy_http_enabled:

# Имя хоста / IP-адрес для HTTPS прокси
gnome_proxy_https_host:

# Порт для HTTPS прокси
gnome_proxy_https_port:

# Имя хоста / IP-адрес для FTP прокси
gnome_proxy_ftp_host:

# Порт для FTP прокси
gnome_proxy_ftp_port:

# Имя хоста / IP-адрес для SOCKS прокси
gnome_proxy_socks_host:

# Порт для SOCKS прокси
gnome_proxy_socks_port:

# Директория, где находятся схемы GLib
gnome_proxy_glib_schemas_directory: '/usr/share/glib-2.0/schemas'

# Имя файла переопределения для конфигурации gnome_proxy
gnome_proxy_overide_filename: '20_ansible-proxy.gschema.override'

Примеры плейбуков

Авто-прокси

- hosts: servers
  roles:
    - role: gantsign.gnome-proxy
      gnome_proxy_mode: 'auto'
      # Gnome должен иметь возможность обнаружить URL авто-настройки с помощью:
      # https://en.wikipedia.org/wiki/Web_Proxy_Autodiscovery_Protocol
      # если автоматическое обнаружение не удалось, вы можете указать URL ниже:
      gnome_proxy_autoconfig_url: 'http://wpad.example.com/wpad.dat'

Ручной прокси

- 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

Другие роли от GantSign

Вы можете найти больше ролей от GantSign на Ansible Galaxy.

Разработка и тестирование

Этот проект использует Molecule для помощи в разработке и тестировании; роль тестируется с использованием Testinfra и pytest.

Чтобы разрабатывать или тестировать, вам нужно установить следующее:

Linux (например, Ubuntu)
Docker
Python (включая python-pip)
Ansible
Molecule

Поскольку установка вышеупомянутого может быть сложной, в проект включен Molecule Wrapper. Molecule Wrapper — это оболочка, которая устанавливает Molecule и его зависимости (кроме Linux), а затем выполняет Molecule с командой, которую вы передаете.

Чтобы протестировать эту роль с помощью Molecule Wrapper, выполните следующую команду из корневой директории проекта: