devel.md

Local development

Start the web interface

• Clone the agola-web repository

Inside the agola-web repository run:

pnpm install
pnpm run serve

Build the agola binary

To build agola we usually test and support the latest two major versions of Go like in the Go release policy.

make

Start the agola server

• Copy the example/agolademo/config.yml where you prefer

./bin/agola serve --config /path/to/your/config.yml --components all-base,executor

Error handling

Use the --detailed-errors option to easily follow the errors chain.

When developing you should wrap every error using errors.Wrap[f] or errors.WithStack. The ci uses golangci-lint with the wrapcheck linter enabled to check if some errors aren't wrapped.