{"id":18465558,"url":"https://github.com/numtide/nits","last_synced_at":"2025-04-07T11:09:59.576Z","repository":{"id":174674188,"uuid":"639820555","full_name":"numtide/nits","owner":"numtide","description":"Nix \u0026 NATS ","archived":false,"fork":false,"pushed_at":"2024-10-31T11:36:01.000Z","size":17165,"stargazers_count":97,"open_issues_count":1,"forks_count":4,"subscribers_count":12,"default_branch":"main","last_synced_at":"2025-03-31T10:05:53.570Z","etag":null,"topics":["buildbot-numtide"],"latest_commit_sha":null,"homepage":"https://matrix.to/#/!YviWcpsjDGPidlhVRO:bmcgee.ie?via=bmcgee.ie\u0026via=matrix.org","language":"Go","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/numtide.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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-05-12T09:52:05.000Z","updated_at":"2025-02-27T21:06:55.000Z","dependencies_parsed_at":null,"dependency_job_id":"c8d2f0a6-3473-48c7-a8b0-cf0a232d1071","html_url":"https://github.com/numtide/nits","commit_stats":null,"previous_names":["numtide/nits"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/numtide%2Fnits","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/numtide%2Fnits/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/numtide%2Fnits/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/numtide%2Fnits/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/numtide","download_url":"https://codeload.github.com/numtide/nits/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247640465,"owners_count":20971557,"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":["buildbot-numtide"],"created_at":"2024-11-06T09:13:33.325Z","updated_at":"2025-04-07T11:09:59.559Z","avatar_url":"https://github.com/numtide.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n  \u003cbr\u003e\n  \u003cimg src=\"docs/assets/logo.png\" alt=\"logo\" width=\"200\"\u003e\n  \u003cbr\u003e\n  Nits — Nix \u0026 Nats\n  \u003cbr\u003e\n  \u003cbr\u003e\n\u003c/h1\u003e\n\n**Status: highly experimental**\n\n# Motivation\n\nThis project began as a directed learning exercise, taking everyday use cases and functionality from the world of [Nix](https://nixos.org) and seeing how to implement and integrate them with [NATS](https://nats.io).\n\nOver time this has evolved towards a specific use case: _pull-based orchestration of NixOS hosts_.\n\nSeveral options are already available for deploying NixOS across a series of hosts ([Colmena](https://github.com/zhaofengli/colmena), [deploy-rs](https://github.com/serokell/deploy-rs) et al.). However, these tools are inherently _push-based_, supporting _'online'_ deployments that require hosts to be contactable during rollout.\n\nIn some cases, it is desirable to have more of a _pull-based_ deployment, in which the system closure for a given host is updated ahead of time and applied when that host subsequently checks in. For example, you may have a series of devices deployed in an area with little network coverage.\n\nWe feel that NATS is a logical platform on top of which to build a pull-based deployment mechanism. As such, this project will work towards that goal, developing what is needed to meet it and see what valuable sub-components and side-projects may emerge along the way.\n\n# Usage\n\nThe project is currently in a state of rapid iteration. We will update this section and add more documentation when it has reached a steady state.\n\n# Preview\n\nIf an agent is connected, the deployment behaves much like a push-based system. Eventually, if the agent is not connected,\nwe will schedule a deployment for later.\n\nAgent logs are streamed into NATS and captured, allowing you to observe what the agent is doing in real-time or go back\nand have a look at the logs later.\n\n![](./docs/assets/deploy.gif)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnumtide%2Fnits","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnumtide%2Fnits","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnumtide%2Fnits/lists"}