Lancer barrel dans Docker
L’image barrel-server lance barrel_server, le nœud HTTP de barrel, avec les backends de pièces jointes système de fichiers et S3. Utilisez-la quand vous voulez un nœud barrel sur un serveur ou dans un cluster sans installer Erlang. Vous la configurez avec des variables d’environnement, ou vous montez votre propre sys.config quand il vous en faut plus.
Démarrer un nœud
$ docker run -d --name barrel -p 8080:8080 \
-v barrel-data:/data \
-e BARREL_AUTH_TOKENS=change-me \
ghcr.io/barrel-db/barrel-server:latest
$ curl localhost:8080/ready
{"status":"ready"}
Créez une base et écrivez un document :
$ curl -XPUT localhost:8080/db/notes -H 'authorization: Bearer change-me'
$ curl -XPUT localhost:8080/db/notes/doc/hello -H 'authorization: Bearer change-me' \
-H 'content-type: application/json' -d '{"text": "hello"}'
Le guide du serveur REST liste toutes les routes.
Réglages
| Variable | Défaut | Ce qu’elle règle |
|---|---|---|
BARREL_HTTP_PORT | 8080 | Port HTTP dans le conteneur |
BARREL_DATA_DIR | /data | Où vivent les bases et les index ; gardez-le sur un volume |
BARREL_AUTH_TOKENS | aucun | Jetons bearer séparés par des virgules |
BARREL_AUTH_TOKENS_FILE | aucun | Un fichier avec un jeton par ligne, pour les secrets Docker ou Kubernetes |
BARREL_LOG_LEVEL | info | debug, info, notice, warning ou error |
BARREL_NODE_NAME | barrel@127.0.0.1 | Nom du nœud Erlang |
BARREL_COOKIE | aléatoire | Cookie de distribution Erlang |
Sans jeton, le serveur accepte toutes les requêtes et journalise un avertissement au démarrage. Définissez au moins un jeton sur tout nœud que d’autres peuvent joindre. /health et /ready n’ont jamais besoin de jeton.
Garder les jetons dans un secret
services:
barrel:
image: ghcr.io/barrel-db/barrel-server:latest
ports: ["8080:8080"]
volumes: ["barrel-data:/data"]
environment:
BARREL_AUTH_TOKENS_FILE: /run/secrets/barrel_tokens
secrets: [barrel_tokens]
secrets:
barrel_tokens:
file: ./tokens.txt
volumes:
barrel-data:
Utiliser votre propre configuration
Pour les listeners TLS, HTTP/2 et HTTP/3, les requêtes signées, CORS, MCP ou les pièces jointes S3, écrivez un sys.config et montez-le sur /etc/barrel/sys.config. Les variables d’environnement ci-dessus sont alors ignorées. Montez /etc/barrel/vm.args de la même façon pour définir les options de la VM Erlang.
[
{barrel_server, [
{data_dir, "/data/docdb"},
{auth, #{tokens => [<<"change-me">>]}},
{listeners, #{https => #{port => 8443}}},
{tls, #{certfile => "/etc/barrel/cert.pem", keyfile => "/etc/barrel/key.pem"}}
]},
{barrel_docdb, [{data_dir, "/data/docdb"}]},
{barrel_ngram, [{data_dir, "/data/ngram"}]}
].
$ docker run -d -p 8443:8443 -v barrel-data:/data \
-v $PWD/barrel:/etc/barrel:ro \
ghcr.io/barrel-db/barrel-server:latest
Le guide de synchronisation décrit les clés des listeners et de TLS.
Ouvrir un shell distant
$ docker exec -it barrel barrel remote_console
Construire l’image vous-même
Depuis un checkout du dépôt :
$ docker build -t barrel-server .
Notes
- Le conteneur tourne sous l’utilisateur
barrel(uid 1000). Un répertoire de données monté depuis l’hôte (bind mount) doit être accessible en écriture pour cet uid. - Le health check appelle
/readysurBARREL_HTTP_PORT:docker psmontre donc le nœud comme sain dès que les processus de la base et de la réplication tournent. Si votre propre configuration sert HTTP sur un autre port, réglezBARREL_HTTP_PORTsur ce port. - Les images sont publiées pour
linux/amd64etlinux/arm64avec chaque bundle Barrel, taguées avec le bundle (YYYY.MM.N) etlatest. Épinglez un tag de bundle en production.