Merge pull request #49 from opennetworkinglab/maintenance

update testing

Author: llpeterson

index.rst

@@ -24,6 +24,7 @@
    onramp/roc
    onramp/devel
    onramp/blueprints
+   onramp/testing
 
 .. toctree::
    :maxdepth: 3
@@ -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

intro.rst

@@ -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

onramp/testing.rst

@@ -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.