|
|
| (114 intermediate revisions by one other user not shown) |
| Line 1: |
Line 1: |
| | + | [[Main Page]] >> GitLab server |
| | + | |
| | == GitLab server == | | == GitLab server == |
| | | | |
| − | The University provides every student with a fully working Version Control system called GitLab: | + | The University provides every student with a Git Version Control system called GitLab: |
| − | | |
| − | * [https://fsegitlab.wlv.ac.uk/ https://fsegitlab.wlv.ac.uk/]
| |
| − | | |
| − | Please note that you should only use this server to store files related to University coursework. Personal or word related files should not be stored on this server.
| |
| − | | |
| − | == Signing in==
| |
| − | | |
| − | You can sign in using your usual university credentials. Make sure that you select the "LDAP" tab on the "Sign in" screen:
| |
| − | | |
| − | https://mi-linux.wlv.ac.uk/wiki-images/gitlab01.png
| |
| − | | |
| − | == Creating a project ==
| |
| − | | |
| − | Your next step is to create a "Project" that will contain your work. Click on the "+ New Project" button.
| |
| − | | |
| − | https://mi-linux.wlv.ac.uk/wiki-images/gitlab02.png
| |
| − | | |
| − | And populate the following fields:
| |
| − | * Project Name
| |
| − | * Description
| |
| − | * Visibility Level
| |
| − | | |
| − | '''Important''': The Visibility Level should be set to "Private" for all assessment-related work. Any other Visibility Level would allow other students to look at and clone your work, which equates to Collusion under the University's Academic Misconduct regulations.
| |
| − | | |
| − | Set the Project's Visibility level to "Private" and then manually invite new project members, via the Project's settings:
| |
| − | | |
| − | https://mi-linux.wlv.ac.uk/wiki-images/gitlab03.png
| |
| − | | |
| − | == Creating your first repository ==
| |
| − | | |
| − | When visiting your project's homepage you are presented with some command line Git code that you should use to create your first repository. Please note that you get 2 access options:
| |
| − | | |
| − | * SSH
| |
| − | * HTTPS
| |
| − | | |
| − | We'll look that HTTPS for now, so click the "HTTPS" button near the top.
| |
| − | | |
| − | === Git commands ===
| |
| − | | |
| − | Your project's homepage should contain commands similars to these ones:
| |
| − | | |
| − | ''Git global setup''
| |
| − | <pre>
| |
| − | git config --global user.name "in9352"
| |
| − | git config --global user.email "alix.bergeret@wlv.ac.uk"
| |
| − | </pre>
| |
| − | | |
| − | ''Create a new repository''
| |
| − | <pre>mkdir great-work-by-alix
| |
| − | cd great-work-by-alix
| |
| − | git init
| |
| − | touch README.md
| |
| − | git add README.md
| |
| − | git commit -m "first commit"
| |
| − | git remote add origin git@fsegitlab.wlv.ac.uk:in9352/great-work-by-alix.git
| |
| − | git push -u origin master
| |
| − | </pre>
| |
| − | | |
| − | ''Push an existing Git repository''
| |
| − | <pre>
| |
| − | cd existing_git_repo
| |
| − | git remote add origin git@fsegitlab.wlv.ac.uk:in9352/great-work-by-alix.git
| |
| − | git push -u origin master
| |
| − | </pre>
| |
| − | | |
| − | In order to run the code above you have 3 options:
| |
| − | * [Windows] Run Git Bash, a Git client installed in all MI labs
| |
| − | * [Windows] SSH into mi-linux.wlv.ac.uk using an SSH client such as Putty
| |
| − | * [Linux] Boot under Linux, and open a Command window.
| |
| − | | |
| − | === Git commands - details ===
| |
| − | | |
| − | Let's look at each command in more details:
| |
| − | | |
| − | <pre>
| |
| − | git config --global user.name "in9352"
| |
| − | git config --global user.email "alix.bergeret@wlv.ac.uk"
| |
| − | </pre>
| |
| − | | |
| − | The commands above simply set some global settings (your user name and email address) that are required for this process.
| |
| − | | |
| − | <pre>
| |
| − | mkdir great-work-by-alix
| |
| − | cd great-work-by-alix
| |
| − | </pre>
| |
| − | | |
| − | Well, nothing too difficult here, we simply create an empty folder and move into it. Note that you may wish to move into an existing folder that already contains files instead!
| |
| − | | |
| − | <pre>
| |
| − | git init
| |
| − | </pre>
| |
| − | | |
| − | Here is the first important command. [http://git-scm.com/docs/git-init git init] creates an empty Git repository. If the command is successful you should get a message stating "Initialized empty Git repository in ...". This has created a hidden ".git" folder that you can see by running the command "ls -la".
| |
| − | | |
| − | <pre>
| |
| − | touch README.md
| |
| − | </pre>
| |
| | | | |
| − | This command simply creates an empty test file called "README.md". If you already have files in your folder (e.g. PHP files), then you don't need to do this.
| + | * [https://git-srv.wlv.ac.uk/gitlab https://git-srv.wlv.ac.uk/gitlab] |
| | | | |
| − | <pre>
| + | Please read through the following tutorials: |
| − | git add README.md
| + | # [[Getting started with GitLab]] |
| − | </pre>
| + | # [[Cloning and pulling from GitLab]] |
| | + | # [[Solving conflicts on GitLab]] |
| | + | # [[Working environments]] |
| | + | # [[Working with GitLab Issues, Milestones and Labels]] |
| | | | |
| − | Second important command. [http://git-scm.com/docs/git-add git add] adds a file to the repository's index. We can run this command to add our dummy "README.md" file, or any existing files you may have.
| + | '''Important''': Please note that you should only use this server to store files related to University coursework. Personal or work-related files should not be stored on this server. |
| | | | |
| − | === Summary of important commands === | + | == Further reading == |
| | | | |
| − | * git init: Creates an empty Git repository | + | This tutorial only acts as an introduction, please refer to the following resources for more information and further reading: |
| − | * git add: Adds a file to the repository's index | + | * [http://git-scm.com/doc Git documentation] |
| | + | * [http://doc.gitlab.com/ce/ GitLab documentation] |
