In a mess while refactor!

templates/caddy/README.txt

@@ -0,0 +1,3 @@
+Caddy!
+
+Edit the static site, and the Caddyfile.

templates/caddy/_common.sh

@@ -0,0 +1,155 @@
+#!/bin/bash
+
+# COMMON FUNCTIONS
+# JDE
+# 2025-04-25
+
+# This file is not required if you write your own template.
+
+
+# Print error message and exit with code 1
+# Usage: die "error message"
+die() {
+    echo -e "\033[91mError: $1\033[0m"
+    exit 1
+}
+
+grey_start() {
+    echo -e -n "\033[90m"
+}
+
+grey_end() {
+    echo -e -n "\033[0m"
+}
+
+create_and_start_container() {
+    if [ -z "$1" ] || [ -z "$2" ]; then
+        die "Template error: create_and_start_container <run_cmd> <container_name>"
+    fi
+
+    local run_cmd="$1"
+    local container_name="$2"
+
+    if _is_container_exists $container_name; then
+        _is_container_running $container_name && return 0
+        _start_container $container_name
+    else
+        grey_start
+        $run_cmd
+        grey_end
+    fi
+
+    if ! _is_container_running $container_name; then
+        die "Container ${container_name} failed to start"
+    fi
+
+    ID=$(_get_container_id $container_name)
+    echo "Container ${container_name} is running with ID ${ID}"
+}
+
+function create_folder() {
+    local folder="$1"
+    if [ -d "$folder" ]; then
+        return 0
+    fi
+    if ! mkdir -p "$folder"; then
+        die "Failed to create folder: $folder"
+    fi
+    chmod 777 "$folder"
+    echo "Folder created: $folder"
+}
+
+# Check if docker is installed
+_check_docker_installed() {
+    if ! command -v docker &> /dev/null; then
+        echo "Docker is not installed"
+        return 1
+    fi
+
+    # check if docker daemon is running
+    if ! docker info &> /dev/null; then
+        echo "Docker daemon is not running"
+        return 1
+    fi
+
+    # check if user has permission to run docker
+    if ! docker run --rm hello-world &> /dev/null; then
+        echo "User does not have permission to run docker"
+        return 1
+    fi
+
+    return 0
+}
+
+# Check if a container exists
+_is_container_exists() {
+    if ! docker ps -a --format "{{.Names}}" | grep -q "^$1$"; then
+        return 1
+    fi
+    return 0
+}
+
+# Check if a container is running
+_is_container_running() {
+    if ! docker ps --format "{{.Names}}" | grep -q "^$1$"; then
+        return 1
+    fi
+    return 0
+}
+
+# get contianer ID
+_get_container_id() {
+    docker ps --format "{{.ID}}" --filter "name=$1"
+}
+
+# get container status
+_get_container_status() {
+    docker ps --format "{{.Status}}" --filter "name=$1"
+}
+
+# start container that exists
+_start_container() {
+    _is_container_exists $1 || return 1
+    _is_container_running $1 && return 0
+    docker start $1
+}
+
+# stop container that exists
+_stop_container() {
+    _is_container_running $1 || return 0;
+    docker stop $1
+}   
+
+# remove container that exists
+_remove_container() {
+    _stop_container $1
+    _is_container_exists $1 || return 0;
+    docker rm $1
+}
+
+# get container logs
+_get_container_logs() {
+    if ! _is_container_exists $1; then
+        echo "Container $1 does not exist"
+        return 1
+    fi
+
+    docker logs $1
+}
+
+check_required_env_vars() {
+    local required_vars=("$@")
+    for var in "${required_vars[@]}"; do
+        if [ -z "${!var}" ]; then
+            die "Required environment variable $var is not set in your service.env file"
+        fi
+    done
+}
+
+function _root_remove_tree() {
+    local to_remove="$1"
+    parent=$(dirname "$to_remove")
+    abs_parent=$(realpath "$parent")
+    child=$(basename "$to_remove")
+    docker run --rm -v "$abs_parent":/data alpine rm -rf "/data/$child"
+}

templates/caddy/_default.env

@@ -0,0 +1,8 @@
+# Service settings specific to this server 
+
+# Image settings
+IMAGE_REGISTRY="docker.io"
+IMAGE_REPO="caddy"
+
+DATA_VOLUME=caddy_data
+CONFIG_VOLUME=caddy_config

templates/caddy/backup.sh

@@ -0,0 +1,22 @@
+#!/bin/bash
+
+# BACKUP SCRIPT
+# The backup script is OPTIONAL.
+# It is used to backup the service on the server.
+# It is called with one argument: the path to the destination backup file.
+# If the backup file already exists, the script should exit with a message.
+
+source "$(dirname "$0")/_common.sh"
+check_required_env_vars "CONTAINER_NAME" "DATA_VOLUME" "CONFIG_VOLUME" "CONFIG_PATH"
+
+# Stop container before backup
+_stop_container "$CONTAINER_NAME"
+
+if ! autobackup volume=$DATA_VOLUME volume=$CONFIG_VOLUME $1 $2; then
+    die "Failed to create backup"
+fi
+
+# Start container after backup
+_start_container "$CONTAINER_NAME"
+
+echo "Backup created successfully: $BACKUP_FILE"

templates/caddy/example/.template_info.env

@@ -0,0 +1,2 @@
+# Template to use - always required!
+TEMPLATE=caddy

templates/caddy/example/Caddyfile

@@ -0,0 +1,2 @@
+# See https://caddyserver.com/docs/caddyfile
+

templates/caddy/example/service.env

@@ -0,0 +1,10 @@
+# Service settings specific to this server 
+# (can also override anything in the _default.env file in the template to make it specific to this server)
+CONTAINER_NAME=caddy
+IMAGE_TAG="latest"
+
+# Scripts will have these environment variables set, plus those in _default.env, plus:
+# SERVER, SERVICE, CONFIG_PATH
+# CONFIG_PATH points to this directory!
+
+

templates/caddy/example/static/index.html

@@ -0,0 +1,9 @@
+<html>
+    <head>
+        <title>Static Site</title>
+    </head>
+    <body>
+        <h1>Static Site</h1>
+        <p>This is a static site.</p>
+    </body>
+</html>

templates/caddy/install.sh

@@ -0,0 +1,30 @@
+#!/bin/bash
+
+# INSTALL SCRIPT
+# The install script is required for all templates.
+# It is used to install the service on the server.
+# It is called with the path to the server specific env file as an argument.
+
+source "$(dirname "$0")/_common.sh"
+
+# Required environment variables
+check_required_env_vars "CONTAINER_NAME" "IMAGE_REGISTRY" "IMAGE_REPO" "IMAGE_TAG" "DATA_VOLUME" "CONFIG_VOLUME"
+
+if ! autocreate volume=$DATA_VOLUME volume=$CONFIG_VOLUME; then
+    die "Failed to autocreate volumes and paths"
+fi
+
+# Test Docker 
+_check_docker_installed || die "Docker test failed, aborting installation..."
+
+# check can pull image on remote host and exit if fails
+docker pull "$IMAGE_REGISTRY/$IMAGE_REPO:$IMAGE_TAG" || die "Failed to pull image $IMAGE_REGISTRY/$IMAGE_REPO:$IMAGE_TAG"
+
+[ -f "${CONFIG_PATH}/Caddyfile" ] || die "Caddyfile not found in ${CONFIG_PATH}!"
+
+# remove and restart, as the env may have changed.
+bash ./stop.sh || die "Failed to stop container ${CONTAINER_NAME}"
+_remove_container $CONTAINER_NAME || die "Failed to remove container ${CONTAINER_NAME}"
+bash ./start.sh || die "Failed to start container ${CONTAINER_NAME}"
+
+echo "Installation of ${CONTAINER_NAME} complete"

templates/caddy/logs.sh

@@ -0,0 +1,16 @@
+#!/bin/bash
+
+# LOGS SCRIPT
+# The logs script is OPTIONAL.
+# It is used to return the logs of the service.
+# It is called with the path to the server specific env file as an argument.
+
+source "$(dirname "$0")/_common.sh"
+
+# Required environment variables
+check_required_env_vars "CONTAINER_NAME"
+
+echo "Container ${CONTAINER_NAME} logs:"
+grey_start
+docker logs "${CONTAINER_NAME}"
+grey_end

templates/caddy/nuke.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+
+# NUKE SCRIPT
+# This is run after the uninstall.sh script to delete all data.
+# dropshell handles the configuration files, so we just need to remove
+# any docker volumes and any custom local data folders.
+
+source "$(dirname "$0")/_common.sh"
+check_required_env_vars "CONTAINER_NAME" "DATA_VOLUME" "CONFIG_VOLUME" "CONFIG_PATH"
+
+if ! autonuke volume=$DATA_VOLUME volume=$CONFIG_VOLUME; then
+    die "Failed to nuke"
+fi
+
+echo "Nuking of ${CONTAINER_NAME} complete."

templates/caddy/ports.sh

@@ -0,0 +1,5 @@
+#!/bin/bash
+
+source "$(dirname "$0")/_common.sh"
+echo 80
+echo 443

templates/caddy/restore.sh

@@ -0,0 +1,22 @@
+#!/bin/bash
+
+# RESTORE SCRIPT
+# The restore script is OPTIONAL.
+# It is used to restore the service on the server from a backup file.
+# It is called with one argument: the path to the backup file.
+
+source "$(dirname "$0")/_common.sh"
+check_required_env_vars "DATA_VOLUME" "CONFIG_VOLUME" "CONFIG_PATH"
+
+# uninstall container before restore
+bash ./uninstall.sh || die "Failed to uninstall service before restore"
+
+# restore data from backup file
+if ! autorestore volume=$DATA_VOLUME volume=$CONFIG_VOLUME "$1" "$2"; then
+    die "Failed to restore data from backup file"
+fi
+
+# reinstall service
+bash ./install.sh || die "Failed to reinstall service after restore"
+
+echo "Restore complete! Service is running again."

templates/caddy/start.sh

@@ -0,0 +1,34 @@
+#!/bin/bash
+
+# START SCRIPT
+# The start script is required for all templates.
+# It is used to start the service on the server.
+# It is called with the path to the server specific env file as an argument.
+
+source "$(dirname "$0")/_common.sh"
+check_required_env_vars "CONTAINER_NAME" "DATA_VOLUME" "CONFIG_VOLUME"
+
+
+DOCKER_RUN_CMD="docker run -d \
+                --restart unless-stopped \
+                --name ${CONTAINER_NAME} \
+                -p 80:80 \
+                -p 443:443 \
+                -p 443:443/udp \
+                -v ${CONFIG_PATH}/Caddyfile:/etc/caddy/Caddyfile \
+                -v ${DATA_VOLUME}:/data \
+                -v ${CONFIG_VOLUME}:/config \
+                -v ${CONFIG_PATH}/static:/srv \
+                ${IMAGE_REGISTRY}/${IMAGE_REPO}:${IMAGE_TAG}"
+
+
+if ! create_and_start_container "$DOCKER_RUN_CMD" "$CONTAINER_NAME"; then
+    die "Failed to start container ${CONTAINER_NAME}"
+fi
+
+# Check if the container is running
+if ! _is_container_running "$CONTAINER_NAME"; then
+    die "Container ${CONTAINER_NAME} is not running"
+fi
+
+echo "Container ${CONTAINER_NAME} started"

templates/caddy/status.sh

@@ -0,0 +1,17 @@
+#!/bin/bash
+
+# STATUS SCRIPT
+# The status script is OPTIONAL.
+# It is used to return the status of the service (0 is healthy, 1 is unhealthy).
+# It is called with the path to the server specific env file as an argument.
+
+
+# This is an example of a status script that checks if the service is running.
+source "$(dirname "$0")/_common.sh"
+check_required_env_vars "CONTAINER_NAME"
+
+# check if the service is running
+_is_container_running $CONTAINER_NAME || die "Service is not running - did not find container $CONTAINER_NAME."
+
+echo "Service is healthy"
+exit 0

templates/caddy/stop.sh

@@ -0,0 +1,13 @@
+#!/bin/bash
+
+# STOP SCRIPT
+# The stop script is required for all templates.
+# It is used to stop the service on the server.
+# It is called with the path to the server specific env file as an argument.
+
+source "$(dirname "$0")/_common.sh"
+check_required_env_vars "CONTAINER_NAME"
+
+_stop_container $CONTAINER_NAME || die "Failed to stop container ${CONTAINER_NAME}"
+
+echo "Container ${CONTAINER_NAME} stopped"

templates/caddy/uninstall.sh

@@ -0,0 +1,19 @@
+#!/bin/bash
+
+# UNINSTALL SCRIPT
+# The uninstall script is required for all templates.
+# It is used to uninstall the service from the server.
+# It is called with the path to the server specific env file as an argument.
+
+source "$(dirname "$0")/_common.sh"
+check_required_env_vars "CONTAINER_NAME" "IMAGE_REGISTRY" "IMAGE_REPO" "IMAGE_TAG"
+
+_remove_container $CONTAINER_NAME || die "Failed to remove container ${CONTAINER_NAME}"
+_is_container_running && die "Couldn't stop existing container"
+_is_container_exists && die "Couldn't remove existing container"
+
+# remove the image
+docker rmi "$IMAGE_REGISTRY/$IMAGE_REPO:$IMAGE_TAG" || echo "Failed to remove image $IMAGE_REGISTRY/$IMAGE_REPO:$IMAGE_TAG"
+
+echo "Uninstallation of ${CONTAINER_NAME} complete."
+echo "Local data still in place."