{"id":22766756,"url":"https://github.com/ls1intum/hades","last_synced_at":"2025-04-15T00:34:12.708Z","repository":{"id":196486371,"uuid":"692428065","full_name":"ls1intum/hades","owner":"ls1intum","description":"A flexible and stateless job scheduler / CI System ","archived":false,"fork":false,"pushed_at":"2025-04-14T13:55:27.000Z","size":671,"stargazers_count":8,"open_issues_count":19,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-14T14:57:15.654Z","etag":null,"topics":["ci","docker","golang","kubernetes","stateless"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ls1intum.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":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-09-16T12:54:59.000Z","updated_at":"2025-04-02T15:06:16.000Z","dependencies_parsed_at":null,"dependency_job_id":"7f07010b-31e8-4ea6-bedb-a5ae342420a2","html_url":"https://github.com/ls1intum/hades","commit_stats":null,"previous_names":["mtze/hades"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ls1intum%2Fhades","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ls1intum%2Fhades/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ls1intum%2Fhades/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ls1intum%2Fhades/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ls1intum","download_url":"https://codeload.github.com/ls1intum/hades/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248985671,"owners_count":21194003,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["ci","docker","golang","kubernetes","stateless"],"created_at":"2024-12-11T13:14:39.709Z","updated_at":"2025-04-15T00:34:12.682Z","avatar_url":"https://github.com/ls1intum.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# HadesCI: Scalable Continuous Integration for Programming Exercises\n\nWelcome to HadesCI, a robust Continuous Integration (CI) tool designed with scalability in mind. HadesCI's primary mission is to provide a straightforward, scalable, and adaptable CI solution tailored for executing build jobs in large-scale programming courses.\n\n## Design Goals\n\nHadesCI embodies several core design principles:\n\n- **Simplicity**: Unlike many other CI implementations, HadesCI focuses on delivering just the essentials required to execute build jobs efficiently.\n\n- **Scalability**: HadesCI has scalability at its core, capable of queuing and executing a vast number of build jobs in parallel, making it ideal for large-scale operations.\n\n- **Container-Based**: HadesCI executes build jobs within containers, ensuring a high level of isolation and security between jobs.\n\n- **Kubernetes Native**: As a Kubernetes-native solution, HadesCI leverages the power and flexibility of Kubernetes as its primary execution platform.\n\n- **Extensibility**: HadesCI is designed to be highly extensible, allowing for easy integration with other build execution platforms as needed.\n\n## Architecture\n\nHadesCI is built upon the following key components:\n\n- **API**: Serving as the main entry point, the API handles all incoming requests\n\n- **Queue**: The queue component is responsible for managing the queue of build jobs, ensuring efficient scheduling.\n\n- **Scheduler**: The scheduler orchestrates the execution of build jobs, coordinating with the executor components.\n\n  - **Docker Executor**: Designed for local development, the Docker executor is responsible for running build jobs within Docker containers.\n\n  - **Kubernetes Executor**: Intended for production use, the Kubernetes executor executes build jobs within a Kubernetes cluster.\n\n## Getting Started\n\n### Prerequisites\n\n- You need a kubeconfig file to connect to a Kubernetes cluster.\n- [Docker](https://docs.docker.com/get-docker/)\n- [Docker Compose](https://docs.docker.com/compose/install/)\n- [Kubectl](https://kubernetes.io/docs/tasks/tools/install-kubectl/)\n- [Minikube](https://minikube.sigs.k8s.io/docs/start/)\n\n### Running in Docker Mode\n\nTo run HadesCI in Docker mode, follow these steps:\n\n1. Copy the `.env.example` file to `.env`.\n   - The default is to use docker as the executor!\n   - Changes should not be necessary for a local test.\n2. Start the HadesCI services using Docker Compose\n\n```bash\ndocker-compose -f docker-compose.yml up -d\n```\n\n### Running in Kubernetes Mode\n\n\u003e We assume that you have a Kubernetes cluster running and a kubeconfig file to connect to it.\n\nTo run HadesCI in Kubernetes mode, follow these steps:\n\n1. Copy the `.env.example` file to `.env`.\n   - Change the `HADES_EXECUTOR` variable to `kubernetes`.\n2. Adjust the Kubeconfig volume mount in the `docker-compose.k8s.yml` file.\n3. Start the HadesCI services using Docker Compose\n\n```bash\ndocker-compose -f docker-compose.yml -f docker-compose.k8s.yml up -d\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fls1intum%2Fhades","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fls1intum%2Fhades","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fls1intum%2Fhades/lists"}