Skip to content

Commit 8ed6a48

Browse files
authored
Merge pull request #2534 from splunk/adasplunk-O11YDOCS-6653
[O11YDOCS-6653] Replace uppercase env variable names with lowercase
2 parents 14175cc + aeb7b4d commit 8ed6a48

File tree

1 file changed

+17
-19
lines changed

1 file changed

+17
-19
lines changed

synthetics/test-config/private-locations.rst

Lines changed: 17 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -141,59 +141,57 @@ For example, here is what a command might look like after you modify it to fit y
141141

142142

143143

144-
Configuring proxy settings for a private location
144+
Configure proxy settings for a private location
145145
===================================================
146146

147147
In environments where direct internet access is restricted, you can route synthetic test traffic through a proxy server by configuring the following environment variables:
148148

149-
* ``HTTP_PROXY``: Specifies the proxy server for HTTP traffic.
149+
* ``http_proxy``: Specifies the proxy server for HTTP traffic.
150150

151-
* Example: ``export HTTP_PROXY="\http://proxy.example.com:8080"``
151+
* Example: ``export http_proxy="http://proxy.example.com:8443"``
152152

153-
* ``HTTPS_PROXY``: Specifies the proxy server for HTTPS traffic.
153+
* ``https_proxy``: Specifies the proxy server for HTTPS traffic.
154154

155-
* Example: ``export HTTPS_PROXY="\https://proxy.example.com:8443"``
155+
* Example: ``export https_proxy="http://proxy.example.com:8443"``
156156

157-
* ``NO_PROXY``: Specifies a comma-separated list of domains or IP addresses that should bypass the proxy.
157+
* ``no_proxy``: Specifies a comma-separated list of domains or IP addresses that should bypass the proxy.
158158

159-
* Example: ``export NO_PROXY="localhost,127.0.0.1,.internal-domain.com"``
159+
* Example: ``export no_proxy="localhost,127.0.0.1,.internal-domain.com"``
160160

161161
For example, here is what a command might look like after you modify it to fit your environment:
162162

163163

164164
.. code:: yaml
165165
166-
docker run --cap-add NET_ADMIN -e "RUNNER_TOKEN=*****" quay.io/signalfx/splunk-synthetics-runner:latest -e NO_PROXY=".signalfx.com,.amazonaws.com" -e HTTPS_PROXY="https://172.17.0.1:1234" -e HTTP_PROXY="http://172.17.0.1:1234"
166+
docker run --cap-add NET_ADMIN -e "RUNNER_TOKEN=*****" -e "no_proxy=.signalfx.com,.amazonaws.com,127.0.0.1,localhost" -e "https_proxy=http://172.17.0.1:1234" -e "http_proxy=http://172.17.0.1:1234" quay.io/signalfx/splunk-synthetics-runner:latest
167+
167168
168169
In this example:
169170

170-
``HTTP_PROXY`` and ``HTTPS_PROXY`` are set to route traffic through a proxy at ``http://172.17.0.1:1234``.
171+
``http_proxy`` and ``https_proxy`` are set to route traffic through a proxy at ``http://172.17.0.1:1234``.
171172

172-
``NO_PROXY`` is configured to bypass the proxy for local addresses and specific domains like .signalfx.com and .amazonaws.com.
173+
``no_proxy`` is configured to bypass the proxy for local addresses and specific domains like .signalfx.com and .amazonaws.com.
173174

174175
Ensure that these variables are correctly configured to comply with your network policies. This setup allows the synthetic tests to communicate securely and efficiently in a controlled network environment.
175176

176-
When using runner, it's important to correctly configure the proxy settings to avoid issues with browser-based tests. The following steps should be followed when setting up their environment:
177+
When using a private runner, it's important to correctly configure the proxy settings to avoid issues with browser-based tests. The following steps should be followed when setting up their environment:
177178

178-
1. :strong:`Ensure proper NO_PROXY setup`:
179+
1. :strong:`Ensure proper no_proxy setup`:
179180

180-
- When configuring ``NO_PROXY`` always include the following addresses:
181+
- When configuring ``no_proxy`` always include the following addresses:
181182

182183
- ``127.0.0.1`` (for localhost communication)
183184
- ``localhost`` (for resolving local tests)
184185

185186
These addresses ensure that internal services and tests run correctly without routing through a proxy, preventing potential failures.
186187

187-
2. :strong:`Merging HTTP_PROXY and http_proxy`:
188-
189-
- The system automatically handles both ``HTTP_PROXY`` and ``http_proxy`` environment variables. If you define one of these, ensure the other is also set, or they will be automatically merged at start-up.
190-
191188
3. :strong:`Dockerfile defaults`:
192189

193-
- By default, the runner will set the ``NO_PROXY`` variable in the Dockerfile to include ``127.0.0.1``. If you override ``NO_PROXY``, you must ensure that ``127.0.0.1`` and ``localhost`` are still present, or browser tests may fail.
194-
190+
- By default, the private runner sets the ``no_proxy`` variable in the Dockerfile to include ``127.0.0.1``. If you override ``no_proxy``, you must ensure that ``127.0.0.1`` and ``localhost`` are still present, or browser tests may fail.
195191

196192

193+
.. note::
194+
Lower case variable names take precedence and are best practice.
197195

198196

199197
Assess the health of a private location

0 commit comments

Comments
 (0)