|
|
| (101 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 https://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.
| |
| − | | |
| − | If you omit these you will get the following warning later on:
| |
| − | | |
| − | * "Your name and email address were configured automatically based on your username and hostname. Please check that they are accurate. You can suppress this message by setting them explicitly."
| |
| − | | |
| − | <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.
| |
| − | | |
| − | <pre>
| |
| − | git add README.md
| |
| − | </pre>
| |
| − | | |
| − | 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.
| |
| − | | |
| − | <pre>
| |
| − | git commit -m "first commit"
| |
| − | </pre>
| |
| − | | |
| − | Third important command! [http://git-scm.com/docs/git-commit git commit] records all changes to the local repository. This should be run regularly when your code is in a working, stable state. '''Important''': for now your changes were only committing to the '''local''' repository. To commit them to the central repository you'll need the "push" command below.
| |
| − | | |
| − | '''Important''': It is always considered good practice to type in a comment when committing code to a repository, so that other developers can read about your update. When using the command line this is done using the -m argument, as demonstrated above.
| |
| − | | |
| − | <pre>
| |
| − | git remote add origin https://fsegitlab.wlv.ac.uk/in9352/great-work-by-alix.git
| |
| − | </pre>
| |
| − | | |
| − | This is an optional command that create a "remote", aka an alias (or shortcut) to your lengthy repository's full address. In this case we name it "origin". So from now on we can simply refer to "origin" when working with this repository (see below!)
| |
| − | | |
| − | '''Note''': your repository's address should contain "https://". If it doesn't then your forgot to press the "HTTPS" button earlier.
| |
| − | | |
| − | <pre>
| |
| − | git push -u origin master
| |
| − | </pre>
| |
| − | | |
| − | And here is the final important command! [http://git-scm.com/docs/git-push git push] commits all local changes to the central repository, i.e. "origin", definied in the previous step.
| |
| − | | |
| − | The second parameter is the "branch" you want to commit to. In this case we create a default branch called "master". We'll worry about branches later.
| |
| − | | |
| − | '''Important''': for now you will need to retype your login and password every time you want to push changes to the central repository. We'll get around this later using the SHH method instead of HTTPS.
| |
| − | | |
| − | === Has it worked? ===
| |
| − | | |
| − | If you go back to [https://fsegitlab.wlv.ac.uk/ GitLab] (in your browser) and refresh your project's homepage you should now see something similar to this:
| |
| − | | |
| − | https://mi-linux.wlv.ac.uk/wiki-images/gitlab04.png
| |
| − | | |
| − | As you can see we can see 1 commit to our new branch "master". If you click on the "Files" tab at the top you will see the files you pushed earlier. In my case I pushed a file called "index.html":
| |
| − | | |
| − | https://mi-linux.wlv.ac.uk/wiki-images/gitlab05.png
| |
| − | | |
| − | === Summary of important commands ===
| |
| − | | |
| − | Whether you use an old fashion command line Git Client or a fancy IDE, it is crucial to understand the process and the various steps required when working with git:
| |
| | | | |
| − | * git init: Creates an empty Git repository | + | * [https://git-srv.wlv.ac.uk/gitlab https://git-srv.wlv.ac.uk/gitlab] |
| − | * git add: Adds a file to the repository's index
| |
| − | * git commit: Commits changes to '''local repository'''
| |
| − | * git push: Commits changes to '''remote repository'''
| |
| | | | |
| − | === Making changes via GitLab interface ===
| + | Please read through the following tutorials: |
| | + | # [[Getting started with GitLab]] |
| | + | # [[Cloning and pulling from GitLab]] |
| | + | # [[Solving conflicts on GitLab]] |
| | + | # [[Working environments]] |
| | + | # [[Working with GitLab Issues, Milestones and Labels]] |
| | | | |
| − | === Pulling changes ===
| + | '''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. |
| | | | |
| − | === Cloning a repository === | + | == Further reading == |
| | | | |
| − | === Using Git from Eclipse ===
| + | This tutorial only acts as an introduction, please refer to the following resources for more information and further reading: |
| | + | * [http://git-scm.com/doc Git documentation] |
| | + | * [http://doc.gitlab.com/ce/ GitLab documentation] |
