GitLab
We provide a GitLab installation at code.fbi.h-da.de.
Identity Provider
Sign in using the h-da.de
identity provider. Your user name probably looks
like stgespel
(students) or fbiXYZW
(faculty/staff).
Note that must have changed your password at least once after 2019-04-11 to be able to sign in to GitLab using your university account.
Refer to Accounts for additional information on user credentials.
External Users
Users without access to an h_da account can sign in to GitLab as External Users using their accounts from either GitHub or GitLab.com.
External Users are restricted in what they can do. They cannot create their own groups or projects and only access those that are designated as public.
They may be invited to collaborate on projects created by h_da users though. Thus, there's no need to request h_da accounts for external partners just to collaborate on GitLab projects.
Availability of CI/CD Runners
Authenticated users may take advantage of the department's computational resources through the instance-wide CI/CD runners available for use with GitLab CI.
Every CI job is provided with a pristine environment and is executed as a set
of containers. The Docker
image to use for your pipeline can be specified
as part of the .gitlab-ci.yml
file in the root of your Git repository.
Services
Services are additional containers executed as part of your CI pipeline. Services can be used to ensure the availability of dependencies required by your CI pipelines.
A common use-case is providing some kind of database system accessed by your program's test suite. An example using the PostgreSQL DBMS can be found here.
Building Docker Images in GitLab CI/CD
Building Docker images from within a Docker container using the Docker-in-Docker (dind) approach requires the dind container to execute in privileged mode. This poses several security issues and is thus not supported with GitLab CI/CD on code.fbi.h-da.de.
An alternative approach that doesn't require privileged mode is documented in the upstream GitLab documentation. See Building images with kaniko and GitLab CI/CD.
GitLab Pages
Pages is a static web hosting facility that can be used from GitLab. The web site you're reading right now is hosted through GitLab Pages.
Each GitLab user or group is assigned a sub-domain of h-da.io that may be used for Pages and automatically gets SSL/TLS set up. Note that this doesn't work with user names containing a dot as is the case with most FBI faculty accounts. Please use a group in that case.
Your site will be available at group.h-da.io/optional-project-name.
A comprehensive guide to GitLab Pages can be found here. A set of quick-start examples is available here.
Plain-html template
Due to popular demand, we have set up the plain-html quick-start example as an instance template. It can be chosen when creating a new GitLab project.
The resulting repo is configured to make all files within the public/
directory available. Thus, you can drop arbitrary HTML, CSS or Javascript files
there and they will be hosted at your sub-domain.