sloci-image

Simple script for creating single-layer OCI images.

MIT License

Stars
15
Committers
4

= sloci-image :script-name: sloci-image :script-sha1: 995e7de37735a8fd82733370f1eba7f311f4ac5d :version: 0.1.2 :gh-name: jirutka/{script-name}

ifdef::env-github[] image:https://github.com/{gh-name}/workflows/CI/badge.svg["Build Status", link="https://github.com/{gh-name}/actions"] endif::env-github[]

This project provides a simple CLI tool for packing rootfs into a single-layer OCI image (compliant with OCI Image Format 1.0.1). It’s written in POSIX shell and uses only common unix utilities.footnote:[You read it correctly, no bloated Go c̶r̶a̶p̶s̶ tools are needed.]

== Requirements

  • POSIX-sh compatible shell (e.g. Busybox ash, dash, Bash, ZSH)
  • common Unix userland with awk, date, gzip, sed, sha256sum (e.g. from Busybox, core-utils, …)
  • tar (full-blown)

== Usage

Read documentation in the link:{script-name}[{script-name} script].

You can add {script-name} as a submodule into your repository or download it on demand, e.g.:

[source, sh, subs="+attributes"] wget https://raw.githubusercontent.com/{gh-name}/v{version}/{script-name} && echo '{script-sha1} {script-name}' | sha1sum -c || exit 1

== License

This project is licensed under http://opensource.org/licenses/MIT/[MIT License]. For the full text of the license, see the link:LICENSE[LICENSE] file.