stove/rougail-tutorials
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
rougail-tutorials/doc.md

46 lines
3.2 KiB
Markdown
Raw Normal View History

[tutorial Ansible 1.0] a single string variable Proxy configuration =================== Add a single "host" variable --- env_proxy: host: proxy.example.net
2023-12-18 11:34:30 +01:00
---
gitea: none
include_toc: true
---
# Variables
[tutorial Ansible 1.1] advanced hostname variable Proxy configuration =================== Modify the "host" variable Examples of Ops inventory file ============================== 1/ VALID: --- env_proxy: host: proxy.example.net 2/ INVALID, host is null: --- env_proxy: host: 3/ INVALID, host is an integer: --- env_proxy: host: 1 4/ INVALID but only for rougail: --- env_proxy: host: the proxy
2023-12-18 11:34:30 +01:00
## 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.
[tutorial Ansible 1.0] a single string variable Proxy configuration =================== Add a single "host" variable --- env_proxy: host: proxy.example.net
2023-12-18 11:34:30 +01:00
| Parameter | Comment |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
[tutorial Ansible 1.1] advanced hostname variable Proxy configuration =================== Modify the "host" variable Examples of Ops inventory file ============================== 1/ VALID: --- env_proxy: host: proxy.example.net 2/ INVALID, host is null: --- env_proxy: host: 3/ INVALID, host is an integer: --- env_proxy: host: 1 4/ INVALID but only for rougail: --- env_proxy: host: the proxy
2023-12-18 11:34:30 +01:00
| **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 server’s 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 |
[tutorial Ansible 1.3] default variable Proxy configuration =================== env_proxy.port has a default value with ansible we needs to define a new mapping variable: env_proxy_all Examples of Ops inventory file ============================== 1/ VALID: --- env_proxy: host: proxy.example.net 2/ VALID: --- env_proxy: host: proxy.example.net port: "3129"
2023-12-18 11:34:31 +01:00
| **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 |
[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
| **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 |
[tutorial Ansible 1.0] a single string variable Proxy configuration =================== Add a single "host" variable --- env_proxy: host: proxy.example.net
2023-12-18 11:34:30 +01:00
# Example with mandatories variables
```
env_proxy:
[tutorial Ansible 1.1] advanced hostname variable Proxy configuration =================== Modify the "host" variable Examples of Ops inventory file ============================== 1/ VALID: --- env_proxy: host: proxy.example.net 2/ INVALID, host is null: --- env_proxy: host: 3/ INVALID, host is an integer: --- env_proxy: host: 1 4/ INVALID but only for rougail: --- env_proxy: host: the proxy
2023-12-18 11:34:30 +01:00
host: proxy.silique.fr
[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
no_proxy:
- 192.168.1.1
- 192.168.10.0/24
- www.silique.fr
- .internal.silique.fr
[tutorial Ansible 1.0] a single string variable Proxy configuration =================== Add a single "host" variable --- env_proxy: host: proxy.example.net
2023-12-18 11:34:30 +01:00
```
# Example with all variables
```
env_proxy:
[tutorial Ansible 1.1] advanced hostname variable Proxy configuration =================== Modify the "host" variable Examples of Ops inventory file ============================== 1/ VALID: --- env_proxy: host: proxy.example.net 2/ INVALID, host is null: --- env_proxy: host: 3/ INVALID, host is an integer: --- env_proxy: host: 1 4/ INVALID but only for rougail: --- env_proxy: host: the proxy
2023-12-18 11:34:30 +01:00
host: proxy.silique.fr
[tutorial Ansible 1.2] a port variable Proxy configuration =================== Add the env_proxy.port variable --- env_proxy: host: proxy.example.net port: "3128" Examples of Ops inventory file ============================== 1/ INVALID only with rougail: --- env_proxy: host: proxy.example.net port: 3128 2/ INVALID, port is missing: --- env_proxy: host: proxy.example.net
2023-12-18 11:34:31 +01:00
port: '3128'
[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
no_proxy:
- 192.168.1.1
- 192.168.10.0/24
- www.silique.fr
- .internal.silique.fr
[tutorial Ansible 1.0] a single string variable Proxy configuration =================== Add a single "host" variable --- env_proxy: host: proxy.example.net
2023-12-18 11:34:30 +01:00
```
Reference in a new issue Copy permalink