This repository provides the control server for a beardo installation. A beardo-control install lives at the centre of an installation, providing a single point of control/information.

This server uses Docker to provide a standard development environment for all developers on the project, this is the preferred method of installation/development. No support is provided for non-docker setups.

• Gitlab sync
  • user accounts
  • SSH keys
  • projects (with webhooks, but not project-users yet)
• Accepts webhooks on push to any attached git repo, enqueing a build job.
• Queue API allowing build tasks to be leased/marked complete by a build worker.
• Basic dashboard
  • User management
  • Project management
  • View build logs

• You must have a working Gitlab server set up (preferably dedicated to beardo use, as beardo will remove projects/users without confirmation).
• You must have a valid secrets.py file in the app/ folder. You can copy the secrets.example.py file to get started.

The easiest way to use this skeleton is with Docker. With Docker installed, running your application should be as simple as:

$ make run

To run your application's tests, use the command:

$ make test

Visit the running application http://localhost:8080

Check out the Makefile in the repository root for all available commands.

See the Third party libraries page for libraries that are already included in the SDK. To include SDK libraries, add them in your app.yaml file. Other than libraries included in the SDK, only pure python libraries may be added to an App Engine project.

Any third-party Python modules added to the app/vendor/ directory will be added to Python's sys.path at runtime.

See LICENSE