From b4c720450586a4366b633422a0e91ed44824ea58 Mon Sep 17 00:00:00 2001 From: Dominik Meyer Date: Fri, 19 Jan 2024 09:02:22 +0100 Subject: [PATCH] ADD: updated Readme --- README.md | 73 ++++++++++++++++++++++++++++++++----------------------- 1 file changed, 43 insertions(+), 30 deletions(-) diff --git a/README.md b/README.md index 49d2068..aa8c143 100644 --- a/README.md +++ b/README.md @@ -1,49 +1,62 @@ +--- +lang: EN_US +--- + # ImapFilter Container Image +## Description + This repository contains the Containerfile and associated scripts for a container image that runs [imapfilter](https://github.com/lefcha/imapfilter). -The container is based on alpine linux to keep it small. +The image is based on Alpine Linux and compiles the main branch of +imapfilter in a build image so that the bare imapfilter image is +as small as possible. -## Author +imapfilter is running in a loop waiting 500 seconds between each +run. -- Dominik Meyer +## Security + +Imapfilter is running with a non-root userid to improve security. +In kubernetes you can also enforce running the image with readonly +root directory. + +## Supported Architectures + +- amd64 +- arm64 + +## Updates + +I am trying to update the image weekly as long as my private kubernetes cluster is available. So I do not promise anything and do **not** rely +your business on this image. + +## Prerequisities + +A container runtime like + +* docker +* podman +* kubernetes -## Prerequisites +## Container Parameters -- Buildah +At the moment there are no parameters but there will be +some added in the future. -## Usage -### Building the Container Image +## Volumes -You can build the container image using the following command: +You have to mount the imapfilter config file to /home/imapfilter/config.lua. This can be done by a bind mount or a configmap in kubernetes. -\```bash -buildah bud -t imapfilter:latest . -\``` +## Source Repository -### Running the Container +* https://gitea.federationhq.de/Container/imapfilter.git -You can create and run a container from this image with the following command: +## Authors -\```bash -podman run -d --name imapfilter imapfilter:latest -\``` - -### Pushing the Container Image to a Registry - -With Buildah: - -\```bash -buildah push imapfilter:latest docker:////imapfilter:latest -\``` - -Replace `` with the name of your Docker registry and `` with your username on that registry. - -## Configuration - -T.b.d. +* **Dominik Meyer** - *Initial work* ## License