{"id":21296891,"url":"https://github.com/reddec/nano-run","last_synced_at":"2025-10-26T05:32:49.224Z","repository":{"id":81702618,"uuid":"294373195","full_name":"reddec/nano-run","owner":"reddec","description":"Lightweight request runner","archived":false,"fork":false,"pushed_at":"2020-12-08T12:18:42.000Z","size":365,"stargazers_count":17,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-07-02T11:02:02.484Z","etag":null,"topics":["docker","infrastructure-as-code"],"latest_commit_sha":null,"homepage":"","language":"Go","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/reddec.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","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},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":["http://reddec.net/about/#donate"]}},"created_at":"2020-09-10T10:07:41.000Z","updated_at":"2024-04-10T13:29:13.000Z","dependencies_parsed_at":null,"dependency_job_id":"5734898b-3da0-4e27-96f5-9c59ff9ffc03","html_url":"https://github.com/reddec/nano-run","commit_stats":null,"previous_names":[],"tags_count":16,"template":false,"template_full_name":null,"purl":"pkg:github/reddec/nano-run","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/reddec%2Fnano-run","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/reddec%2Fnano-run/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/reddec%2Fnano-run/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/reddec%2Fnano-run/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/reddec","download_url":"https://codeload.github.com/reddec/nano-run/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/reddec%2Fnano-run/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264870453,"owners_count":23676234,"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":["docker","infrastructure-as-code"],"created_at":"2024-11-21T14:30:29.996Z","updated_at":"2025-10-26T05:32:49.166Z","avatar_url":"https://github.com/reddec.png","language":"Go","funding_links":["http://reddec.net/about/#donate"],"categories":[],"sub_categories":[],"readme":"# Nano-Run\n\n![nano-run](https://user-images.githubusercontent.com/6597086/97143787-4f70db80-179e-11eb-9b9c-7e16bfff845e.png)\n\nLightweight async request runner. GitOps friendly.\n\nA simplified version of [trusted-cgi](https://github.com/reddec/trusted-cgi) designed\nfor async processing extreme amount of requests.\n\nMain goals:\n\n* Should have semi-constant resource consumption regardless of: \n  * number of requests,\n  * size of requests,\n  * kind of requests;\n* Should be ready to run without configuration;\n* Should be ready for deploying in clouds;\n* Should support extending for another providers;\n* Can be used as library and as a complete solution;\n* **Performance (throughput/latency) has less priority** than resource usage.\n\nPlease note that the project is being developed in free time, as a non-profitable hobby project. \nAll codes, bugs, opinions, and other related subjects should not be considered as the official position, official project,\nor company-backed project to any of the companies for/with which I worked before or/and at present.   \n\nTODO:\n\n* On attempt failed job\n* On failed job\n* On success job\n* Per endpoint swagger\n* Pickup file as an artifact\n\n\n![sample-nano-run](https://user-images.githubusercontent.com/6597086/98463432-303e6900-21f6-11eb-9632-806b1c99813b.gif)\n\n## Documentation\n\n* [Installation](#installation)\n* [Quick start](#quick-start)\n* [Architecture overview](_docs/flow.md)\n* [API](_docs/api.md)\n* [API Authorization](_docs/authorization.md)\n* [UI](_docs/ui.md)\n* [UI Authorization](_docs/ui_authorization.md)\n* [Unit configuration](_docs/unit.md)\n* [Docker](_docs/docker.md)\n* [Cron-like scheduler](_docs/cron.md)\n\n## Stability\n\n(After 1.0.0)\n\nWe are trying to follow semver:\n\n* Patch releases provides fixes or light improvements without migration\n* Minor releases provides new functionality and provides automatic migration if needed\n* Major releases provides serious platform changes and may require manual or automatic migration\n\nWithin one major release, it guarantees forward compatibility: new versions can use data from previous versions, but not vice-versa.\n\n## Reproducible binaries\n\nThe project tries to follow best practices providing reproducible binaries: it means, that\nyou can verify that complied binaries will be exactly the same (byte to byte) as if you will compile it by yourself\nby following our public instructions.  \n\n## License\n\nThe project (source code and provided official binaries) are licensed\nunder Apache-2.0 (see License file, or in [plain English](https://tldrlegal.com/license/apache-license-2.0-(apache-2.0))) and suitable \nfor personal, commercial, government, and others usage without restrictions as long as it used with abiding\nlicense agreement.\n\nDo not forget to bring your changes back to the project. I will\n be happy to assist you with PR. \n\nThe project uses external libraries that may be distributed\nunder other licenses.   \n\n## Installation\n\n### Debian/Ubuntu\n\n(recommended)\n\nTested on 20.04 and 18.04, but should good for any x64 version.\n\nAdd the repository (only once)\n\n```bash\nsudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 379CE192D401AB61\necho \"deb https://dl.bintray.com/reddec/debian all main\" | sudo tee /etc/apt/sources.list.d/reddec.list\n```\n\nInstall or update nano-run\n\n```bash\nsudo apt update\nsudo apt install nano-run\n```\n\nAutomatically creates service `nano-run.service`.\n\n### Binary\n\nDownload and unpack desired version in [releases](https://github.com/reddec/nano-run/releases).\n\n### Docker\n\n`docker pull reddec/nano-run`\n\n### From source\n\nRequires go 1.14+\n\n`go get -v github.com/reddec/nano-run/cmd/...`\n\n### Ansible for debian servers\n\n\n```yaml\n- name: Add an apt key by id from a keyserver\n  become: yes\n  apt_key:\n    keyserver: keyserver.ubuntu.com\n    id: 379CE192D401AB61\n- name: Add repository\n  become: yes\n  apt_repository:\n    repo: deb https://dl.bintray.com/reddec/debian all main\n    state: present\n    filename: reddec\n- name: Install nano-run\n  become: yes\n  apt:\n    name: nano-run\n    update_cache: yes\n    state: latest\n```\n\n## Quick start\n\n**(optional) initialize configuration**\n\n    nano-run server init\n\nit will create required directories and files in a current working directory. \n\n**define a unit file**\n\nCreate minimal unit file (date.yaml) that will return current date (by unix command `date`) and put it\nin directory `run/conf.d/`\n\n_run/conf.d/date.yaml_\n```yaml\ncommand: date\n```\n\n**start nano-run**\n\n    nano-run server run\n    \n    \nnow you can open ui over http://localhost:8989 or do API call: `curl -X POST http://localhost:8989/api/date/`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Freddec%2Fnano-run","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Freddec%2Fnano-run","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Freddec%2Fnano-run/lists"}