provisioning tool for building opinionated architecture
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
pvincent 72ed035132 smtp-check 4 weeks ago
.vscode second commit 3 months ago
lib passthrough ok 4 weeks ago
recipes nftables missing 1 month ago
scripts smtp-check 4 weeks ago
templates passthrough ok 4 weeks ago
.gitignore passthrough ok 4 weeks ago
.semver_git_tag tagged as 0.0.3 3 months ago
LICENSE second commit 3 months ago
README.md readme 2 months ago

README.md

MIAOU

provisioning tool for building opinionated architecture following these principles:

  • free software: AGPLv3
  • multi-target: DEV, BETA (alias staging), PROD
  • container-based: LXD/LXC on Debian 12 (bookworm)
  • secured: NFT
  • monitored: MONIT

TODO

  • backup postgresql missing out on saturday
  • TOOLBOOX/nc (binary)
  • final ansible-like indicators: same/new
  • patched editor (backup+editor+diff+patch)
  • to improve log journal for each recipe (apache, for example) in order to shorten disk space

ORIGIN

The project name miaou comes up from both a French and Reunion's Creole pun

  • miaou is a shortcut for mi aim aou, which means 'I love you'
  • miaou means 'meow' in french, related to the acronym C.H.A.T.O.N.S

ARCHITECTURE

to draw... (mermaid?)

  • DEV (sync from PROD via SAVE, sync from BETA, push new to BETA)
  • BETA (sync from PROD via SAVE, push new to PROD)
  • PROD (backup to SAVE, full backup, recipe data backup)
  • SAVE (dedicated server, home local)

ACTIVE COMPONENTS

  • grub
    • cgroup1
  • linux
  • rust
    • tera
  • go
  • perl
  • python
    • ovh
  • bash
    • miaou-bash

Debian12 fresh install

  • log as normal user with sudo group

  • sudo apt install -y git
  • git clone https://git.artcode.re/miaou/miaou.git
  • EITHER:

    • ./miaou/lib/install.sh dev
    • OR:

    • EMAIL=<your email> ./miaou/lib/install.sh dev
  • then, FINALLY

  • miaou

Nested container test drive

  • CONTAINER=nested
  • lxc-miaou-create $CONTAINER -o sameuser,nesting
  • lxc sameuser $CONTAINER
    • /opt/miaou/lib/install.sh dev

Hardening server

  • /opt/miaou/lib/harden.sh

Development mode

  • requirement Codium IDE

  • sudo apt install y shellcheck shfmt