This article explains how to clone and set up a local Banner XE Application repository from Oakland University’s GitLab server, including updating submodules and preparing baseline and test release branches.
Procedures
Create a new local XE application repository
To clone an XE application repository to your workstation:
- cd to the directory on your workstation where you will be storing your repositories
- Enter "git clone ssh_string"
where "ssh_string" will be one of:
If your current directory does not already have a gitfu script, create one. It will modify your clone's .gitmodules file to replace references to git.ellucian.com with code.oakland.edu. A sample is shown below; replace the Ellucian references with the appropriate Oakland references.
sed "s?https://git.ellucian.com/scm/banxeplug?https://gitlab-ci-token:mytoken@code.oakland.edu/banner-xe-applications?g" .gitmodules > /tmp/gitmod1
sed "s?https://git.ellucian.com/scm/ext?https://gitlab-ci-mytoken@code.oakland.edu/banner-xe-applications?g" /tmp/gitmod1 > /tmp/gitmod2
mv .gitmodules .gitmodules.save
mv /tmp/gitmod2 .gitmodules
The git clone command will create a directory on your workstation named after the repository. Enter "cd cloned_directory" to navigate there.
- Enter "sh ../gitfu" to update your .gitmodules file.
- Enter "git submodule update --init" to download all of the submodules needed for your repository.
- stash change to origin/master - DO NOT commit, since this will break your ability to download further updates from Ellucian!
- create a baseline branch from the commit tagged with the release you intend to work on (this will take a long time, because it undoes the gitfu and will raise errors)
- sh ../gitfu
- git submodule update --init
- commit change to your baseline release branch
- create a test release branch from your baseline release branch
Additional Support
- OU Technology Center
- 44 Oakland Center
- Rochester, MI 48309-4479
- (248) 370-4357
- Office Hours: M-F 8:00am - 5:00pm