byggsteg — Build Freely: Your CI/CD, Your Control, Your…

Pitch

Description

Comments

About this project

Byggsteg offers a seamless CI/CD solution that liberates you from proprietary systems. Designed for engineers, it enables you to create tailored pipelines with complete control, leveraging plain Guile and minimal dependencies. Build, test, and deploy your projects efficiently while capturing logs and monitoring job statuses effortlessly. Start building freely today!

Byggsteg is a powerful Continuous Integration/Continuous Delivery (CI/CD) orchestrator designed with freedom in mind, written in Guile Scheme. The term "byggsteg" translates to "build step" in Norwegian, aptly reflecting its purpose to streamline software delivery processes. This lightweight CI/CD system operates with minimal dependencies, utilizing plain Guile, SXML, and essential POSIX/UNIX utilities.

Key Features

Byggsteg empowers engineers to enhance their software delivery efficiency while allowing them complete ownership of their CI/CD pipelines. Its primary goal is to free users from reliance on proprietary systems like GitHub Actions, enabling the creation of customizable CI/CD workflows that align with specific needs. Here are some of its standout features:

Repository Management: Automatically clone specified repositories into isolated folders for each branch while efficiently caching by reusing existing branches.
Job Execution: Navigate to directories and execute system commands, such as testing or building Haskell projects using commands like stack test or stack build.
Comprehensive Logging: Capture and save log output from all jobs, providing clear visibility into processes and outcomes.
Dashboard: Display the status of running jobs, indicating whether they are in progress, successful, or failed.

Usage

To get started with Byggsteg, run the server using the command guile run-server.scm from the root directory. It features an HTML frontend and a REST API, ensuring compatibility with most Unix-like systems while offering the best performance on GNU Guix. You can easily integrate Byggsteg into your workflows by submitting job requests via the user interface or through API calls.

Example Job Submission

Submit a job using a simple Guile Scheme code structure:

`((project . "free-alacarte")
  (branch-name . "trunk")
  (task . "stack-test")
  (clone-url . "https://github.com/jjba23/free-alacarte"))

You can also leverage cURL for programmatic submission:

curl 'https://byggsteg.jointhefreeworld.org/api/jobs/submit' \
    -X POST -H 'Content-Type: application/x-www-form-urlencoded' \
    -H 'Authorization: Basic ${{secrets.

Visit byggsteg