Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
6213d66bcd | ||
|
|
1d5a155cc2 | ||
|
|
a12ceeb0dd | ||
|
|
ca70d18293 | ||
|
|
06d8f4625d | ||
|
|
a1281ef45c | ||
|
|
9201778fad | ||
|
|
bff29ac494 | ||
|
|
e4be4ad005 | ||
|
|
10017089e9 | ||
|
|
fa1de4a811 | ||
|
|
e17bf4910b | ||
|
|
d72e997be8 | ||
|
|
76b0b01565 | ||
|
|
42929b8d14 | ||
|
|
594be32236 | ||
|
|
952fa6436d | ||
|
|
df396afc51 | ||
|
|
5ab9c36182 | ||
|
|
123a06f31f | ||
|
|
fa889767b2 | ||
|
|
04f0651b9f | ||
|
|
b7f8c8ffe7 | ||
|
|
bb7c15e231 | ||
|
|
bdfbe31f59 | ||
|
|
3e7ea713b6 | ||
|
|
731f9b4d35 | ||
|
|
6171bd339f | ||
|
|
8b2f017591 |
+4
-1
@@ -2,7 +2,10 @@
|
||||
FROM myoung34/github-runner-base:latest
|
||||
LABEL maintainer="myoung34@my.apsu.edu"
|
||||
|
||||
ARG GH_RUNNER_VERSION="2.273.5"
|
||||
ENV AGENT_TOOLSDIRECTORY=/opt/hostedtoolcache
|
||||
RUN mkdir -p /opt/hostedtoolcache
|
||||
|
||||
ARG GH_RUNNER_VERSION="2.274.1"
|
||||
ARG TARGETPLATFORM
|
||||
|
||||
SHELL ["/bin/bash", "-o", "pipefail", "-c"]
|
||||
|
||||
+2
-2
@@ -1,11 +1,11 @@
|
||||
FROM ubuntu:focal
|
||||
LABEL maintainer="myoung34@my.apsu.edu"
|
||||
|
||||
ARG GIT_VERSION="2.26.2"
|
||||
ARG GIT_VERSION="2.29.0"
|
||||
ARG DUMB_INIT_VERSION="1.2.2"
|
||||
ARG DOCKER_KEY="7EA0A9C3F273FCD8"
|
||||
|
||||
ENV DOCKER_COMPOSE_VERSION="1.26.2"
|
||||
ENV DOCKER_COMPOSE_VERSION="1.27.4"
|
||||
|
||||
SHELL ["/bin/bash", "-o", "pipefail", "-c"]
|
||||
ENV DEBIAN_FRONTEND=noninteractive
|
||||
|
||||
@@ -29,6 +29,7 @@ These containers are built via Github actions that [copy the dockerfile](https:/
|
||||
| `REPO_URL` | If using a non-organization runner this is the full repository url to register under such as 'https://github.com/myoung34/repo' |
|
||||
| `RUNNER_TOKEN` | If not using a PAT for `ACCESS_TOKEN` this will be the runner token provided by the Add Runner UI (a manual process). Note: This token is short lived and will change frequently. `ACCESS_TOKEN` is likely preferred. |
|
||||
| `RUNNER_WORKDIR` | The working directory for the runner. Runners on the same host should not share this directory. Default is '/_work'. This must match the source path for the bind-mounted volume at RUNNER_WORKDIR, in order for container actions to access files. |
|
||||
| `RUNNER_GROUP` | Name of the runner group to add this runner to (defaults to the default runner group) |
|
||||
|
||||
## Examples ##
|
||||
|
||||
@@ -38,12 +39,13 @@ If you're using a RHEL based OS with SELinux, add `--security-opt=label=disable`
|
||||
|
||||
### Manual ###
|
||||
|
||||
```
|
||||
# org runner
|
||||
```shell
|
||||
# org runner
|
||||
docker run -d --restart always --name github-runner \
|
||||
-e RUNNER_NAME_PREFIX="myrunner" \
|
||||
-e ACCESS_TOKEN="footoken" \
|
||||
-e RUNNER_WORKDIR="/tmp/github-runner-your-repo" \
|
||||
-e RUNNER_GROUP="my-group" \
|
||||
-e ORG_RUNNER="true" \
|
||||
-e ORG_NAME="octokode" \
|
||||
-e LABELS="my-label,other-label" \
|
||||
@@ -56,6 +58,7 @@ docker run -d --restart always --name github-runner \
|
||||
-e RUNNER_NAME="foo-runner" \
|
||||
-e RUNNER_TOKEN="footoken" \
|
||||
-e RUNNER_WORKDIR="/tmp/github-runner-your-repo" \
|
||||
-e RUNNER_GROUP="my-group" \
|
||||
-v /var/run/docker.sock:/var/run/docker.sock \
|
||||
-v /tmp/github-runner-your-repo:/tmp/github-runner-your-repo \
|
||||
myoung34/github-runner:latest
|
||||
@@ -63,7 +66,7 @@ docker run -d --restart always --name github-runner \
|
||||
|
||||
Or shell wrapper:
|
||||
|
||||
```
|
||||
```shell
|
||||
function github-runner {
|
||||
name=github-runner-${1//\//-}
|
||||
org=$(dirname $1)
|
||||
@@ -75,6 +78,7 @@ function github-runner {
|
||||
-e RUNNER_TOKEN="$2" \
|
||||
-e RUNNER_NAME="linux-${repo}" \
|
||||
-e RUNNER_WORKDIR="/tmp/github-runner-${repo}" \
|
||||
-e RUNNER_GROUP="my-group" \
|
||||
-e LABELS="my-label,other-label" \
|
||||
-v /var/run/docker.sock:/var/run/docker.sock \
|
||||
-v /tmp/github-runner-${repo}:/tmp/github-runner-${repo} \
|
||||
@@ -86,18 +90,19 @@ github-runner your-account/some-other-repo ARGHANOTHERGITHUBACTIONSTOKEN ubuntu-
|
||||
```
|
||||
|
||||
Or `docker-compose.yml`:
|
||||
|
||||
```yml
|
||||
version: '2.3'
|
||||
|
||||
services:
|
||||
worker:
|
||||
build: .
|
||||
image: myoung34/github-runner:latest
|
||||
environment:
|
||||
REPO_URL: https://github.com/example/repo
|
||||
RUNNER_NAME: example-name
|
||||
RUNNER_TOKEN: someGithubTokenHere
|
||||
RUNNER_WORKDIR: /tmp/runner/work
|
||||
RUNNER_GROUP: my-group
|
||||
ORG_RUNNER: 'false'
|
||||
LABELS: linux,x64,gpu
|
||||
security_opt:
|
||||
@@ -106,14 +111,14 @@ services:
|
||||
volumes:
|
||||
- '/var/run/docker.sock:/var/run/docker.sock'
|
||||
- '/tmp/runner:/tmp/runner'
|
||||
# note: a quirk of docker-in-docker is that this path
|
||||
# note: a quirk of docker-in-docker is that this path
|
||||
# needs to be the same path on host and inside the container,
|
||||
# docker mgmt cmds run outside of docker but expect the paths from within
|
||||
```
|
||||
|
||||
### Nomad ###
|
||||
|
||||
```
|
||||
```hcl
|
||||
job "github_runner" {
|
||||
datacenters = ["home"]
|
||||
type = "system"
|
||||
@@ -125,6 +130,7 @@ job "github_runner" {
|
||||
ACCESS_TOKEN = "footoken"
|
||||
RUNNER_NAME_PREFIX = "myrunner" \
|
||||
RUNNER_WORKDIR = "/tmp/github-runner-your-repo"
|
||||
RUNNER_GROUP = "my-group"
|
||||
ORG_RUNNER = "true"
|
||||
ORG_NAME = "octokode"
|
||||
LABELS = "my-label,other-label"
|
||||
@@ -144,7 +150,7 @@ job "github_runner" {
|
||||
|
||||
### Kubernetes ###
|
||||
|
||||
```
|
||||
```yml
|
||||
apiVersion: apps/v1
|
||||
kind: Deployment
|
||||
metadata:
|
||||
@@ -172,7 +178,7 @@ spec:
|
||||
image: myoung34/github-runner:latest
|
||||
env:
|
||||
- name: ORG_RUNNER
|
||||
value: true
|
||||
value: "true"
|
||||
- name: ORG_NAME
|
||||
value: octokode
|
||||
- name: LABELS
|
||||
@@ -189,6 +195,8 @@ spec:
|
||||
fieldPath: metadata.name
|
||||
- name: RUNNER_WORKDIR
|
||||
value: /tmp/github-runner-your-repo
|
||||
- name: RUNNER_GROUP
|
||||
value: my-group
|
||||
volumeMounts:
|
||||
- name: dockersock
|
||||
mountPath: /var/run/docker.sock
|
||||
@@ -198,7 +206,7 @@ spec:
|
||||
|
||||
## Usage From GH Actions Workflow ##
|
||||
|
||||
```
|
||||
```yml
|
||||
name: Package
|
||||
|
||||
on:
|
||||
@@ -218,11 +226,12 @@ jobs:
|
||||
|
||||
A runner token can be automatically acquired at runtime if `ACCESS_TOKEN` (a GitHub personal access token) is a supplied. This uses the [GitHub Actions API](https://developer.github.com/v3/actions/self_hosted_runners/#create-a-registration-token). e.g.:
|
||||
|
||||
```
|
||||
```shell
|
||||
docker run -d --restart always --name github-runner \
|
||||
-e ACCESS_TOKEN="footoken" \
|
||||
-e RUNNER_NAME="foo-runner" \
|
||||
-e RUNNER_WORKDIR="/tmp/github-runner-your-repo" \
|
||||
-e RUNNER_GROUP="my-group" \
|
||||
-e ORG_RUNNER="true" \
|
||||
-e ORG_NAME="octokode" \
|
||||
-e LABELS="my-label,other-label" \
|
||||
@@ -242,5 +251,5 @@ Creating GitHub personal access token (PAT) for using by self-hosted runner make
|
||||
* admin:org_hook
|
||||
* notifications
|
||||
* workflow
|
||||
|
||||
|
||||
Also, when creating a PAT for self-hosted runner which will process events from several repositories of the particular organization, create the PAT using organization owner account. Otherwise your new PAT will not have sufficient privileges for all repositories.
|
||||
|
||||
@@ -14,6 +14,7 @@ deregister_runner() {
|
||||
_RUNNER_NAME=${RUNNER_NAME:-${RUNNER_NAME_PREFIX:-github-runner}-$(head /dev/urandom | tr -dc A-Za-z0-9 | head -c 13 ; echo '')}
|
||||
_RUNNER_WORKDIR=${RUNNER_WORKDIR:-/_work}
|
||||
_LABELS=${LABELS:-default}
|
||||
_RUNNER_GROUP=${RUNNER_GROUP:-Default}
|
||||
_SHORT_URL=${REPO_URL}
|
||||
|
||||
if [[ ${ORG_RUNNER} == "true" ]]; then
|
||||
@@ -33,6 +34,7 @@ echo "Configuring"
|
||||
--name "${_RUNNER_NAME}" \
|
||||
--work "${_RUNNER_WORKDIR}" \
|
||||
--labels "${_LABELS}" \
|
||||
--runnergroup "${_RUNNER_GROUP}" \
|
||||
--unattended \
|
||||
--replace
|
||||
|
||||
|
||||
Reference in New Issue
Block a user