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

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

context clj

download-artifact clj

(download-artifact req)

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

download-cache clj

(download-cache req)

download-workspace clj

(download-workspace req)

edn 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-ip-addr clj

(get-ip-addr)

Determines the ip address of this VM

get-params clj

make-app clj

(make-app opts)

make-router clj

(make-router opts)

(make-router opts routes)

post-events clj

(post-events req)

repo-id clj

req->api clj

req->artifacts clj

req->build clj

Gets current build configuration from the request

req->cache clj

req->ctx clj

(req->ctx req)

Gets the config map from the request

req->storage 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

start-server clj

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

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

upload-artifact clj

(upload-artifact req)

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

upload-cache clj

(upload-cache req)

with-build clj

(with-build conf b)