SSH keys
An SSH key allows you to establish a secure connection between your computer and GitLab. Before generating an SSH key in your shell, check if your system already has one by running the following command:
Windows Command Line:
type %userprofile%\.ssh\id_rsa.pub
GNU/Linux/Mac/PowerShell:
cat ~/.ssh/id_rsa.pub
If you see a long string starting with
ssh-rsa, you can skip the ssh-keygen step.
To generate a new SSH key, use the following command:
ssh-keygen -t rsa -C "admin@example.com"
This command will prompt you for a location and filename to store the key pair and for a password. When prompted for the location and filename, just press enter to use the default. If you use a different name, the key will not be used automatically.
Note: It is a best practice to use a password for an SSH key, but it is not required and you can skip creating a password by pressing enter.
If you want to change the password of your key later, you can use the following command:
ssh-keygen -p <keyname>Use the command below to show your public key:
Windows Command Line:
type %userprofile%\.ssh\id_rsa.pub
GNU/Linux/Mac/PowerShell:
cat ~/.ssh/id_rsa.pub
Copy-paste the key to the ‘My SSH Keys’ section under the ‘SSH’ tab in your user profile. Please copy the complete key starting with ssh-rsa and ending with your username and host.
To copy your public key to the clipboard, use the code below. Depending on your OS you’ll need to use a different command:
Windows Command Line:
type %userprofile%\.ssh\id_rsa.pub | clip
Windows PowerShell:
cat ~/.ssh/id_rsa.pub | clip
Mac:
pbcopy < ~/.ssh/id_rsa.pub
GNU/Linux (requires xclip):
xclip -sel clip < ~/.ssh/id_rsa.pub
Le Workflow d’un projet
Avant de commencer le développement d’un projet, il est fortement conseillé de définir son workflow (ainsi
que des règles d’utilisation). Les étapes usuelles pour un développeur dans le cadre des projets du cycle
ISMIN sont les suivantes :
1. Avant le démarrage d’un projet :
1. Installer et initialiser Git, et installer les outils nécessaires au projet
2. Obtenir de l’enseignant le dépôt distant du compte projet
3. Récupérer ce dépôt localement (dépôt local)
2. Pendant la réalisation du projet :
1. Récupérer les changements de l’équipe de manière distante
2. Modifier le projet et appliquer les changements localement
3. Vérifier (et tester) les changements locaux
4. Partager les changements avec l’équipe de manière distante
3. À la fin du projet :
1. Consolider la restitution du projet par un étiquetage (tag)
2. À la date fixée, l’enseignant verrouille les dépôts distants de son compte projet
Voici des exemple de règles que vous avez à définir : nature du dépôt distant, périodicité des opérations, etc.
Vous constaterez qu’avec des règles précises, il est possible d’utiliser Git de manière centralisée (cela fait
partie également des avantages des systèmes décentralisés). Dans ce cas, le dépôt commun est appelé « dépôt
partagé ». C’est ce principe de fonctionnement qui est décrit dans ces pages.