Skip to content

Commit

Permalink
make docs consistent by pointing to checked-in file. Related to #30
Browse files Browse the repository at this point in the history
  • Loading branch information
davidkarlsen committed May 29, 2020
1 parent 40faab2 commit a3f48ca
Showing 1 changed file with 5 additions and 84 deletions.
89 changes: 5 additions & 84 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,90 +9,7 @@ is a way to host your own runners and customize the environment used to run jobs

This operator helps you schedule runners on-demand in a declarative way.

## CRD

Declare a resource like this:
```yaml
apiVersion: "garo.tietoevry.com/v1alpha1"
kind: GithubActionRunner
metadata:
name: runner
spec:
# minimum amount of runners that should be available
minRunners: 1
# maximum amount of runners that should be available
maxRunners: 1
# the GitHub organization name, from https://github.com/yourGithubOrgId
organization: yourGithubOrgId
# reference to secret in same namespace containing the token for GitHub, needs org-level scope
tokenRef:
# name of secret
name: github-token
# key within secret holding the value
key: GH_TOKEN
# a podspec like you wish for the runners.
# the spec here will run the one from https://github.com/evryfs/github-actions-runner as the runner,
# with a companion dind (Docker In Docker) container.
podSpec:
containers:
- env:
- name: RUNNER_DEBUG
value: "true"
- name: DOCKER_TLS_CERTDIR
value: /certs
- name: DOCKER_HOST
value: tcp://localhost:2376
- name: DOCKER_TLS_VERIFY
value: "1"
- name: DOCKER_CERT_PATH
value: /certs/client
- name: GH_ORG
value: yourGithubOrgId
envFrom:
- secretRef:
name: github-token
image: quay.io/evryfs/github-actions-runner:latest
imagePullPolicy: Always
lifecycle:
preStop:
exec:
command:
- /bin/bash
- -c
- /remove_runner.sh
name: runner
resources: {}
volumeMounts:
- mountPath: /certs
name: docker-certs
- mountPath: /settings-xml
name: settings-xml
- env:
- name: DOCKER_TLS_CERTDIR
value: /certs
image: docker:stable-dind
imagePullPolicy: Always
name: docker
resources: {}
securityContext:
privileged: true
volumeMounts:
- mountPath: /var/lib/docker
name: docker-storage
- mountPath: /certs
name: docker-certs
volumes:
- emptyDir: {}
name: docker-storage
- emptyDir: {}
name: docker-certs
- configMap:
defaultMode: 420
name: settings-xml
name: settings-xml
```
## Helm-chart
## Helm-chart based install

Helm3 chart is available from [our existing helm repo](https://github.com/evryfs/helm-charts).

Expand All @@ -102,6 +19,10 @@ kubectl create namespace github-actions-runner-operator
helm install github-actions-runner-operator evryfs-oss/github-actions-runner-operator --namespace github-actions-runner-operator
```

## CRD

Declare a resource like [in the example](deploy/crds/garo.tietoevry.com_v1alpha1_githubactionrunner_cr.yaml)

## Missing parts and weaknesses

* Github's runner-api only exposes the on/off-line status, not if the runner is occupied with a job,
Expand Down

0 comments on commit a3f48ca

Please sign in to comment.