Getting Started with Numerous
This guide will show you how to get a simple code-example up and running on the numerous platform.
Prerequisites
You will need the following in order to get started with this guide:
- A GitLab account (opens in a new tab)
- Access to the numerous platform, see more here.
The main way to add your job-code to numerous is by connecting your GitLab account to the platform and the repository (GitLab project) you want to add. This guide will show you how to connect your GitLab account and work with a simple code example from there.
Add your GitLab account to numerous
In the side bar click on Settings > Integrations > GitLab. Click on the button Connect to GitLab and follow the guide. Your GitLab account is now connected to the numeorus platform.
Add a repository
Click on Repositories in the sidebar. Click Add repository.
In the field "Input repository ID" paste the following ID of the public Sine Wave project: 43018776. Click the button Add repository at the bottom
This is a sample project, you can find the code here https://gitlab.com/numerous/resources/Sine-Wave (opens in a new tab). The project is using the numerous.sdk (opens in a new tab) and has specified a Dockerfile to make it work with the numerous platform.
The repository has now been added. You can see an overview of the files in the latest commit.
Create a tool
Click on Tools in the menu to the left. Click on + Add New Tool.
Give the tool a name like "Sine Wave tool". Click Add Tool
Link the tool to the repository
On the tool page for the tool you just created, click on the button "Link tool to repository".
The Link tool to repository-dialog appears.
Choose the "Sine Wave"-repository. Click Next.
Choose the latest commit at the top. Click Link repository to tool.
Add a job to the tool
Click on + Add Job. The job-dialog opens.
Give your job a Job Name like "My Job".
Switch from Manual to Repository in the middle of the dialog-screen. Choose the Dockerfile (there is only one).
Click on the Add Job-button at the bottom of the dialog.
Click Save changes at the top of the window to save the changes to the tool.
Build the job-code
Click the button Build image under Jobs. Wait for the build to finish. This takes a couple of minutes.
Create a project
Click on the general workspace in the sidebar menu. Click on + New Project in the top right corner.
Give the project a Name like "My Project".
Click on Add Project at the bottom of the page
Add a group to your project
Click on the Add Group button. Give your group a Group Name like "My Group".
Click the Save button.
Add a scenario
On the group you just created click on the Add Scenario button.
Under Tool choose the tool you just created.
Give the scenario a Scenario name like "My Scenario". Click the Add Scenario button.
On the scenario page
Now you are on a page that looks like this:
Figure 1: Scenario Page
Running the code
Click on the play button (▶) to open the Start My Job-dialog.
Set duration to one hour. You do that by clicking Time in between and setting it to 1 hour.
Click Save changes & start job.
The Sine Wave job code will now run.
Displaying the output
Notice how Data output turned green. Click on the green icon above Data Output.
Click on + Add New Report
Click Save
Open your report
Click New Line Graph
Under Current scenario data tags click on the tag Sine
Now you should see a graph like the one below:
Figure 2: The sine wave graph
You can zoom in by clicking and dragging on the graph. You zoom out again by double-clicking.
The End
Congratulations 🎉. You have reached the end of this tutorial.