La CLI lampion couvre l'intégralité de l'API : projets, branches, endpoints, SQL, rôles, extensions, backups, anonymisation. Output formaté avec Rich pour l'humain, sortie JSON pour l'automatisation.
pip install lampion-cli · PyPI · Python 3.9+
Pour les agents IA, voir le serveur MCP. Pour le détail des endpoints, la référence API.
# installer, configurer le token, lister $ pip install lampion-cli $ export LAMPION_TOKEN=lmp_live_… $ lampion projects list → my-app · fr-par-1 · running
Un paquet PyPI, aucune dépendance système. Exportez une clé API scopée et la CLI parle à l'API de production.
# installer depuis PyPI $ pip install lampion-cli $ uv pip install lampion-cli # exporter la clé API scopée $ export LAMPION_TOKEN=lmp_live_xxxxxxxxxxxxxxxx # (optionnel) cibler une autre API $ export LAMPION_API_URL=https://api.lampion.cloud
Générez une clé API dans Settings › API Keys de la console.
Créez un projet, récupérez le connection string, exécutez du SQL, forkez une branch pour tester — le tout sans quitter le terminal.
# créer un projet sur Scaleway Paris $ lampion projects create my-app --region fr-par-1 ✓ Project created: abc123 (fr-par-1) # lister les endpoints pour le connection string $ lampion endpoints list abc123 ┌──────────┬─────────┬──────────────────────────────────────────┐ │ ID │ Status │ Connection String │ ├──────────┼─────────┼──────────────────────────────────────────┤ │ ep-abc │ running │ postgresql://cloud_admin:[email protected]… │ └──────────┴─────────┴──────────────────────────────────────────┘ # exécuter du SQL $ lampion sql abc123 ep-abc "SELECT count(*) FROM users" ┌─────────┐ │ count │ ├─────────┤ │ 42,847 │ └─────────┘ # créer une branch, tester, supprimer $ lampion branches create abc123 staging --parent abc123 ✓ Branch created: stg-tid (staging) $ lampion branches delete abc123 stg-tid ✓ Deleted
Chaque commande de la CLI, regroupée par domaine. Toutes suivent la même forme : lampion <groupe> <action> <arguments>.
lampion projects list Lister les projets lampion projects create my-app --region fr-par-1 Créer un projet lampion projects get <id> Détails d'un projet lampion projects delete <id> Supprimer un projet lampion branches list <pid> Lister les branches lampion branches create <pid> dev --parent <pid> Créer une branch CoW lampion branches reset <pid> <bid> Reset au parent lampion branches merge <pid> <bid> --dry-run Merger le schéma (preview) lampion branches promote <pid> <bid> Promouvoir en main lampion branches delete <pid> <bid> Supprimer une branch lampion endpoints list <pid> Lister les computes lampion endpoints suspend <pid> <eid> Scale to zero lampion endpoints resume <pid> <eid> Relancer lampion sql <pid> <eid> "SELECT ..." Exécuter du SQL lampion schema <pid> --database postgres Introspecter le schéma lampion databases list <pid> <eid> Lister les databases lampion databases create <pid> <eid> mydb Créer une database lampion roles list <pid> <eid> Lister les rôles lampion roles create <pid> <eid> app_user Créer un rôle lampion extensions list <pid> <eid> Lister lampion extensions install <pid> <eid> pgvector Installer lampion extensions uninstall <pid> <eid> pgvector Désinstaller lampion metrics <pid> CPU, RAM, connexions, cache lampion slow-queries <pid> <eid> Top requêtes lentes lampion logs <pid> <eid> --lines 50 Tail des logs PG lampion usage <pid> Usage compute/storage lampion backups list <pid> Lister les snapshots lampion backups create <pid> <bid> "name" Créer un snapshot lampion backups restore <pid> <bkid> Restaurer lampion dump <pid> <eid> -o dump.sql Export pg_dump lampion anon status <pid> <bid> Statut anonymisation lampion anon enable <pid> <bid> Activer le masking lampion anon add-rule <pid> <bid> --table users --column email --function "anon.fake_email()" Ajouter une règle lampion anon disable <pid> <bid> Désactiver lampion allowlist get <pid> <eid> IP allowlist lampion allowlist set <pid> <eid> 1.2.3.4/32 Configurer l'allowlist lampion permissions list <pid> <eid> Permissions par rôle lampion permissions grant <pid> <eid> --role app --table users --privilege SELECT GRANT lampion residency <pid> Localisation des données Par défaut, l'output est formaté avec Rich pour la lecture. Ajoutez --json et chaque commande list devient parsable par jq, un script ou un pipeline CI/CD.
# sortie JSON brute $ lampion projects list --json [{"id":"abc123","name":"my-app","region":"fr-par-1"}] # extraire un champ avec jq $ lampion projects list --json | jq '.[].id' "abc123"
Passez --region à la création d'un projet. Infrastructure Scaleway à Paris — vos données ne quittent jamais le territoire ; d'autres régions souveraines sont sur la roadmap.
| Région | Opérateur | Localisation |
|---|---|---|
| fr-par-1 | Scaleway | Paris — Vitry-sur-Seine |
| fr-par-2 | Scaleway | Paris — Saint-Ouen-l'Aumône |