diff options
| author | Drew DeVault <sir@cmpwn.com> | 2017-12-03 12:31:53 -0500 |
|---|---|---|
| committer | Drew DeVault <sir@cmpwn.com> | 2017-12-03 12:31:53 -0500 |
| commit | fbacd2222f254e57292b0d058abb7987b87a977b (patch) | |
| tree | 7e62135e20c83cbd4d8e322dc9ef431d53d2778f /builds.sr.ht | |
| parent | 129d66334259371f2254b164713043e8754a533d (diff) | |
| download | sr.ht-docs-fbacd2222f254e57292b0d058abb7987b87a977b.tar.gz | |
Start adding builds.sr.ht docs
Diffstat (limited to 'builds.sr.ht')
| -rw-r--r-- | builds.sr.ht/api.md | 39 | ||||
| -rw-r--r-- | builds.sr.ht/index.md | 5 |
2 files changed, 44 insertions, 0 deletions
diff --git a/builds.sr.ht/api.md b/builds.sr.ht/api.md new file mode 100644 index 0000000..74e7e03 --- /dev/null +++ b/builds.sr.ht/api.md @@ -0,0 +1,39 @@ +The build.sr.ht API allows you to insert jobs, monitor their progress, and +access some information about the build system. Authentication to this API is +brokered by meta.sr.ht. This API uses standard sr.ht error responses. + +# API Endpoints + +## POST /api/jobs + +**Scopes**: jobs:write + +Inserts a new job into the job queue. + + { + "manifest": "string", The build manifest + "note": "string", Human-friendly description of this build + (markdown, optional) + "tags": [...], Arbitrary list of strings that identify this + build and can be used to navigate the + dashboard. Each string must use only + lowercase alphanumeric characters, or any + of "-_.:" (optional) + "access:read": [ List of users that have read access to this + job (optional). The user submitting the + build will be included regardless of this + value. The special username "*" indicates + public read access to this build. + Defaults to *. + "string" Username + ], + "access:write": [ List of users that have write access to this + job (optional). The user submitting the + build will be included regardless of this + value. + "string" Username + ], + "triggers": [...], Post-build triggers (optional) + "execute": boolean, True to start the build immediately + (optional - defaults to true) + } diff --git a/builds.sr.ht/index.md b/builds.sr.ht/index.md new file mode 100644 index 0000000..1027492 --- /dev/null +++ b/builds.sr.ht/index.md @@ -0,0 +1,5 @@ +[builds.sr.ht](https://builds.sr.ht) is a service on sr.ht that allows you to +submit "build manifests" for us to work on. We spin up a virtual machine per +your specifications and run your scripts in it. This is generally used to +compile and test patches, deploy websites, build and publish packages, and so +on. |