https://github.com/sclevine/packfile
Dockerfile alternative, built on Cloud Native Buildpacks (buildpacks.io)
https://github.com/sclevine/packfile
Last synced: 2 months ago
JSON representation
Dockerfile alternative, built on Cloud Native Buildpacks (buildpacks.io)
- Host: GitHub
- URL: https://github.com/sclevine/packfile
- Owner: sclevine
- License: apache-2.0
- Created: 2019-07-22T01:40:49.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2020-07-13T04:48:26.000Z (almost 5 years ago)
- Last Synced: 2025-02-02T06:22:19.996Z (3 months ago)
- Language: Go
- Homepage:
- Size: 288 KB
- Stars: 9
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# packfile
Packfile is an abstraction for writing modular Cloud Native Buildpacks.
It enables you to efficiently build OCI (Docker) images using declarative TOML, YAML, or Go.
Features:
- Can be used to build modular [buildpacks](https://buildpacks.io).
- Intelligently determines what layers need to be rebuilt, and only rebuilds those layers.
- Builds OCI image layers in parallel.
- Builds OCI images that are fully reproducible.
- Builds OCI images with swappable base images (compatible with `pack rebase`, so no containers required).
- Adds detailed metadata about OCI image contents.
Built on top of [Cloud Native Buildpacks](https://buildpacks.io).
**NOTE: Packfile is currently an untested proof-of-concept.**
## Documentation
[See here.](./docs)
## Usage
The `pf` binary can be used:
- To convert a directory containing `packfile.toml` or `packfile.yaml` into a buildpack (with `-i`).
- To create a buildpack that will run `packfile.toml` or `packfile.toml` in an app directory (without `-i`).
- To create a buildpack from a compiled packfile binary and asset directory (with both `-p` and `-i `).
- To create a buildpack from a compiled packfile binary and metadata (with both `-p` and `-i `).
- On Linux as a buildpack that runs `packfile.toml` or `packfile.yaml` (when symlinked to `bin/build` and `bin/detect`).
## Build
```bash
./bin/tools
./bin/build
```
Buildpacks:
- `out/pf.tgz` can be used to build `testdata/app`.
- `testout/node-toml.tgz` is a Node.js engine buildpack built from `testdata/node-toml`.
- `testout/node-yaml.tgz` is a Node.js engine buildpack built from `testdata/node-yaml`.
- `testout/node-go.tgz` is a Node.js engine buildpack built from `testdata/node-go`.
- `testout/npm-toml.tgz` is an NPM buildpack built from `testdata/npm-toml`.
- `testout/npm-yaml.tgz` is an NPM buildpack built from `testdata/npm-yaml`.
- `testout/npm-go.tgz` is an NPM buildpack built from `testdata/npm-go`.
- `testout/ruby-yaml.tgz` is a Ruby buildpack built from `testdata/ruby-yaml`.
- `testout/bundler-yaml.tgz` is a Bundler buildpack built from `testdata/bundler-yaml`.
- `testout/ytt-yaml.tgz` is a buildpack that builds YTT from `testdata/ytt-yaml`.
## Test
```bash
./bin/test
```