reproducible's Introduction

Reproducible

A library for creating simple, reproducible environments with docker. Build artifacts reproducibly using the docker build system!

Installation

npm install reproducible

Usage

Check out the full go-hello-world reproducible build example in the examples folder;

Example Build File

FROM golang:buster
WORKDIR /opt/build
COPY ./ ./
RUN go build -o ./dist/main src/main.go

Example Run Script

import reproducible from 'reproducible';

(async () => {
  // Generate a DockerFile for Build Pipeline
  reproducible.generateDockerfile('golang:buster', './', 'go build -o ./dist/main src/main.go');

  // Build artifacts using docker build system and export as image
  await reproducible.createBuild('valist-build');

  // Export build artifacts from image
  await reproducible.exportBuild('valist-build','dist/main');
})();

Building the Package

npm run build

Maintainers

@awantoch

@jiyuu-jin

@nasdf

License

Reproducible is licensed under the Mozilla Public License Version 2.0

reproducible's People

Contributors

Watchers

reproducible's Issues

Add --platform flag to use amd64 on M1 Macs / other ARM based computers

Add contents of .*ignore to .dockerignore

We'll need to respect the existing ignore files, like .gitignore, .npmignore, etc to the .dockerignore file before building the image.

This both helps with reproducibility (not copying in dependencies built on the host) as well as security (not accidentally copying in secrets to an image that could potentially be published later)

Recommend Projects