Déployer PocketBase.Conservez durablement les données de ce backend compact.
Démarrez un backend PocketBase à version fixe, avec son API, son authentification, ses abonnements en temps réel, son stockage de fichiers et son interface d’administration protégée par des identifiants générés.
Même opérationnel, un projet PocketBase doit être mis en production en toute sécurité.
L’application ou le service ne représente qu’une partie de la production. Les résultats de compilation, l’état d’exécution, les contrôles de santé, les secrets, les journaux, les routes et la version promue doivent pouvoir être examinés ensemble.
Démarrer PocketBase à partir d'un modèle versionné
Le modèle officiel télécharge PocketBase 0.40.2 pour amd64 ou arm64, vérifie sa somme de contrôle fixée, génère une clé de chiffrement et un mot de passe superutilisateur, et crée le premier administrateur de manière idempotente.
Faire de la persistance une décision explicite
La base SQLite, les fichiers téléversés, les paramètres et les sauvegardes locales partagent un seul volume persistant /app/pb_data. Le modèle utilise volontairement une seule réplique pour conserver la cohérence de cet état.
Garder l'état de service visible pour les opérateurs
Utilisez /api/health pour vérifier la disponibilité, ouvrez /_/ pour l’administration et sauvegardez le volume de données avec les secrets stables de chiffrement et du superutilisateur.
Du code source à la mise en production
Trois étapes vous permettent de vérifier le parcours de déploiement.
Utilisez le code source et le fonctionnement en production déjà définis pour le projet. Le manifeste décrit ce que la plateforme doit compiler ou provisionner et les critères à remplir pour que le résultat soit prêt.
01
Commencer par la source ou un modèle
Importez le dépôt existant, ou examinez et déployez l’une des variantes de modèles précisément référencées ci-dessous.
$adios login
02
Revoir le contrat de déploiement
Consignez dans adios.yaml les commandes, la version de l’environnement d’exécution ou du service, les critères de santé et les références aux secrets.
$git diff -- adios.yaml
03
Déployer et inspecter le résultat
Suivez les résultats de compilation et d’exécution, vérifiez la version candidate, puis ouvrez la route ou la connexion de service promue en production.
Le modèle complet fixe les sommes de contrôle de la version pour chaque architecture et définit l’adresse e-mail du premier superutilisateur à admin@pocketbase.local.
Points de départ déployables
Démarrer PocketBase à partir d'un modèle lorsque le dépôt n'est pas prêt.
Examinez le modèle PocketBase complet, clonez son dépôt autonome ou déployez-le directement avec la clé publique pocketbase.
Applications Web
PocketBase 0.40.2
PocketBase 0.40.2 avec données SQLite persistantes, identifiants de superutilisateur générés et API intégrées d’authentification et de temps réel.
Go / SQLiteVersion du projet d’origine
Clé du modèle
pocketbase
Environnement d’exécution
pinned binary
Dépôt
template-pocketbase
Emplacement de la source
.
git clone https://github.com/adiosdotdev/template-pocketbase.git
cd template-pocketbase
adios up
Vérifier la charge de travail.Puis promouvez la version en production.
Pour sécuriser la première mise en production, partez d’une compilation ou d’une configuration de service reproductible et d’un aperçu qui sollicite les dépendances réellement utilisées en production.
Prêt quand...
Le mot de passe du superutilisateur généré est récupéré en toute sécurité.
L’interface d’administration n’est accessible que sur la route prévue.
Les enregistrements de la base de données et les fichiers téléversés sont conservés lors d’une nouvelle mise en production.
La restauration des données et du secret de chiffrement est testée conjointement.
Prévisualiser quand...
Une migration ou un hook modifie le modèle de données.
Les fichiers téléversés volumineux modifient les besoins en espace disque et en sauvegarde.
La charge de travail doit pouvoir exécuter plusieurs répliques.
Les réponses à vos questions
Ce qu’il faut savoir avant de déployer PocketBase.
Vérifiez les limites de l’environnement d’exécution ou du service, le chemin du modèle, le comportement en cas d’échec et les contrôles de production avant de créer la première version.
Puis-je déployer PocketBase à partir d’un modèle officiel ?
Oui. Choisissez le modèle PocketBase correspondant à la version ou à la configuration souhaitée, stockez les identifiants dans des secrets Adios et déployez-le depuis la console ou avec adios up.
Le modèle PocketBase utilise-t-il un stockage persistant ?
La base SQLite, les fichiers téléversés, les paramètres et les sauvegardes locales partagent un seul volume persistant /app/pb_data. Le modèle utilise volontairement une seule réplique pour conserver la cohérence de cet état.
Où se trouve l’interface d’administration PocketBase ?
Ouvrez /_/ sur la route HTTPS générée. Le modèle crée admin@pocketbase.local et enregistre son mot de passe généré dans un secret Adios.
Ce modèle PocketBase peut-il exécuter plusieurs répliques ?
Pas en toute sécurité avec cette configuration basée sur SQLite local et le stockage de fichiers. Elle utilise volontairement une seule réplique ; choisissez une autre architecture si l’application nécessite un état backend répliqué horizontalement.
Où stocker les mots de passe de la base de données et du broker ?
Stockez les valeurs sensibles dans les secrets Adios et référencez-les avec secret://NAME. Ne placez pas les identifiants de production directement dans adios.yaml et ne les enregistrez pas dans Git.
Que dois-je vérifier avant de recevoir du trafic de production ?
Vérifiez l’authentification, la connectivité applicative, les écritures et lectures, la persistance après redémarrage, les besoins de sauvegarde ou de restauration, la capacité et le comportement en cas d’échec de chaque application dépendante.