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.
 
 
Valentin Lab 7981ed7dec new: add doc to ``sftp`` charm 2 weeks ago
apache fix: dev: removed ``--force-yes`` everywhere as it is deprecated 6 months ago
bitwarden new: [bitwarden] upgrade to ``1.22.2``. 3 months ago
cron fix: dev: removed ``--force-yes`` everywhere as it is deprecated 6 months ago
cyclos new: [cyclos] new database with more standardized payment types and bug fixes 4 months ago
cyclos-ui new: [cyclos-ui] new charm 1 year ago
docker-host new: [docker-host] set system timezone 3 years ago
docker-registry new: dev: [apache] store a ``url`` argument instead of a ``protocol`` argument. 3 years ago
docker-registry-auth new: [docker-registry-auth] allow usage of acl rules for public access. 2 years ago
drone new: [drone] add ``backup`` relation 7 months ago
drone-agent new: [drone-agent] implemented labels 3 years ago
etherpad fix: [etherpad] keep API key 1 month ago
gitea chg: [gitea] update to 1.14.2 5 months ago
gitlab new: [gitlab] new charm 3 years ago
gogocarto fix: [gogocarto] allow to follow redirection when downloading release 7 months ago
gogocartojs new: [gogocartojs] added charm 2 years ago
hedgedoc fix: [hedgedoc] fix upload of image and updatge to ``1.7.2`` 9 months ago
letsencrypt fix: [letsencrypt] wildcard domains would fail to be created 1 year ago
lo-xcgd new: [py3o-{fusion,server},lo-xcgd] add charm 2 years ago
logrotate chg: [logrotate] be more verbose 9 months ago
mariadb fix: [mariabd] bad typo would prevent dump to be made 5 months ago
mattermost fix: [mongo,odoo-tecnativa,mattermost,peertube,synapse,rocketchat,redis] avoid using ``find``'s ``-exec`` option as it fails 2 years ago
mongo new: [bitwarden,mongo,nextcloud,rocketchat] added backup relation 1 year ago
monujo new: [monujo] add charm 4 months ago
mysql fix: dev: removed ``--force-yes`` everywhere as it is deprecated 6 months ago
nextcloud new: [nextcloud] allow to override image locally 9 months ago
odoo-tecnativa new: [odoo-tecnativa] add ``install`` action to install module into database 1 month ago
onlyoffice chg: [onlyoffice] add backup to onlyoffice, relunctantly 5 months ago
peertube new: [peertube] update to v3.3.0 3 months ago
piwigo new: [piwigo] added ``backup`` relation. 1 year ago
postgres chg: [postgres] change ``backup`` relation from ``optional`` to is ``recommended`` 7 months ago
postgres-alpine new: ``charm`` and ``service`` are now clear distinct concept 3 years ago
precise fix: [docker-host] support fixing root SSL certificate for older hosts 3 weeks ago
py3o-fusion new: [py3o-{fusion,server},lo-xcgd] add charm 2 years ago
py3o-server new: [py3o-{fusion,server},lo-xcgd] add charm 2 years ago
radicale new: added ``radicale``. 4 years ago
rancher chg: [mattermost,odoo-tecnativa,rancher-agent,rancher,traefik] restart policy is now automatically set for non run-once services. 3 years ago
rancher-agent chg: [mattermost,odoo-tecnativa,rancher-agent,rancher,traefik] restart policy is now automatically set for non run-once services. 3 years ago
redis new: [apache,peertube,redis] added new backup relation 1 year ago
rocketchat chg: [rocketchat] update to version ``3.18.1`` 1 month ago
rsync-backup new: [rsync-backup] add ``compose.yml`` to backup 6 months ago
rsync-backup-target new: [rsync-backup-target] allow backup account to request a recovery key 6 months ago
searx new: [searx] add charm 8 months ago
sftp new: add doc to ``sftp`` charm 2 weeks ago
softether new: [softether] new charm. 5 years ago
synapse fix: [mongo,odoo-tecnativa,mattermost,peertube,synapse,rocketchat,redis] avoid using ``find``'s ``-exec`` option as it fails 2 years ago
traefik chg: [mattermost,odoo-tecnativa,rancher-agent,rancher,traefik] restart policy is now automatically set for non run-once services. 3 years ago
vsftp new: [vsftp] new charm 3 years ago
whoami new: [traefik,whoami] new charms 3 years ago
README.org chg: updated the README and changed to ``org`` format 1 year ago

README.org

0k-charms

This package provides charms, which are special system recipes, that are meant to be executable and mangled together to allow managing a wide set of services.

Inspired by juju charms, these are mostly bash scripts organized by service and meant to automate all administration tasks, from installation, to connection with other services, or any other task a service would need.

Several tools are able to read the current state of this repository to effectively deploy full production grade services on different type of platform.

The only real fully functional implementation is 0k-compose. It will use these charms to drive, prepare, and build in docker, complete sets of services.

Another old solution called lxc-deploy was used actively before to deploy services on LXC tool set until 2016 using these charms.

Bare hosts can also replay some recipes to install services directly on them via the 0k-charm project using the charm apply command. Note that actually, as most recipes are bash executable, it is still a viable option to copy-paste parts of source-code of these scripts. These last two options are still used very often to bootstrap installs of docker-hosts for instance.

Maturity

Charms in these repository are in a wide set of maturity, from simple note taking of shell commands, not even executable, to full charm allowing to deploy services and manage the full life cycle of the service.

The repository in a whole is thus NOT considered as mature at all, and will require some thorough cleaning and decisions to furthermore structure to reach a state where it'll make sense to go full public.

Usage

TODO Through compose for full deployment of sets of services

Requires 0k-compose package that contains the compose command line tool.

TBD

TODO Through lxc-deploy for full install and deployment of services

Requires lxc-scripts package that holds several tools for LXC management, amongst them is lxc-deploy.

TBD

TODO Through docker-build-charm for docker image creation

Requires 0k-docker package that holds several tools for docker management, amongst them is docker-build-charm.

docker-build-charm will use the install recipes in a charm to basically mimic the Dockerfile purpose and create a docker image for a specific service.

TBD

TODO Through 0k-charm for bare hosts installs

Requires 0k-charm package to get the charm command line util.

TBD

Installation

Most tools should check the CHARM_STORE bash environment variable that should be the path to reach the root of this repository. If not defined, most tools will look in /srv/charm-store by default.