Line 32: |
Line 32: |
| }} | | }} |
| | | |
− | The [https://gitlab.socsci.ru.nl Social Sciences GitLab server] offers [[wikipedia:Git|Git]] repository management, code reviews, issue tracking, activity feeds and wikis. | + | The [https://gitlab.socsci.ru.nl Social Sciences GitLab server] offers [[wikipedia:Git|Git]] repository management, code reviews, issue tracking, and wikis. |
| + | With the [[Mattermost Social Sciences]] you can chat with your colleagues and interact with your projects. |
| | | |
| <!-- Table of Contents will be generated here --> | | <!-- Table of Contents will be generated here --> |
Line 39: |
Line 40: |
| 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. |
− | 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. | + | You can create at least 50 projects, make them private or share them with your lab members, or even the entire Internet. |
| + | With [[Mattermost Social Sciences]] you can chat with your colleagues and even manage the project through chat commands. |
| | | |
| Think of GitLab as a "Facebook" around your projects. | | Think of GitLab as a "Facebook" around your projects. |
| Similar services include e.g. [https://github.com GitHub.com] or [https://gitlab.com GitLab.com] (which also runs the GitLab software on their servers). | | Similar services include e.g. [https://github.com GitHub.com] or [https://gitlab.com 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. | | 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. | + | That means we determine our own terms of use; for example, you can get private projects for free - on GitHub, you would have to pay. |
| | | |
| Note that there's another self-hosted [https://gitlab.science.ru.nl GitLab service running at the Faculty of Science]. | | Note that there's another self-hosted [https://gitlab.science.ru.nl 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). | + | 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). Members of UMC with Z-numbers have to request external accounts, see below. |
| * External users can ask for an account and then login with their username (switch to the "Standard" tab in the Sign-In page). | | * 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 [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. |
| | | |
| == Login for external users == | | == Login for 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 | + | External user accounts should be requested from a member of Radboud University. |
| + | If you want to allow people without RU account to join your Mattermost team or GitLab project, please request an account by sending an email to |
| [mailto:gitlab@socsci.ru.nl gitlab@socsci.ru.nl]. | | [mailto:gitlab@socsci.ru.nl 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. | + | Please provide the full name of the user, a requested username, and a valid email address, preferably from the university or organization the person is working at. |
| | | |
− | Note that with an external account, the user has to switch to the "Standard" tab on the Sign-In page. | + | ''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. | | From GitLab's point of view, all accounts have the same rights and restrictions. |
| Once logged in, there are no further differences. | | Once logged in, there are no further differences. |
Line 78: |
Line 81: |
| | | |
| Longer answer: All employees and students of Radboud University have access (with their U-, S-, E- or F-number). | | Longer answer: All employees and students of Radboud University have access (with their U-, S-, E- or F-number). |
| + | Members from Radboud UMC with Z-numbers have to request external accounts, see above. |
| If you log in the first time, a corresponding account will be created. | | If you log in the first time, a corresponding account will be created. |
| In addition, you can request accounts for people from other universities, for example to collaborate with them on confidential projects. | | In addition, you can request accounts for people from other universities, for example to collaborate with them on confidential projects. |
Line 93: |
Line 97: |
| | | |
| === What can/should be stored on GitLab? === | | === What can/should be stored on GitLab? === |
− | Short answer: Scripts, documentation, theses, figures etc. '''No data please!''' For data, use https://data.donders.ru.nl/. | + | Short answer: Scripts, documentation, theses, figures etc. '''No research data please!''' For research data, use https://data.donders.ru.nl/. |
| + | For some niche cases, GitLab's Large File Storage (LFS) might be useful, see below. |
| | | |
| Longer answer: Git and GitLab are meant primarily for smaller amounts of data (think Megabytes, not Gigabytes). | | Longer answer: Git and GitLab are meant primarily for smaller amounts of data (think Megabytes, not Gigabytes). |
− | Most features, like comparing versions, only really make sense with text-based files. | + | Most features, like comparing versions, only really make sense with changing text-based files. |
− | Git keeps track of every change you make in its history, and never really forgets. | + | Git keeps track of every change you make in its history, and thus content is never really deleted. |
| That means Git repositories only grow larger, and even if you "delete" files, you can go back and un-delete them. | | That means Git repositories only grow larger, and even if you "delete" files, you can go back and un-delete them. |
| That's a main feature, you get an "unlimited undo" for all kinds of files (and across different editors and computers). | | That's a main feature, you get an "unlimited undo" for all kinds of files (and across different editors and computers). |
| | | |
− | Keeping an unchangeable history makes it impractical for data - you can't really delete them, comparing versions of them makes little sense. | + | Keeping an unchangeable history makes it impractical for binary data - you can't really delete them, comparing versions of them makes little sense. |
| And potentially you later want to make the project available to more people - but maybe without sharing all data. | | And potentially you later want to make the project available to more people - but maybe without sharing all data. |
− | Finally, our server also has limited capacity.
| + | For these reasons, please use https://data.donders.ru.nl/ for your research data. |
− | For all these reasons, please use https://data.donders.ru.nl/ for your data. | + | |
| + | In case you need certain large data files for your development, GitLab offers Large File Storage (LFS). |
| + | Please only use this feature after careful consideration, for files that are integral to your project and for which no other data repository makes sense. |
| + | Note that you need to install the LFS extension on your local machine to use this. |
| + | For more documentation, please refer to https://docs.gitlab.com/ce/workflow/lfs/manage_large_binaries_with_git_lfs.html. |
| | | |
| === What happens to my GitLab projects when I leave? === | | === What happens to my GitLab projects when I leave? === |