Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 1 addition & 11 deletions index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,7 @@
onramp/roc
onramp/devel
onramp/blueprints
onramp/testing

.. toctree::
:maxdepth: 3
Expand Down Expand Up @@ -56,17 +57,6 @@
operations/metering
operations/monitor

.. toctree::
:maxdepth: 3
:caption: Test Automation
:hidden:
:glob:

testing/about_system_tests
testing/integration_tests
testing/aether-roc-tests


.. toctree::
:maxdepth: 2
:caption: Releases
Expand Down
3 changes: 0 additions & 3 deletions intro.rst
Original file line number Diff line number Diff line change
Expand Up @@ -34,9 +34,6 @@ Other Aether guides available on this site include:
* :doc:`Runtime Operations </operations/gui>`: Learn how
to operate Aether's 5G connectivity service.

* :doc:`Test Automation </testing/about_system_tests>`: Learn how Aether
components are tested.

Note that Aether was originally deployed as a centrally-managed cloud
service with a dedicated ops team. The expectation was that
organizations would participate in Aether by connecting their edge
Expand Down
35 changes: 35 additions & 0 deletions onramp/testing.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
Integration Tests
--------------------

A set of integration tests validate the released :doc:`Aether
Blueprints </onramp/blueprints>`. The tests are managed by Jenkins,
and can be monitored using the following `Dashboard
<https://jenkins.aetherproject.org/>`__. Log files generated by
recent runs are available on that site.

Source code for the integration tests can be found in the
`aether-jenkins repo
<https://github.com/opennetworkinglab/aether-jenkins>`__ on
GitHub, where each file in the repo corresponds to a Groovy script
that implements a Jenkins pipeline for one of the blueprints.

The pipelines are executed daily, with each pipeline parameterized to
run in multiple jobs. The ``${AgentLabel}`` parameter selects the
Ubuntu release being tested (currently ``22.04`` and ``24.04``), with
all jobs running in AWS VMs (currently resourced as
``M7iFlex2xlarge``). Pipelines that exercise two-server
tests—currently ``ueransim.groovy``, ``upf.groovy``,
``srsran.groovy``, and ``gnbsim.groovy``\—invoke the `AWS CLI
<https://aws.amazon.com/cli/>`__ to create the second VM.

All VMs created by Jenkins run images prepared using Packer, with the
current specification templates available in the `aether-packer repo
<https://github.com/opennetworkinglab/aether-packer>`__ on GitHub.

Finally, note that the integration tests run a variety of simulated 5G
workloads, including gNBsim, UERANSIM, OAI 5G RAN (in simulation
mode), and srsRAN (in simulation mode). Of these, gNBsim provides the
most rigorous testing of the Core's control plane, and serves as
Aether's primary validation of that functionality. More information
about gNBsim can be found in the :doc:`Emulated RAN
</onramp/gnbsim>` section of this Guide.
27 changes: 0 additions & 27 deletions testing/about_system_tests.rst

This file was deleted.

220 changes: 0 additions & 220 deletions testing/aether-roc-tests.rst

This file was deleted.

26 changes: 0 additions & 26 deletions testing/integration_tests.rst

This file was deleted.