{"repo":"poseidon/github-runner","free":true,"listed":false,"github":"https://github.com/poseidon/github-runner","clone":"git clone https://github.com/poseidon/github-runner.git","description":"GitHub Actions self-hosted runner container image that registers itself","language":"Go","stars":12,"topics":["github-actions","github-workflows"],"license":"MPL-2.0","category":"self-hosted-apps","readme_excerpt":"github-runner github-runner provides the GitHub Actions self-hosted runner as a container image that registers itself with GitHub. Features Minimalist, runners register themselves (no controller, no CRDs) Acts as a GitHub App to generate registration tokens Add org-level runners Use github-runner as a base image to customize Install languages needed for GitHub Workflows Add tools needed for GitHub Workflows Deregisters runner when the container/pod exits Background GitHub self-hosted runners allow you to run GitHub Actions Workflows in environments you manage on your own infrastructure. github-runner packages the GitHub runner along with a tool to fetch a runner registration token dynamically on container start by acting as a GitHub App. On Kubernetes, you can create a Deployment of github-runner (or descendant image) Pods, watch them register and run jobs. A runner Pod can run one job (\"ephemeral\") or be long-lived. Note: GitHub personal access tokens can also fetch runner registration tokens, but at most organizations, using a personal token or a robot user isn't an option. Usage Create a GitHub App for your account or organization. Use the links below to pre-fill fields where possible. Be sure to choose a unique app name (e.g. org-name/github-runner). GitHub App for your account GitHub App for your Organization Organization Permissions: Self-hosted runners (read/write) Note the App ID . Next, generate a private key . Finally, install your private GitHub App into your user ","default_branch":null,"files":null,"tree":[],"storefront":"/r/poseidon","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/poseidon/github-runner/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}