Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/yobasystems/gitlab-runner
Gitlab Runner on Alpine Linux [Docker]
https://github.com/yobasystems/gitlab-runner
alpine amd64 arm64 armhf docker-image dockerfile gitlab gitlab-ci gitlab-runner yobasystems
Last synced: 3 months ago
JSON representation
Gitlab Runner on Alpine Linux [Docker]
- Host: GitHub
- URL: https://github.com/yobasystems/gitlab-runner
- Owner: yobasystems
- Created: 2017-06-21T22:23:37.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2024-08-19T22:46:37.000Z (6 months ago)
- Last Synced: 2024-08-20T03:10:30.399Z (6 months ago)
- Topics: alpine, amd64, arm64, armhf, docker-image, dockerfile, gitlab, gitlab-ci, gitlab-runner, yobasystems
- Language: Dockerfile
- Homepage: https://hub.docker.com/r/yobasystems/gitlab-runner/
- Size: 163 KB
- Stars: 21
- Watchers: 5
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Gitlab Runner on Alpine Linux
This is the Container image for the Gitlab runner, running on Alpine Linux.
[](https://hub.docker.com/r/yobasystems/gitlab-runner/)
[](https://hub.docker.com/r/yobasystems/gitlab-runner/)
[](https://hub.docker.com/r/yobasystems/gitlab-runner/)
[](https://alpinelinux.org/)
[](https://www.docker.com/)
This Container image [(yobasystems/gitlab-runner)](https://hub.docker.com/r/yobasystems/gitlab-runner/) is based on the minimal [Alpine Linux](https://alpinelinux.org/) with [Gitlab Runner](https://packages.gitlab.com/runner/gitlab-runner) pre-installed.
### Alpine Version 3.20.2 (Released 2024-07-22)
##### Gitlab Runner Version 17.3.0
##### Docker Machine Version 0.16.2-gitlab.28
----
- [What is Alpine Linux?](#what-is-alpine-linux)
- [Features](#features)
- [Architectures](#architectures)
- [Tags](#tags)
- [Layers & Sizes](#layers--sizes)
- [How to use this image](#how-to-use-this-image)
- [Image contents & Vulnerability analysis](#image-contents--vulnerability-analysis)
- [Source Repositories](#source-repositories)
- [Container Registries](#container-registries)
- [Links](#links)
- [Donation](#donation)
## 🏔️ What is Alpine Linux?
Alpine Linux is a Linux distribution built around musl libc and BusyBox. The image is only 5 MB in size and has access to a package repository that is much more complete than other BusyBox based images. This makes Alpine Linux a great image base for utilities and even production applications. Read more about Alpine Linux here and you can see how their mantra fits in right at home with Container images.
## 👟 What is Gitlab Runner?
GitLab Runner is the open source project that is used to run your jobs and send the results back to GitLab. It is used in conjunction with GitLab CI, the open-source continuous integration service included with GitLab that coordinates the jobs.
## ✨ Features
* Minimal size only
* 50 MB and only 5 layers
* Memory usage is minimal on a simple install
## 🏗️ Architectures
* ```:amd64```, ```:x86_64``` - 64 bit Intel/AMD (x86_64/amd64)
* ```:arm64v8```, ```:aarch64``` - 64 bit ARM (ARMv8/aarch64)
* ```:arm32v7```, ```:armhf``` - 32 bit ARM (ARMv7/armhf)
#### 📝 PLEASE CHECK TAGS BELOW FOR SUPPORTED ARCHITECTURES, THE ABOVE IS A LIST OF EXPLANATION
## 🏷️ Tags
* ```:latest``` latest branch based (Automatic Architecture Selection)
* ```:master``` master branch usually inline with latest
* ```:17.3.0```, ```:17.3.0-arch``` version tag (Automatic Architecture Selection)
* ```:amd64```, ```:x86_64``` amd64 based on latest tag but amd64 architecture
* ```:aarch64```, ```:arm64v8``` Armv8 based on latest tag but arm64 architecture
* ```:armhf```, ```:arm32v7``` Armv7 based on latest tag but arm architecture
## 📏 Layers & Sizes
## 🚀 How to use this image
### amd64/armhf/aarch64 (Alpine)
```
docker pull yobasystems/gitlab-runner
sudo docker run -d --name=gitlab-runner --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v /data/gitlab-runner/config:/etc/gitlab-runner yobasystems/gitlab-runner
```
#### Register runner with gitlab server
These can be passed at runtime as environment variables or by running the following command:
```
docker exec -it gitlab-runner /bin/sh
gitlab-runner register -n --url https://gitlab.url.domain.co.uk/ci --registration-token eRp938AHcv8JiHi4hUip --executor docker --docker-image "yobasystems/gitlab-runner-docker" --docker-privileged
```
### Config file
Sometimes it is needed to add the following `"/var/run/docker.sock:/var/run/docker.sock"`, in the example below you will see the placement.
```
concurrent = 1
check_interval = 0
[[runners]]
name = "gitlab-runner001"
url = "https://gitlab.url.domain.co.uk/ci"
token = "eRp938AHcv8JiHi4hUip"
executor = "docker"
[runners.docker]
tls_verify = false
image = "yobasystems/gitlab-runner-docker:dind"
privileged = true
disable_cache = true
volumes = ["/var/run/docker.sock:/var/run/docker.sock", "/cache"]
shm_size = 0
[runners.cache]
```
### Usage
Use like you would any other base image:
```
version: '2'
services:
gitlab-runner:
privileged: true
image: yobasystems/gitlab-runner
stdin_open: true
volumes:
- /var/run/docker.sock:/var/run/docker.sock
- /data/gitlab-runner/config:/etc/gitlab-runner
tty: true
```
## 🔍 Image contents & Vulnerability analysis
| PACKAGE NAME | PACKAGE VERSION | VULNERABILITIES |
|-----------------------|-----------------|-----------------|
## 📚 Source Repositories
* [Github - yobasystems/gitlab-runner](https://github.com/yobasystems/gitlab-runner)
* [Gitlab - yobasystems/gitlab-runner](https://gitlab.com/yobasystems/gitlab-runner)
* [Bitbucket - yobasystems/gitlab-runner](https://bitbucket.org/yobasystems/gitlab-runner/)
## 🐳 Container Registries
* [Dockerhub - yobasystems/gitlab-runner](https://hub.docker.com/r/yobasystems/gitlab-runner/)
* [Quay.io - yobasystems/gitlab-runner](https://quay.io/repository/yobasystems/gitlab-runner)
## 🔗 Links
* [Yoba Systems](https://www.yobasystems.co.uk/)
* [Github - Yoba Systems](https://github.com/yobasystems/)
* [Dockerhub - Yoba Systems](https://hub.docker.com/u/yobasystems/)
* [Quay.io - Yoba Systems](https://quay.io/organization/yobasystems)
* [Maintainer - Dominic Taylor](https://github.com/dominictayloruk)
## 💰 Donation
[](https://www.buymeacoffee.com/dominictayloruk?new=1)
[](bitcoin:bc1q7hy8qmyvq7rw6slrna7yffcdnj9rcg4e9xjecc)
[](ethereum:0xb6bE2e4da3d86b50Bdae1F9B6960c23dd87C532C)