docs/content/ftest/tutorial-new-specimen.md

+++ title = "[Tutorial] Add new specimen" insert_anchor_links = "right" weight = 7 +++

How to add new specimen

1. Fork the control repository.

git clone https://git.batsense.net/ForgeFlux/ftest-control

2. Create specimen subdirectory

If specimen doesn't exist within targets/ directory, then create subdirectory for it:

mkdir targets/<insert-specimen-name>
cd targets/<insert-specimen-name>

3. Create docker-compose.yml:

touch docker-compose.yml

Populate docker-compose.yml with instructions to spin up a test environment for the specimen. The specimen's upstream sources will include a reference docker-compose file should be fine in most cases.

4. Create job manifest

Job manifest is defined in ftest.toml file in the specimen's subdirectory. It can contain information on:

Initialization code

needs to be run to prepare the test environment.