Go to file
2023-03-28 20:01:14 -04:00
bin fix typo 2023-03-21 19:31:50 -04:00
ctx/home initial revision 2023-02-27 13:33:28 -05:00
.build.yml fix typo for dh publish 2023-03-13 20:33:28 -04:00
.gitignore cleanup 2023-03-16 12:21:36 -04:00
Dockerfile initial revision 2023-02-27 13:33:28 -05:00
justfile cleanup 2023-03-16 12:21:36 -04:00
LICENSE initial revision 2023-02-27 13:33:28 -05:00
NOTICE initial revision 2023-02-27 13:33:28 -05:00
README.md doc update 2023-03-28 20:01:14 -04:00

alpine-cli

A minimal image for running Linux CLI utilities - shell scripts and similar. This is useful for both interactive purposes or as the basis for other utility images.

Quickstart

$ docker run -ti --rm ghcr.io/jswank/alpine-cli
~ $ ^D
exit

$ bin/cli
~ $ ^D
exit

More Info

The image is based on alpine:edge, with a small amount of additional setup/installation done. See the Dockerfile and ctx/ for the specifics.

  • Some basic utilities are installed for interative and script-based shell usage
  • A user is created with sudo (-u root) access.
  • A few personal preferences are enabled via dotfiles.

A helper script, using casey/just is in bin/cli. It can be used to quickly start an ephemeral (or persistent) container.

$ bin/cli --list
Available recipes:
    clean   # remove the persistent image
    default # run
    persist # run (or attach to) a perisent container {{n}}
    run     # run a temporary container based on {{image}}

$ bin/cli
~ $ ^D
exit

$ bin/cli persist
~ $ ls
~ $ 
exit

$ podman cp foo.json cli:/home/cli

$ bin/cli persist
~ $ ls
foo.json
~ $ ^D
exit

Bonus - the same script could be used to start other containers:

$ bin/cli image=alpine:edge
/ # ^D