From c7e498194546416fb7231cb03254e77e085d18df Mon Sep 17 00:00:00 2001 From: Georg Lauterbach <44545919+georglauterbach@users.noreply.github.com> Date: Sun, 12 Sep 2021 01:29:02 +0200 Subject: [PATCH] Move setup process via script into container (#2174) Decoupling setup process from `setup.sh` script by introducing a setup script _inside_ the container that coordinates the setup process. **This is not a breaking change**. This way, we do not have to keep track of versions of `setup.sh`. This change brings the additional benefit for Kubernetes users to be able to make use of `setup` now, without the need for `setup.sh`. --- * move setup process into container; setup.sh versioning not needed anymore * add tilde functionality to docs Co-authored-by: Brennan Kinney <5098581+polarathene@users.noreply.github.com> Co-authored-by: Casper --- README.md | 25 +-- docs/content/config/setup.sh.md | 52 +++--- docs/mkdocs.yml | 1 + setup.sh | 318 ++++++++------------------------ target/bin/setup | 171 +++++++++++++++++ test/tests.bats | 14 +- 6 files changed, 285 insertions(+), 296 deletions(-) create mode 100644 target/bin/setup diff --git a/README.md b/README.md index 4a10e537..36570b31 100644 --- a/README.md +++ b/README.md @@ -76,28 +76,23 @@ All workflows are using the tagging convention listed below. It is subsequently ### Get the tools -Download `docker-compose.yml` and `mailserver.env` +Since Docker Mailserver `v10.2.0`, `setup.sh` functionality is included within the Docker image. The external convenience script is no longer required if you prefer using `docker exec setup ` instead. + +> **Note:** If you're using Docker or Docker Compose and are new to Docker Mailserver, it is recommended to use the script `setup.sh` for convenience. ``` BASH -wget https://raw.githubusercontent.com/docker-mailserver/docker-mailserver/master/docker-compose.yml -wget https://raw.githubusercontent.com/docker-mailserver/docker-mailserver/master/mailserver.env -``` - -and the `setup.sh` **in the correct version** - -``` BASH -# if you're using :edge as the image tag -wget https://raw.githubusercontent.com/docker-mailserver/docker-mailserver/master/setup.sh -# if you're using :latest (= :10.1.1) as the image tag -wget https://raw.githubusercontent.com/docker-mailserver/docker-mailserver/v10.1.2/setup.sh +DMS_GITHUB_URL='https://raw.githubusercontent.com/docker-mailserver/docker-mailserver/master' +wget "${DMS_GITHUB_URL}/docker-compose.yml" +wget "${DMS_GITHUB_URL}/mailserver.env" +wget "${DMS_GITHUB_URL}/setup.sh" chmod a+x ./setup.sh - -# and make yourself familiar with the script ./setup.sh help ``` -**Make sure to get the `setup.sh` that comes with the release you're using**. Look up the release and the git commit on which this release is based upon by selecting the appropriate tag on GitHub. This can done with the "Switch branches/tags" button on GitHub, choosing the right tag. This is done in order to rule out possible inconsistencies between versions. +If no `docker-mailserver` container is running, any `./setup.sh` command will check online for the `:latest` image tag (the current stable release), performing a `pull` if necessary followed by running the command in a temporary container. + +**NOTE** _If you're using Docker Mailserver version `v10.1.x` or below_, you will need to get `setup.sh` with a specific version. Substitute `` with the mail server version you're using: `wget https://raw.githubusercontent.com/docker-mailserver/docker-mailserver//setup.sh`. ### Create a docker-compose environment diff --git a/docs/content/config/setup.sh.md b/docs/content/config/setup.sh.md index b2731720..cfa1b9d4 100644 --- a/docs/content/config/setup.sh.md +++ b/docs/content/config/setup.sh.md @@ -1,7 +1,7 @@ --- title: Your best friend setup.sh hide: - - toc # Hide Table of Contents for this page + - toc --- [`setup.sh`][github-file-setupsh] is an administration script that helps with the most common tasks, including initial configuration. It is intended to be used from the host machine, _not_ from within your running container. @@ -13,13 +13,9 @@ wget https://raw.githubusercontent.com/docker-mailserver/docker-mailserver/maste chmod a+x ./setup.sh ``` -!!! info - - Make sure to get the `setup.sh` that comes with the release you're using. Look up the release and the git commit on which this release is based upon by selecting the appropriate tag on GitHub. This can done with the "Switch branches/tags" button on GitHub, choosing the right tag. This is done in order to rule out possible inconsistencies between versions. - ## Usage -Run `./setup.sh help` and you'll get some usage information: +Run `./setup.sh help` and you'll get ~~all you have ever wanted~~ some usage information: ```TXT SETUP(1) @@ -55,28 +51,6 @@ VERSION following URL, where TAG looks like 'vX.X.X': https://raw.githubusercontent.com/docker-mailserver/docker-mailserver/TAG/setup.sh -OPTIONS - Config path, container or image adjustments - -i IMAGE_NAME - Provides the name of the docker-mailserver image. The default value is - docker.io/mailserver/docker-mailserver:latest - - -c CONTAINER_NAME - Provides the name of the running container. - - -p PATH - Provides the config folder path. The default is - /home/maxwell/Dokumente/github/docker-mailserver/config/ - - SELinux - -z - Allows container access to the bind mount content that is shared among - multiple containers on a SELinux-enabled host. - - -Z - Allows container access to the bind mount content that is private and - unshared with other containers on a SELinux-enabled host. - [SUB]COMMANDS COMMAND email := ./setup.sh email add [] @@ -122,6 +96,28 @@ EXAMPLES This will provide you with a detailed explanation on how to use the config dkim command, showing what arguments can be passed and what they do. +OPTIONS + Config path, container or image adjustments + -i IMAGE_NAME + Provides the name of the docker-mailserver image. The default value is + docker.io/mailserver/docker-mailserver:latest + + -c CONTAINER_NAME + Provides the name of the running container. + + -p PATH + Provides the config folder path to the temporary container + (does not work if docker-mailserver container already exists). + + SELinux + -z + Allows container access to the bind mount content that is shared among + multiple containers on a SELinux-enabled host. + + -Z + Allows container access to the bind mount content that is private and + unshared with other containers on a SELinux-enabled host. + EXIT STATUS Exit status is 0 if the command was successful. If there was an unexpected error, an error message is shown describing the error. In case of an error, the script will exit with exit diff --git a/docs/mkdocs.yml b/docs/mkdocs.yml index 9eb3e60e..a40da281 100644 --- a/docs/mkdocs.yml +++ b/docs/mkdocs.yml @@ -75,6 +75,7 @@ markdown_extensions: - pymdownx.superfences - pymdownx.magiclink - pymdownx.inlinehilite + - pymdownx.tilde - pymdownx.emoji: emoji_index: !!python/name:materialx.emoji.twemoji emoji_generator: !!python/name:materialx.emoji.to_svg diff --git a/setup.sh b/setup.sh index 0fb0ae66..6d8708d6 100755 --- a/setup.sh +++ b/setup.sh @@ -1,37 +1,63 @@ #! /bin/bash -# version v0.3.0 stable +# version v1.0.0 # executed manually / via Make # task wrapper for various setup scripts SCRIPT='setup.sh' -WHITE="\e[37m" -RED="\e[31m" -PURPLE="\e[35m" -YELLOW="\e[93m" -ORANGE="\e[38;5;214m" -CYAN="\e[96m" -BLUE="\e[34m" -LBLUE="\e[94m" -BOLD="\e[1m" -RESET="\e[0m" - set -euEo pipefail -trap '__log_err "${FUNCNAME[0]:-?}" "${BASH_COMMAND:-?}" "${LINENO:-?}" "${?:-?}"' ERR +trap '__err "${FUNCNAME[0]:-?}" "${BASH_COMMAND:-?}" "${LINENO:-?}" "${?:-?}"' ERR -function __log_err +function __err { - printf "\n--- ${BOLD}${RED}UNCHECKED ERROR${RESET}\n%s\n%s\n%s\n%s\n\n" \ - " - script = ${SCRIPT:-${0}}" \ - " - function = ${1} / ${2}" \ - " - line = ${3}" \ - " - exit code = ${4}" >&2 + [[ ${4} -gt 1 ]] && exit 1 - printf "Make sure you use a version of this script that matches -the version / tag of docker-mailserver. Please read the -'Get the tools' section in the README on GitHub careful- -ly and use ./setup.sh help and read the VERSION section.\n" >&2 + local ERR_MSG='--- \e[31m\e[1mUNCHECKED ERROR\e[0m' + ERR_MSG+="\n - script = ${SCRIPT:-${0}}" + ERR_MSG+="\n - function = ${1} / ${2}" + ERR_MSG+="\n - line = ${3}" + ERR_MSG+="\n - exit code = ${4}" + ERR_MSG+='\n' + + echo -e "${ERR_MSG}" +} + +function _show_local_usage +{ + local WHITE="\e[37m" + local ORANGE="\e[38;5;214m" + local LBLUE="\e[94m" + local RESET="\e[0m" + + # shellcheck disable=SC2059 + printf "${ORANGE}OPTIONS${RESET} + ${LBLUE}Config path, container or image adjustments${RESET} + -i IMAGE_NAME + Provides the name of the docker-mailserver image. The default value is + ${WHITE}docker.io/mailserver/docker-mailserver:latest${RESET} + + -c CONTAINER_NAME + Provides the name of the running container. + + -p PATH + Provides the config folder path to the temporary container (does not work if docker-mailserver container already exists). + + ${LBLUE}SELinux${RESET} + -z + Allows container access to the bind mount content that is shared among + multiple containers on a SELinux-enabled host. + + -Z + Allows container access to the bind mount content that is private and + unshared with other containers on a SELinux-enabled host. + +${ORANGE}EXIT STATUS${RESET} + Exit status is 0 if the command was successful. If there was an unexpected error, an error + message is shown describing the error. In case of an error, the script will exit with exit + status 1. + +" } function _get_absolute_script_directory @@ -39,7 +65,8 @@ function _get_absolute_script_directory if [[ "$(uname)" == "Darwin" ]] then readlink() { - greadlink "${@:+$@}" # Requires coreutils + # requires coreutils + greadlink "${@:+$@}" } fi if dirname "$(readlink -f "${0}")" &>/dev/null @@ -70,7 +97,9 @@ function _check_root { if [[ ${EUID} -ne 0 ]] then - echo "Curently docker-mailserver doesn't support podman's rootless mode, please run this script as root user." + echo "Curently, DMS doesn't support podman's rootless mode. +Please run this script as root user." + exit 1 fi } @@ -81,7 +110,7 @@ function _update_config_path then VOLUME=$(${CRI} inspect "${CONTAINER_NAME}" \ --format="{{range .Mounts}}{{ println .Source .Destination}}{{end}}" | \ - grep "/tmp/docker-mailserver$" 2>/dev/null) + grep "/tmp/docker-mailserver$" 2>/dev/null || :) fi if [[ -n ${VOLUME} ]] @@ -90,137 +119,6 @@ function _update_config_path fi } -function _inspect -{ - if _docker_image_exists "${IMAGE_NAME}" - then - echo "Image: ${IMAGE_NAME}" - else - echo "Image: '${IMAGE_NAME}' can’t be found." - fi - - if [[ -n ${CONTAINER_NAME} ]] - then - echo "Container: ${CONTAINER_NAME}" - echo "Config mount: ${CONFIG_PATH}" - else - echo "Container: Not running, please start docker-mailserver." - fi -} - -function _usage -{ - # shellcheck disable=SC2059 - printf "${PURPLE}SETUP${RED}(${YELLOW}1${RED}) - -${ORANGE}NAME${RESET} - ${SCRIPT:-${0}} - docker-mailserver administration script - -${ORANGE}SYNOPSIS${RESET} - ./${SCRIPT:-${0}} [ OPTIONS${RED}...${RESET} ] COMMAND [ help ${RED}|${RESET} ARGUMENTS${RED}...${RESET} ] - - COMMAND ${RED}:=${RESET} { email ${RED}|${RESET} alias ${RED}|${RESET} quota ${RED}|${RESET} config ${RED}|${RESET} relay ${RED}|${RESET} debug } SUBCOMMAND - -${ORANGE}DESCRIPTION${RESET} - This is the main administration script that you use for all interactions with your - mail server. Setup, configuration and much more is done with this script. - - Please note that this script executes most of its commands inside the running 'mailserver' container itself. - If it cannot find a running container, it will attempt to run one using any available tags - which include label=org.opencontainers.image.title=\"docker-mailserver\" and then run the necessary commands. - If the tag for the container is not found, this script will pull the ${WHITE}:latest${RESET} tag of - ${WHITE}docker.io/mailserver/docker-mailserver${RESET}. This tag refers to the latest release, - see the tagging convention in the README under - ${BLUE}https://github.com/docker-mailserver/docker-mailserver/blob/master/README.md${RESET} - - You will be able to see detailed information about the script you're invoking and - its arguments by appending ${WHITE}help${RESET} after your command. Currently, this - does not work with all scripts. - -${ORANGE}VERSION${RESET} - The current version of this script is backwards compatible with versions of - ${WHITE}docker-mailserver${RESET} ${BOLD}after${RESET} ${BLUE}8.0.1${RESET}. In case that there is not a more recent release, - this script is currently only working with the ${WHITE}:edge${RESET} tag. - - You can download the script for your release by substituting TAG from the - following URL, where TAG looks like 'vX.X.X': - https://raw.githubusercontent.com/docker-mailserver/docker-mailserver/TAG/setup.sh - -${ORANGE}OPTIONS${RESET} - ${LBLUE}Config path, container or image adjustments${RESET} - -i IMAGE_NAME - Provides the name of the docker-mailserver image. The default value is - ${WHITE}docker.io/mailserver/docker-mailserver:latest${RESET} - - -c CONTAINER_NAME - Provides the name of the running container. - - -p PATH - Provides the config folder path to the temporary container (does not work if docker-mailserver container already exists). The default is - ${WHITE}${DIR}/config/${RESET} - - ${LBLUE}SELinux${RESET} - -z - Allows container access to the bind mount content that is shared among - multiple containers on a SELinux-enabled host. - - -Z - Allows container access to the bind mount content that is private and - unshared with other containers on a SELinux-enabled host. - -${RED}[${ORANGE}SUB${RED}]${ORANGE}COMMANDS${RESET} - ${LBLUE}COMMAND${RESET} email ${RED}:=${RESET} - ${0} email ${CYAN}add${RESET} [] - ${0} email ${CYAN}update${RESET} [] - ${0} email ${CYAN}del${RESET} [ OPTIONS${RED}...${RESET} ] [ ${RED}...${RESET} ] - ${0} email ${CYAN}restrict${RESET} [] - ${0} email ${CYAN}list${RESET} - - ${LBLUE}COMMAND${RESET} alias ${RED}:=${RESET} - ${0} alias ${CYAN}add${RESET} - ${0} alias ${CYAN}del${RESET} - ${0} alias ${CYAN}list${RESET} - - ${LBLUE}COMMAND${RESET} quota ${RED}:=${RESET} - ${0} quota ${CYAN}set${RESET} [] - ${0} quota ${CYAN}del${RESET} - - ${LBLUE}COMMAND${RESET} config ${RED}:=${RESET} - ${0} config ${CYAN}dkim${RESET} [ ARGUMENTS${RED}...${RESET} ] - - ${LBLUE}COMMAND${RESET} relay ${RED}:=${RESET} - ${0} relay ${CYAN}add-domain${RESET} [] - ${0} relay ${CYAN}add-auth${RESET} [] - ${0} relay ${CYAN}exclude-domain${RESET} - - ${LBLUE}COMMAND${RESET} debug ${RED}:=${RESET} - ${0} debug ${CYAN}fetchmail${RESET} - ${0} debug ${CYAN}fail2ban${RESET} [unban ] - ${0} debug ${CYAN}show-mail-logs${RESET} - ${0} debug ${CYAN}inspect${RESET} - ${0} debug ${CYAN}login${RESET} - -${ORANGE}EXAMPLES${RESET} - ${WHITE}./setup.sh email add test@domain.tld${RESET} - Add the email account ${WHITE}test@domain.tld${RESET}. You will be prompted - to input a password afterwards since no password was supplied. - - ${WHITE}./setup.sh config dkim keysize 2048 domain 'whoami.com,whoareyou.org'${RESET} - Creates keys of length 2048 but in an LDAP setup where domains are not known to - Postfix by default, so you need to provide them yourself in a comma-separated list. - - ${WHITE}./setup.sh config dkim help${RESET} - This will provide you with a detailed explanation on how to use the ${WHITE} - config dkim${RESET} command, showing what arguments can be passed and what they do. - -${ORANGE}EXIT STATUS${RESET} - Exit status is 0 if the command was successful. If there was an unexpected error, an error - message is shown describing the error. In case of an error, the script will exit with exit - status 1. - -" -} - function _docker_image_exists { ${CRI} history -q "${1}" &>/dev/null @@ -236,9 +134,9 @@ function _docker_image ${CRI} pull "${IMAGE_NAME}" fi - ${CRI} run --rm \ + ${CRI} run --rm "${USE_TTY}" \ -v "${CONFIG_PATH}:/tmp/docker-mailserver${USE_SELINUX}" \ - "${USE_TTY}" "${IMAGE_NAME}" "${@:+$@}" + "${IMAGE_NAME}" "${@:+$@}" } function _docker_container @@ -247,7 +145,8 @@ function _docker_container then ${CRI} exec "${USE_TTY}" "${CONTAINER_NAME}" "${@:+$@}" else - # If no container yet, run a temporary one: https://github.com/docker-mailserver/docker-mailserver/pull/1874#issuecomment-809781531 + # if no container is running, run a temporary one: + # https://github.com/docker-mailserver/docker-mailserver/pull/1874#issuecomment-809781531 _docker_image "${@:+$@}" fi } @@ -263,7 +162,7 @@ function _main _check_root else echo "No supported Container Runtime Interface detected." - exit 10 + exit 1 fi INFO=$(${CRI} ps --no-trunc --format "{{.Image}};{{.Names}}" --filter \ @@ -288,33 +187,29 @@ function _main fi local OPTIND - while getopts ":c:i:p:hzZ" OPT + while getopts ":c:i:p:zZ" OPT do case ${OPT} in - i ) IMAGE_NAME="${OPTARG}" ;; - z ) USE_SELINUX=":z" ;; - Z ) USE_SELINUX=":Z" ;; - c ) - # container specified, connect to running instance - CONTAINER_NAME="${OPTARG}" - ;; + ( i ) IMAGE_NAME="${OPTARG}" ;; + ( z | Z ) USE_SELINUX=":${OPTARG}" ;; + ( c ) CONTAINER_NAME="${OPTARG}" ;; - p ) + ( p ) case "${OPTARG}" in - /* ) WISHED_CONFIG_PATH="${OPTARG}" ;; - * ) WISHED_CONFIG_PATH="${DIR}/${OPTARG}" ;; + ( /* ) WISHED_CONFIG_PATH="${OPTARG}" ;; + ( * ) WISHED_CONFIG_PATH="${DIR}/${OPTARG}" ;; esac if [[ ! -d ${WISHED_CONFIG_PATH} ]] then - echo "Directory doesn't exist" - _usage - exit 40 + echo "Specified directory '${WISHED_CONFIG_PATH}' doesn't exist" >&2 + exit 1 fi ;; - * ) + ( * ) echo "Invalid option: -${OPT}" >&2 + exit 1 ;; esac @@ -335,75 +230,10 @@ function _main CONFIG_PATH=${WISHED_CONFIG_PATH} fi + _docker_container setup "${@:+$@}" + [[ ${1} == 'help' ]] && _show_local_usage - case ${1:-} in - - email ) - case ${2:-} in - add ) shift 2 ; _docker_container addmailuser "${@:+$@}" ;; - update ) shift 2 ; _docker_container updatemailuser "${@:+$@}" ;; - del ) shift 2 ; _docker_container delmailuser "${@:+$@}" ;; - restrict ) shift 2 ; _docker_container restrict-access "${@:+$@}" ;; - list ) _docker_container listmailuser ;; - * ) _usage ;; - esac - ;; - - alias ) - case ${2:-} in - add ) shift 2 ; _docker_container addalias "${1}" "${2}" ;; - del ) shift 2 ; _docker_container delalias "${1}" "${2}" ;; - list ) shift 2 ; _docker_container listalias ;; - * ) _usage ;; - esac - ;; - - quota ) - case ${2:-} in - set ) shift 2 ; _docker_container setquota "${@:+$@}" ;; - del ) shift 2 ; _docker_container delquota "${@:+$@}" ;; - * ) _usage ;; - esac - ;; - - config ) - case ${2:-} in - dkim ) shift 2 ; _docker_container open-dkim "${@:+$@}" ;; - * ) _usage ;; - esac - ;; - - relay ) - case ${2:-} in - add-domain ) shift 2 ; _docker_container addrelayhost "${@:+$@}" ;; - add-auth ) shift 2 ; _docker_container addsaslpassword "${@:+$@}" ;; - exclude-domain ) shift 2 ; _docker_container excluderelaydomain "${@:+$@}" ;; - * ) _usage ;; - esac - ;; - - debug ) - case ${2:-} in - fetchmail ) _docker_container debug-fetchmail ;; - fail2ban ) shift 2 ; _docker_container fail2ban "${@:+$@}" ;; - show-mail-logs ) _docker_container cat /var/log/mail/mail.log ;; - inspect ) _inspect ;; - login ) - shift 2 - if [[ -z ${1:-} ]] - then - _docker_container /bin/bash - else - _docker_container /bin/bash -c "${@:+$@}" - fi - ;; - * ) _usage ; exit 1 ;; - esac - ;; - - help ) _usage ;; - * ) _usage ; exit 1 ;; - esac + return 0 } _main "${@:+$@}" diff --git a/target/bin/setup b/target/bin/setup new file mode 100644 index 00000000..9ac972d2 --- /dev/null +++ b/target/bin/setup @@ -0,0 +1,171 @@ +#! /bin/bash + +SCRIPT='setup' + +set -euE -o pipefail + +function _usage +{ + local WHITE="\e[37m" + local RED="\e[31m" + local PURPLE="\e[35m" + local YELLOW="\e[93m" + local ORANGE="\e[38;5;214m" + local CYAN="\e[96m" + local BLUE="\e[34m" + local LBLUE="\e[94m" + local RESET="\e[0m" + + # shellcheck disable=SC2059 + printf "${PURPLE}SETUP${RED}(${YELLOW}1${RED}) + +${ORANGE}NAME${RESET} + ${SCRIPT:-${0}} - docker-mailserver administration & configuration script + +${ORANGE}SYNOPSIS${RESET} + ./${SCRIPT:-${0}} [ OPTIONS${RED}...${RESET} ] COMMAND [ help ${RED}|${RESET} ARGUMENTS${RED}...${RESET} ] + + COMMAND ${RED}:=${RESET} { email ${RED}|${RESET} alias ${RED}|${RESET} quota ${RED}|${RESET} config ${RED}|${RESET} relay ${RED}|${RESET} debug } SUBCOMMAND + +${ORANGE}DESCRIPTION${RESET} + This is the main administration script that you use for all interactions with your + mail server. Setup, configuration and much more is done with this script. + + Please note that this script executes most of its commands inside the running 'mailserver' + container itself. If it cannot find a running container, it will attempt to run one using + any available tags which include label=org.opencontainers.image.title=\"docker-mailserver\" + and then run the necessary commands. If the tag for the container is not found, this script + will pull the ${WHITE}:latest${RESET} tag of ${WHITE}docker.io/mailserver/docker-mailserver${RESET}.This tag refers to the + latest release, see the tagging convention in the README under + ${BLUE}https://github.com/docker-mailserver/docker-mailserver/blob/master/README.md${RESET} + + You will be able to see detailed information about the script you're invoking and their + arguments by appending ${WHITE}help${RESET} after your command. Currently, this does not work with all scripts. + +${RED}[${ORANGE}SUB${RED}]${ORANGE}COMMANDS${RESET} + ${LBLUE}COMMAND${RESET} email ${RED}:=${RESET} + ${0} email ${CYAN}add${RESET} [] + ${0} email ${CYAN}update${RESET} [] + ${0} email ${CYAN}del${RESET} [ OPTIONS${RED}...${RESET} ] [ ${RED}...${RESET} ] + ${0} email ${CYAN}restrict${RESET} [] + ${0} email ${CYAN}list${RESET} + + ${LBLUE}COMMAND${RESET} alias ${RED}:=${RESET} + ${0} alias ${CYAN}add${RESET} + ${0} alias ${CYAN}del${RESET} + ${0} alias ${CYAN}list${RESET} + + ${LBLUE}COMMAND${RESET} quota ${RED}:=${RESET} + ${0} quota ${CYAN}set${RESET} [] + ${0} quota ${CYAN}del${RESET} + + ${LBLUE}COMMAND${RESET} config ${RED}:=${RESET} + ${0} config ${CYAN}dkim${RESET} [ ARGUMENTS${RED}...${RESET} ] + + ${LBLUE}COMMAND${RESET} relay ${RED}:=${RESET} + ${0} relay ${CYAN}add-domain${RESET} [] + ${0} relay ${CYAN}add-auth${RESET} [] + ${0} relay ${CYAN}exclude-domain${RESET} + + ${LBLUE}COMMAND${RESET} debug ${RED}:=${RESET} + ${0} debug ${CYAN}fetchmail${RESET} + ${0} debug ${CYAN}fail2ban${RESET} [unban ] + ${0} debug ${CYAN}show-mail-logs${RESET} + ${0} debug ${CYAN}inspect${RESET} + ${0} debug ${CYAN}login${RESET} + +${ORANGE}EXAMPLES${RESET} + ${WHITE}./setup.sh email add test@domain.tld${RESET} + Add the email account ${WHITE}test@domain.tld${RESET}. You will be prompted + to input a password afterwards since no password was supplied. + + ${WHITE}./setup.sh config dkim keysize 2048 domain 'whoami.com,whoareyou.org'${RESET} + Creates keys of length 2048 but in an LDAP setup where domains are not known to + Postfix by default, so you need to provide them yourself in a comma-separated list. + + ${WHITE}./setup.sh config dkim help${RESET} + This will provide you with a detailed explanation on how to use the ${WHITE} + config dkim${RESET} command, showing what arguments can be passed and what they do. + +" +} + +function _invalid_command +{ + echo "The command '${*}' is invalid. +Use \`./setup.sh help\` to get an overview of all commands." >&2 + exit 2 +} + +function _main +{ + case ${1:-} in + + email ) + case ${2:-} in + add ) shift 2 ; addmailuser "${@}" ;; + update ) shift 2 ; updatemailuser "${@}" ;; + del ) shift 2 ; delmailuser "${@}" ;; + restrict ) shift 2 ; restrict-access "${@}" ;; + list ) listmailuser ;; + * ) _invalid_command "${1}" "${2}" ;; + esac + ;; + + alias ) + case ${2:-} in + add ) shift 2 ; addalias "${1}" "${2}" ;; + del ) shift 2 ; delalias "${1}" "${2}" ;; + list ) shift 2 ; listalias ;; + * ) _invalid_command "${1}" "${2}" ;; + esac + ;; + + quota ) + case ${2:-} in + set ) shift 2 ; setquota "${@}" ;; + del ) shift 2 ; delquota "${@}" ;; + * ) _invalid_command "${1}" "${2}" ;; + esac + ;; + + config ) + case ${2:-} in + dkim ) shift 2 ; open-dkim "${@}" ;; + * ) _invalid_command "${1}" "${2}" ;; + esac + ;; + + relay ) + case ${2:-} in + add-domain ) shift 2 ; addrelayhost "${@}" ;; + add-auth ) shift 2 ; addsaslpassword "${@}" ;; + exclude-domain ) shift 2 ; excluderelaydomain "${@}" ;; + * ) _invalid_command "${1}" "${2}" ;; + esac + ;; + + debug ) + case ${2:-} in + fetchmail ) debug-fetchmail ;; + fail2ban ) shift 2 ; fail2ban "${@}" ;; + show-mail-logs ) cat /var/log/mail/mail.log ;; + login ) + shift 2 + if [[ -z ${1:-} ]] + then + /bin/bash + else + /bin/bash -c "${@}" + fi + ;; + * ) _invalid_command "${1}" "${2}" ;; + esac + ;; + + help ) _usage ;; + * ) _invalid_command "${*}" ;; + esac +} + +_main "${@}" diff --git a/test/tests.bats b/test/tests.bats index 0220c57b..327693a3 100644 --- a/test/tests.bats +++ b/test/tests.bats @@ -943,13 +943,13 @@ EOF @test "setup.sh :: exit with error when no arguments provided" { run ./setup.sh assert_failure - assert_line --index 2 " setup.sh - docker-mailserver administration script" + assert_line --index 0 --partial "The command '' is invalid." } @test "setup.sh :: exit with error when wrong arguments provided" { run ./setup.sh lol troll assert_failure - assert_line --index 2 " setup.sh - docker-mailserver administration script" + assert_line --index 0 --partial "The command 'lol troll' is invalid." } @test "checking setup.sh: setup.sh email add and login" { @@ -1126,17 +1126,13 @@ EOF } # debug + @test "checking setup.sh: setup.sh debug fetchmail" { run ./setup.sh -c mail debug fetchmail - assert_failure 11 + assert_failure assert_output --partial "fetchmail: normal termination, status 11" } -@test "checking setup.sh: setup.sh debug inspect" { - run ./setup.sh -c mail debug inspect - assert_success - assert_line --index 0 "Image: ${NAME}" - assert_line --index 1 "Container: mail" -} + @test "checking setup.sh: setup.sh debug login ls" { run ./setup.sh -c mail debug login ls assert_success