Astro Studio
Le portail web Astro Studio vous permet de vous connecter et de gérer vos bases de données Astro DB hébergées à distance via une interface web ou en utilisant des commandes CLI.
Depuis votre tableau de bord Studio, vous avez accès à la gestion de votre compte, à des articles d’aide et à une console de messages d’assistance.
Visitez Astro Studio pour vous inscrire ou vous connecter.
Créer un nouveau projet Studio
Titre de la section Créer un nouveau projet StudioIl existe deux façons de créer un projet dans Astro Studio :
-
Utiliser l’interface web Astro Studio pour créer à partir d’un dépôt GitHub nouveau ou existant.
Pour commencer, cliquez sur le bouton “créer un projet” dans l’en-tête et suivez les instructions. Astro Studio se connectera à votre dépôt GitHub et créera une nouvelle base de données hébergée pour votre projet.
-
Utilisez le CLI d’Astro Studio pour créer à partir de n’importe quel projet Astro local. Vous pouvez exécuter les commandes suivantes pour commencer :
Une fois connecté et relié avec succès, vous pouvez exécuter toutes les commandes Astro DB pour gérer votre base de données distante.
Voir la référence CLI Astro DB pour toutes les commandes disponibles.
Déployer avec une connexion Studio
Titre de la section Déployer avec une connexion StudioVous pouvez déployer votre projet Astro DB avec une connexion en direct à votre base de données Studio. Ceci est possible avec n’importe quelle plateforme de déploiement utilisant des constructions statiques ou un adaptateur SSR.
Tout d’abord, configurez votre commande de compilation pour qu’elle se connecte à Studio en utilisant l’option --remote
. Cet exemple applique le drapeau à un script "build"
dans le package.json
de votre projet. Si votre plateforme de déploiement accepte une commande de construction, assurez-vous qu’elle est définie comme npm run build
.
Créer un jeton d’application Studio
Titre de la section Créer un jeton d’application StudioVous devez créer un jeton d’application pour accéder à votre base de données Studio à partir d’un déploiement en production. Vous pouvez créer un jeton d’application à partir du tableau de bord de votre projet Studio en accédant à l’onglet Settings et en sélectionnant Tokens.
Copiez le jeton généré et appliquez-le en tant que variable d’environnement / secret d’environnement dans votre plateforme de déploiement en utilisant le nom ASTRO_STUDIO_APP_TOKEN
.
Configurer l’action CI GitHub
Titre de la section Configurer l’action CI GitHubVous pouvez pousser automatiquement les changements de schéma dans votre base de données Studio avec l’action Studio CI. Cela permet de vérifier que les changements peuvent être effectués en toute sécurité, et de maintenir votre configuration à jour à chaque fois que vous fusionnez avec main
.
Suivez la documentation de GitHub pour configurer un nouveau secret dans votre dépôt avec le nom ASTRO_STUDIO_APP_TOKEN
et le jeton de votre application Studio comme valeur pour le secret.
Une fois que votre secret est configuré, créez un nouveau fichier de workflow GitHub Actions dans le répertoire .github/workflows
de votre projet pour extraire le dépôt et installer Node.js comme étapes, et utilisez l’action withastro/action-studio
pour synchroniser les changements de schémas.
L’action lancera astro db verify
sur tous les déclencheurs d`évènements pour s’assurer que les changements de schéma peuvent être appliqués en toute sécurité. Si vous ajoutez spécifiquement le déclencheur push, l’action poussera ces changements dans la base de données de Studio.
Cet exemple d’action GitHub _studio.yml
pousse les changements à chaque fois que la branche main
est mise à jour :