|Roberto Alsina de90875c1a|
Lightweight async request runner. GitOps friendly.
A simplified version of trusted-cgi designed for async processing extreme amount of requests.
- Should have semi-constant resource consumption regardless of:
- number of requests,
- size of requests,
- kind of requests;
- Should be ready to run without configuration;
- Should be ready for deploying in clouds;
- Should support extending for another providers;
- Can be used as library and as a complete solution;
- Performance (throughput/latency) has less priority than resource usage.
Please note that the project is being developed in free time, as a non-profitable hobby project. All codes, bugs, opinions, and other related subjects should not be considered as the official position, official project, or company-backed project to any of the companies for/with which I worked before or/and at present.
- On attempt failed job
- On failed job
- On success job
- Per endpoint swagger
- Pickup file as an artifact
- Quick start
- Architecture overview
- API Authorization
- UI Authorization
- Unit configuration
- Cron-like scheduler
We are trying to follow semver:
- Patch releases provides fixes or light improvements without migration
- Minor releases provides new functionality and provides automatic migration if needed
- Major releases provides serious platform changes and may require manual or automatic migration
Within one major release, it guarantees forward compatibility: new versions can use data from previous versions, but not vice-versa.
The project tries to follow best practices providing reproducible binaries: it means, that you can verify that complied binaries will be exactly the same (byte to byte) as if you will compile it by yourself by following our public instructions.
The project (source code and provided official binaries) are licensed under Apache-2.0 (see License file, or in plain English) and suitable for personal, commercial, government, and others usage without restrictions as long as it used with abiding license agreement.
Do not forget to bring your changes back to the project. I will be happy to assist you with PR.
The project uses external libraries that may be distributed under other licenses.
Tested on 20.04 and 18.04, but should good for any x64 version.
Add the repository (only once)
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 379CE192D401AB61 echo "deb https://dl.bintray.com/reddec/debian all main" | sudo tee /etc/apt/sources.list.d/reddec.list
Install or update nano-run
sudo apt update sudo apt install nano-run
Automatically creates service
Download and unpack desired version in releases.
docker pull reddec/nano-run
Requires go 1.14+
go get -v github.com/reddec/nano-run/cmd/...
Ansible for debian servers
- name: Add an apt key by id from a keyserver become: yes apt_key: keyserver: keyserver.ubuntu.com id: 379CE192D401AB61 - name: Add repository become: yes apt_repository: repo: deb https://dl.bintray.com/reddec/debian all main state: present filename: reddec - name: Install nano-run become: yes apt: name: nano-run update_cache: yes state: latest
(optional) initialize configuration
nano-run server init
it will create required directories and files in a current working directory.
define a unit file
Create minimal unit file (date.yaml) that will return current date (by unix command
date) and put it
nano-run server run
now you can open ui over http://localhost:8989 or do API call:
curl -X POST http://localhost:8989/api/date/