Update git authored by Boman Romain's avatar Boman Romain
...@@ -25,7 +25,7 @@ Git must know your name and e-mail address. All your personnal work will be iden ...@@ -25,7 +25,7 @@ Git must know your name and e-mail address. All your personnal work will be iden
## Configure SSH keys ## Configure SSH keys
The GitLab of ULiège does not allow you to use your student ID / password for git commands. It uses a "SSH keys". The GitLab of ULiège does not allow you to use your student-ID / password for git commands. It uses a "SSH keys".
Go to the "Settings" of your account (upper right corner of the GitLab website) Go to the "Settings" of your account (upper right corner of the GitLab website)
...@@ -34,7 +34,7 @@ Go to the "Settings" of your account (upper right corner of the GitLab website) ...@@ -34,7 +34,7 @@ Go to the "Settings" of your account (upper right corner of the GitLab website)
Then choose "SSH keys" on the menu on the left. Then choose "SSH keys" on the menu on the left.
Follow the [procedure](https://gitlab.uliege.be/help/ssh/README#generating-a-new-ssh-key-pair) to create a SSH-key pair. Follow the [procedure](https://gitlab.uliege.be/help/ssh/README#generating-a-new-ssh-key-pair) to create a SSH-key pair.
Use the RSA type, which is more compatible with older machines (suc as NIC4) Use the RSA type, which is more compatible with older machines (such as NIC4)
``` ```
$ ssh-keygen -o -t rsa -b 4096 -C "demo" $ ssh-keygen -o -t rsa -b 4096 -C "demo"
Generating public/private rsa key pair. Generating public/private rsa key pair.
...@@ -48,7 +48,7 @@ SHA256:8ijxJLH1SETJZVkbRbBUXXdlmXE17C3mspK/KrSC/Jc demo ...@@ -48,7 +48,7 @@ SHA256:8ijxJLH1SETJZVkbRbBUXXdlmXE17C3mspK/KrSC/Jc demo
``` ```
You can use no passphrase if you do not share your private key (if it stays on your laptop). You can use no passphrase if you do not share your private key (if it stays on your laptop).
The previous command created 2 files located in `/c/Users/your_name/.ssh/`. A public key `id_rsa.pub` and a private key `id_rsa`. The private key is similar to a password. Anyone who owns this file is able to behave as you on GitLab. It should never be shared if it is not protected by a password! The previous command created 2 files located in `/c/Users/your_name/.ssh/`. A public key `id_rsa.pub` and a private key `id_rsa`. The private key is similar to a password. Anyone who owns this file is able to behave as you on GitLab! It should never be shared if it is not protected by a password!
Open the public key (file `/c/Users/your_name/.ssh/id_rsa.pub`) in an editor... Open the public key (file `/c/Users/your_name/.ssh/id_rsa.pub`) in an editor...
...@@ -60,7 +60,7 @@ Open the public key (file `/c/Users/your_name/.ssh/id_rsa.pub`) in an editor... ...@@ -60,7 +60,7 @@ Open the public key (file `/c/Users/your_name/.ssh/id_rsa.pub`) in an editor...
Then click on the "Add" button. Then click on the "Add" button.
You can test that you are able to connect to GitLab with the following command (check that you target `gitlab.uliege.be` instead of `gitlab.com` in the instructions!): You can test that you are able to connect to GitLab with the following command in a "git-bash terminal" (check that you target `gitlab.uliege.be` instead of `gitlab.com` in the instructions!):
``` ```
ssh -T git@gitlab.uliege.be ssh -T git@gitlab.uliege.be
``` ```
...@@ -75,9 +75,9 @@ answer `yes` (you will be asked only once). ...@@ -75,9 +75,9 @@ answer `yes` (you will be asked only once).
Warning: Permanently added 'gitlab.uliege.be,139.165.47.38' (ECDSA) to the list of known hosts. Warning: Permanently added 'gitlab.uliege.be,139.165.47.38' (ECDSA) to the list of known hosts.
``` ```
``` ```
Welcome to GitLab, @R.Boman! Welcome to GitLab, @Your_name!
``` ```
If you do not get the welcome message "Welcome to GitLab`, something went wrong in the previous steps. If you do not get the welcome message "Welcome to GitLab`, something went wrong in the previous steps. Read again the instructions.
# Clone the repository # Clone the repository
... ...
......