# kitefactory

**Repository Path**: mirrors_prometheus-community/kitefactory

## Basic Information

- **Project Name**: kitefactory
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-10-27
- **Last Updated**: 2026-01-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Kitefactory

This is a framework to easily test Go-based applications a wide variety of
native build targets, using the [Buildkite CI
platform](https://buildkite.com/).  This is especially
important when there are CGo components involved in the system.  This could be
easily adapted to other languages as well.

Thanks goes out to the [boxcutter folks](https://github.com/boxcutter), for
packer templates to get started with for some of the platforms.

## Prerequisites

Depends on the following being available on the path:

- curl
- xz
- Packer
- Ansible

## Provisioning (e.g. Image Generator) Stack

### src/packer

Bootstrap VM creation (with QEMU) + provisioning with Ansible.

### src/ansible

Provision target VM for running Buildkite agent as unprivileged user.

## Using

You will need to set the following environment variables before building:

- `PROVISIONING_PASSWORD` - password for the root account in the new VM
- `BUILDKITE_TOKEN` - token given by Buildkite to configure the agent with

It is suggested to store them in `secrets/$machine-type/env` as shell
variables, and then sourcing them.  This will allow the Makefile to detect
changes and do the right thing.

Run `make machine-type` where machine-type is in:

- freebsd-11.0-amd64
- freebsd-11.1-amd64
- freebsd-11.1-i386
- freebsd-11.2-amd64
- freebsd-11.2-i386
- debian-9.4.0-ppc64le
- openbsd-6.3-amd64
- openbsd-6.3-i386

# Running

Take a look at the `$machine-type-run` target in the Makefile.  This makes
assumptions about the state of the VM host providing DHCP and routing of some
type.

It might be helpful to install libvirt, and use either virt-manager, or virsh
to attach and run multiple vms.