Skip to content
Snippets Groups Projects
Commit 967acb1f authored by Adrien KRÄHENBÜHL's avatar Adrien KRÄHENBÜHL
Browse files

Ajout des informations pour démarrer

parent af4c17b2
No related merge requests found
SSH et Giltab
=============
Cette procédure permet d'utiliser l'authentification par clé SSH plutôt que de taper ses login et mot de passe à chaque requête vers Gitlab (push, pull, etc.). Elle comporte deux étapes détaillées ci-dessous :
1. Créer une clé SSH pour votre compte utilisateur
2. Copier la clé publique dans Gitlab
Si vous utilisez Gitlab à partir de plusieurs comptes (ordi de l'IUT, ordi perso, etc.), la procédure suivante est à répéter pour chaque compte.
1 - Créer une clé SSH
---------------------
1. Dans un terminal, tapez la commande suivante :
```
login@ordi:~$ ssh-keygen -b 4096 -C [nom de la clé]
```
Pour chaque question, laissez vide et validez :
```
Generating public/private rsa key pair.
Enter file in which to save the key (/.../login/.ssh/id_rsa):
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in /.../login/.ssh/id_rsa.
Your public key has been saved in /.../login/.ssh/id_rsa.pub.
The key fingerprint is:
SHA256:f3FTQpO9zwSY4DS2rIc1qT687x9C8CsuTD8MB61ogyU [nom de la clé]
The key's randomart image is:
+---[RSA 4096]----+
| =. ooo |
| B = +o.o..|
| .. B ..o|
| E . . .B . +.|
| + . oS + . oo.|
| . + +o.+ . o .o|
| . + == + o |
| o.++ o . |
| .o+o.. |
+----[SHA256]-----+
```
2. Deux fichiers (au moins) sont alors créés dans votre répertoire `/.../login/.ssh/` :
```
login@ordi:~$ ls ~/.ssh
... id_rsa id_rsa.pub ...
```
- `id_rsa` contient votre clé privé : ne jamais la communiquer !
- `id_rsa.pub` contient votre clé publique : vous pouvez la communiquer au monde entier.
2 - Copier la clé publique dans Gitlab
--------------------------------------
*Un GIF illustrant les 8 points suivants est disponible dans `images/sshGitlab.gif`.*
1. Connectez-vous sur Gitlab avec vos identifiants Unistra : https://git.unistra.fr
2. Cliquez sur l'icône en haut à droite de l'écran
3. Cliquez sur le menu "Settings" ("Paramètres")
4. Dans le menu à gauche de l'écran, cliquez sur le menu "SSH Keys" ("Clés SSH")
5. Dans un terminal, affichez votre clé avec la commande suivante :
```
login@ordi:~$ cat ~/.ssh/id_rsa.pub
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAACAQC3GZATo37T8jZVwV14k3luTLmXZUaKeUVFxqBBOow+0i1FcHmDEakdmTC6gz5iZt/o7oht8bdFFDxkroM7IkpiJ7Yb4WGBfhnw232L7U8oWb/4Wu17JZ/qeMXmUwZuSk7utX0ucW9SKOuTPID1qtJXOTrqSiiueK4BmPtAQEVI0DB5lo1q4/RNQwLAuGU06i2B9k+Fk6NWjcbWoDyNltbyvmosCpmmjNXYxiCP6GYYnEeUUBkZGoMRhwcZCG0tSm26X9oUqkauD8daY9Y+0W6xysrkEe2HVb+Aqv2ljV+L1Vnftor1VuhAwQD+LPAmUGoh2VcWMT37lOWxYOYLbf93rTwcPZKGsGQwljwVdl4cfK6+UzNU2h4/u1+YvNtEBj2eVw55AQPz34IMXmiBTa4MuKSBp9Di0ZWfiAjNEzHvzxC7l9+Uqfo/YlEWnGocfrci0dPXGJGaRNEF85BIIm+YkmMP2LRbKgCLYt3x8a/7ba56barUWs9N5rjFZ1BikPfCBCuTXR8rX/8RKBQQj0g/yqoTg6TggQ6jou5U5oQ54NpSCQZntIJ6b8ub+V9Cni1NWmURoBqEDnoxXomGJokJLhwMNqHi0Quc5OMSbZW9CNaNbv5uPrZxNfcfnD5pA0LhId3S2VlS/YxCc8iYyPj6vDwBZw43ipwk2tU8pOOHAQ== [nom de la clé]
```
6. Copiez-collez votre clé `ssh-rsa AAAA...AQ== [nom de la clé]` dans le champ "Key" ("Clé") sur Giltab
7. Cliquez sur le bouton "Add key" ("Ajouter la clé")
8. C'est terminé : vous recevez dans la foulée un mail vous indiquant qu'une clé ssh a été ajoutée.
HOWTO.md 0 → 100644
"*M'sieur, comment...*
======================
#### *... j'affiche l'état de mon clône ?"*
```sh
git status
```
#### *... j'ajoute des fichiers à prendre en compte au prochain commit ?"*
```sh
git add [file]
```
#### *... je commite (sauvegarde localement) mes modifications ?"*
```sh
git commit -m "[message qui DÉTAILLE les modifications]"
```
ATTENTION : Seuls les fichiers préalablement ajoutés seront sauvegardés.
#### *... je pousse mes commits sur Gitlab (sauvegarde distante) ?"*
```sh
git push origin master
```
#### *... je récupère localement les fichiers que vous avez ajouté ?"*
```sh
git pull prof master
```
#### *... je récupère sur ordinateur2 ce que j'ai fait sur ordinateur1 ?"*
1. Je **commite** sur ordinateur1 et **pousse** vers Gitlab (voir ci-dessus)
2. Je **tire** sur ordinateur2 ce qui est maintenant sur Gitlab
```sh
git pull origin master
```
W31 - Programmation web côté serveur
====================================
#### IMPORTANT : Il sera impératif de savoir utiliser ce dépôt pour le TP noté.
Pour démarrer, vous devez :
1. Mettre en place une clé SSH en suivant le tuto [GITLABSSH.md](GITLABSSH.md)
2. Mettre en place votre environnement de travail en suivez les instructions ci-dessous.
Ensuite, pour **utiliser** de votre dépôt, regardez la page [HOWTO.md](HOWTO.md).
#### Les diapos des cours :
- [CM n°1 : Introduction à PHP](http://adrien.krahenbuhl.fr/courses/IUTRS/W31/CM1)
- [CM n°2 : POO et PDO](http://adrien.krahenbuhl.fr/courses/IUTRS/W31/CM2)
- [CM n°3 : Laravel](http://adrien.krahenbuhl.fr/courses/IUTRS/W31/CM3)
1 - Créer un **clône distant** sur Gitlab
-----------------------------------------
Il suffit de cliquer sur le bouton "Fork" en haut de la page, à côté du bouton bleu "Clone".
**À FAIRE** : Ajouter votre enseignant de TP en tant que "Reporter" de votre dépôt (menu "Members").
2 - Créer un **clône local** sur votre ordinateur
-------------------------------------------------
1. Installer git sur votre ordinateur personnel (rien à faire sur les postes de l'IUT) :
```sh
$ sudo apt install git
```
2. Configurer vos informations d'utilisateur :
```sh
$ git config --global user.name "[Prenom] [Nom]"
$ git config --global user.email "[login]@unistra.fr"
```
3. Cloner votre fork :
```sh
$ git clone git@git.unistra.fr:[username]/W31.git
```
3 - Ajouter le **remote "prof"**
--------------------------------
En trois commandes :
```sh
$ cd W31
$ git remote add prof git@git.unistra.fr:W31/W31.git
$ git fetch prof
```
Si tout s'est bien passé, la commande :
```sh
$ git remote
```
affiche :
```sh
origin
prof
```
images/sshGiltab.gif

615 KiB

0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment