[abchr.git] / README.MD

# abchr

There are various build chains surrounding Alpine. Most solutions use
containerization, QEMU, and other technologies; meanwhile I just wanted a
simple way to build packages and install development utilities without shitting
up my production system. `abchr` is an attempt to create a simple solution to
my simple problem. It isn't very flexible, requires root access for chroot, and
won't allow you to (easily) build for multiarch, but it works.

## Installation

1. Create a directory and 3 subdirectories named `bin`, `alpine`, and `aports`.
   Your tree should look like this:
    ```
    + abchr
      + bin
      + alpine
      + aports
    ```
2. Clone the repo to the `bin` directory.
3. Run `abchr-newchroot` to populate the `alpine` directory with a new
   installation of Alpine Linux. This processes downloads the latest
   `apk-tools-static` into the chroot and installs the basic packages necessary
   for a build environment.
4. To ensure everything worked, run `abchr abuild -h`. You should see the help
   text for `abuild`, which should be installed in the chroot.
Commit	Line	Data
fb547c12	1	# abchr
	2
	3	There are various build chains surrounding Alpine. Most solutions use
	4	containerization, QEMU, and other technologies; meanwhile I just wanted a
	5	simple way to build packages and install development utilities without shitting
	6	up my production system. `abchr` is an attempt to create a simple solution to
	7	my simple problem. It isn't very flexible, requires root access for chroot, and
	8	won't allow you to (easily) build for multiarch, but it works.
	9
	10	## Installation
	11
	12	1. Create a directory and 3 subdirectories named `bin`, `alpine`, and `aports`.
	13	Your tree should look like this:
	14	```
	15	+ abchr
	16	+ bin
	17	+ alpine
	18	+ aports
	19	```
	20	2. Clone the repo to the `bin` directory.
	21	3. Run `abchr-newchroot` to populate the `alpine` directory with a new
	22	installation of Alpine Linux. This processes downloads the latest
	23	`apk-tools-static` into the chroot and installs the basic packages necessary
	24	for a build environment.
	25	4. To ensure everything worked, run `abchr abuild -h`. You should see the help
	26	text for `abuild`, which should be installed in the chroot.