@nexrender/server
v1.54.3
Published
Server acts as a single entry point for all your worker nodes, as well as api clients. Essentially it is an HTTP REST API server with few methods that allow:
Downloads
199
Readme
nexrender-server
Server acts as a single entry point for all your worker nodes, as well as api clients. Essentially it is an HTTP REST API server with few methods that allow:
- Getting list of jobs
- Getting info about specific job
- Posting new jobs
- Updating existing jobs
- Removing jobs
Server uses process memory to store current list of jobs, and persists them onto disk each time a new job added/updated/removed/etc.
By default job list is persisted to this location: $HOME/nexrender/database.js
.
Can be overriden by providing NEXRENDER_DATABASE
env variable before launching the server.
You are able to change ordering of the jobs. By default nexrender is using oldest-first
(FIFO) type queue.
Can be changed by providing NEXRENDER_ORDERING
env vartiable before launching the server with such values:
oldest-first
- FIFO queue, oldest jobs will be rendered firstnewest-first
- LIFO queue, newest jobs will be rendered first, oldest will be rendered lastrandom
- Random access queue, jobs will be selected based on random counterpriority
- Jobs are selected based on their priority field (default 0), in case of a collision it will choose the oldest one.
If you want to monitor the status of all your running jobs, consider trying our SaaS solution, Nexrender Cloud, which offers enhanced visibility and a range of other cool features. Here is how it looks like:
Installation
- For binary usage:
npm install @nexrender/server -g
- For programmatic usage:
npm install @nexrender/server --save
Usage (binary)
Server can be used in 2 modes, binary and programmatic.
nexrender-server --port 3000 --secret=myapisecret
Binary has some options that can be used to configure it, for detailed list please check help
:
nexrender-server --help
Usage (programmatic)
Programmatic usage allows to embed the server directly into your application and use it as a controlled server:
const server = require('@nexrender/server')
const port = 3000
const secret = 'myapisecret'
server.listen(port, secret, () => {
console.log(`Server listening on port ${port}`)
})
Or, alternatively you can use createHandler
method, to integrate it with your custom http server:
const {createHandler} = require('@nexrender/server')
const handler = createHandler('myapisecret')
module.exports = (req, res) => handler(req, res)
API Routes
Here is a short description of all api routes:
GET /api/v1/jobs
Gets list of all jobs, returns an array of json records.
GET /api/v1/jobs/:uid
Gets info about a specific job.
POST /api/v1/jobs
Creates a new job from json passed within a body.
Requires content-type=application/json
header to be present.
PUT /api/v1/jobs/:uid
Updates an existing job, merges json provided by user with the one that exists in the server memory.
Requires content-type=application/json
header to be present.
DELETE /api/v1/jobs/:uid
Removes provided job from the server.
GET /api/v1/jobs/pickup
An internal method, used by worker to fetch a random job from the list, and start rendering. Probably should not be used by users, unless they know what are they doing.
GET /api/v1/jobs/pickup/:tags
An internal method, used by worker to fetch a random job with specific tags from the list, and start rendering. Tags name must be an alphanumeric. Probably should not be used by users, unless they know what are they doing.
GET /api/v1/health
Can serve as the health check for the service, does not require the secret header to be passed. Returns 200 always.