Table of Contents
This is an old revision of the document!
GitLab User Documentation
Welcome on the UNIGE GitLab documentation. You will find here all the information you need to use the UNIGE GitLab instance.
Access
gitlab.unige.ch is open to the whole Swiss educational audience via SWITCHaai (UNIGE members should use their ISIs credentials) and to any non-academic entity via SWITCH edu-ID (free registration required) . For this reason, password authentication has been deactivated.
SSH
Git clone/push/pull are available:
- via SSH (see https://gitlab.unige.ch/help/ssh/README.md ) after either the user has added a key in the GitLab profile settings or one of the project administrators has set up a Deploy Key in the GitLab project interface (see https://gitlab.unige.ch/help/user/project/deploy_keys/index.md )
- via HTTPS after the user has generated a Personal Access Token in the GitLab profile settings (see https://gitlab.unige.ch/help/user/profile/personal_access_tokens.md ) or one of the project administrators has set up a Deploy Token in the GitLab project interface (see https://gitlab.unige.ch/help/user/project/deploy_tokens/index.md )
Permissions
Access to each resource is directly managed per (sub)group or project via the web interface (see https://gitlab.unige.ch/help/user/permissions ).
To easy access management, you should think in a hierarchical terms from the very beginning:
- create a top-level group with the least possible members (basically, only the administrators)
- inside this group, create sub-groups or projects with specific permissions
- they can not create groups or projects
- read access to private or internal projects must be explicitly granted
- read access to public projects is permitted
- write access to any project must be explicitly granted
Resources
By default, the following settings apply to any internal users:
- maximum number of projects: 20
- maximum size of a single project: 100MB
- maximum size of an attachment: 10MB
- maximum size of a single
git push: 1MB
Please contact the UNIGE GitLab administrators (see https://catalogue-si.unige.ch/gitlab ) if you need more resources.
Project visibility
By default, each project is private , i.e. they can only be cloned and viewed by project members.
For more details, please check the corresponding section of the upstream documentation of the UNIGE GitLab instance.
External resources
Learn Git with a game: https://ohmygit.org/
Git Windows client https://dataforum.unige.ch/t/recommended-git-client-for-gitlab-unige-account/322/2
SPC VCS courses https://spc.unige.ch/en/teaching/digitalskills/source-code-management-git/
You did something wrong with Git? This site may help you: https://ohshitgit.com/
