Difference between revisions of "Gitlab Social Sciences"
(Clarified external users) |
(Got rid of setup, configuration, and usage of Git - instead just point to documentation.) |
||
| Line 41: | Line 41: | ||
<!-- Table of Contents will be generated here --> | <!-- Table of Contents will be generated here --> | ||
| − | ==Features== | + | == Features == |
With GitLab you can easily manage your projects, synchronize your code between computers, or create wiki-pages for documentation. | With GitLab you can easily manage your projects, synchronize your code between computers, or create wiki-pages for documentation. | ||
Whether you write code or a paper, you can review, deploy, or document your project together with others. | Whether you write code or a paper, you can review, deploy, or document your project together with others. | ||
| Line 54: | Line 54: | ||
Anyone who has a "science login" can also use this service; it's running the same software (just the login page looks different). | Anyone who has a "science login" can also use this service; it's running the same software (just the login page looks different). | ||
| − | ==Requirements== | + | == Requirements == |
1. A GitLab account to log in at https://gitlab.socsci.ru.nl: | 1. A GitLab account to log in at https://gitlab.socsci.ru.nl: | ||
* Everyone from Radboud University can login (with their U-, S-, E- or F-number). | * Everyone from Radboud University can login (with their U-, S-, E- or F-number). | ||
| Line 60: | Line 60: | ||
2. For more than the most basic tasks, you'll also need to install [https://git-scm.com/downloads Git] on your computer. | 2. For more than the most basic tasks, you'll also need to install [https://git-scm.com/downloads Git] on your computer. | ||
| − | ==External Users== | + | == 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 | 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:gitlab@socsci.ru.nl gitlab@socsci.ru.nl]. | [mailto:gitlab@socsci.ru.nl gitlab@socsci.ru.nl]. | ||
| Line 69: | Line 69: | ||
Once logged in, there are no further differences. | Once logged in, there are no further differences. | ||
| − | ==Configuration== | + | == Setup, Configuration and Usage of Git == |
| − | + | For more advanced tasks, you will need a Git installed on your computer and set it up. | |
| − | + | There is excellent documentation for this available throughout the Internet, for example https://git-scm.com/documentation or https://docs.gitlab.com/ce/gitlab-basics/README.html. | |
| − | + | It would make little sense to repeat these here. | |
| − | + | There are many graphical user interfaces available for every major operating system. | |
| − | + | In addition, many development software packages (including Matlab) are aware of Git repositories and you can set them up to work with GitLab. | |
| − | + | Note that for most daily tasks, only about 5 Git operations are necessary to know about. | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
=== Troubleshoot === | === Troubleshoot === | ||
| − | |||
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) | ||
When you see the below message you will need to say yes. | When you see the below message you will need to say yes. | ||
| Line 123: | Line 89: | ||
Remote SSH connection should now be established. | Remote SSH connection should now be established. | ||
| − | For other technical issues you can contact [mailto: | + | For other technical issues you can contact [mailto:gitlab@socsci.ru.nl gitlab@socsci.ru.nl]. |
== Git Clients == | == Git Clients == | ||
Revision as of 13:45, 1 June 2017
 | |||||||||
| Development status | Active | ||||||||
|---|---|---|---|---|---|---|---|---|---|
| Operating system | any | ||||||||
| Platform | Microsoft Windows, MacOSX, Linux | ||||||||
| License | MIT License | ||||||||
| Website | gitlab.socsci.ru.nl | ||||||||
| |||||||||
The Social Sciences GitLab server offers Git repository management, code reviews, issue tracking, activity feeds and wikis.
Features
With GitLab you can easily manage your projects, synchronize your code between computers, or create wiki-pages for documentation. Whether you write code or a paper, you can review, deploy, or document your project together with others. You can create at least 50 projects, and you can make them private, or share them with your lab members, or even the entire Internet.
Think of GitLab as a "Facebook" around your projects. Similar services include e.g. GitHub.com or GitLab.com (which also runs the GitLab software on their servers). In contrast to these services, GitLab Social Sciences is self-hosted on a server on the Radboud campus. That means we determine our own terms of use; for example, here you can private projects for free - on GitHub, you would have to pay.
Note that there's another self-hosted GitLab service running at the Faculty of Science. Anyone who has a "science login" can also use this service; it's running the same software (just the login page looks different).
Requirements
1. A GitLab account to log in at https://gitlab.socsci.ru.nl:
- Everyone from Radboud University can login (with their U-, S-, E- or F-number).
- External users can ask for an account and then login with their username (switch to the "Standard" tab in the Sign-In page).
2. For more than the most basic tasks, you'll also need to install Git on your computer.
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 gitlab@socsci.ru.nl. Please provide the full name of the user, a requested username, and a valid email address, preferably from the university the person is working in.
Note that with an external account, the user has to switch to the "Standard" tab on the Sign-In page. From GitLab's point of view, all accounts have the same rights and restrictions. Once logged in, there are no further differences.
Setup, Configuration and Usage of Git
For more advanced tasks, you will need a Git installed on your computer and set it up. There is excellent documentation for this available throughout the Internet, for example https://git-scm.com/documentation or https://docs.gitlab.com/ce/gitlab-basics/README.html. It would make little sense to repeat these here. There are many graphical user interfaces available for every major operating system. In addition, many development software packages (including Matlab) are aware of Git repositories and you can set them up to work with GitLab. Note that for most daily tasks, only about 5 Git operations are necessary to know about.
Troubleshoot
Some users will see the following message when they want to make a remote connection with SSH. (existing repository) When you see the below message you will need to say yes.
$ 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 $ Are you sure you want to continue connecting (yes/no)? yes
Remote SSH connection should now be established.
For other technical issues you can contact gitlab@socsci.ru.nl.
Git Clients
You can find the git clients for various operating systems here. Additionally, you may be able to find a Git plugin for your code editor of choice.