Gitlab - Getting Started - Revision history

Jkinne: /* Course Assignment */

2026-10-06T14:47:14Z

Course Assignment

← Older revision		Revision as of 14:47, 6 October 2026
Line 105:		Line 105:
	#: Click through to make the merge request.		#: Click through to make the merge request.
	#: Do NOT approve the merge request, that will be for your instructor to do.		#: Do NOT approve the merge request, that will be for your instructor to do.

			=Administration=
			On ISU's gitlab instance, a few common things that are done...
			* Create a group for the course and term (e.g., CS 473/573 fall 2026). After each student in the course logs in to git.indstate.edu once, you can add them to the course group with their role as "Developer" (this allows them to create their own branches and push changes).
			* Set the main branch so the students (with "Developer" role) cannot approve merge requests. As of 2026, you go to Settings, Repository, Protected Branches, and change the "Allowed to push and merge" setting so it is "Maintainers" only (and does not include "Developers").

Jkinne: /* Course Assignment */

2026-10-06T14:34:40Z

Course Assignment

← Older revision		Revision as of 14:34, 6 October 2026
Line 101:		Line 101:
	# When you are done, depending on the assignment, you might do a merge request to merge your changes into the main branch of the project. If so, you go to https://git.indstate.edu/PATH_TO_THE_PROJECT and change to your branch.		# When you are done, depending on the assignment, you might do a merge request to merge your changes into the main branch of the project. If so, you go to https://git.indstate.edu/PATH_TO_THE_PROJECT and change to your branch.
	#: Click on Merge requests on the left. Then click on New Merge Request.		#: Click on Merge requests on the left. Then click on New Merge Request.
	#: For the Source branch, put your branch (~~jkinne for Jeff Kinne~~). For the Target branch put main.		#: For the Source branch, put your branch (YOUR_SYCAMORE_ID). For the Target branch put main.
	#: When prompted for the Assignee and Reviewer, put your instructor.		#: When prompted for the Assignee and Reviewer, put your instructor.
	#: Click through to make the merge request.		#: Click through to make the merge request.
	#: Do NOT approve the merge request, that will be for your instructor to do.		#: Do NOT approve the merge request, that will be for your instructor to do.

Jkinne: /* Course Assignment */

2026-10-06T14:34:07Z

Course Assignment

← Older revision		Revision as of 14:34, 6 October 2026
Line 98:		Line 98:
	#:<code>git add ANY_FILES_THAT_HAVE_BEEN_MODIFIED_THAT_YOU_WANT_TO_COMMIT</code>		#:<code>git add ANY_FILES_THAT_HAVE_BEEN_MODIFIED_THAT_YOU_WANT_TO_COMMIT</code>
	#:<code>git commit</code>		#:<code>git commit</code>
	#:<code>git push --set-upstream origin YOUR_SYCAMORE_ID</code.>		#:<code>git push --set-upstream origin YOUR_SYCAMORE_ID</code>
	# When you are done, depending on the assignment, you might do a merge request to merge your changes into the main branch of the project. If so, you go to https://git.indstate.edu/PATH_TO_THE_PROJECT and change to your branch.		# When you are done, depending on the assignment, you might do a merge request to merge your changes into the main branch of the project. If so, you go to https://git.indstate.edu/PATH_TO_THE_PROJECT and change to your branch.
	#: Click on Merge requests on the left. Then click on New Merge Request.		#: Click on Merge requests on the left. Then click on New Merge Request.

Jkinne: /* Course Assignment */

2026-10-06T14:33:40Z

Course Assignment

Jkinne: /* Course Assignment */

2026-10-06T14:31:50Z

Course Assignment

← Older revision		Revision as of 14:31, 6 October 2026
Line 86:		Line 86:
	# Edit your ssh configuration on your computer so it knows which key to use for git.indstate.edu. See https://cs.indstate.edu/web/index.php/Gitlab_-_Getting_Started#SSH_Keys for the file to edit and the text to use.		# Edit your ssh configuration on your computer so it knows which key to use for git.indstate.edu. See https://cs.indstate.edu/web/index.php/Gitlab_-_Getting_Started#SSH_Keys for the file to edit and the text to use.
	# In the terminal, set your name and email with git:		# In the terminal, set your name and email with git:
	#:<~~pre~~>git config --global user.name "Your name"		#:<code>git config --global user.name "Your name"</code>
	#:git config --global user.email "your email address"</~~pre~~>		#:<code>git config --global user.email "your email address"</code>
	# In the terminal, browse to the directory where you want to store this project.		# In the terminal, browse to the directory where you want to store this project.
	# Still in the terminal, run this command to clone the repository: git clone git+ssh://git@git.indstate.edu/PATH_TO_THE_PROJECT		# Still in the terminal, run this command to clone the repository: git clone git+ssh://git@git.indstate.edu/PATH_TO_THE_PROJECT

Jkinne: /* Course Assignment */

2026-10-06T14:31:25Z

Course Assignment

← Older revision		Revision as of 14:31, 6 October 2026
Line 86:		Line 86:
	# Edit your ssh configuration on your computer so it knows which key to use for git.indstate.edu. See https://cs.indstate.edu/web/index.php/Gitlab_-_Getting_Started#SSH_Keys for the file to edit and the text to use.		# Edit your ssh configuration on your computer so it knows which key to use for git.indstate.edu. See https://cs.indstate.edu/web/index.php/Gitlab_-_Getting_Started#SSH_Keys for the file to edit and the text to use.
	# In the terminal, set your name and email with git:		# In the terminal, set your name and email with git:
	<pre>git config --global user.name "Your name"		#:<pre>git config --global user.name "Your name"
	git config --global user.email "your email address"</pre>		#:git config --global user.email "your email address"</pre>
	# In the terminal, browse to the directory where you want to store this project.		# In the terminal, browse to the directory where you want to store this project.
	# Still in the terminal, run this command to clone the repository: git clone git+ssh://git@git.indstate.edu/PATH_TO_THE_PROJECT		# Still in the terminal, run this command to clone the repository: git clone git+ssh://git@git.indstate.edu/PATH_TO_THE_PROJECT

	# Then: cd PROJECT_DIRECTORY (will depend on what project you are cloning)		# Then: cd PROJECT_DIRECTORY (will depend on what project you are cloning)
	# Create your own branch, named after your sycamore id. For Jeff Kinne, that would mean replacing YOUR_SYCAMORE_ID with jkinne everywhere below:		# Create your own branch, named after your sycamore id. For Jeff Kinne, that would mean replacing YOUR_SYCAMORE_ID with jkinne everywhere below:

Jkinne: /* Course Assignment */

2026-10-06T14:29:52Z

Course Assignment

← Older revision		Revision as of 14:29, 6 October 2026
Line 83:		Line 83:
	# Install git on your computer from https://git-scm.com/install/		# Install git on your computer from https://git-scm.com/install/
	# Note: if given the option for what the default editor for git should be, you probably don't want it to be vim. On Windows, Notepad is easier to use.		# Note: if given the option for what the default editor for git should be, you probably don't want it to be vim. On Windows, Notepad is easier to use.
	# Follow the instructions at https://docs.gitlab.com/user/ssh/ to generate a private and public key to use for logging into git.indstate.edu. Follow the instructions also to upload your public key into your account at git.indstate.edu (note - do not put it at gitlab.com, put it on git.indstate.edu). The key files are probably stored in your home directory and in a subdirectory there named ".ssh". That will probably be a "hidden" directory, so check online about how to show hidden files on your		# Follow the instructions at https://docs.gitlab.com/user/ssh/ to generate a private and public key to use for logging into git.indstate.edu. Follow the instructions also to upload your public key into your account at git.indstate.edu (note - do not put it at gitlab.com, put it on git.indstate.edu). The key files are probably stored in your home directory and in a subdirectory there named ".ssh". That will probably be a "hidden" directory, so check online about how to show hidden files on your operating system (e.g., on Mac, type cmd-shift-.).
	operating system (e.g., on Mac, type cmd-shift-.).
	# Edit your ssh configuration on your computer so it knows which key to use for git.indstate.edu. See https://cs.indstate.edu/web/index.php/Gitlab_-_Getting_Started#SSH_Keys for the file to edit and the text to use.		# Edit your ssh configuration on your computer so it knows which key to use for git.indstate.edu. See https://cs.indstate.edu/web/index.php/Gitlab_-_Getting_Started#SSH_Keys for the file to edit and the text to use.
	# In the terminal, set your name and email with git:		# In the terminal, set your name and email with git:

Jkinne: /* Course Assignment */

2026-10-06T14:29:40Z

Course Assignment

← Older revision		Revision as of 14:29, 6 October 2026
Line 83:		Line 83:
	# Install git on your computer from https://git-scm.com/install/		# Install git on your computer from https://git-scm.com/install/
	# Note: if given the option for what the default editor for git should be, you probably don't want it to be vim. On Windows, Notepad is easier to use.		# Note: if given the option for what the default editor for git should be, you probably don't want it to be vim. On Windows, Notepad is easier to use.
	# Follow the instructions at https://docs.gitlab.com/user/ssh/ to generate a private and public key to use for logging into git.indstate.edu. Follow the instructions also to upload your public key into your account at git.indstate.edu (note - do not put it at gitlab.com, put it on git.indstate.edu).		# Follow the instructions at https://docs.gitlab.com/user/ssh/ to generate a private and public key to use for logging into git.indstate.edu. Follow the instructions also to upload your public key into your account at git.indstate.edu (note - do not put it at gitlab.com, put it on git.indstate.edu). The key files are probably stored in your home directory and in a subdirectory there named ".ssh". That will probably be a "hidden" directory, so check online about how to show hidden files on your
	The key files are probably stored in your home directory and in a subdirectory there named ".ssh".
	That will probably be a "hidden" directory, so check online about how to show hidden files on your
	operating system (e.g., on Mac, type cmd-shift-.).		operating system (e.g., on Mac, type cmd-shift-.).
	# Edit your ssh configuration on your computer so it knows which key to use for git.indstate.edu. See https://cs.indstate.edu/web/index.php/Gitlab_-_Getting_Started#SSH_Keys for the file to edit and the text to use.		# Edit your ssh configuration on your computer so it knows which key to use for git.indstate.edu. See https://cs.indstate.edu/web/index.php/Gitlab_-_Getting_Started#SSH_Keys for the file to edit and the text to use.

Jkinne: /* Getting Around */

2026-10-06T14:29:01Z

Getting Around

← Older revision		Revision as of 14:29, 6 October 2026
Line 77:		Line 77:
	git merge branch_name # merge your branch into the main branch		git merge branch_name # merge your branch into the main branch
	</pre>		</pre>

			=Course Assignment=
			The following is a list of steps to complete if you are just starting with using ISU's gitlab server for a course assignment.

			# Install git on your computer from https://git-scm.com/install/
			# Note: if given the option for what the default editor for git should be, you probably don't want it to be vim. On Windows, Notepad is easier to use.
			# Follow the instructions at https://docs.gitlab.com/user/ssh/ to generate a private and public key to use for logging into git.indstate.edu. Follow the instructions also to upload your public key into your account at git.indstate.edu (note - do not put it at gitlab.com, put it on git.indstate.edu).
			The key files are probably stored in your home directory and in a subdirectory there named ".ssh".
			That will probably be a "hidden" directory, so check online about how to show hidden files on your
			operating system (e.g., on Mac, type cmd-shift-.).
			# Edit your ssh configuration on your computer so it knows which key to use for git.indstate.edu. See https://cs.indstate.edu/web/index.php/Gitlab_-_Getting_Started#SSH_Keys for the file to edit and the text to use.
			# In the terminal, set your name and email with git:
			<pre>git config --global user.name "Your name"
			git config --global user.email "your email address"</pre>
			# In the terminal, browse to the directory where you want to store this project.
			# Still in the terminal, run this command to clone the repository: git clone git+ssh://git@git.indstate.edu/PATH_TO_THE_PROJECT

			# Then: cd PROJECT_DIRECTORY (will depend on what project you are cloning)
			# Create your own branch, named after your sycamore id. For Jeff Kinne, that would mean replacing YOUR_SYCAMORE_ID with jkinne everywhere below:
			<pre>git branch YOUR_SYCAMORE_ID
			git checkout YOUR_SYCAMORE_ID</pre>
			Note that we could have used some other name for the branch other than your sycamore id, but using the sycamore id makes it easy to tell which branch is yours.
			# Work on the assignment, doing whatever you are supposed to do. You should frequently commit and push changes (this saves them and also lets the instructor see the progress you are making).
			<pre>git add ANY_FILES_THAT_HAVE_BEEN_MODIFIED_THAT_YOU_WANT_TO_COMMIT
			git commit
			git push --set-upstream origin YOUR_SYCAMORE_ID</pre>
			# When you are done, depending on the assignment, you might do a merge request to merge your changes into the main branch of the project. If so, you go to https://git.indstate.edu/PATH_TO_THE_PROJECT and change to your branch.
			Click on Merge requests on the left. Then click on New Merge Request.
			For the Source branch, put your branch (jkinne for Jeff Kinne). For the Target branch put main.
			When prompted for the Assignee and Reviewer, put your instructor.
			Click through to make the merge request.
			Do NOT approve the merge request, that will be for your instructor to do.

Jkinne: /* Workflow */

2026-10-06T14:20:05Z

Workflow

← Older revision		Revision as of 14:20, 6 October 2026
Line 72:		Line 72:
	'''Pull''' - To pull/download updates that have happened (by others), you use <code>git pull</code>.		'''Pull''' - To pull/download updates that have happened (by others), you use <code>git pull</code>.

	'''Merge''' - When you ready to have your changes merged in to the main branch of the project, ask the owner of the project to check your branch. When the owner is ready for it, the owner can run the following commands.		'''Merge''' - When you are ready to have your changes merged in to the main branch of the project, ask the owner of the project to check your branch. When the owner is ready for it, the owner can run the following commands.
	<pre>		<pre>
	git branch main # owner is working in the main branch		git branch main # owner is working in the main branch
	git merge branch_name # merge your branch into the main branch		git merge branch_name # merge your branch into the main branch
	</pre>		</pre>

← Older revision		Revision as of 14:33, 6 October 2026
Line 89:		Line 89:
	#:<code>git config --global user.email "your email address"</code>		#:<code>git config --global user.email "your email address"</code>
	# In the terminal, browse to the directory where you want to store this project.		# In the terminal, browse to the directory where you want to store this project.
	# Still in the terminal, run this command to clone the repository: git clone git+ssh://git@git.indstate.edu/PATH_TO_THE_PROJECT		# Still in the terminal, run this command to clone the repository: <code>git clone git+ssh://git@git.indstate.edu/PATH_TO_THE_PROJECT</code>
	# Then: cd PROJECT_DIRECTORY (will depend on what project you are cloning)		# Then: <code>cd PROJECT_DIRECTORY</code> (will depend on what project you are cloning)
	# Create your own branch, named after your sycamore id. For Jeff Kinne, that would mean replacing YOUR_SYCAMORE_ID with jkinne everywhere below:		# Create your own branch, named after your sycamore id. For Jeff Kinne, that would mean replacing YOUR_SYCAMORE_ID with jkinne everywhere below:
	<~~pre~~>git branch YOUR_SYCAMORE_ID		#:<code>git branch YOUR_SYCAMORE_ID</code>
	git checkout YOUR_SYCAMORE_ID</~~pre~~>		#:<code>git checkout YOUR_SYCAMORE_ID</code>
	Note that we could have used some other name for the branch other than your sycamore id, but using the sycamore id makes it easy to tell which branch is yours.		#:Note that we could have used some other name for the branch other than your sycamore id, but using the sycamore id makes it easy to tell which branch is yours.
	# Work on the assignment, doing whatever you are supposed to do. You should frequently commit and push changes (this saves them and also lets the instructor see the progress you are making).		# Work on the assignment, doing whatever you are supposed to do. You should frequently commit and push changes (this saves them and also lets the instructor see the progress you are making).
	<~~pre~~>git add ANY_FILES_THAT_HAVE_BEEN_MODIFIED_THAT_YOU_WANT_TO_COMMIT		#:<code>git add ANY_FILES_THAT_HAVE_BEEN_MODIFIED_THAT_YOU_WANT_TO_COMMIT</code>
	git commit		#:<code>git commit</code>
	git push --set-upstream origin YOUR_SYCAMORE_ID</~~pre~~>		#:<code>git push --set-upstream origin YOUR_SYCAMORE_ID</code.>
	# When you are done, depending on the assignment, you might do a merge request to merge your changes into the main branch of the project. If so, you go to https://git.indstate.edu/PATH_TO_THE_PROJECT and change to your branch.		# When you are done, depending on the assignment, you might do a merge request to merge your changes into the main branch of the project. If so, you go to https://git.indstate.edu/PATH_TO_THE_PROJECT and change to your branch.
	Click on Merge requests on the left. Then click on New Merge Request.		#: Click on Merge requests on the left. Then click on New Merge Request.
	For the Source branch, put your branch (jkinne for Jeff Kinne). For the Target branch put main.		#: For the Source branch, put your branch (jkinne for Jeff Kinne). For the Target branch put main.
	When prompted for the Assignee and Reviewer, put your instructor.		#: When prompted for the Assignee and Reviewer, put your instructor.
	Click through to make the merge request.		#: Click through to make the merge request.
	Do NOT approve the merge request, that will be for your instructor to do.		#: Do NOT approve the merge request, that will be for your instructor to do.