f496393ee6
The openapi.yaml driving NSwag client generation is no longer committed. A build-time target in LogosStorageClient.csproj extracts it byte-for-byte from the Logos Storage image (STORAGEDOCKERIMAGE, default latest-dist-tests) via 'docker cp' whenever a Docker daemon is reachable, always overwriting so the generated client matches the container under test. Where no daemon is reachable (the CI runner pod) the spec must be pre-placed on disk by the job's initContainer, else the build fails loudly. Because StoragePlugin's PreBuildEvent runs before project references are built, the old hash-injection prebuild read the spec before it could be materialized and baked a stale hash. Materialization and the ApiChecker hash check are therefore mutually exclusive, so ApiChecker and the LogosStoragePluginPrebuild project are removed here. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> # Conflicts: # ProjectPlugins/LogosStorageClient/openapi.yaml # ProjectPlugins/StoragePlugin/ApiChecker.cs # Conflicts: # ProjectPlugins/LogosStorageClient/openapi.yaml # ProjectPlugins/StoragePlugin/ApiChecker.cs
Distributed System Tests
This project allows you to write tools and tests that control and interact with container-based applications to form a distributed system in a controlled, reproducible environment.
Dotnet: v10.0
Kubernetes: v1.34.1
Dotnet-kubernetes SDK: v18.0.3 https://github.com/kubernetes-client/csharp
Nethereum: v4.14.0
Currently, this project is mainly used for distributed testing of Logos Storage. However, its plugin-structure allows for other projects to be on-boarded (relatively) easily. (See 'contribute a plugin`.)
Tests/DistTestCore
Library with generic distributed-testing functionality. Uses NUnit3. Reference this project to build unit-test style scenarios: setup, run test, teardown. The DistTestCore responds to the following env-vars:
LOGPATH= Path where log files will be written.DATAFILEPATH= Path where (temporary) data files will be stored.ALWAYS_LOGS= When set, DistTestCore will always download all container logs at the end of a test run. By default, logs are only downloaded on test failure.
Tests/LogosStorageTests and Tests/LogosStorageLongTests
These are test assemblies that use DistTestCore to perform tests against transient Logos Storage nodes. Read more HERE
Tests/ContinuousTests
A console application that runs tests in an endless loop against a persistent deployment of Logos Storage nodes. Read more HERE
Framework architecture
The framework is designed to be extended by project-specific plugins. These plugins contribute functionality and abstractions to the framework. Users of the framework use these to perform tasks such as testing and deploying.
How to contribute a plugin
If you want to add support for your project to the testing framework, follow the steps HERE
How to contribute tests
If you want to contribute tests, please follow the steps HERE.
Run the tests on your machine
Creating tests is much easier when you can debug them on your local system. This is possible, but requires some set-up. If you want to be able to run the tests on your local system, follow the steps HERE. Please note that tests which require explicit node locations cannot be executed locally. (Well, you could comment out the location statements and then it would probably work. But that might impact the validity/usefulness of the test.)
Missing functionality
Surely the test-infra doesn't do everything we'll need it to do. If you're running into a limitation and would like to request a new feature for the test-infra, please create an issue.