Skip to content

Commit df74856

Browse files
author
bowler
committed
-update bigip/4 to West
-text formatting
1 parent e87f812 commit df74856

File tree

1 file changed

+27
-22
lines changed

1 file changed

+27
-22
lines changed

docs/class1/module2/lab2.rst

+27-22
Original file line numberDiff line numberDiff line change
@@ -81,18 +81,23 @@ F5 AST Configuration Setting Files
8181

8282
.. note:: Default device settings can be overridden by individual device configurations in the ``config/bigip_receivers.yaml`` file.
8383

84-
As mentioned in Step 4, we need to add a new BIG-IP instance for data scraping: ``APAC - bigip-01``.
84+
As mentioned in Step 4, we need to add a new BIG-IP instance for data scraping: ``East Region - bigip-01``.
8585

8686
#. First, inspect the ``config/bigip_receivers.yaml`` file with the following command:
8787

8888
.. code-block:: console
8989
9090
more config/bigip_receivers.yaml
9191
92-
Here's the configuration for one of the BIG-IPs:
92+
Here's the configuration for ``West Region - bigip-01``:
9393

9494
.. code-block:: console
9595
96+
# Your bigip targets
97+
# Values not explicitly configured here inherit values in
98+
# the ast_defaults.yaml bigip_receiver_defaults section.
99+
# Each entry must have a unique name, starting with bigip/
100+
# (e.g. bigip/1, bigip/2)
96101
bigip/1:
97102
# Endpoint must be specified for each device
98103
# Set this to the management IP for the device. This must be
@@ -141,7 +146,7 @@ F5 AST Configuration Setting Files
141146
.. code-block:: console
142147
143148
bigip/4:
144-
endpoint: https://10.1.1.6
149+
endpoint: https://10.1.1.7
145150
146151
To save your changes, press ``escape``, then type ``:wq`` and ``return``. You should see a message similar to the following upon successful save:
147152

@@ -160,12 +165,12 @@ Once the ``bigip_receivers.yaml`` file has been updated, you must run the config
160165
161166
sudo docker run --rm -it -w /app -v ${PWD}:/app --entrypoint /app/src/bin/init_entrypoint.sh python:3.12.6-slim-bookworm --generate-config
162167
163-
Output ending with the following two lines indicates the configuration was successfully generated.
168+
Output ending with the following two lines indicates the configuration was successfully generated.
164169

165-
.. code-block:: console
170+
.. code-block:: console
166171
167-
2024-11-19 06:28:46,272 - INFO - Successfully wrote data to './services/otel_collector/pipelines.yaml'.
168-
2024-11-19 06:28:46,273 - INFO - Successfully wrote data to './services/otel_collector/receivers.yaml'.
172+
2024-11-19 06:28:46,272 - INFO - Successfully wrote data to './services/otel_collector/pipelines.yaml'.
173+
2024-11-19 06:28:46,273 - INFO - Successfully wrote data to './services/otel_collector/receivers.yaml'.
169174
170175
Updating F5 AST
171176
---------------
@@ -174,48 +179,48 @@ Let's check the release version of the repo by examining the ``docker-compose.ya
174179

175180
#. Review the ``docker-compose.yaml`` file:
176181

177-
.. code-block:: console
182+
.. code-block:: console
178183
179-
more docker-compose.yaml
184+
more docker-compose.yaml
180185
181186
Press ``space`` until the entire file contents are revealed. Notice the ``otel-collector`` section and the ``image`` property therein.
182187

183-
.. code-block:: console
188+
.. code-block:: console
184189
185-
otel-collector:
186-
image: ghcr.io/f5devcentral/application-study-tool/otel_custom_collector:v0.7.0
190+
otel-collector:
191+
image: ghcr.io/f5devcentral/application-study-tool/otel_custom_collector:v0.7.0
187192
188193
This particular output reveals ``v0.7.0`` of the OTel Custom Collector. If that version is lower than what's listed on the `f5devcentral / application-study-tool Releases board <https://github.com/f5devcentral/application-study-tool/releases/tag/v0.7.0>`_, perform the following steps. Otherwise, you're ready and free to roll on to :ref:`Accessing F5 AST`.
189194

190195
#. Since local changes have been made to files which are actively tracked for changes in the repo, such as ``.env.device-secrets`` and ``config/bigip_receivers.yaml``, we must stash away those changes prior to performing a ``git pull``. Stashing simply sets them aside temporarily. We'll reincorporate them after pulling the latest code from GitHub.
191196

192-
.. code-block:: console
197+
.. code-block:: console
193198
194-
sudo git stash
199+
sudo git stash
195200
196201
#. Pull new code from the GitHub repo:
197202

198-
.. code-block:: console
203+
.. code-block:: console
199204
200-
sudo git pull origin main
205+
sudo git pull origin main
201206
202207
#. Undo the ``git stash`` action, bringing our local changes back where they need to be:
203208

204-
.. code-block:: console
209+
.. code-block:: console
205210
206-
sudo git stash pop
211+
sudo git stash pop
207212
208213
#. Run the F5 AST Configuration Helper:
209214

210-
.. code-block:: console
215+
.. code-block:: console
211216
212-
sudo docker run --rm -it -w /app -v ${PWD}:/app --entrypoint /app/src/bin/init_entrypoint.sh python:3.12.6-slim-bookworm --generate-config
217+
sudo docker run --rm -it -w /app -v ${PWD}:/app --entrypoint /app/src/bin/init_entrypoint.sh python:3.12.6-slim-bookworm --generate-config
213218
214219
#. Restart the OTel Custom Collector container:
215220

216-
.. code-block:: console
221+
.. code-block:: console
217222
218-
sudo docker container restart application-study-tool_otel-collector_1
223+
sudo docker container restart application-study-tool_otel-collector_1
219224
220225
That's it! The upgrade process should be seamless and good to go.
221226

0 commit comments

Comments
 (0)