Register a Runner

Once the host is up and running with all the needed software. You will need to register your GitLab Runner to the dAIEdge-VLab. This step is not yet automated, thus, you will need to contact the dAIEdge-VLab team for them to give you the register token.

Request a register Token

The register token is used to register a runner in the dAIEdge-VLab. This allows the dAIEdge-VLab to run your target repository on user demand. Follow the next steps to make a token request to the VierualLab team. You will need to make a request for each target-runtime couple you are developing. For instance, you are developing on an MCU target named STM32L4R9, you have ported two runtime (TFLite and X-CUBE-AI). You then must have two different repository (one for each runtime). You then have to register two target-runtime (STM32L4R9_TFLite and STM32L4R9_X-CUBE-AI).

Gather mandatory information

The mandatory information are :

Contact e-mail : This e-mail will be used to contact you in case we have questions about the target you are developing or to let you know about problems regarding the target.
Target name : The name of the target, mainly the processor/accelerator reference.
Runtime : The runtime used by the developed target.
Extensions : File extensions supported by the Runtime as input.
Description : A brief description of the hardware and runtime that compose the target. Focused mainly on the elements relevant for the dAIEdge-VLab (memory, specific hardware for AI application).
Host : The host operating system.
Memory : The memory available on the target for the models.

Contact the dAIEdge-VLab Team

Send an e-mail to vlab@daiedge.eu with the previously stated information.

You may use the following template for the e-mail :

E-mail Template

Object : Request to register a runner

Hello, 

I would like to register a runner for the dAIEdge-VLab. Here is all the mandatory information : 
- Contact e-mail : your.email@example.com
- Target name : your_target_name
- Runtime : your_runtime
- Extensions : your_list_of_supported_extensions
- Description : your_decription
- host : your_host_os
- Memory : your_available_target_memory

Thank you, 
Best regards, 

your_signature

Useing the token

Normally, you will get the following command as an answer :

gitlab-runner register --token $RUNNER_AUTHENTICATION_TOKEN

Run this command on your host. Then follow the configuration steps.

For the Runner name, you can name it as you want.
Select docker for the executor
Give the docker image path developed alongside your target for the default docker image. You can find the image tag in the container registry of your target repository.

ℹ️

Container Registry Access : It is likely that Docker cannot access the previously given Docker image. This is to be expected, the next section fix this issue.

Access the configuration

Keep an eye on where the file config.toml is located on your host. You will need to modify it later. By default, it is located at ~/.gitlab-runner/config.toml.

Install Gitlab runner and Docker Target repository folder structure