Skip to content

Latest commit

 

History

History
56 lines (35 loc) · 2.55 KB

testing.md

File metadata and controls

56 lines (35 loc) · 2.55 KB

Testing

ServiceControl tests are designed to test difference components and behaviors. This document outlines the tests in the respository and what they are meant to test.

Unit tests

ServiceControl compoonents have specific unit tests projects verifying their behaviors and API.

Packaging tests

Packaging tests check:

Installation engine tests

Installation engine tests run partial installations and checks:

  • That the generated configuration is correct.
  • That transport and persistence are correctly extracted.

Persistence tests

Persistence tests check assumption at the persistence seam level by exercising each persister.

Transport tests

Transport tests are done by executing the transport test suite for each transport.

Acceptance tests

Run ServiceControl full version and use the HTTP API to validate results. LearningTransport is used for all tests.

Multi-instance tests

Multi-instance tests validate the interaction between different ServiceControl instances. ServiceControl instances are run in-memory in the same process. LearningTransport is used for all tests.

Container tests

Containers images generated for all builds are pushed to the GitHub container registry. Once pushed all images are tested by spinning them all up for each supported transport.

Containers built by a PR and stored on GitHub Container Registry can be tested locally:

  1. Authenticate to the GitHub Container Registry using a personal access token.
  2. In the terminal, navigate to []/docs/test-ghcr-tag](/docs/test/ghcr-tag).
  3. Edit the .env file to specify the PR-based tag (in the form pr-####) to test.
  4. Run docker compose up -d.
  5. Services will be avialable at the following URLs:
  6. Tear down services using docker compose down.