Initial commit: image Dopbase à partir du binaire officiel (étapes de install.sh)
This commit is contained in:
commit
c5f32b71f7
5 files changed
+200
No files matched your search
@@ -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_<version>_linux_<arch>.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<version>`.
|
||||
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
|
||||
```
|
||||
Reference in new issue
Block a user