6.1. GitLab Introduction

6.1.1. Generalities

As a user of the public GitLab server provided by eRTOSgener, you can access to an EGOS dedicated GitLab instance using the following address: https://gitlab.ertosgener.com

This GitLab instance is hosted by a dedicated OVH server, which is fully owned by eRTOSgener and that we handle ourselves, without intermediates, in order to guarantee the confidentiality of the data stored on this server.

This document will explain to you how to access your GitLab account, how to set up the required tool locally and also how to work with GitLab and with EGOS in general.

This document will not provide a guideline about what is GitLab and how to use it in details. If you want to know more about GitLab, please refer to its official documentation: https://docs.gitlab.com/ee/user/index.html (The provided instance is an enterprise edition, which is a bit different than the community edition, although this is the Core version (free of charge)).

6.1.2. User account & access

6.1.2.1. User Account

In order to request a new user account, in case you already have colleagues from your company who have access, please send an email to support@ertosgener.com with the following information:

  • Full Name (first name + family name)
  • The name of your company
  • The name of the project you are working on.

If no one from your company has an account, please send an email to commerce@ertosgener.com

In case you participate in a training session organized by eRTOSgener, an account will be created so you dont need to request anything.

6.1.2.2. Access

Once your access has been created by eRTOSgener, you will receive an email from gitlab-public@ertosgener.com with a link so you can create your own password.

Please note this password on your side since no one will be able to recover it.

In case you forgot your password, please click on the Forgot your password? link on the Sign-in page to receive instructions to reset your password. This procedure is automated by the GitLab instance, no one (not even the instance administrator) at eRTOSgener will be able to see or recover your password.

The link provided in the email will then redirect you to a page which should look like the following screenshot:

GitLab-Welcome

If you have a doubt about the origin of the email or the page you are redirected to, please contact support@ertosgener.com for assistance before logging-in.

Note: DO NOT use the public GitLab instance provided by GitLab company (gitlab.com)!

6.1.3. GitLab Groups & Projects organization

Each partner or customer company will have a dedicated group, separated from the other customer groups.

Only one group will be visible for every user of the GitLab instance: Documentation and Support. This group contains 2 main projects:

  • Documentation: Project which contains the public documentation of EGOS, including various development Guidelines and tooling workflow.
  • Support: Project which allows you to create issues regarding EGOS or the associated tooling. Please use the provided default template when creating an issue so that our support team can improve the response time with an appropriate level of feedback. The more detail the issue is described, the faster we will be able to answer with a high-quality response. Please note that this Support project is intended only for EGOS support, not for GitLab related topics (except access rights). For specific GitLab issues, please refer to GitLab documentation and support: https://docs.gitlab.com/

GitLab-Doc-And-Support

Developers at eRTOSgener are working on a dedicated GitLab instance so that only official releases of EGOS are available on this public instance.

The goal of providing this GitLab instance to you with a dedicated group is not only for you to have access to the delivery but also to work with GitLab so that you are easily able to develop your driver and/or application using high-quality development environment. So feel free to use your own groups Repository, Issues, Merge Request and also CI/CD plugins to develop your application.

A public GitLab-Runner can be provided on request so that you can fully use the CI/CD plugin, although you can also create your own Runner at your side. This GitLab-Runner is installed on a CentOS-7 Virtual Machine, which does not host anything else but this Runner to avoid any risk during your pipeline execution.