Git

Git is the version control system used for every project on the platform.

There is no password authentication

Git here authenticates with an SSH key or a personal access token. Username and password will not work. See First steps.

New to Git, or want a refresher? Start with GitLab's Git tutorial. If you are already comfortable with it, just add an SSH key for this instance.

The branching model

A main branch with feature/… branches that are merged back into it. Several feature branches can be in flight at once.

---
config:
    theme: neutral
---
gitGraph
    commit
    commit
    branch develop
    checkout develop
    commit
    commit
    checkout main
    commit
    branch feature/awesome-feature
    commit
    checkout feature/awesome-feature
    commit
    commit
    checkout main
    merge feature/awesome-feature
    merge develop
    commit
    commit

Work reaches main through a merge request. That is where review happens, and it is what runs a pipeline against your changes before they land.

Large files

Keep binaries such as installers, archives and test data out of Git history with Git LFS. Install it once, then track the file types in the repository:

git lfs install
git lfs track "*.zip" "*.bin"
git add .gitattributes

Commit and push as usual; the tracked files go to LFS storage instead of the repository. Build output and packages belong in a registry, not in LFS.

Getting a repository, or access to one

Both go through your Vector contact:

  • A new repository: say which group it should live in and what it should be called. See naming.
  • Access to an existing one: access is granted by adding your team group to the project rather than adding you individually, which is why "I cannot see project X" is usually a membership question. How to ask