doc(README): usage
continuous-integration/drone/push Build is passing Details

This commit is contained in:
Markus Pesch 2022-08-22 12:22:21 +02:00
parent 65f7b4aba0
commit 4f1e914a18
Signed by: volker.raschek
GPG Key ID: 852BCC170D81A982
3 changed files with 27 additions and 38 deletions

View File

@ -11,4 +11,4 @@ RUN if [ -z ${MKISOFS_VERSION+x} ]; then \
yum install --assumeyes xorriso-${MKISOFS_VERSION}; \ yum install --assumeyes xorriso-${MKISOFS_VERSION}; \
fi fi
ENTRYPOINT [ "/usr/bin/xorriso" ] ENTRYPOINT [ "/usr/bin/mkisofs" ]

View File

@ -10,22 +10,31 @@ The primary goal of this project is to package the binary `mkisofs` and
dependencies as container image to provide the functionally for CI/CD workflows dependencies as container image to provide the functionally for CI/CD workflows
or for systems which does contains the binary. or for systems which does contains the binary.
## mkisofs.sh ## Usage
The shell script `mkisofs.sh` is a wrapper for the binary `mkisofs`, which
is not available depending on the distribution. It starts the container image
`docker.io/volkerraschek/mkisofs` in the background to call the binary. For
this reason, a container runtime like `docker` or `podman` is necessary.
### Installation
The script can be installed via the following command:
```bash
curl https://git.cryptic.systems/volker.raschek/mkisofs-docker/raw/branch/master/mkisofs.sh --output - | sudo tee /usr/local/bin/mkisofs.sh && sudo chmod +x /usr/local/bin/mkisofs.sh
```
### Usage
The script forwards all arguments directly to the binary running inside the The script forwards all arguments directly to the binary running inside the
container. For this reason, all arguments from the original binary can be used. container. For this reason, all arguments from the original binary can be used,
for example to create an adapted bootable fedora iso image.
```bash
SCRIPT_DIR=$( cd -- "$( dirname -- "${BASH_SOURCE[0]}" )" &> /dev/null && pwd )
podman run \
--rm \
--volume ${SCRIPT_DIR}:/workspace \
--workdir /workspace \
docker.io/volkerraschek/mkisofs \
-output /workspace/fedora-35.iso \
-eltorito-boot isolinux/isolinux.bin \
-eltorito-catalog isolinux/boot.cat \
-no-emul-boot \
-joliet \
-joliet-long \
-boot-load-size 4 \
-boot-info-table \
-full-iso9660-filenames \
-rational-rock \
-verbose \
-volid "exam" \ # specified in ks.cfg
/workspace/custom-iso
```

View File

@ -1,20 +0,0 @@
#!/bin/bash
set -e
CONTAINER_RUNTIME=$(which podman)
MKISOFS_IMAGE_FULLY_QUALIFIED=docker.io/volkerraschek/mkisofs:latest
CUSTOM_UID=$(getent passwd ${USER} | cut -d ':' -f 3)
CUSTOM_GID=$(getent passwd ${USER} | cut -d ':' -f 4)
# Extract last element of passed arguments
REPO_DIR=${@: -1}
${CONTAINER_RUNTIME} run \
--rm \
--volume ${REPO_DIR}:${REPO_DIR} \
--workdir ${REPO_DIR} \
--user ${CUSTOM_UID}:${CUSTOM_GID} \
${MKISOFS_IMAGE_FULLY_QUALIFIED} ${@}