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 Studio

Il existe deux façons de créer un projet dans Astro Studio :

1. 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.

2. 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 :

   npm

   # Connectez-vous à Astro Studio avec votre compte GitHub
   npx astro login
   
   # Créez un lien vers un nouveau projet en suivant les instructions.
   npx astro link
   
   # (Facultatif) Transférer la configuration de la base de données locale vers la base de données distante.
   npx astro db push

   pnpm

   # Connectez-vous à Astro Studio avec votre compte GitHub
   pnpm astro login
   
   # Créez un lien vers un nouveau projet en suivant les instructions.
   pnpm astro link
   
   # (Facultatif) Transférer la configuration de la base de données locale vers la base de données distante.
   pnpm astro db push

   Yarn

   # Connectez-vous à Astro Studio avec votre compte GitHub
   yarn astro login
   
   # Créez un lien vers un nouveau projet en suivant les instructions.
   yarn astro link
   
   # (Facultatif) Transférer la configuration de la base de données locale vers la base de données distante.
   yarn astro db push

   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 Studio

Vous 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.

package.json

{
  "scripts": {
    "build": "astro build --remote"
  }
}

Créer un jeton d’application Studio

Titre de la section Créer un jeton d’application Studio

Vous 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 GitHub

Vous 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 :

.github/workflows/_studio.yml

name: Astro Studio

env:
  ASTRO_STUDIO_APP_TOKEN: ${{secrets.ASTRO_STUDIO_APP_TOKEN }}

on:
  push:
    branches:
      - main
  pull_request:
    types: [opened, reopened, synchronize]

jobs:
  DB:
    permissions:
      contents: read
      actions: read
      pull-requests: write
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
      - uses: jaid/action-npm-install@v1.2.1
      - uses: withastro/action-studio@main