bext Cloud
bext Cloud est le plan de contrôle de vos sites et projets. Utilisez le tableau de bord, l'API authentifiée ou un client MCP compatible pour travailler avec le même compte et ses autorisations.
Choisissez une tâche#
| Je veux… | Commencez ici |
|---|---|
| Créer un site WordPress, PrestaShop ou PRISM | Sites et déploiements |
| Déployer un projet Git configuré | Déployer à partir d'un référentiel |
| Publier sur mon propre domaine | Connecter un domaine |
| Créer ou télécharger une sauvegarde | Sauvegardes |
| Laisser un assistant gérer mes sites | Serveur Cloud MCP |
| Utiliser la plateforme en tant qu'administrateur | Panneau d'administration |
Commencez depuis le tableau de bord#
- Connectez-vous au Cloud.
- Ouvrez Nouveau projet et choisissez le type de site ou de projet dont vous avez besoin.
- Ouvrez sa page de projet pour suivre le provisionnement ou le déploiement, attacher des domaines et inspecter les outils disponibles.
Un site géré et un projet Git ont des cycles de vie différents. Un projet de démarrage PRISM géré est fourni directement ; ce n'est pas un déploiement de référentiel. Utilisez un projet Git distinct lorsque vous avez besoin de compilations à partir d'un référentiel.
Le plan gratuit comprend un site de préproduction géré. Les sites gérés supplémentaires et la publication sur votre propre domaine nécessitent un forfait payant éligible. L'option de sauvegarde quotidienne est distincte. Le cloud applique les contrôles d'abonnement, d'allocation de site et de propriété de votre compte pour les opérations de tableau de bord, d'API et MCP.
Utiliser des jetons de compte#
Pour la CLI, exécutez :
bext login
Terminez la connexion au navigateur. La CLI stocke les informations d'identification de son compte dans ~/.bext/credentials.json.
Pour un assistant ou votre propre intégration, créez un jeton nommé à partir de Compte → Connecter un assistant. La page du compte fournit un jeton de 90 jours et une configuration de connexion MCP. Les jetons sont affichés une fois ; retirez-les de la liste des jetons du compte lorsqu'ils ne sont plus nécessaires.
Un jeton de compte dispose des autorisations du compte, y compris un accès administratif si le compte est un administrateur. Gardez-le hors des référentiels publics, des captures d'écran et des journaux partagés.
Appeler l'API#
Définissez BEXT_CLOUD_TOKEN dans votre shell ou votre magasin secret, puis vérifiez le compte :
curl https://cloud.bext.dev/api/auth/whoami \
-H "Authorization: Bearer $BEXT_CLOUD_TOKEN"
Lister ses projets :
curl https://cloud.bext.dev/api/projects \
-H "Authorization: Bearer $BEXT_CLOUD_TOKEN"
Les ID de projet de cette réponse sont utilisés par les API de déploiement, de domaine, de journalisation et de sauvegarde. Un nom de projet ne remplace pas son identifiant ; les opérations de cycle de vie du site géré utilisent un slug de site.
| Point de terminaison | Méthode | But |
|---|---|---|
/api/projects |
GET / POST | Lister ou créer des projets |
/api/projects/:projectId |
GET / PUT | Lire ou mettre à jour un projet |
/api/sites |
GET / POST | Répertorier ou provisionner les sites gérés |
/api/projects/:projectId/deploys |
GET / POST | Lire l'historique de déploiement ou demander un déploiement |
/api/projects/:projectId/domains |
GET / POST | Lisez les domaines ou joignez-en un pour vérification |
/api/projects/:projectId/logs |
GET | Lire les journaux récents |
/api/backups?project_id=:projectId |
GET | Lire l'historique des sauvegardes |
/api/backups |
POST | Demander une sauvegarde |
/api/auth/tokens |
GET / POST | Répertorier ou créer des jetons de compte |
/api/auth/tokens/:tokenId |
DELETE | Révoquer un jeton de compte |
/api/mcp |
POST | Appelez le Serveur Cloud MCP |
Les erreurs API contiennent un message error et peuvent inclure un code lisible par machine. Considérez un travail ou un déploiement renvoyé comme une acceptation, puis suivez son statut. Une requête qui a démarré une compilation n'a pas encore vérifié que le site déployé fonctionne.
Organiser le travail des clients#
Les comptes d'agence peuvent organiser les projets par client et utiliser les vues client du tableau de bord. L'administration de la plateforme, les importations de serveurs et les actions d'infrastructure ont des exigences d'accès supplémentaires ; ils ne sont pas accordés en créant un projet ou en connectant un client MCP.
Pour un serveur nginx existant, lisez le guide de migration avant d'importer ou de modifier sa configuration. Pour une application exécutée en dehors du Cloud, voir modes de déploiement.
Plus de points de terminaison d'API#
Ces points de terminaison de projet et d’agence existants complètent les guides de tâches. Chaque opération vérifie toujours les autorisations de l'appelant ; un point de terminaison répertorié ne garantit pas qu’une opération est disponible pour chaque projet ou fournisseur.
| Point de terminaison | Méthodes | But |
|---|---|---|
/api/projects/:projectId/domains/:domainId |
PATCH / DELETE | Vérifier ou supprimer un domaine attaché |
/api/projects/:projectId/php-pool |
GET | Inspecter le pool PHP du projet |
/api/projects/:projectId/ssl |
GET | Inspecter les certificats |
/api/projects/:projectId/metrics |
GET | Lire les métriques du projet |
/api/projects/:projectId/members |
GET / POST | Répertorier ou ajouter des membres du projet |
/api/projects/:projectId/deploys/:deploymentId/rollback |
POST | Demander une restauration prise en charge |
/api/projects/:projectId/deploys/:deploymentId/cancel |
POST | Annuler un enregistrement de déploiement en cours |
/api/projects/:projectId/webhook |
GET / POST | Lire ou configurer le webhook GitHub |
/api/agency |
GET / POST | Lire ou créer une agence |
/api/agency/clients |
GET / POST | Répertorier ou créer des dossiers clients |
/api/agency/clients/:clientId |
GET / PUT / DELETE | Lire, mettre à jour ou supprimer un dossier client |
La facturation et la gestion des rôles restent dans leurs vues de tableau de bord. Voir abonnement et facturation pour votre forfait et la référence de l'administrateur pour un accès à la plateforme uniquement.
Les importations de serveur et l'administration de la plateforme disposent d'autorisations supplémentaires. Lisez les documents Guide de migration nginx et référence d'administrateur avant d'utiliser ces flux de travail.
Surveillance de l'état du serveur#
Le tableau de bord Cloud lit également les informations des instances bext connectées. Sur l'hôte du moteur, /__bext/health signale l'état de base du moteur ; les autres points finaux de gestion et de diagnostic ont leurs propres exigences d'accès. Consultez points de terminaison et informations d'identification avant de connecter une instance et surveillance pour l’intégrité et les métriques.