入门 on bouine

安装

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

Docker

运行 bouine 最快的方式是使用 Docker 镜像：

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

默认镜像包含 /etc/bouine/config.yaml 中的最小配置，因此容器无需挂载卷即可启动。

生产环境

将您自己的配置挂载到 /etc/bouine/config.yaml，或使用 Helm chart 让 Kubernetes 管理 ConfigMap。

快速开始

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

Start a tiny origin server:

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

Create 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

Run bouine:

Docker

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

运行官方镜像

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

挂载配置文件

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

本地构建

在 Apple Silicon 上构建 Linux amd64 集群：

Kubernetes

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

添加 chart 仓库

bouine 发布 Helm chart 仓库到 https://charts.bouine.org，索引在 Artifact Hub。 chart 默认从 Docker Hub 拉取 bouinecache/bouine 镜像。

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 ...

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"

这会部署一个带 gossip 集群的 StatefulSet、一个 headless Service 用于节点发现，以及一个 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.