{"id":18611658,"url":"https://github.com/nhs-england-tools/github-runner-image","last_synced_at":"2026-04-28T17:35:22.808Z","repository":{"id":193766629,"uuid":"684698763","full_name":"nhs-england-tools/github-runner-image","owner":"nhs-england-tools","description":"🏃‍♂️📦 🐳 This repository offers a set of Docker base images for GitHub runners, optimised for performance, security and compatibility. It ensures smooth CI/CD workflows with GitHub Actions and includes pre-installed tools to speed up build and test processes.","archived":false,"fork":false,"pushed_at":"2024-06-14T12:30:36.000Z","size":406,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":7,"default_branch":"main","last_synced_at":"2025-05-16T23:33:46.461Z","etag":null,"topics":["automation","base-image","best-practices","ci-cd-pipeline","devops","docker-image","engineering","github-actions","nhs-digital","nhs-england"],"latest_commit_sha":null,"homepage":"","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nhs-england-tools.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-08-29T17:09:02.000Z","updated_at":"2024-06-14T12:30:40.000Z","dependencies_parsed_at":"2023-09-09T22:25:05.640Z","dependency_job_id":"d43e5b94-927e-4dff-9167-bcf645bc0d24","html_url":"https://github.com/nhs-england-tools/github-runner-image","commit_stats":null,"previous_names":["nhs-england-tools/github-runner-image"],"tags_count":0,"template":false,"template_full_name":"nhs-england-tools/repository-template","purl":"pkg:github/nhs-england-tools/github-runner-image","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nhs-england-tools%2Fgithub-runner-image","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nhs-england-tools%2Fgithub-runner-image/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nhs-england-tools%2Fgithub-runner-image/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nhs-england-tools%2Fgithub-runner-image/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nhs-england-tools","download_url":"https://codeload.github.com/nhs-england-tools/github-runner-image/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nhs-england-tools%2Fgithub-runner-image/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32392300,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-28T14:34:11.604Z","status":"ssl_error","status_checked_at":"2026-04-28T14:32:37.009Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","base-image","best-practices","ci-cd-pipeline","devops","docker-image","engineering","github-actions","nhs-digital","nhs-england"],"created_at":"2024-11-07T03:14:30.848Z","updated_at":"2026-04-28T17:35:22.780Z","avatar_url":"https://github.com/nhs-england-tools.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# GitHub Runner Image (PoC / Experimental)\n\n[![Publish](https://github.com/nhs-england-tools/github-runner-image/actions/workflows/cicd-2-publish.yaml/badge.svg)](https://github.com/nhs-england-tools/github-runner-image/actions/workflows/cicd-2-publish.yaml)\n[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=github-runner-image\u0026metric=alert_status)](https://sonarcloud.io/summary/new_code?id=github-runner-image)\n\nTODO: Overview \n\n## Table of Contents\n\n- [GitHub Runner Image (PoC / Experimental)](#github-runner-image-poc--experimental)\n  - [Table of Contents](#table-of-contents)\n  - [Setup](#setup)\n    - [Prerequisites](#prerequisites)\n    - [Installation](#installation)\n  - [Usage](#usage)\n    - [Testing](#testing)\n  - [Architecture](#architecture)\n    - [Diagrams](#diagrams)\n    - [Configuration](#configuration)\n  - [Contributing](#contributing)\n  - [Contacts](#contacts)\n  - [Licence](#licence)\n\n## Setup\n\nBy including preferably a one-liner or if necessary a set of clear CLI instructions we improve user experience. This should be a frictionless installation process that works on various operating systems (macOS, Linux, Windows WSL) and handles all the dependencies.\n\nClone the repository\n\n```shell\ngit clone https://github.com/nhs-england-tools/github-runner-image.git\ncd nhs-england-tools/github-runner-image\n```\n\n### Prerequisites\n\nThe following software packages or their equivalents are expected to be installed\n\n- [GNU make](https://www.gnu.org/software/make/) **v3.82 or later: OS X users, take note below**\n- [Docker](https://www.docker.com/)\n\nNote that the version of GNU Make available by default on OS X is earlier than this.  You will need to upgrade it, or certain `make` tasks will fail. On OS X, you will need [homebrew](https://brew.sh/) installed, then to install `make`, like so:\n\n```shell\n/bin/bash -c \"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)\"\nbrew install make\n```\n\nYou will then see instructions to fix your `$PATH` variable to make the newly installed version available.\nIf you are using [dotfiles](https://github.com/nhs-england-tools/dotfiles), this is all done for you.\n\n### Installation\n\nInstall and configure toolchain dependencies\n\n```shell\nmake config\n```\n\nIf this repository is\n\n```shell\n/bin/bash -c \"$(curl -fsSL https://raw.githubusercontent.com/org/repo/branch/install.sh)\"\n```\n\n## Usage\n\nAfter a successful installation, provide an informative example of how this project can be used. Additional code snippets, screenshots and demos work well in this space. You may also link to the other documentation resources, e.g. the [User Guide](./docs/user-guide.md) to demonstrate more use cases and to show more features.\n\n### Testing\n\nThere are `make` tasks for you to configure to run your tests. Run `make test` to see how they work.  You should be able to use the same entry points for local development as in your CI pipeline.\n\n## Architecture\n\n### Diagrams\n\n```mermaid\nC4Container\n  Boundary(b1, \"Foundation Images\", \"\") {\n    Component(base_image, \"Base Image\", \"System dependencies, Development tools, Docker, Node.js\", \"Provides the base packages for all the images built on top of it\")\n    Component(gh_act_image, \"GitHub Base Image\", \"Development dependencies and tools\", \"Builds on top of the base image adding GitHub specific packages\")\n    Component(gh_aws_image, \"GitHub AWS\", \"AWS development dependencies and tools\", \"This base image comes with packages and tools\u003cbr\u003ewhich make it compatible with the AWS cloud services\")\n    Component(gh_azure_image, \"GitHub Azure\", \"Azure development dependencies and tools\", \"This base image comes with packages and tools\u003cbr\u003ewhich make it compatible with the Azure cloud services\")\n  }\n  Boundary(b2, \"Service Images\", \"\") {\n    Component_Ext(service_image, \"Service Image\", \"Service dependencies and tools\", \"Preloads all the build and test dependencies\u003cbr\u003e which are used in the CI/CD pipeline\")\n  }\n  Rel(gh_act_image, base_image, \"Is built from\")\n  Rel(gh_aws_image, gh_act_image, \"Is built from\")\n  Rel(gh_azure_image, gh_act_image, \"Is built from\")\n  Rel(service_image, gh_aws_image, \"Is built from\")\n  UpdateLayoutConfig($c4ShapeInRow=\"2\", $c4BoundaryInRow=\"1\")\n```\n\n### Configuration\n\nMost of the projects are built with customisability and extendability in mind. At a minimum, this can be achieved by implementing service level configuration options and settings. The intention of this section is to show how this can be used. If the system processes data, you could mention here for example how the input is prepared for testing - anonymised, synthetic or live data.\n\n## Contributing\n\nDescribe or link templates on how to raise an issue, feature request or make a contribution to the codebase. Reference the other documentation files, like\n\n- Environment setup for contribution, i.e. `CONTRIBUTING.md`\n- Coding standards, branching, linting, practices for development and testing\n- Release process, versioning, changelog\n- Backlog, board, roadmap, ways of working\n- High-level requirements, guiding principles, decision records, etc.\n\n## Contacts\n\nProvide a way to contact the owners of this project. It can be a team, an individual or information on the means of getting in touch via active communication channels, e.g. opening a GitHub discussion, raising an issue, etc.\n\n## Licence\n\n\u003e The [LICENCE.md](./LICENCE.md) file will need to be updated with the correct year and owner\n\nUnless stated otherwise, the codebase is released under the MIT License. This covers both the codebase and any sample code in the documentation.\n\nAny HTML or Markdown documentation is [© Crown Copyright](https://www.nationalarchives.gov.uk/information-management/re-using-public-sector-information/uk-government-licensing-framework/crown-copyright/) and available under the terms of the [Open Government Licence v3.0](https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnhs-england-tools%2Fgithub-runner-image","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnhs-england-tools%2Fgithub-runner-image","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnhs-england-tools%2Fgithub-runner-image/lists"}