api

Documentation

Overview

Package api provides the handlers for the Vela API.

Usage:

import "github.com/go-vela/worker/api"

Index

• func GetBuild(c *gin.Context)
• func GetExecutor(c *gin.Context)
• func GetExecutors(c *gin.Context)
• func Health(c *gin.Context)
• func KillBuild(c *gin.Context)
• func Metrics() http.Handler
• func Shutdown(c *gin.Context)

Functions

func GetBuild

func GetBuild(c *gin.Context)

GetBuild represents the API handler to capture the build currently running on an executor.

func GetExecutor

func GetExecutor(c *gin.Context)

GetExecutor represents the API handler to capture the executor currently running on a worker.

func GetExecutors

func GetExecutors(c *gin.Context)

GetExecutors represents the API handler to capture the executors currently running on a worker.

func Health

func Health(c *gin.Context)

Health check the status of the application

func KillBuild

func KillBuild(c *gin.Context)

KillBuild represents the API handler to kill a build currently running on an executor.

This function performs a hard cancellation of a build on worker. Any build running during this time will immediately be stopped.

func Metrics

func Metrics() http.Handler

Metrics returns a Prometheus handler for serving go metrics

func Shutdown

func Shutdown(c *gin.Context)

Shutdown represents the API handler to shutdown a executors currently running on an worker.

This function performs a soft shut down of a worker. Any build running during this time will safely complete, then the worker will safely shut itself down.