{"id":44235400,"url":"https://github.com/canonical/github-runner-image-builder-operator","last_synced_at":"2026-04-02T19:24:07.410Z","repository":{"id":260503454,"uuid":"786707869","full_name":"canonical/github-runner-image-builder-operator","owner":"canonical","description":"github-runner-image-builder-operator - charm repository.","archived":false,"fork":false,"pushed_at":"2026-03-30T23:28:40.000Z","size":96901,"stargazers_count":1,"open_issues_count":16,"forks_count":2,"subscribers_count":5,"default_branch":"main","last_synced_at":"2026-03-31T01:36:09.784Z","etag":null,"topics":["charm","platform-engineering","product-self-hosted-github-runner","squad-apac"],"latest_commit_sha":null,"homepage":"https://charmhub.io/github-runner-image-builder","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/canonical.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-04-15T06:42:47.000Z","updated_at":"2026-03-27T10:44:16.000Z","dependencies_parsed_at":"2026-02-17T12:01:25.752Z","dependency_job_id":null,"html_url":"https://github.com/canonical/github-runner-image-builder-operator","commit_stats":null,"previous_names":["canonical/github-runner-image-builder-operator"],"tags_count":132,"template":false,"template_full_name":null,"purl":"pkg:github/canonical/github-runner-image-builder-operator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/canonical%2Fgithub-runner-image-builder-operator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/canonical%2Fgithub-runner-image-builder-operator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/canonical%2Fgithub-runner-image-builder-operator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/canonical%2Fgithub-runner-image-builder-operator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/canonical","download_url":"https://codeload.github.com/canonical/github-runner-image-builder-operator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/canonical%2Fgithub-runner-image-builder-operator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31314375,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T12:59:32.332Z","status":"ssl_error","status_checked_at":"2026-04-02T12:54:48.875Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: 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":["charm","platform-engineering","product-self-hosted-github-runner","squad-apac"],"created_at":"2026-02-10T09:18:24.287Z","updated_at":"2026-04-02T19:24:07.396Z","avatar_url":"https://github.com/canonical.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!-- vale Canonical.007-Headings-sentence-case = NO --\u003e\n# GitHub runner image builder operator\n\u003c!-- vale Canonical.007-Headings-sentence-case = YES --\u003e\n\u003c!-- Use this space for badges --\u003e\n\nA Juju charm that provides the GitHub runner workload embedded snapshot image to the \n[GitHub runner](https://charmhub.io/github-runner) charm. This charm is deployed as a VM and works\non top of OpenStack infrastructure.\n\nLike any Juju charm, this charm supports one-line deployment, configuration, integration, scaling,\nand more. For Charmed GitHub runner image builder, this includes support for configuring:\n* Multi-arch\n* Multi Ubuntu bases\n* Juju/MicroK8s snap channels\n* External scripts\n\nFor information about how to deploy, integrate, and manage this charm, see the Official \n[CharmHub Documentation](https://charmhub.io/github-runner-image-builder).\n\n## Get started\n\u003c!--Briefly summarize what the user will achieve in this guide.--\u003e\nDeploy GitHub runner image builder with GitHub runners.\n\n\u003c!--Indicate software and hardware prerequisites--\u003e\nYou'll need a working [OpenStack installation](https://microstack.run/docs/single-node) with\nflavors with a minimum of 2 CPU cores, 8GB RAM and 10GB disk.\n\n### Set up\n\nFollow [MicroStack's single-node](https://microstack.run/docs/single-node) starting guide to set \nup MicroStack.\n\nFollow the [tutorial on GitHub runner](https://charmhub.io/github-runner) to deploy the GitHub\nrunner.\n\n### Deploy\n\nDeploy the charm.\n\n```\njuju deploy github-runner-image-builder \\\n--config experimental-external-build=True \\\n--config experimental-external-build-network=\u003cOPENSTACK-NETWORK-NAME\u003e \\\n--config openstack-auth-url=\u003cOPENSTACK-AUTH-URL\u003e \\\n--config openstack-password=\u003cOPENSTACK-PASSWORD\u003e \\\n--config openstack-project-domain-name=\u003cOPENSTACK-PROJECT-DOMAIN-NAME\u003e \\\n--config openstack-project-name=\u003cOPENSTACK-PROJECT-NAME\u003e \\\n--config openstack-user-name=\u003cOPENSTACK-USER-NAME\u003e\n\njuju integrate github-runner-image-builder github-runner\n```\n\n### Basic operations\n\u003c!--Brief walkthrough of performing standard configurations or operations--\u003e\n\nAfter having deployed and integrated the charm with the GitHub runner charm, the image should start\nto build and be provided to the GitHub runner automatically. The whole process takes around 10\nminutes.\n\n## Integrations\n\u003c!-- Information about particularly relevant interfaces, endpoints or libraries related to the charm. For example, peer relation endpoints required by other charms for integration.--\u003e \n* image: The image relation provides the OpenStack image ID to the GitHub runners.\n* cos-agent: The COS agent subordinate charm provides observability using the Canonical\nObservability Stack (COS).\n\nFor a full list of integrations, please refer to the [Charmhub documentation](https://charmhub.io/github-runner-image-builder/integrations).\n\n## Repository structure\n\nThis repository contains the charm in the root directory and the `github-runner-image-builder`\napplication in the `app` directory. Refer to [Contributing](CONTRIBUTING.md) for more information.\n\n## Learn more\n* [Read more](https://charmhub.io/github-runner-image-builder) \u003c!--Link to the charm's official documentation--\u003e\n* [Developer documentation](https://github.com/canonical/github-runner-image-builder-operator/blob/main/CONTRIBUTING.md) \u003c!--Link to any developer documentation--\u003e\n* [Troubleshooting](https://matrix.to/#/#charmhub-charmdev:ubuntu.com)\n\n## Project and community\n* [Issues](https://github.com/canonical/github-runner-image-builder-operator/issues) \u003c!--Link to GitHub issues (if applicable)--\u003e\n* [Contributing](https://github.com/canonical/github-runner-image-builder-operator/blob/main/CONTRIBUTING.md) \u003c!--Link to any contribution guides--\u003e \n* [Matrix](https://matrix.to/#/#charmhub-charmdev:ubuntu.com) \u003c!--Link to contact info (if applicable), e.g. Matrix channel--\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcanonical%2Fgithub-runner-image-builder-operator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcanonical%2Fgithub-runner-image-builder-operator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcanonical%2Fgithub-runner-image-builder-operator/lists"}