VSC Software Stack

Central repository of easyconfigs used in the software installations on VSC clusters.

Repository structure

The organization of this repo is structured in standard git branches, each one providing a different degree of reliability:

vsc: main branch with software installations validated and tested by multiple VSC sites
site-kul: software installations specific to clusters managed by KU Leuven
site-ua: software installations specific to clusters managed by UAntwerp
site-ugent: software installations specific to clusters managed by UGent
site-vub: software installations specific to clusters managed by VUB
wip: software installations on any site that are work-in-progress

Bootstrap

Users of this repo are encouraged to work with git worktrees. This approach allows to have all easyconfigs available in the VSC Software Stack across all its branches under a single folder in your local system.

Create a new folder for this repo
```
$ mkdir vsc-software-stack
```

Clone the bare repository (we keep it in a hidden folder as it won't be used directly)

$ git clone --bare git@github.com:vscentrum/vsc-software-stack.git vsc-software-stack/.bare

Point git to the bare repo already from the root folder
```
$ echo "gitdir: ./.bare" > vsc-software-stack/.git
```

Add worktrees for each branch in their own folder

$ cd vsc-software-stack
$ git worktree add vsc
$ git worktree add wip

Commits with worktrees

Pushing/pulling changes in worktrees is no different than in a regular repo. As soon as you change directory into a worktree folder, you can work as if you were on a regular repo. There will be an active branch, you can create/checkout other branches and commit to any branch as usual.

Unreviewed branches

Branches such as wip or the site-* branches do not require PRs and reviews to push changes.

Enter the target worktree/branch
```
$ cd vsc-software-stack/wip
```
Fetch updates in this branch from remote repository
```
$ git fetch origin
$ git pull origin wip
```

Add and commit the files affected by this change

$ git add 000_example/example.eb
$ git commit -m "adding WIP easyconfig example.eb"

Push new commit to remote branch in vsc-software-stack repo
```
$ git push origin wip
```

Reviewed branches

The vsc branch requires a PR and a positive review (+ working test report) to merge changes into it. PRs should be open from a fork of the vsc-software-stack repo.

In the following we assume the following names for the remote repos:

origin: vsc-software-stack repo in vscentrum
personal: your fork of vsc-software-stack

Enter the target worktree/branch
```
$ cd vsc-software-stack/vsc
```

Fetch updates in this branch from remote repository

$ git fetch origin
$ git pull origin vsc
$ git push personal vsc

Create a new local branch to work on the changes
```
$ git checkout -b 000_example
```

Add new easyconfigs from another worktree

$ cp ../wip/000_example/example.eb e/example/example.eb