Your First Service

Download or copy the maintained example into configurations/services/http-lab.yaml. The displayed file and download are generated from the same source that CI validates.

apiVersion: "v1"
protocol: "http"
address: ":8080"
description: "Lab HTTP decoy"
commands:
  - regex: "^/$"
    methods: [GET, HEAD]
    handler: "<html><body><h1>Internal portal</h1></body></html>"
    headers:
      - "Content-Type: text/html"
    statusCode: 200
  - regex: "^.*$"
    handler: "Not found"
    statusCode: 404

Validate before starting the runtime:

beelzebub validate

Start it with beelzebub run, then test / and an unknown path. Commands are evaluated in order: put specific routes before a catch-all. A route whose regex matches but whose method list excludes the request returns 405 with Allow; a catch-all without methods accepts every method.