Difference between revisions of "Git / Gitlab"

Revision as of 19:59, 21 January 2016

GitLab / GIT

GitLab is the web interface of choice for managing GIT repositories.

A list of features: https://about.gitlab.com/features/

Additional Info:

• GitLab URL: https://git.linuxmce.org/
• Repository URL: https://git.linuxmc.org/< username / group name >/< project name >.git

Get access to GitLab

Go to IRC #linuxmce-devel and ask for a Account.

To create an account we need following information:

1. Name
2. Username
3. E-Mail

As soon as your account was created you'll receive an E-Mail containing a link to set your password. Klick on that link and set your password, then you are ready to login. No mail received? Check your spam/junk folder.

Clone repository

You have 2 options to clone a repository:

• SSH (requires a SSH key st up in GitLab) e.g. git clone git@git.linuxmce.org:ochorocho/gitlab-irc.git
• HTTPS e.g. git clone https://git.linuxmce.org/ochorocho/gitlab-irc.git

Workflow

We have no fine grained workflow at the moment and no continous integration.

With no write access

Even if you have write access you can use this method.

1. Fork a repository
2. Do your stuff, implement features, fix bugs etc.
3. Make "Pull Request" for your changes
4. "Pull Request" will be verified and merged by a LinuxMCE Dev, please be patient

With write access

Master is always deployable, so we must not work on Master at any time!
Master is only used for merge in working stuff.

1. Clone a repository
2. Branch of from Master
3. Do your stuff, implement features, fix bugs etc.
4. Commit/Push your branch - on bigger changes i would recommend doing a test build using this branch
5. Merge your changes into Master
6. Push the verified changes to master

GitLab IRC

To enable IRC notifications for your project add a Web Hooks (Settings -> Web hook) with the URL http://localhost:4567/commit Somehow GitLab seems to ignore "Trigger". When only checked "Push events" it's still triggered for Comments, Issue events etc.

Because of that fact i extended the config.yml of giltab-irc (/home/git/gitlab-irc/config/config.yml) to have at least the option to configure notifications globally.

Following options for notifications:

msg:
  push: true
  tag_push: false
  issue: true
  note: false
  short_uri: true

To start gitlab-irc run:

/etc/init.d/gitlab-irc start

Useful links

• GIT clients: http://git-scm.com/downloads/guis
• GIT Docs: http://git-scm.com/docs
• Cheatsheet / Commands:
  • fancy: http://ndpsoftware.com/git-cheatsheet.html
  • pdf: https://training.github.com/kit/downloads/github-git-cheat-sheet.pdf
• Merge vs. Rebase: https://www.atlassian.com/git/tutorials/merging-vs-rebasing/conceptual-overview