https://github.com/drevops/ci-runner
🏃♂️ Docker image for CI job runner container
https://github.com/drevops/ci-runner
Last synced: 3 months ago
JSON representation
🏃♂️ Docker image for CI job runner container
- Host: GitHub
- URL: https://github.com/drevops/ci-runner
- Owner: drevops
- License: gpl-3.0
- Created: 2018-02-02T13:49:36.000Z (over 8 years ago)
- Default Branch: main
- Last Pushed: 2025-02-12T10:16:38.000Z (over 1 year ago)
- Last Synced: 2025-02-19T20:12:42.983Z (over 1 year ago)
- Language: Dockerfile
- Homepage:
- Size: 118 KB
- Stars: 4
- Watchers: 2
- Forks: 5
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
Docker image for CI runner
[](https://github.com/drevops/ci-runner/actions/workflows/test.yml)
[](https://github.com/DrevOps/ci-runner/issues)
[](https://github.com/DrevOps/ci-runner/pulls)
[](https://hub.docker.com/r/drevops/ci-runner)
[](https://github.com/drevops/vortex)
---
Based on Debian `php:8.4-cli-bookworm`.
## Included packages
- [aspell](http://aspell.net): `3.1.20`
- [Bats](https://github.com/bats-core/bats-core): `1.13.0`
- [Composer](https://getcomposer.org): `2.9.5`
- [Codecov](https://codecov.io): `0.8.0`
- [curl](https://curl.se): `7.88.1`
- [Docker](https://www.docker.com): `28.5.2`
- [Docker Buildx](https://github.com/docker/buildx): `0.32.1`
- [Docker Compose](https://docs.docker.com/compose): `5.1.0`
- [Git](https://git-scm.com): `2.39.5`
- [GnuPG](https://gnupg.org): `2.2.40`
- [jq](https://jqlang.github.io/jq): `1.6`
- [kcov](https://github.com/SimonKagstrom/kcov): `43`
- [lsof](https://github.com/lsof-org/lsof): `4.95.0`
- [Lynx](https://lynx.invisible-island.net): `2.9.0`
- [Node.js](https://nodejs.org): `24.14.0`
- [npm](https://www.npmjs.com): `11.9.0`
- [npx](https://www.npmjs.com/package/npx): `11.9.0`
- [PHP](https://www.php.net): `8.4.19`
- [rsync](https://rsync.samba.org): `3.2.7`
- [ShellCheck](https://www.shellcheck.net): `0.11.0`
- [shfmt](https://github.com/mvdan/sh): `3.13.0`
- [OpenSSH](https://www.openssh.com): `9.2`
- [tree](http://mama.indstate.edu/users/ice/tree): `2.1.0`
- [UnZip](http://www.info-zip.org/UnZip.html): `6.00`
- [Vim](https://www.vim.org): `9.0`
- [Yarn](https://yarnpkg.com): `1.22.22`
- [Zip](http://www.info-zip.org/Zip.html): `3.0`
## Usage
Make sure to **always** pin the version of this image to the tag:
```
drevops/ci-runner:25.1.0
```
For testing purposes, you can use the `canary` tag:
```
drevops/ci-runner:canary
```
When using in GitHub Actions, make sure to add a fix for the overwritten `$HOME`:
```
name: Test
jobs:
test:
runs-on: ubuntu-latest
container:
image: drevops/ci-runner:25.8.0
steps:
- name: Preserve $HOME set in the container
run: echo HOME=/root >> "$GITHUB_ENV" # https://github.com/actions/runner/issues/863
- name: Check out the repo
uses: actions/checkout@v5
```
## Testing
The image includes [Goss](https://github.com/aelsabbahy/goss) for environment testing. To run tests locally using dgoss:
```bash
# Build the image
docker build -t drevops/ci-runner:test-ci .
# Run tests
dgoss run -i drevops/ci-runner:test-ci
```
**Note for ARM64 systems (Apple Silicon):** You'll need to install the correct goss binaries:
```bash
# Create bin directory
mkdir -p ~/bin
# Download macOS ARM64 goss binary for local use
curl -L "https://github.com/aelsabbahy/goss/releases/latest/download/goss-darwin-arm64" -o ~/bin/goss
chmod +x ~/bin/goss
# Download Linux AMD64 goss binary for container testing
curl -L "https://github.com/aelsabbahy/goss/releases/latest/download/goss-linux-amd64" -o ~/bin/goss-linux-amd64
chmod +x ~/bin/goss-linux-amd64
# Download dgoss wrapper
curl -L "https://github.com/aelsabbahy/goss/releases/latest/download/dgoss" -o ~/bin/dgoss
chmod +x ~/bin/dgoss
# Run tests with correct binary
export GOSS_PATH=~/bin/goss-linux-amd64
~/bin/dgoss run -i drevops/ci-runner:test-ci
```
## Maintenance and releasing
### Versioning
This project uses _Year-Month-Patch_ versioning:
- `YY`: Last two digits of the year, e.g., `23` for 2023.
- `m`: Numeric month, e.g., April is `4`.
- `patch`: Patch number for the month, starting at `0`.
Example: `23.4.2` indicates the third patch in April 2023.
### Releasing
Releases are scheduled to occur at a minimum of once per month.
This image is built by DockerHub via an automated build and tagged as follows:
- `YY.m.patch` tag - when release tag is published on GitHub.
- `latest` - when release tag is published on GitHub.
- `canary` - on every push to `main` branch
### Dependencies update
Renovate bot is used to update dependencies. It creates a PR with the changes
and automatically merges it if CI passes. These changes are then released as
a `canary` version.
---
_This repository was created using the [Scaffold](https://getscaffold.dev/) project template_