boxhatter 0.2.6

Continuous integration server/executor

Box Hatter is continuous integration server/executor. It provides isolated execution environments, for running automated actions, as containers managed by podman or docker.

Key features:

• automated projects based on git repositories

• containers as execution runners

• per project configuration as YAML file inside project’s repository

• web based control and monitoring interface (without JavaScript)

• webhook/periodic execution triggering

• CLI executor

Runtime requirements

• python >=3.8

• git

• podman or docker

Install

$ pip install boxhatter

Running

Box Hatter enables execution of actions described by simple YAML files which contain container image name and Posix shell execution script. Actions files are stored as part of git repositories (default name of action file is .boxhatter.yaml, stored in root of git working tree).

These actions can be executed with:

$ boxhatter execute <path>

where <path> is path to git repository containing action definition. Referenced git repository can be local or remote.

Additionally, Box Hatter can be run as daemon providing web server interface:

$ boxhatter server

When run as server, Box Hatter periodically lists configured git repository references, and schedules action executions if new commits are available. New commit checking can also be triggered by webhooks available at listening /repo/<repo_name>/webhook URL path (<repo_name> is configured repository name).

Box Hatter server provides basic web GUI which can be used for monitoring action executions and scheduling new executions based on user provided git reference.

Action and server configurations are defined and documented by JSON schemas schemas_json/action.yaml and schemas_json/server.yaml.

For additional options, see:

$ boxhatter --help

Configuration example

• .boxhatter.yaml

  image: alpine
  command: |
      echo "hello $WHO"

• server.yaml

  repos:
      example:
          url: path/to/example/repository
          env:
              WHO: world

Build

Build tool used for Box Hatter is pydoit (http://pydoit.org). It can be installed together with other python dependencies by running:

$ pip install -r requirements.pip.dev.txt

For listing available doit tasks, use:

$ doit list

Default task:

$ doit

creates build folder containing Box Hatter distribution.

License

boxhatter - continuous integration server/executor

Copyright (C) 2017-2022 Bozo Kopic

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/>.