Démarrage on bouine

Installation

Mon, 01 Jan 0001 00:00:00 +0000

Docker

Le moyen le plus rapide d’exécuter bouine est l’image Docker :

docker pull bouinecache/bouine:latest
docker run --rm -p 8080:80 -p 9000:9000 bouinecache/bouine:latest

L’image par défaut inclut une configuration minimale dans /etc/bouine/config.yaml afin que le conteneur démarre sans montage de volume.

Démarrage rapide

Mon, 01 Jan 0001 00:00:00 +0000

Démarrez un petit serveur d’origine :

mkdir -p /tmp/bouine-origin
printf 'hello from origin\n' > /tmp/bouine-origin/index.html
python3 -m http.server 3000 --directory /tmp/bouine-origin

Créez config.yaml :

listen:
 http: ":8080"
 admin: ":9000"

storage:
 hot_max_bytes: 256Mo

upstream_pools:
 - name: origin
 targets: ["127.0.0.1:3000"]

routes:
 - match: { path_prefix: / }
 pool: origin
 cache:
 ttl_default: 60s
 stale_while_revalidate: 10s
 stale_if_error: 300s

Exécutez bouine :

Docker

Mon, 01 Jan 0001 00:00:00 +0000

Exécuter l’image officielle

docker run --rm \
 -p 8080:80 \
 -p 9000:9000 \
 bouinecache/bouine:latest

Monter un fichier de configuration

docker run --rm \
 -p 8080:80 \
 -p 9000:9000 \
 -v "$PWD/config.yaml:/etc/bouine/config.yaml:ro" \
 bouinecache/bouine:latest

Construire localement

Sur Apple Silicon ciblant un cluster Linux amd64 :

Kubernetes

Mon, 01 Jan 0001 00:00:00 +0000

Ajouter le dépôt de charts

bouine publie un dépôt de charts Helm à l’adresse https://charts.bouine.org, indexé sur Artifact Hub. Le chart récupère l’image bouinecache/bouine depuis Docker Hub par défaut.

helm repo add bouine https://charts.bouine.org
helm repo update
helm search repo bouine

NAME CHART VERSION APP VERSION DESCRIPTION
bouine/bouine 0.5.8 0.5.8 Cloud-native HTTP cache in Go ...

Démarrage rapide Helm

helm install bouine bouine/bouine \
 --namespace bouine --create-namespace \
 --set "config.upstream_pools[0].name=app" \
 --set "config.upstream_pools[0].targets[0]=app.default.svc:8080" \
 --set "config.routes[0].pool=app"

Cela déploie un StatefulSet avec clustering par gossip, un Service headless pour la découverte des pairs et un PodDisruptionBudget.

Example configurations

Mon, 01 Jan 0001 00:00:00 +0000

Static site / blog

listen:
 http: ":8080"
 admin: ":9000"

storage:
 hot_max_bytes: 64Mo

upstream_pools:
 - name: site
 targets: ["site.default.svc.cluster.local:80"]

routes:
 - match: { path_prefix: /assets/ }
 pool: site
 cache:
 ttl_default: 86400s
 stale_if_error: 604800s
 jitter_percent: 10

 - match: { path_prefix: / }
 pool: site
 cache:
 ttl_default: 300s
 stale_while_revalidate: 60s
 stale_if_error: 86400s
 jitter_percent: 15

Self-served static site (no origin server)

bouine can serve files directly from disk — no separate nginx or Caddy needed. See Static file serving for the full reference.