323 lines
7.5 KiB
Bash
323 lines
7.5 KiB
Bash
#!/usr/bin/env bash
|
|
|
|
# docker-finance | modern accounting for the power-user
|
|
#
|
|
# Copyright (C) 2021-2024 Aaron Fiore (Founder, Evergreen Crypto LLC)
|
|
#
|
|
# This program is free software: you can redistribute it and/or modify
|
|
# it under the terms of the GNU General Public License as published by
|
|
# the Free Software Foundation, either version 3 of the License, or
|
|
# (at your option) any later version.
|
|
#
|
|
# This program is distributed in the hope that it will be useful,
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
# GNU General Public License for more details.
|
|
#
|
|
# You should have received a copy of the GNU General Public License
|
|
# along with this program. If not, see <https://www.gnu.org/licenses/>.
|
|
|
|
#
|
|
# "Libraries"
|
|
#
|
|
|
|
# Docker impl
|
|
source "$(dirname "$(realpath -s $0)")/src/docker/lib/internal/lib_docker.bash" || exit 1
|
|
|
|
# Environment generation
|
|
source "$(dirname "$(realpath -s $0)")/src/docker/lib/internal/lib_gen.bash" || exit 1
|
|
|
|
# Development tools
|
|
source "$(dirname "$(realpath -s $0)")/src/docker/lib/internal/dev-tools/lib_doxygen.bash" || exit 1
|
|
source "$(dirname "$(realpath -s $0)")/src/docker/lib/internal/dev-tools/lib_license.bash" || exit 1
|
|
source "$(dirname "$(realpath -s $0)")/src/docker/lib/internal/dev-tools/lib_linter.bash" || exit 1
|
|
|
|
# Utilities (a container library (but container is never exposed to client code))
|
|
source "$(dirname "$(realpath -s $0)")/../container/src/finance/lib/internal/lib_utils.bash" || exit 1
|
|
|
|
#
|
|
# Implementation
|
|
#
|
|
|
|
if [ $UID -lt 1000 ]; then
|
|
lib_utils::die_fatal "Do not run as root or system user!"
|
|
fi
|
|
|
|
# Dependencies
|
|
deps=("sed")
|
|
lib_utils::deps_check "${deps[@]}"
|
|
|
|
# Top-level caller
|
|
global_basename="$(basename $0)"
|
|
declare -rx global_basename
|
|
|
|
# Globals argument delimiters
|
|
# NOTE: argument parsing will use this unified format
|
|
[ -z "$global_arg_delim_1" ] && declare -rx global_arg_delim_1="/"
|
|
[ -z "$global_arg_delim_2" ] && declare -rx global_arg_delim_2="="
|
|
[ -z "$global_arg_delim_3" ] && declare -rx global_arg_delim_3=","
|
|
|
|
# "Constructor" for client environment
|
|
function lib_docker::docker()
|
|
{
|
|
# Instance format:
|
|
#
|
|
# docker-finance/platform/user:tag
|
|
#
|
|
# Where user supplies:
|
|
#
|
|
# platform/user:tag
|
|
|
|
[[ -z "$1" || -z "$2" ]] && return 2
|
|
[[ ! "$1" =~ $global_arg_delim_1 ]] && return 2
|
|
|
|
# Parse image
|
|
IFS="/" read -ra _image <<<"$1"
|
|
declare -g global_platform="${_image[0]}"
|
|
local -r _user="${_image[1]}"
|
|
lib_utils::print_debug "global_platform=${global_platform}"
|
|
|
|
if [[ ! "$global_platform" =~ ^archlinux$|^ubuntu$|^dev-tools$ ]]; then
|
|
lib_utils::print_warning "unsupported platform '${global_platform}', defaulting to Arch Linux"
|
|
global_platform="archlinux"
|
|
fi
|
|
|
|
# Parse tag
|
|
IFS=":" read -ra _tag <<<"$_user"
|
|
declare -g global_user="${_tag[0]}"
|
|
declare -g global_tag="${_tag[1]}"
|
|
[ -z "$global_tag" ] && global_tag="latest" # TODO: needs to make sense, actually have version-related functionality with client conf
|
|
lib_utils::print_debug "global_user=${global_user}"
|
|
lib_utils::print_debug "global_tag=${global_tag}"
|
|
|
|
# Set instance name
|
|
declare -gr global_image="docker-finance/${global_platform}/${global_user}"
|
|
declare -gr global_container="docker-finance_${global_platform}_${global_user}"
|
|
declare -gr global_network="docker-finance_${global_platform}"
|
|
lib_utils::print_debug "global_image=${global_image}"
|
|
lib_utils::print_debug "global_container=${global_container}"
|
|
lib_utils::print_debug "global_network=${global_network}"
|
|
|
|
# Instance command
|
|
declare -gr global_command="$2"
|
|
lib_utils::print_debug "global_command=${global_command}"
|
|
|
|
# Convenience usage
|
|
declare -gr global_usage="$global_basename ${global_platform}${global_arg_delim_1}${global_user}:${global_tag} $global_command"
|
|
lib_utils::print_debug "global_usage=${global_usage}"
|
|
|
|
# Setup remaining client/container globals
|
|
lib_gen::gen || return $?
|
|
|
|
[ -z "$global_repo_client" ] && lib_utils::die_fatal
|
|
declare -g global_dockerfile_path="${global_repo_client}/Dockerfiles/"
|
|
|
|
case "$global_platform" in
|
|
archlinux | ubuntu)
|
|
global_dockerfile_path+="finance"
|
|
;;
|
|
dev-tools)
|
|
global_dockerfile_path+="dev-tools"
|
|
;;
|
|
*)
|
|
lib_utils::die_fatal "platform was not previously checked"
|
|
;;
|
|
esac
|
|
|
|
#
|
|
# docker-compose
|
|
#
|
|
|
|
[ -z "$global_env_file" ] && lib_utils::die_fatal
|
|
[ -z "$global_shell_file" ] && lib_utils::die_fatal
|
|
|
|
local _path="${global_dockerfile_path}/docker-compose.yml"
|
|
lib_utils::print_debug "Generating '${_path}'"
|
|
|
|
sed \
|
|
-e "s|@DOCKER_FINANCE_IMAGE@|${global_image}:${global_tag}|g" \
|
|
-e "s|@DOCKER_FINANCE_CONTAINER@|${global_container}|g" \
|
|
-e "s|@DOCKER_FINANCE_NETWORK@|${global_network}|g" \
|
|
"${_path}.${global_platform}.in" >"$_path" || return $?
|
|
|
|
#
|
|
# Dockerfile
|
|
#
|
|
|
|
[ -z "$DOCKER_FINANCE_UID" ] && lib_utils::die_fatal
|
|
[ -z "$DOCKER_FINANCE_GID" ] && lib_utils::die_fatal
|
|
[ -z "$DOCKER_FINANCE_USER" ] && lib_utils::die_fatal
|
|
|
|
local _path="${global_dockerfile_path}/Dockerfile"
|
|
lib_utils::print_debug "Generating '${_path}'"
|
|
|
|
sed \
|
|
-e "s:@DOCKER_FINANCE_UID@:${DOCKER_FINANCE_UID}:g" \
|
|
-e "s:@DOCKER_FINANCE_GID@:${DOCKER_FINANCE_GID}:g" \
|
|
-e "s:@DOCKER_FINANCE_USER@:${DOCKER_FINANCE_USER}:g" \
|
|
"${_path}.${global_platform}.in" >"$_path" || return $?
|
|
|
|
return 0
|
|
}
|
|
|
|
#
|
|
# Generate client/container environment
|
|
#
|
|
|
|
function lib_docker::gen()
|
|
{
|
|
lib_gen::generate
|
|
lib_utils::catch $?
|
|
}
|
|
|
|
#
|
|
# Build docker-finance image
|
|
#
|
|
|
|
function lib_docker::build()
|
|
{
|
|
lib_docker::__build "$@"
|
|
lib_utils::catch $?
|
|
}
|
|
|
|
#
|
|
# Bring up docker-finance services
|
|
#
|
|
|
|
function lib_docker::up()
|
|
{
|
|
lib_docker::__up "$@"
|
|
lib_utils::catch $?
|
|
}
|
|
|
|
#
|
|
# Bring down docker-finance services
|
|
#
|
|
|
|
function lib_docker::down()
|
|
{
|
|
lib_docker::__down "$@"
|
|
lib_utils::catch $?
|
|
}
|
|
|
|
#
|
|
# Start docker-finance services
|
|
#
|
|
|
|
function lib_docker::start()
|
|
{
|
|
lib_docker::__start "$@"
|
|
lib_utils::catch $?
|
|
}
|
|
|
|
#
|
|
# Stop docker-finance services
|
|
#
|
|
|
|
function lib_docker::stop()
|
|
{
|
|
lib_docker::__stop "$@"
|
|
lib_utils::catch $?
|
|
}
|
|
|
|
#
|
|
# Remove docker-finance image
|
|
#
|
|
|
|
function lib_docker::rm()
|
|
{
|
|
lib_docker::__rm "$@"
|
|
lib_utils::catch $?
|
|
}
|
|
|
|
#
|
|
# Spawn a docker-finance container with given command
|
|
#
|
|
|
|
function lib_docker::run()
|
|
{
|
|
lib_docker::__run "$@"
|
|
lib_utils::catch $?
|
|
}
|
|
|
|
#
|
|
# Open shell into docker-finance container
|
|
#
|
|
|
|
function lib_docker::shell()
|
|
{
|
|
lib_docker::__shell "$@"
|
|
lib_utils::catch $?
|
|
}
|
|
|
|
#
|
|
# Edit client configuration of given docker-finance instance
|
|
#
|
|
|
|
function lib_docker::edit()
|
|
{
|
|
lib_docker::__edit "$@"
|
|
lib_utils::catch $?
|
|
}
|
|
|
|
#
|
|
# Backup docker-finance image
|
|
#
|
|
|
|
function lib_docker::backup()
|
|
{
|
|
lib_docker::__backup
|
|
lib_utils::catch $?
|
|
}
|
|
|
|
#
|
|
# Generate docker-finance license for source file
|
|
#
|
|
|
|
function lib_docker::license()
|
|
{
|
|
[[ "$global_platform" != "dev-tools" ]] \
|
|
&& lib_utils::die_fatal "Invalid platform, use 'dev-tools'"
|
|
|
|
lib_license::license "$@"
|
|
lib_utils::catch $?
|
|
}
|
|
|
|
#
|
|
# Lint docker-finance source files
|
|
#
|
|
|
|
function lib_docker::linter()
|
|
{
|
|
[[ "$global_platform" != "dev-tools" ]] \
|
|
&& lib_utils::die_fatal "Invalid platform, use 'dev-tools'"
|
|
|
|
lib_linter::linter "$@"
|
|
lib_utils::catch $?
|
|
}
|
|
|
|
#
|
|
# Generate Doxygen for docker-finance source files
|
|
#
|
|
|
|
function lib_docker::doxygen()
|
|
{
|
|
[[ "$global_platform" != "dev-tools" ]] \
|
|
&& lib_utils::die_fatal "Invalid platform, use 'dev-tools'"
|
|
|
|
lib_doxygen::doxygen "$@"
|
|
lib_utils::catch $?
|
|
}
|
|
|
|
#
|
|
# Prints `docker-finance` version (and dependencies' version)
|
|
#
|
|
|
|
function lib_docker::version()
|
|
{
|
|
lib_docker::__version "$@"
|
|
lib_utils::catch $?
|
|
}
|
|
|
|
# vim: sw=2 sts=2 si ai et
|