Differences

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

--- techsupport:services:git [2019/06/20 18:42] – kjohns23
+++ techsupport:services:git [2023/08/08 15:48] (current) – kjohns23
@@ Line 1: / Line 1: @@
-====== Git ======
+====== Gitlab ======
 ==== Overview ====
 The School of Computer Science git server is available at [[http://git.socs.uoguelph.ca|git.socs.uoguelph.ca]], and is accessible to all SoCS Students, Faculty and Staff. It uses Gitlab as it's software, with detailed user documentation available at [[https://docs.gitlab.com/ee/user/]].
+SoCS Gitlab offers a mix of self-service and department-provided Groups and Projects.
+==== Tutorials ====
+[[https://moodle.socs.uoguelph.ca/course/view.php?id=169|Gitlab Tutorials]] are available on Moodle.
 ==== How to Start ====
-To access the SoCS git service, visit [[https://git.socs.uoguelph.ca]] in a web browser, and log in with your UoG Credentials. Ensure that the "Central Login ID" tab is selected.
+=== Logging In ===
+To access the SoCS git service, visit [[https://git.socs.uoguelph.ca|git.socs.uoguelph.ca]] in a web browser, and log in with your UoG Credentials. Ensure that the "Central Login ID" tab is selected.
 {{:techsupport:services:gitlab1.png?400|}}
-==== Importing Repositories ====
+=== Creating your own Project ===
+Create a project by clicking the green "New Project" button at the top right of the window.
+{{:techsupport:services:gitlab2.png?400|}}
+Enter a name for your project in the "Project Name" box. While you type here, the "Project Slug" box will automatically be filled.
+The "Project URL" section will list your username by default. You should leave this as is, unless you are creating a group project. More information on that can be found in the [[https://docs.gitlab.com/ee/user/group/|Gitlab Documentation]].
+By default your project will be set to Private access. While you can set this to public, please be aware that it may be academic misconduct to make current coursework publicly available. If you need to share your project with other SoCS Students/Instructors, it is best to make a Group Project, and share it with them directly.
+{{:techsupport:services:gitlab3.png?400|}}
+=== Creating your own Group ===
+If you need to manage a number of projects together, you can create a Group.
+==== Course Assignment and Lab Repositories ====
+To make the management of git repositories for code submitted to instructors for marking, SoCS IT can create nested groups and projects for your course. Instructors and TAs get access to an umbrella group containing all groups and projects for their course. Each student then has access to only their own subgroup, which contains a list of projects/repositories as defined by the instructor.
+Some example project names are A1, A2, LE1, LabExam, Coursework, but instructors can specify any valid project name.
-Repositories can be imported to the SoCS git server from a number of platforms including github, and the old SoCS Server.
+To request course git groups, send an email to help@socs.uoguelph.ca, indicating the course code, and desired project/repository structure.
-To import from github, or another web platform, please see the [[https://docs.gitlab.com/ee/user/project/import/|Gitlab Documentation]] for details.
+==== Additional Gitlab Features ====
-To import from the old SoCS Git server, follow the [[https://docs.gitlab.com/ee/user/project/import/repo_by_url.html| Repo By URL Directions]] with the below settings.
+Below is a list of features available through Gitlab that instructors may find useful
-== Find your Repositories ==
+  * [[https://docs.gitlab.com/ee/ci/|Continuous Integration and Development]]
+  * [[https://docs.gitlab.com/ee/user/project/issues/|Issue Tracking]]
-== Git Repository URL ==
-This will usually be https://sprout.socs.uoguelph.ca/<Username>/<Reponame> for personal repositories, or https://sprout.socs.uoguelph.ca/<cisXXXX>/<Username>/<Reponame> for course based repositories