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