rougail-tutorials/doc.md
Emmanuel Garette f1a276f3d5 [tutorial Ansible 1.4] a variable with multiple values
Proxy configuration
===================

Add env_proxy.no_proxy for proxy exception

---
env_proxy:
  host: proxy.example.net
  no_proxy:
    - localhost
    - 192.168.1.1
    - .ac-dijon.fr

Examples of Ops inventory file
==============================

1/ INVALID, must be a list:

---
env_proxy:
  host: proxy.example.net
  no_proxy: localhost

2/ INVALID, an integer:

---
env_proxy:
  host: proxy.example.net
  no_proxy:
    - 1

3/ INVALID, without value:

---
env_proxy:
  host: proxy.example.net
2023-12-18 11:34:32 +01:00

45 lines
3.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
gitea: none
include_toc: true
---
# Variables
## HTTP(s) proxy server overview and configuration (env_proxy)
A proxy server acts as an intermediary gateway between a client and another
HTTP(s) server, such as the Internet.
It makes service requests on behalf of a local client and allows the client
to make network connections to network services outside its own network.
| Parameter | Comment |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **host**<br/>`mandatory`<br/>**Type:** [`domainname`](https://forge.cloud.silique.fr/stove/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | The proxy servers address.<br/>Specifies the hostname of proxy server to enable proxy server access to all of your HTTP(s) requests. .<br/>**Example:** proxy.silique.fr |
| **port**<br/>`mandatory`<br/>**Type:** [`port`](https://forge.cloud.silique.fr/stove/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | The proxy server's port.<br/>**Default:** 3128 |
| **no_proxy**<br/>`mandatory`, `multiple`<br/>**Type:** [`domainname`](https://forge.cloud.silique.fr/stove/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Exclude proxy server.<br/>Network address(es), network address range(s) and domains to exclude from using the proxy when initiating connection(s). .<br/>**Examples:** 192.168.1.1, 192.168.10.0/24, www.silique.fr, .internal.silique.fr |
# Example with mandatories variables
```
env_proxy:
host: proxy.silique.fr
no_proxy:
- 192.168.1.1
- 192.168.10.0/24
- www.silique.fr
- .internal.silique.fr
```
# Example with all variables
```
env_proxy:
host: proxy.silique.fr
port: '3128'
no_proxy:
- 192.168.1.1
- 192.168.10.0/24
- www.silique.fr
- .internal.silique.fr
```