Module CSC5002—ASR6: Middleware and software architecture for distributed applications

Guide for using the TSP GitLab server and creating the project

Installations and configurations for using GitLab and the provided skeleton, even outside of the lab rooms.
Creation of your project and configurations.

Creation of your project

You have to create one (private) project for one pair of students, so only one student creates the project and then add the second member. Make your project accessible to your CSC5002 module teachers, so that they can follow your project's progress throughout the module.

this step is carried out by only one member of the pair. This person adds the second member to the project after creation.

Here's the URL of the GitLab platform of Télécom SudParis, note the https : gitlabense.imtbs-tsp.eu.

You connect to the platform using Shibboleth authentication, indicated by the Shibboleth button at the bottom of the page.

Once connected, select the csc-mw-project project, then create your own by copying it with the Fork button (between the Star button and the the URL). Once the project has been created, configure it by following the Settings link.

Your project should be « private » by following the links Settings then General, and then Permissions. Put the attribute Project Visibility to Private. Failure to comply with this will expose you to the measures set out in paragraph concerning « Fraud » in the school rules.

In the Settings/Members page of project, add the other student of the pair as Maintainer and the module teachers as Developer.

To find the other student in the list of GitLabense users, they must have logged in at least once' (via Shibboleth).

To get notification messages after a push operation (feature email-on-push), select Settings then Integrations. Browse the list of services and select Emails on push. In the open page, tick the boxes Active, Push, Tag push and Send from committer, then add the email addresses of all the members (students and teachers) of the project in the Recipients form. Do not forget to click on Save changes the the end.

At last, in the top left-hand corner of the page, select your GitLab account configuration, then Preferences and open the User Settings page. Select the Notifications page and verify that the Receive notifications about your own activity option is activated.

By default, continuous integration is set up. During project, adapt the contents of the .gitlab-ci.yml file at the root of your project.

Confidence SSH path

To add an SSH key, in the top left-hand corner of the page, select your GitLab account configuration, then Preferences, User Settings and select SSH keys. Copy/paste your public key (~/.ssh/id_rsa.pub file of the pair [private key/public key publique]) in the Key form.

To test the use of the key, return to the project page, and on the machine in the lab room, copy/paste the URL starting with the « git@gitlabense.imtbs-tsp.eu: » URL in the command: « git clone URL&nbsp». You should now have a copy of the repository of your project.

Here is the message from DISI for access to the forge from outside of campus:
« Nous avons ouvert la plateforme GitLab depuis l’extérieur du campus à un nombre limité de Fournisseurs d'Accès Internet (FAI), principalement Orange, SFR, Bouygues, Free, mais il est possible que nous n'ayons pas énuméré toutes les adresses sources dont ils disposent. Si vous avez un refus d'accès, merci de retourner à la DISI via le helpdesk l’adresse Internet (adresse IP) de votre point d’accès (box, mobile, lieu d’hébergement...), adresse disponible depuis votre appareil en allant sur le site https://ip.lafibre.info/, afin que la DISI adapte les filtres IP d’accès à GitLab. Retournez l'information (adresse IPv4) obtenue sur cette page en envoyant un courriel : "Subject: contrôle d'accès IP à gitlab, To: helpdesk@imtbs-tsp.eu, Body: contenu de https://ip.lafibre.info/" »
« We have opened up the GitLab platform to a limited number of Internet Service Providers (ISPs), mainly Orange, SFR, Bouygues, Free, but we may have not listed all the source addresses available to them. If you are denied access, please contact the DISI via the helpdesk and provide the Internet address (IP address) of your access point (box, mobile, accommodation...). This address is available from your device on the https://ip.lafibre.info/ page, so that the DISI can adapt the IP filters for access to GitLab. Return the information (IPv4 address) obtained on this page by sending an e-mail: "Subject: Gitlab IP access control, To: helpdesk@imtbs-tsp.eu, Body: content of https://ip.lafibre.info/ page" »