README.md

mborne/docker-devbox

Provides stacks to setup a container-based development environment with Docker or Kubernetes for some of them.

Motivation

This is my playground to learn and illustrate how to deploy application with docker compose and helm.

Getting started

Usage with docker :

• Install docker compose plugin
• Create devbox's network : docker network create devbox
• Try some stacks, for example :
  • redis
  • traefik to get https://whoami.dev.localhost instead of http://localhost:8888
  • portainer to get a web based UI for docker
  • ...

Usage with Kubernetes :

• Install kubectl and helm
• Configure kubectl to use a DEV instance (see kind/README.md - quickstart.sh)

Stacks

Load balancer and reverse proxy

• traefik : A reverse proxy including configuration discovery mechanism.
• whoami : An helloworld app to test traefik.
• cert-manager : An helper to generate TLS certificates from various issuers including LetsEncrypt (K8S only)

Web UI

• portainer : Web-based UI for Kubernetes, Docker, Swarm and Nomad.
• headlamp : Web-based UI for Kubernetes
• kubernetes-dashboard : Web-based UI for Kubernetes (retired)

LLM

• ollama : Ollama API to use locally open LLM models.
• AnythingLLM : Web-based UI (ChatGPT-like) for Ollama and others.
• Open WebUI : Web-based UI (ChatGPT-like) for Ollama and others.

CI/CD pipeline

• ArgoCD : GitOps continuous delivery tool for Kubernetes.
• Jenkins : Open source automation server with hundred of plugins (ansible, jmeter,...).

Authentication

See also dex and oauth2-proxy

• Keycloak : Open Source Identity and Access Management providing OIDC and SAML implementation (K8S not implemented)

Storage

• s3-dev : S3 compatible API based on rclone serve s3.
• Longhorn : Distributed block storage for K8S providing ReadWriteMany volumes (K8S only).
• nfs-subdir-external-provisioner : Provides ReadWriteMany volumes using existing NFS server.
  • nfs-server : NFS server to test nfs-subdir-external-provisioner.

Database

• Redis
• Valkey (forked from Redis)
• CloudNativePG with some PostgreSQL/PostGIS examples.
• PostGIS : PostgreSQL with the spatial extension PostGIS.
• CloudBeaver : Web-based UI for SQL databases (docker only)

Logging and monitoring

Option 1 :

• Grafana : Grafana with Loki and Prometheus datasources and dashboards preconfigured.
• Prometheus : Grafana/Prometheus for system and monitoring.
• Loki : Grafana/Loki to store logs with Grafana/Promtail to ship logs.
• x509-certificate-exporter : Prometheus exportor to monitor TLS certicates (K8S only)

Option 2 (variant of the famous ELK stack) :

• OpenSearch : OpenSearch and OpenSearch Dashboards (fork from ElasticSearch and Kibana by AWS).
• fluent : fluent-bit sending containers and systemd logs to OpenSearch.

Security

• kyverno : kyverno with kyverno-policies and Policy Reporter (metrics & UI).
• trivy : trivy-operator from Aqua Security (K8S only)
• SonarQube : Centralisation of Code Quality and Code Security metrics.

Mailing

• Mailpit : Email & SMTP testing tool with API for developers (docker only)

License

MIT