Ansible 角色：Gnome 代理

该角色用于配置 Gnome 应用程序和其他使用 Gnome 代理设置的应用程序（如谷歌 Chrome 浏览器）的代理设置。

需求

• Ansible >= 2.9

  • 注意：早期版本的 Ansible 可能可以工作，但未经过测试。

• Linux 发行版

  • Debian 系列

    • Ubuntu

      • Bionic (18.04)
      • Focal (20.04)

  • 注意：其他版本可能可以工作，但未经过测试。

角色变量

以下变量会改变此角色的行为（显示默认值）：

# 代理模式（无、手动或自动）
gnome_proxy_mode:

# 代理自动配置（PAC）文件的 URL
# 见： 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:

# HTTP 代理的主机名/IP 地址
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:

# HTTPS 代理的主机名/IP 地址
gnome_proxy_https_host:

# HTTPS 代理的端口
gnome_proxy_https_port:

# FTP 代理的主机名/IP 地址
gnome_proxy_ftp_host:

# FTP 代理的端口
gnome_proxy_ftp_port:

# SOCKS 代理的主机名/IP 地址
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 的角色

您可以在 Ansible Galaxy 上找到来自 GantSign 的更多角色。

开发与测试

该项目使用 Molecule 辅助开发和测试；该角色使用 Testinfra 和 pytest 进行单元测试。

要进行开发或测试，您需要安装以下内容：

• Linux（例如 Ubuntu）
• Docker
• Python（包括 python-pip）
• Ansible
• Molecule

由于以上内容的安装可能比较复杂，因此该项目包含 Molecule Wrapper。Molecule Wrapper 是一个安装 Molecule 及其依赖项（除了 Linux）的 shell 脚本，然后执行您传递给它的命令。

要使用 Molecule Wrapper 测试该角色，请从项目根目录运行以下命令：

./moleculew test

注意：某些依赖项需要 sudo 权限进行安装。

许可证

MIT

作者信息

John Freeman

GantSign 有限公司。 公司编号：06109112（在英格兰注册）