Changes

Jump to navigation Jump to search

Gitlab Social Sciences (view source)

Revision as of 18:29, 24 November 2016

84 bytes added ,  18:29, 24 November 2016
no edit summary
Line 28: Line 28:  
     | downloads          = {{bulleted list
 
     | downloads          = {{bulleted list
 
         | [https://git-scm.com/downloads Git Download]
 
         | [https://git-scm.com/downloads Git Download]
−
         | [https://git-scm.com/download/gui/linux Git Desktop Clients]
+
         | [https://git-scm.com/downloads/guis Git Desktop Clients]
 
     }}
 
     }}
 
     | manuals            = {{bulleted list
 
     | manuals            = {{bulleted list
−
         | [[:File:Xkcd_git.png | Quick start guide]]
+
         | [https://git-scm.com/documentation Git] Git Documentation.
−
         | [http://doc.gitlab.com/ce/ Gitlab documentation]
+
         | [http://doc.gitlab.com/ce/ Gitlab Documentation]
 +
        | [https://www.youtube.com/watch?v=7p0hrpNaJ14 Video Tutorial]
 
     }}
 
     }}
 
   }}
 
   }}
 
}}
 
}}
 +
 +
The Social Sciences GitLab server offers [[wikipedia:Git|Git]] repository management, code reviews, issue tracking, activity feeds and wikis.
    
<!-- Table of Contents will be generated here -->
 
<!-- Table of Contents will be generated here -->
    
==Features==
 
==Features==
−
  −
GitLab offers git repository management, code reviews, issue tracking, activity feeds and wikis.
  −
   
With Gitlab you can:
 
With Gitlab you can:
 
* Create code together
 
* Create code together
Line 49: Line 49:  
* Document code together
 
* Document code together
   −
The Gitlab server is available for all users, from anywhere in the world, provided they have a RU or external account. See below for more information on login and requesting external accounts.
+
===Requirements===  
−
 
+
* [https://git-scm.com/downloads Git].
−
==Requirements==  
+
* A Radboud University account (U-, S-, E- or F-number).
−
* For more information about usage requirements for various operation systems you can click [http://doc.gitlab.com/ce/gitlab-basics/start-using-git.html here]
  −
 
  −
==User Login==
  −
 
  −
You can logon on the environment with your University number or student number and password.
  −
 
  −
'''https://gitlab.socsci.ru.nl'''
  −
 
  −
===External Users===
  −
 
  −
You can send a request with the following information to [mailto:j.keyser@donders.ru.nl Johannes Keyser (DCC)] or [mailto:e.lieffers@ru.nl Eric Lieffers (ISC)]
      +
==External Users==
 +
If you want to allow people without Radboud University account to access and contribute to your Gitlab project, you can request a standard user account by sending an email to
 +
[mailto:j.keyser@donders.ru.nl Johannes Keyser (DCC)] or [mailto:e.lieffers@ru.nl Eric Lieffers (ISC)]. <br/>Be sure to include the following information:
 
{| class="wikitable"
 
{| class="wikitable"
 
| Username
 
| Username
Line 75: Line 67:  
==Configuration==
 
==Configuration==
   −
===Command Line Instructions===
+
The following instructions are for the command line interface. If you are using a graphical user interface (e.g. a desktop client), please consult its documentation for further instructions.
   −
Git Global Setup
+
===Global Setup===
    
<pre style="background-color:#000; color:#fff;">
 
<pre style="background-color:#000; color:#fff;">
−
$ git config --global user.name "username"
+
$ git config --global user.name "your-username-here"
−
$ git config --global user.email "email address"
+
$ git config --global user.email "your-email-address-here"
 
</pre>
 
</pre>
    +
Your username will be visible when pushing a commit to the Gitlab server.
 +
Your email address should be the same as your primary Radboud email address, or if you are an external user, the one provided in your user request.
 +
 +
==Usage==
   −
Create a new repository
+
The following instructions are for the command line interface. If you are using a graphical user interface (e.g. a desktop client), please consult its documentation for further instructions. When creating a new project in the [https://gitlab.socsci.ru.nl web interface], you will also be given these instructions.
    +
===Creating a new repository===
 
<pre style="background-color:#000; color:#fff;">
 
<pre style="background-color:#000; color:#fff;">
 
$ mkdir newproject
 
$ mkdir newproject
Line 93: Line 90:  
$ touch README.md
 
$ touch README.md
 
$ git add README.md
 
$ git add README.md
−
$ git commit -m "first commit"
+
$ git commit -m "initial commit"
 
$ git remote add origin git@gitlab.socsci.ru.nl:username/newproject.git
 
$ git remote add origin git@gitlab.socsci.ru.nl:username/newproject.git
 
$ git push -u origin master
 
$ git push -u origin master
 
</pre>
 
</pre>
 +
Substitute 'newproject' with your project name and 'username' with your username.
   −
Push an existing Git repository
+
===Push an existing Git repository===
    
<pre style="background-color:#000; color:#fff;">
 
<pre style="background-color:#000; color:#fff;">
−
$ cd existing_git_repo
+
$ cd existing-git-repo
 
$ git remote add origin git@gitlab.socsci.ru.nl:username/newproject.git
 
$ git remote add origin git@gitlab.socsci.ru.nl:username/newproject.git
 
$ git push -u origin master
 
$ git push -u origin master
 
</pre>
 
</pre>
 +
Substitute 'newproject' with your project name.
   −
*You can also create a new project within the webinterface in Gitlab.
+
=== Troubleshoot ===
−
*Within the project on the webinterface you will also find the command line instructions.
  −
 
  −
=== Accepting new SSH key (only for some users with existing repository) ===
      
Some users will see the  following message when they want to make a remote connection with SSH. (existing repository)
 
Some users will see the  following message when they want to make a remote connection with SSH. (existing repository)
Line 115: Line 111:     
<pre style="background-color:#000; color:#fff;">
 
<pre style="background-color:#000; color:#fff;">
−
$ Warning: the ECDSA host key for 'smlgitlab.socsci.ru.nl' differs from the key for the IP address 'x.x.x.x'
+
$ Warning: the ECDSA host key for 'gitlab.socsci.ru.nl' differs from the key for the IP address 'x.x.x.x'
 
$ Offending key for IP in /home/user/.ssh/known_hosts:23 Matching host key in /home/user/.ssh/known_hosts:13  
 
$ Offending key for IP in /home/user/.ssh/known_hosts:23 Matching host key in /home/user/.ssh/known_hosts:13  
 
$ Are you sure you want to continue connecting (yes/no)? yes
 
$ Are you sure you want to continue connecting (yes/no)? yes
 
</pre>
 
</pre>
   −
Remote SSH connection should be established.
+
Remote SSH connection should now be established.
−
 
  −
=== Git Clients ===
  −
 
  −
You can find the git clients for various operating systems [https://git-scm.com/downloads here]
  −
 
  −
===Documentation===
  −
 
  −
====Git Documentation====
  −
For Git documentation click [https://git-scm.com/documentation here]
  −
 
  −
====GitLab Documentation====
  −
For step-by-step tutorial click [http://doc.gitlab.com/ce/gitlab-basics/README.html here]
  −
 
  −
====Video Tutorial====
  −
 
  −
Or you can watch the following tutorial on the following youtube video.
     −
{{#ev:youtube|https://www.youtube.com/watch?v=7p0hrpNaJ14}}
+
For other technical issues you can contact [mailto:e.lieffers@ru.nl Eric Lieffers (Server Administrator)]
   −
== Contact ==
+
== Git Clients ==
   −
For techincal issues you can contact [mailto:e.lieffers@ru.nl Eric Lieffers (Server Administrator)]
+
You can find the git clients for various operating systems [https://git-scm.com/downloads here].
 +
Additionally, you may be able to find a Git plugin for your code editor of choice.
    
<!-- ==References==
 
<!-- ==References==
Line 149: Line 130:  
==External Links== <!-- Optional -->
 
==External Links== <!-- Optional -->
 
*{{Official website|http://www.gitlab.com}}
 
*{{Official website|http://www.gitlab.com}}
−
*[https://git-scm.com/documentation Git] &nbsp;– Techincal documentation.
  −
*[http://doc.gitlab.com/ce/ Gitlab]&nbsp;– Technical documentation.
 
Retrieved from "http://tsgdoc.socsci.ru.nl/index.php/Special:MobileDiff/3998"

Navigation menu