diff --git a/README.md b/README.md index c153e56a6573d220c40cb800db2b1a3cd38bddef..3f68f1839ab2ec50a9c10f7c5a48e1191087a7bc 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # GitLab guide -This guide aims at explaining what Git and GitLab are and how they can be used. It is targeted towards new members but is an helpfull reference for everyone. +This guide aims at explaining what Git and GitLab are and how they can be used. It is targeted towards new members but is an helpfull reference for everyone. However this is not a guide on how to use Git. ## What are Git and GitLab @@ -28,3 +28,24 @@ The users can have different levels of permission over groups and repositories: ## New users If you have never logged in into Skyward's GitLab, you just need to use your @skywarder.eu Google account in [the login page](https://git.skywarder.eu/users/sign_in). After your first login you will have by default read access to all repositories, you can find the list [here](https://git.skywarder.eu/explore). If you need write access to some repositories and you do not have a Developer role yet, just ask your IPTL to have your priviledges raised. + +## How to use GitLab + +This section describes the tools you can use to clone and push commits to GitLab's repositories. + +### GitHub Desktop + +The easiest tool you can use is GitHub Desktop, which you can download [here](https://desktop.github.com). Although it has "Github" in its name, this software works just fine with GitLab too. + +To clone a repository you need to select "Clone a Repository from the Internet..." and enter the https url of your repository. + +GitHub Desktop | GitLab +:------------------------------------------------------:|:---------------------------------: + |  + +The first time you clone a repository it will ask for a username and a password. As username put your name and for the password you will need to generate a new access token (this will work as a password). To do this you need to go in [the access tokens menu](https://git.skywarder.eu/-/profile/personal_access_tokens) of your profile setting, give it a name, selects `api` and click "Create personal access token". At this point the page will show you your new token. Be sure to copy it into GitHub Desktop before closing the page because you will not be able to see it again (you can alwais delete and create tokens). + +GitHub Desktop | GitLab +:---------------------------------------------------:|:-------------------------------------------: +. |  + |  diff --git a/images/GitHub Desktop authentication failed.png b/images/GitHub Desktop authentication failed.png new file mode 100644 index 0000000000000000000000000000000000000000..2a99d9c5a8536c011dcdd1df6d1caa4ed1f85def Binary files /dev/null and b/images/GitHub Desktop authentication failed.png differ diff --git a/images/GitHub Desktop clone a repository.png b/images/GitHub Desktop clone a repository.png new file mode 100644 index 0000000000000000000000000000000000000000..f3073f3ed78cfc804ea7af718eeebe6aabd10d74 Binary files /dev/null and b/images/GitHub Desktop clone a repository.png differ diff --git a/images/GitHub Desktop clone from the internet.png b/images/GitHub Desktop clone from the internet.png new file mode 100644 index 0000000000000000000000000000000000000000..e207bba2db419ba30cbc91740a1b76b2d55ce78b Binary files /dev/null and b/images/GitHub Desktop clone from the internet.png differ diff --git a/images/GitLab create access token 2.png b/images/GitLab create access token 2.png new file mode 100644 index 0000000000000000000000000000000000000000..5806c9fc908e7d8877b346e3bf88f7013c9271d3 Binary files /dev/null and b/images/GitLab create access token 2.png differ diff --git a/images/GitLab create access token.png b/images/GitLab create access token.png new file mode 100644 index 0000000000000000000000000000000000000000..43a7fb1736eb80e8e3da78f93b85a8b4a420bbe0 Binary files /dev/null and b/images/GitLab create access token.png differ diff --git a/images/GitLab https url.png b/images/GitLab https url.png new file mode 100644 index 0000000000000000000000000000000000000000..a4bbac63896c9978b50409c2ee05aebfb69a1b0e Binary files /dev/null and b/images/GitLab https url.png differ