README.adoc 1.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142
  1. = Make Alpine Linux RootFS
  2. :script-name: alpine-make-rootfs
  3. :script-sha1: N/A
  4. :gh-name: jirutka/{script-name}
  5. :version: 0.0.0
  6. ifdef::env-github[]
  7. image:https://travis-ci.org/{gh-name}.svg?branch=master["Build Status", link="https://travis-ci.org/{gh-name}"]
  8. endif::env-github[]
  9. This project provides a script for building customized https://alpinelinux.org/[Alpine Linux] rootfs (a base image if you like) for containers.
  10. It’s quite simple (250 LoC of shell), fast and requires minimum dependencies (just common Linux tools).
  11. TIP: Do you want to just quickly chroot into Alpine Linux, e.g. on CI?
  12. Check out https://github.com/alpinelinux/alpine-chroot-install[alpine-chroot-install]!
  13. == Requirements
  14. * Linux system
  15. * http://pubs.opengroup.org/onlinepubs/9699919799/utilities/V3_chap02.html[POSIX-sh] compatible shell (e.g. Busybox ash, dash, ZSH, bash, …)
  16. * common userland with `chroot`, `getopt`, `grep`, `sed`, `sha256sum`, `wget` (e.g. from Busybox, GNU coreutils, …)
  17. * `tar` (full-blown)
  18. == Usage
  19. Read documentation in link:{script-name}[{script-name}].
  20. See link:.travis.yml[.travis.yml] for Travis example.
  21. You can copy link:{script-name}[{script-name}] into your repository or download it on demand, e.g.:
  22. [source, sh, subs="+attributes"]
  23. wget https://raw.githubusercontent.com/{gh-name}/v{version}/{script-name} \
  24. && echo '{script-sha1} {script-name}' | sha1sum -c \
  25. || exit 1
  26. == License
  27. This project is licensed under http://opensource.org/licenses/MIT/[MIT License].
  28. For the full text of the license, see the link:LICENSE[LICENSE] file.