Skip to content

SPRINGFIELD - GitLab User Docs

This is the documentation for Users of the SPRINGFIELD GitLab Instance on https://homer.tobi.backfrak.de/gitlab/

General Usage

Since this is more or less a standard GitLab installation you can apply most of the standard GitLab User Manual to this instance.

However, below you can find some hints that are more or less specific to this instance.

User and Group Management

Since GitLab gives every member the possibility to create own Repositories and Groups, some information about users and Groups can be found below.

Users

SPRINGFIELD Domain User

First of all it's worth to mention that every SPRINGFIELD Domain User can login to this GitLab instance without further registration. However, while your first login you need to verify your email address. This works as follows:

  1. Open https://homer.tobi.backfrak.de/gitlab/users/sign_in
    • Make sure you use the Springfield Domain User login mask
  2. Login with your SPRINGFIELD Domain credentials
  3. Open your email inbox
    1. Open the mail you got from tobi.backfrak.gitlab@e-mail.de
    2. Follow the verification link
  4. Have fun with GitLab

This needs to be done only once, with your first login.

Hint 1: As SPRINGFIELD Domain user you always need to use the Springfield Domain User login mask, not only at first login.

Hint 2: Your SPRINGFIELD Domain credentials, are those you use for https://homer.tobi.backfrak.de/owncloud as well.

Other Users

Users that are only registered for the GitLab Instance use the Standard mask to login.

Already logged in users can add anybody they want to there owned project using the Invite Member feature. Users you add will get a invitation email, they can approve and do a first login by following the instructions in this email. Users added this way are only registered for the GitLab Instance.

Repositories and Groups

As GitLab User you may create your own repositories for whatever you propose you like. You can manage and groupe repositories with your own Repository Groups.

You can add other users to your repositories and groups as you like.

  • Already existing users ( Other Users or Domain Users after there first long ) you just select from the dropdown menu in the Invite members mask
  • Not existing users can be invited by entering the mail address of the user you want to join

Since this is a Open Source GitLab Installation without subscription it is not possible to create or use User Groups. Neither a normal User nor the Admin can create a user group. And even the user groups defined in the SPRINGFIELD Domain LDAP can not be used inside this GitLab instance.
This means every user needs to be added to each repositories group or repositories individually.

GitLab-CI and Runners

This GitLab Instance has at least one GitLab Runner attached. You can use this runner for your CI Jobs. This runners are so called docker runners, so you have to use them with an Docker Image. No other runner types are available.

While the configuration of the runners is pretty standard you still have to take care of one specialty. Since there are no default runners configured in most projects/repositories you need to add the following labels to any of your jobs configurations:

  tags:
    - ci-docker
    - linux

See .gitlab-ci.yml for a working example. This is the CI Job that renders this page by the way.

GitLab Pages

While it is planed to fully support the GitLab Pages features some time in the future it can be only used limited right now. For this reason I will not add any further documentation here until I consider the setup as working as good as possible.

When the best possible setup is done, I will update this page with information about how to use pages on this instance. If you want to keep track on the current state, watch Issue #12 in the springfield-domain repository.

Terms of Service

The SPRINGFIELD GitLab Instance, named 'this service' below is provided under the following conditions:

  1. This service is free of charge
  2. This service is provided as good as possible without any guaranty to be working at any given time
    • In order to support the self service approach all SPRINGFIELD Domain Users can access the GitLab Monitoring Dashboard
    • This instance is installed on a private home server, so do not expected professional uptime or service quality
    • However most downtime due to maintains will be fridays between 22:00 and 24:00
  3. Abusive users will be blocked
    • I will consider any user as abusive that adds to many new users (this is a private instance, I can not handle hundreds of users)
    • I will consider any user as abusive that uses GitLab Runners abusive (e. g. Crypto Mining, attacking other users or services, any other stuff that conflicts with german law)
  4. Any personal information stored by this service is only used for operating the service