sh8s_deployer/Specifications.md

Shlagernetes deployer - Specifications

Context

Shlagernetes is an orchestration tool allowing services to be stored on second-hand servers. It handles the configuration of the servers, the installation and maintenance of services as well as their deletion. Services can be static or dynamic websites, VPNs, etc. They can be in a container if required but not necessarily. Shlagernetes works with an nginx reverse proxy, wireguard VPN, letsencrypt ssl certification and git versioning.

Shl8s works with the principle of Infrastructure As Code. On every server, there will be an instance of the Shl8s deployer, written in C. The deployer will call bash scripts specific to the service, as well as functions from libraries specific to setting the nginx configuration, the vpn, ssl certification, etc.

Call

./deployer deploy/remove all/service_name

Description

deploy_service(service)
{

• determines if the service is on this server
  if it is:
  - creates directories (secret, data, http) if necessary
  - calls the bash scripts specific to the service if they exist (deploy_as)
  - creates user and .env variables if necessary
  - calls the deployment functions from the libraries
  }

remove_service(service) //should there be some kind of less absolute removal?
{

• determines if the service is on this server
  if it is:
  - calls the removing bash scripts specific to the service if they exist
  - calls the removing functions from the libraries
  - deletes .env variables
  - deletes directories
  - deletes user
  - removes from .csv //should this get done before by the sysadmin? but how to check that something was here if it has been removed ?
  }

main.cpp

• reads the instructions If deploy all:
  • checks the environment (/data/mounted and new nginx conf exists)
  • prepares directories
  • prepares Nginx
  • prepares Docker
  • prepares .env
    for each service:
    • deploy_service(service)
  • (re)start nginx
  • cleans
    else if deploy one service:
  • checks the environment (/data/mounted and new nginx conf exists)
  • deploy_service(service)
  • (re)start nginx else if remove all:
    for each service:
    • remove_service(service)
  • stop Docker
  • stop wireguard
  • stop Nginx
  • cleans .env
  • cleans
    else if remove one service:
  • remove_service(service)

plugins/static libraries

• nginx preparation deployment writing new conf testing replacing old conf start/restart cleaning
  stop
• wireguard deploy (with and without namespace) remove
• encryption deploy remove
• docker preparation deploy remove stop clean

functions/imports if too long

• user creation
• environment variables handling