monkey.ci.build.api-server — com.monkeyci/app 0.7.4.1

Functions for setting up a build script API. The build runner starts its own API server, which is only accessible by the build script and any containers it starts. This is for security reasons, since the build script is untrusted code. Restricting access to the API server is done on infra level, by setting up network security rules. Piping all traffic through the build runner also ensures that the global API will not be overloaded by malfunctioning (or misbehaving) builds.

api-client clj

artifact-routes clj

cache-routes clj

container-routes clj

context clj

dispatch-events clj

(dispatch-events req)

download-artifact clj

Downloads an artifact. The body contains the artifact as a stream.

download-cache clj

download-workspace clj

(download-workspace req)

edn clj

events-routes clj

generate-token clj

(generate-token)

Generates a new API security token. This token can be set in the API server and should be passed on to the build script.

get-all-ip-addresses clj

(get-all-ip-addresses)

Lists all non-loopback, non-virtual site local ip addresses

get-ip-addr clj

(get-ip-addr)

Determines the ip address of this VM

get-params clj

(get-params req)

get-params-from-api clj

(get-params-from-api api build)

make-app clj

(make-app opts)

make-router clj

(make-router opts)

(make-router opts routes)

params-routes clj

post-events clj

(post-events req)

repo-id clj

req->artifacts clj

req->build clj

Gets current build configuration from the request

req->cache clj

req->containers clj

req->ctx clj

(req->ctx req)

Gets the config map from the request

req->events clj

req->params clj

req->workspace clj

routes clj

rt->api-server-config clj

(rt->api-server-config rt)

Creates a config map for the api server from the given runtime

security-middleware clj

(security-middleware handler token)

Middleware that checks if the authorization header matches the specified token

srv->api-config clj

(srv->api-config {:keys [port] :as conf})

Creates a configuration object that can be passed to build runners, that includes the url

start-container clj

(start-container req)

start-server clj

(start-server {:keys [port token] :or {port 0} :as conf})

Starts a build API server with a randomly generated token. Returns the server and token.

upload-artifact clj

Uploads a new artifact. The body should contain the file contents.

upload-cache clj

with-build clj

(with-build conf b)

workspace-routes clj