commit c5f32b71f7f910a98acd3ac3388df287a8470a6f Author: claude Date: Tue Nov 10 17:45:17 2026 +0100 Initial commit: image Dopbase à partir du binaire officiel (étapes de install.sh) diff --git a/.env.example b/.env.example new file mode 100644 index 0000000..e066a55 --- /dev/null +++ b/.env.example @@ -0,0 +1,6 @@ +# cp .env.example .env +DOPBASE_VERSION=0.1.10 +DOPBASE_PORT=8840 +DOPBASE_PUBLIC_URL=http://localhost:8840 +# DOPBASE_ROOT_EMAIL=admin@example.com +# DOPBASE_TRUSTED_PROXIES=172.16.0.0/12 diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..4c49bd7 --- /dev/null +++ b/.gitignore @@ -0,0 +1 @@ +.env diff --git a/Dockerfile b/Dockerfile new file mode 100644 index 0000000..398cdc8 --- /dev/null +++ b/Dockerfile @@ -0,0 +1,65 @@ +# Dopbase : image a partir du binaire officiel des releases GitHub. +# Reprend les etapes de https://dopbase.com/install.sh (sans la telemetrie Umami) : +# resolution de version -> checksums.txt -> archive -> SHA-256 -> extraction du seul membre +# "dopbase" -> controle "dopbase --version". +# Le binaire Linux est un executable musl statique (static-pie) : aucune dependance glibc. + +# Tag de release (sans prefixe v, ex: 0.1.10) ou "latest" +ARG DOPBASE_VERSION=0.1.10 + +# --- 1. Telechargement et verification --------------------------------------- +FROM alpine:3.22 AS fetch +ARG DOPBASE_VERSION +ARG TARGETARCH +RUN apk add --no-cache curl +WORKDIR /tmp/dl +RUN set -eu; \ + repo="https://github.com/dopbase/dopbase"; \ + dl() { curl --fail --show-error --silent --location --connect-timeout 10 --retry 3 "$@"; }; \ + # Architecture : TARGETARCH (buildx) sinon uname -m + case "${TARGETARCH:-$(uname -m)}" in \ + amd64|x86_64) arch=amd64 ;; \ + arm64|aarch64) arch=arm64 ;; \ + *) echo "Architecture non supportee : ${TARGETARCH:-$(uname -m)}" >&2; exit 1 ;; \ + esac; \ + # Version : figee, ou resolue via la redirection de /releases/latest + if [ "${DOPBASE_VERSION}" = latest ]; then \ + tag=$(dl --head --output /dev/null --write-out '%{url_effective}' "${repo}/releases/latest"); \ + tag=${tag##*/}; \ + else \ + tag=${DOPBASE_VERSION}; \ + fi; \ + version=${tag#v}; \ + echo "${version}" | grep -Eq '^[0-9]+\.[0-9]+\.[0-9]+$' || { echo "Version invalide : ${tag}" >&2; exit 1; }; \ + archive="dopbase_${version}_linux_${arch}.tar.gz"; \ + base="${repo}/releases/download/${tag}"; \ + dl --output checksums.txt "${base}/checksums.txt"; \ + expected=$(awk -v a="${archive}" '$2 == a { n++; c = $1 } END { if (n != 1 || length(c) != 64) exit 1; print c }' checksums.txt); \ + dl --output "${archive}" "${base}/${archive}"; \ + echo "${expected} ${archive}" | sha256sum -c -; \ + tar -tzf "${archive}" | grep -qx dopbase; \ + tar -xOzf "${archive}" dopbase > /tmp/dopbase; \ + chmod 755 /tmp/dopbase; \ + reported=$(/tmp/dopbase --version); \ + [ "${reported}" = "v${version}" ] || { echo "Attendu v${version}, le binaire annonce ${reported}" >&2; exit 1; } + +# --- 2. Runtime -------------------------------------------------------------- +FROM alpine:3.22 +# UID 10001 identique a la variante "src" : le volume /data est interchangeable. +RUN apk add --no-cache ca-certificates \ + && addgroup -S -g 10001 dopbase \ + && adduser -S -D -H -u 10001 -G dopbase -h /data -s /sbin/nologin dopbase \ + && mkdir /data && chown dopbase:dopbase /data + +COPY --from=fetch /tmp/dopbase /usr/local/bin/dopbase + +ENV DOPBASE_DATA_DIR=/data \ + DOPBASE_HOST=0.0.0.0 \ + DOPBASE_PORT=8840 + +USER dopbase +VOLUME ["/data"] +EXPOSE 8840 + +ENTRYPOINT ["dopbase"] +CMD ["server", "start"] diff --git a/README.md b/README.md new file mode 100644 index 0000000..1d6397c --- /dev/null +++ b/README.md @@ -0,0 +1,94 @@ +# dopbase-docker-binaire + +Déploiement de [Dopbase](https://github.com/dopbase/dopbase) en docker-compose à partir du **binaire officiel** publié dans les releases GitHub. L'image reproduit les étapes de l'installeur officiel `https://dopbase.com/install.sh`, sans sa télémétrie. + +Variante « compilée depuis les sources » : [dopbase-docker-src](https://gitea.vlab.bzh/vLab-BZH/dopbase-docker-src). + +## Contenu + +| Fichier | Rôle | +|---|---| +| `Dockerfile` | Téléchargement et vérification du binaire, puis image runtime Alpine | +| `docker-compose.yml` | Service `dopbase`, volume `dopbase-data`, healthcheck HTTP | +| `.env.example` | Variables à copier dans `.env` | + +## Installation + +```bash +git clone git@gitea.vlab.bzh:vLab-BZH/dopbase-docker-binaire.git +cd dopbase-docker-binaire +cp .env.example .env +# éditer .env : DOPBASE_VERSION, DOPBASE_PUBLIC_URL, etc. +docker compose up -d --build +``` + +Les tags upstream n'ont **pas** de préfixe `v` : `DOPBASE_VERSION=0.1.10`. La valeur `latest` résout la dernière release au moment du build. Une version figée reste recommandée pour des builds reproductibles. + +Le build prend quelques secondes : seul un téléchargement d'environ 9 Mo est nécessaire. + +### Premier démarrage + +```bash +docker compose logs dopbase +``` + +Au premier démarrage, Dopbase affiche dans les logs un token / lien de setup. L'interface d'admin redirige vers `/setup` tant que le compte root n'est pas créé. + +Alternative : renseigner `DOPBASE_ROOT_EMAIL` dans `.env` avant le premier démarrage. Le compte root est alors créé directement, avec un mot de passe généré affiché **une seule fois** dans les logs. + +### Vérification + +```bash +docker compose ps # état healthy attendu +curl http://localhost:8840/api/v1/health +``` + +## Variables (`.env`) + +| Variable | Défaut | Description | +|---|---|---| +| `DOPBASE_VERSION` | `0.1.10` | Tag de release à installer, ou `latest` | +| `DOPBASE_PORT` | `8840` | Port publié sur l'hôte | +| `DOPBASE_PUBLIC_URL` | `http://localhost:8840` | URL vue par les clients (lien de setup, CLI). À adapter derrière un reverse proxy | +| `DOPBASE_ROOT_EMAIL` | vide | Optionnel : crée le root sans passer par le setup web | +| `DOPBASE_TRUSTED_PROXIES` | vide | IP/CIDR du reverse proxy, pour des logs d'audit corrects | + +## Architecture du Dockerfile + +Build multi-stage en 2 étapes : + +``` +┌────────────────────────────────┐ ┌─────────────────────────┐ +│ 1. fetch (alpine + curl) │ │ 2. runtime (alpine) │ +│ checksums.txt + archive .tar.gz │ ──▶ │ ca-certificates │ +│ SHA-256, extraction, --version │ │ user dopbase (10001) │ +└────────────────────────────────┘ └─────────────────────────┘ +``` + +1. **fetch**, équivalent de `install.sh` : + - choix de l'architecture via `TARGETARCH` (buildx) ou `uname -m` : `amd64` ou `arm64` ; + - résolution de la version (figée, ou `latest` via la redirection `releases/latest`) ; + - téléchargement de `checksums.txt` puis de `dopbase__linux_.tar.gz` ; + - vérification SHA-256 de l'archive ; + - extraction du seul membre `dopbase` (`tar -xOzf`), sans restaurer chemins ni permissions ; + - contrôle que `dopbase --version` renvoie exactement `v`. +2. **runtime** : Alpine avec `ca-certificates` (nécessaire pour les appels sortants, OIDC par exemple), binaire dans `/usr/local/bin/dopbase`, exécution en utilisateur non-root `dopbase` (UID 10001, identique à la variante src). Écoute sur `0.0.0.0:8840`, données dans `/data`. Commande : `dopbase server start`. + +Le binaire Linux officiel est un exécutable **musl statique** (`static-pie`, cible `x86_64-unknown-linux-musl`) : il n'a aucune dépendance glibc et tourne sur Alpine. L'UI d'admin Vue est embarquée dans le binaire. + +Différences avec `install.sh` : pas de télémétrie Umami, pas d'installation dans `~/.local/bin`. + +## Données et sauvegarde + +Le volume `dopbase-data` (`/data`) contient la base SQLite, `master.key` et les sauvegardes `.dop`. Sauvegarder le volume, et conserver `master.key` **séparément** de la base. + +## Exposition réseau + +Par défaut le port est publié sur toutes les interfaces de l'hôte. Pour un accès réseau, placer un reverse proxy TLS devant (recommandé par la doc upstream) et renseigner `DOPBASE_PUBLIC_URL` et `DOPBASE_TRUSTED_PROXIES`. Pour limiter à l'hôte local, préfixer le mapping par `127.0.0.1:` dans `docker-compose.yml`. + +## Mise à jour + +```bash +# changer DOPBASE_VERSION dans .env, puis +docker compose up -d --build +``` diff --git a/docker-compose.yml b/docker-compose.yml new file mode 100644 index 0000000..4a68a91 --- /dev/null +++ b/docker-compose.yml @@ -0,0 +1,34 @@ +services: + dopbase: + build: + context: . + args: + # tag de release dopbase/dopbase, sans prefixe v (ex: 0.1.10), ou "latest" + DOPBASE_VERSION: ${DOPBASE_VERSION:-0.1.10} + image: dopbase:bin-${DOPBASE_VERSION:-0.1.10} + container_name: dopbase + restart: unless-stopped + ports: + # Publie sur toutes les interfaces de l'hote. Prefixer par "127.0.0.1:" pour limiter a l'hote, + # et mettre un reverse proxy TLS devant pour tout acces reseau (recommande par la doc). + - "${DOPBASE_PORT:-8840}:8840" + environment: + # URL que les clients utilisent (lien de setup, CLI). A adapter si reverse proxy. + DOPBASE_PUBLIC_URL: ${DOPBASE_PUBLIC_URL:-http://localhost:8840} + # Optionnel : cree root sans passer par le setup web (mot de passe genere, affiche UNE fois dans les logs). + # Laisser vide pour utiliser le lien de setup web affiche dans les logs au premier demarrage. + DOPBASE_ROOT_EMAIL: ${DOPBASE_ROOT_EMAIL:-} + # Si un reverse proxy tourne devant (IP/CIDR du proxy), pour des logs d'audit corrects. + DOPBASE_TRUSTED_PROXIES: ${DOPBASE_TRUSTED_PROXIES:-} + volumes: + # SQLite + master.key + backups (.dop) : a sauvegarder, la cle separement de la base. + - dopbase-data:/data + healthcheck: + test: ["CMD", "wget", "-q", "-O", "/dev/null", "http://127.0.0.1:8840/api/v1/health"] + interval: 30s + timeout: 5s + retries: 3 + start_period: 20s + +volumes: + dopbase-data: