Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/stone-payments/ansible-proxy
Role for Ansible which configures the proxy client parameters in RHEL systems
https://github.com/stone-payments/ansible-proxy
ansible evolucaoinfra proxy
Last synced: 3 days ago
JSON representation
Role for Ansible which configures the proxy client parameters in RHEL systems
- Host: GitHub
- URL: https://github.com/stone-payments/ansible-proxy
- Owner: stone-payments
- License: mit
- Created: 2017-08-04T22:44:59.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2023-12-13T13:48:36.000Z (11 months ago)
- Last Synced: 2024-04-16T00:09:01.121Z (7 months ago)
- Topics: ansible, evolucaoinfra, proxy
- Language: Jinja
- Size: 334 KB
- Stars: 3
- Watchers: 420
- Forks: 3
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# Stone Payments - Proxy
Role for Ansible which configures the proxy client parameters in GNU/Linux and Windows systems.
## Requirements
None.
## Usage
Just include the role and set the variables in the `defaults/main.yml` file:
```yaml
- name: configure proxy client
hosts: all
roles:
- stone-payments.proxy
vars:
proxy_address: "some.server.example.com"
proxy_port: "3128"
```
## Advanced usage
You may also setup another proxy protocol than HTTP (SOCKS or SOCKS5, maybe) and setup authentication by using the following vars:
```yaml
# May be http, socks or socks5
proxy_proto: "http"
proxy_address: ""
proxy_port: ""
# To keep proxy settings when using sudo
proxy_sudo: true
# Configure systemd to use the proxy
proxy_systemd: false
# To use proxy with authentication
proxy_auth: false
proxy_user: ""
proxy_pass: ""
# Configure yum and RHSM to use the proxy
proxy_redhat: false
# Used to set or remove proxy settings for Windows INet which includes Internet Explorer
proxy_win_inet: true
# Used to set, remove, or import proxy settings for Windows HTTP Services WinHTTP
proxy_win_http: false
# Sets the list of hosts that will bypass the set proxy when being accessed
proxy_whitelist:
- "127.0.0.1"
- "localhost"
```
- If you're going to use authentication, you need both to inform the user/pass and enable it by setting `proxy_auth` to true.
- You may also pass a list in `proxy_whitelist` with names or IPs that you do not want to use the proxy and access directly.
## Dependencies
None.
## Testing
This role to use [`molecule`](https://molecule.readthedocs.io/en/latest/) to execute your local tests and check ansible syntax. Notice that we only support Molecule 2.0 or greater. You can install molecule with:
```shell
pipenv install --dev --three
```
After having Molecule setup, you can run the tests with this steps:
```sh
molecule test [-s scenario_name]
```
Where `scenario_name` is the name of a test case under `molecule`.
## Contributing
Just open a PR. We love PRs!
## License
This code is licensed under the MIT license.