Liking cljdoc? Tell your friends :D

dda-pallet

Clojars Project Build Status

DeltaChat chat over e-mail | team@social.meissa-gmbh.de team@social.meissa-gmbh.de | Website & Blog

dda-pallet is a DevOps system for cloud image provisioning, test driven DevOps and continuous server configuration. dda-pallet allows to build your own abstraction layer very easily as pure data to data transformation while providing a stable low level API. It is modular, testable and well-prepared for the handling of configuration data. dda-pallet is open-source, written in Clojure and runs on the proven Java Virtual Machine. Anyone who has dealt with Infrastructure as Code so far, has to deal with a mix of Ruby, Python and Go. If you want to get more from the Java world and if you always wanted to try functional programming, there is now a worthy & fresh alternative: "dda-pallet".

Compatibility

Dda-pallet is compatible with the following versions

  • pallet 0.9
  • clojure 1.10
  • (x)ubuntu 18.04 / 20.04

Principles

  • Adaptable architectural Abstraction Layer: Every Module provides two levels of API. First the low level API oriented on linux installation artifacts is named Infrastructure API. The high level API represents every kind of abstraction and it is named Domain API. So the Infrastructure API is the place for collaboration and knowldege sharing across the whole community. The Domain API is the place to encapsulate your own defaults and architectural decisions. Even if we provide our Domain API as example, it is very easy and intended for you to build your own abstractions aside.
  • Imutable infrastructure: We do most of our installations as one shoot installation. This helps to keep things simple and aligns to the clouds immutable infrastructure model.
  • Distinction between installation and configuration: We distinguish between one shoot installation and continuous configuration. Sometimes immutability does not work for infrastructure, sometimes a rapid configuration change has to be applied to stateful targets. For these cases our modules use the configuration stage.
  • Facts: We collect all the system state information needed at a defined place and point in time. We call them facts. We use facts for running our tests and sometimes to decide how to do continuous configuration. But to keep things simple, we try to use facts very rarely.
  • Full modularization: We separate our modules into common usable system adapters and company specific convention modules. Beside this general principle we are using the full tool stack provided by Clojure. Every pice of code may be factored out as cloujure jar, named and versioned.
  • Configuration is data: In order to keep the interface simple, clean & isolated, we handle all configuration as data. There is no hidden magic.
  • Test-driven DevOps: Domain API as data to data transformation makes it easy, to do unit tests. For the Infrastructure API we are heading towards state-of-the-art integration tests - comparable to Kitchen / Vagrant / Server-spec or packer.

dda-pallet is the core library. If you are looking for ready to provision modules you will find many dda-pallet modules named dda-*-crate aside of this project. Most of them provide a fat-jar for instant usage.

TechDebt Roadmap

Find closer description to the design decisions outlined here: https://dda.gitbooks.io/domaindrivenarchitecture/content/v/6aa12e6226098abf944b87485e0f45a9dcef8395/en/80_devops/40_architecture/Decisions.html

VersionDockerized Integration TestsArtefacts by CISubcomp. LicTarget %sbreak on errormodern hashesuse data-testpyb for dockerprovizionizeconvention instead of domain[infra as primary api]remove '-crate'
dda-config-commons1.5--x------ -
dda-povision0.2--x------ -
dda-pallet-commons1.5--x------ -
dda-pallet4.0--x-x- --xx
dda-user-crate3.0xxxxxx xxx
dda-backup0.1 x
dda-git-crate3.0xxxxxxxxxxx
dda-hardening-crate1.1
dda-k8s-crate1.1xxxxxxx-xx
dda-managed-ide3.1xxxxxxx
dda-managed-vm2.6xxxxxxxxx
dda-serverspec-crate2.0xxxxxxxx-x
dda-smeagol-crate0.1xxxx

License

Copyright © 2015 - 2021 meissa GmbH Licensed under the Apache License, Version 2.0 (the "License") Pls. find licenses of our subcomponents here

Can you improve this documentation? These fine people already did:
jem, Michael Jerger, M.Jerger, scl, Jan Krebs, Lucca Hellriegel, Vlad Bokov, zwa, Tim Heaney & luccr1
Edit on GitHub

cljdoc is a website building & hosting documentation for Clojure/Script libraries

× close