eResearch Doc

User Tools

Site Tools

You are here: start » gitlab
gitlab:start

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
Last revision Both sides next revision
gitlab:start [2021/05/26 11:53]
Yann Sagon [External resources] 		gitlab:start [2023/10/25 11:15]
Philippe Aepli [SSH] fix new URL for ssh
Line 2: Line 2:
 ====== GitLab User Documentation ====== ====== GitLab User Documentation ======
  
-Welcome on UNIGE's GitLab documentation. You will find here all the information you need to use  +Welcome on the UNIGE GitLab documentation. You will find here all the information you need to use the UNIGE GitLab instance.
-the UNIGE's GitLab instance.+
  
 <note important> <note important>
-See https://gitlab.unige.ch/help/user/index.md if you are looking for the upstream documentation of the UNIGE GitLab running instance.+See: 
 +  - https://gitlab.unige.ch/help/user/index.md if you are looking for the upstream documentation of the UNIGE GitLab **running** instance. 
 +  - https://catalogue-si.unige.ch if you need to contact the team behind GitLab.
 </note> </note>
 +
 +==== Learning ====
 +
 +Please see the UNIGE official formations at https://spc.unige.ch/en/teaching/digitalskills/ (old https://spc.unige.ch/en/teaching/digitalskills/).
 +
 +
 ==== Access ==== ==== Access ====
  
 ''gitlab.unige.ch'' is open to the whole Swiss educational audience via [[https://www.switch.ch/aai/|SWITCHaai]] (UNIGE members should use their ISIs credentials) and to any non-academic entity via [[ ''gitlab.unige.ch'' is open to the whole Swiss educational audience via [[https://www.switch.ch/aai/|SWITCHaai]] (UNIGE members should use their ISIs credentials) and to any non-academic entity via [[
-https://eduid.ch/web/registration/1/|SWITCH edu-ID (free registration required)]] .  For this reason, password authentication have been deactivated.+https://eduid.ch/web/registration/1/|SWITCH edu-ID (free registration required)]] .  For this reason, password authentication has been deactivated.
  
  
Line 17: Line 24:
  
 Git ''clone/push/pull'' are available:  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+  - via SSH (see https://gitlab.unige.ch/help/user/ssh ) 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 )   - 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 )
  
Line 30: Line 37:
  
 <note important> <note important>
-Independently of the authentication source (SWITCHaai or SWITCH edu-ID), those users without a UNIGE mail address will automatically get an **external** account (see https://gitlab.unige.ch/help/user/permissions#external-users-permissions ), which means that:+Independently of the authentication source (SWITCHaai or SWITCH edu-ID), those users without a UNIGE mail address will automatically get an **external** account (see https://gitlab.unige.ch/help/user/permissions#external-users ), which means that:
   - they can not create groups or projects   - they can not create groups or projects
   - read access to private or internal projects must be explicitly granted   - read access to private or internal projects must be explicitly granted
Line 46: Line 53:
   - maximum size of a single ''git push'' : 1MB   - maximum size of a single ''git push'' : 1MB
  
-Please contact the GitLab UNIGE administrators (see https://catalogue-si.unige.ch/gitlab ) if you need more resources.+Please contact the UNIGE GitLab administrators (see https://catalogue-si.unige.ch/gitlab ) if you need more resources.
  
 +<note important>
 +If you need to store **large** files such as audio, video or graphics ones, please consider switching to [[https://gitlab.unige.ch/help/topics/git/lfs/index.md|Git LFS]]!
 +</note>
 +
 +
 +==== Features =====
 +
 +The UNIGE GitLab instance is based on the upstream **Community Edition** (cf. https://about.gitlab.com/install/ce-or-ee/), since until now no Enterprise features have been needed after various evaluation.
 +
 +Of the CE-included feature, the UNIGE GitLab instance does not support the following ones:
 +  - CI/CD shared runners (cf. https://dataforum.unige.ch/t/gitlab-runners-not-available/401)
 +  - Pages (cf. https://dataforum.unige.ch/t/gitlab-pages-support/194)
 +  - PlantUML (cf. https://gitlab.unige.ch/help/administration/integration/plantuml.md via https://support-si.unige.ch/openentry.html?tid=INC000000146442)
  
 ==== Project visibility ==== ==== Project visibility ====
Line 53: Line 73:
 By default, each project is **private** , //i.e.// they can only be cloned and viewed by project members. By default, each project is **private** , //i.e.// they can only be cloned and viewed by project members.
  
-For more details, please check the [[https://gitlab.unige.ch/help/public_access/public_access|corresponding section]] of the upstream documentation of the UNIGE GitLab running instance.+For more details, please check the [[https://gitlab.unige.ch/help/public_access/public_access|corresponding section]] of the upstream documentation of the UNIGE GitLab instance. 
  
 ==== External resources ==== ==== External resources ====
gitlab/start.txt · Last modified: 2023/10/25 11:17 by Philippe Aepli

Page Tools

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution 4.0 International
CC Attribution 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki