Buildahcker

Buildahcker is a node.js library to create and run commands in OCI (Open Container Initiative) container images (or docker images), based on Buildah and a hash-based cache. It also contains utilities to easily create a partitioned bootable disk image of a Linux system.

Have a look to the API documentation here.

Installation

1npm install buildahcker --save-dev

Usage

Here is a basic sample:

1import {
2  defaultContainerCache,
3  ImageBuilder,
4  run,
5  addFiles,
6  MemFile,
7  DiskLocation,
8} from "buildahcker";
9
10const createImage = async () => {
11  const builder = await ImageBuilder.from("alpine:latest", {
12    logger: process.stdout,
13    containerCache: defaultContainerCache(),
14  });
15  await builder.executeStep([
16    run(["apk", "add", "--no-cache", "nginx"]),
17    addFiles({
18      "etc/issue": new MemFile({
19        content: "Hello",
20      }),
21      app: new DiskLocation("./app", {
22        overrideAttributes: { uid: 1, gid: 2 },
23      }),
24    }),
25  ]);
26  console.log("Created image: ", builder.imageId);
27};
28
29createImage();

Check the tests and this sample repository for more usage examples.