ActionServerless - Use GitHub Actions to create a serverless service
ActionServerless is an action to do some computing and then generate a string/JSON file to a path, you can visit the file as a service when in dev/testing, or even in your production. We may take it as a GitHub Actions powered serverless service.
In fact you can do all of these in native GitHub actions. ActionServerless just wraps the steps to simplify the work:
- you can focus on coding the real logic, no need to care too much setup steps on the languages that ActionServerless supported(JS/Ruby/Python/Perl etc.). With a template we provide, you even don't bother to edit the action workflow configuration.
- use the route grammer we defined to specify a path to store the generated string/JSON file, that makes the job easy and clear.
Quick start
At first use the template to create a repository. Then We start with a Python example:
# function.py
import json
# GET /api/py_hello.json
print(json.dumps({"hello": "world"}))
put the file to a path(default is the root path of a repo, otherwise you need add the path as an argument to your actions configuaration), when you push the code the action will be triggered. Then the program's output is written to a file located in api/py_hello.json that you defined as a route in the comment.
more languages' examples you can find here.
Languages supported
| Language | Dependency Installation |
|---|---|
| Python |
requirements.txt |
| Ruby |
Gemfile |
| Node.js |
package.json |
| Perl |
cpanfile |
| Golang |
|
| Haskell |
|
| Elixir |
|
| PHP |
|
HTTP Headers
If we'd like to be serious to take visiting such a GitHub raw file as a 'service', it's no problem for most situations as you request a normal HTTP service. But GitHub returns a text/html for any raw files it serves, that might lead to some bugs though I can't give an example yet.
So we provide a header rewrite service, which returns an application/json header for the json format files(those generated file suffixed with .json), and a text/plain header for the rest(those string or any text-based format files).
Header rewrite usage
Fox example, here's a raw url of the file:
https://raw.githubusercontent.com/gitx-io/ActionServerless/master/README.md
its corresponding header-rewritten url should be:
https://gitx.io/j/gitx-io/ActionServerless/master/README.md
just use gitx.io/j/ to replace the raw.githubusercontent.com/ segment.
Contributions
Contributions are welcome! You may check the following features in case you'd like to contribute but no idea what to do:
- Support to add your favorite languages
- Support dependency installation to the existing languages
- Use this action to create an application and share it
2 Jul 20, 2022
1 Nov 21, 2021
6 May 16, 2022
1 Jan 21, 2022
1 Feb 9, 2022
45.3k Jan 2, 2023
4 Aug 8, 2021
11 Dec 17, 2022
17 Dec 5, 2022
1.9k Jan 06, 2023
18 Dec 21, 2022
36 Nov 22, 2022
3 Feb 13, 2022
2 Aug 30, 2022
1k Dec 29, 2022
2 Mar 03, 2022
2 Feb 14, 2022
19 Dec 01, 2022
32 Dec 28, 2022
101 Dec 01, 2022
279 Jan 02, 2023
161 Jan 06, 2023
47 Oct 31, 2022
71 Dec 20, 2022
17 Aug 23, 2022
1 Jan 16, 2022
2 Oct 03, 2021
16 Nov 06, 2022
2 Dec 13, 2022