https://github.com/odavid/jenkins-jnlp-slave

A JNLP Slave that enables docker build and fixes volume permissions on startup
https://github.com/odavid/jenkins-jnlp-slave

docker jenkins jnlp

Last synced: about 2 months ago
JSON representation

A JNLP Slave that enables docker build and fixes volume permissions on startup

• Host: GitHub
• URL: https://github.com/odavid/jenkins-jnlp-slave
• Owner: odavid
• License: mit
• Created: 2017-11-21T10:49:39.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2023-06-28T16:15:11.000Z (over 1 year ago)
• Last Synced: 2024-10-14T08:07:17.696Z (2 months ago)
• Topics: docker, jenkins, jnlp
• Language: Shell
• Size: 50.8 KB
• Stars: 31
• Watchers: 3
• Forks: 37
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
# Jenkins JNLP Agent Docker image

![Build Status](https://github.com/odavid/my-bloody-jenkins/workflows/main/badge.svg)

[![Docker Pulls](https://img.shields.io/docker/pulls/odavid/jenkins-jnlp-slave.svg)](https://hub.docker.com/r/odavid/jenkins-jnlp-slave/)

[![Changelog](https://img.shields.io/github/v/tag/odavid/jenkins-jnlp-slave?label=changelog)](https://github.com/odavid/jenkins-jnlp-slave/blob/master/CHANGELOG.md)

This image is based on https://github.com/jenkinsci/docker-inbound-agent image and fixes permissions issues with volumes created by docker.

The image also contains docker binary and able to mount /var/run/docker.sock to enable the slave to run docker commands on the slave.

The default tag of the image is based on alpine and installs also glibc to enable Oracle JDK installations. (see https://github.com/gliderlabs/docker-alpine/issues/11)

The immage support running docker commands in slave in 2 different modes:

* By mounting the host's /var/run/docker.sock inside the slave.

  * docker commands are running on the host's docker daemon.

  * Containers and images built by the slave are not cleaned up.

  * Cannot mount volumes from the slave's workspace - i.e hard to use docker-compose

* By using *Docker Inside Docker* - requires `privileged` container and passing `DIND=true` variable.

  * docker commands are running within the slave's docker daemon.

  * Containers and images built by the slave are cleaned up directly after slave finishes the build.

  * Ability to mount volumes from the slave's workspace - native usage of docker-compose

## Environment Variables

|Name|Description|

-----|------------

`DIND` | If `true`, then the slave will run *docker inside docker* - Requires `privileged` container

For other environment variables, see https://github.com/jenkinsci/docker-inbound-agent

## Releases

Docker Images are pushed to [Docker Hub](https://hub.docker.com/r/odavid/jenkins-jnlp-slave/)

Each release is a git tag v$UPSTREAM_VERSION-$INCREMENT where:

* UPSRTEAM_VERSION is the [docker-inbound-agent](https://github.com/jenkinsci/docker-inbound-agent) version

* INCREMENT is a number representing that representing the release contents (i.e docker version, bugs, etc...)

For each git tag, there following tags will be created:

* $UPSRTEAM_VERSION-$INCREMENT - one to one releationship with git tag

* $UPSRTEAM_VERSION - latest release for that UPSRTEAM_VERSION version

The following distributions are supported:

* alpine (also the default)

* debian

* jdk11

* jdk17