Astro Studio

Il portale web di Astro Studio ti permette di connetterti e gestire i tuoi database Astro DB ospitati in remoto attraverso un’interfaccia web o utilizzando comandi CLI.

Dalla tua dashboard di Studio, hai accesso alla gestione dell’account, articoli di aiuto e una console per messaggi di supporto.

Visita Astro Studio per registrarti o accedere.

Crea un nuovo progetto Studio

Sezione intitolata Crea un nuovo progetto Studio

Ci sono due modi per creare un progetto in Astro Studio:

1. Usa l’interfaccia web di Astro Studio per creare da un repository GitHub nuovo o esistente.

   Per iniziare, clicca sul pulsante “crea progetto” nell’intestazione e segui le istruzioni. Astro Studio si collegherà al tuo repository GitHub e creerà un nuovo database ospitato per il tuo progetto.

2. Usa la CLI di Astro Studio per creare da qualsiasi progetto Astro locale. Puoi eseguire i seguenti comandi per iniziare:

   npm

   # Accedi ad Astro Studio con il tuo account GitHub
   npx astro login
   
   # Collega a un nuovo progetto seguendo le istruzioni
   npx astro link
   
   # (Opzionale) Invia la tua configurazione db locale al database remoto
   npx astro db push

   pnpm

   # Accedi ad Astro Studio con il tuo account GitHub
   pnpm astro login
   
   # Collega a un nuovo progetto seguendo le istruzioni
   pnpm astro link
   
   # (Opzionale) Invia la tua configurazione db locale al database remoto
   pnpm astro db push

   Yarn

   # Accedi ad Astro Studio con il tuo account GitHub
   yarn astro login
   
   # Collega a un nuovo progetto seguendo le istruzioni
   yarn astro link
   
   # (Opzionale) Invia la tua configurazione db locale al database remoto
   yarn astro db push

   Una volta effettuato l’accesso e collegato con successo, puoi eseguire tutti i comandi di Astro DB per gestire il tuo database remoto.

   Consulta il riferimento della CLI di Astro DB per tutti i comandi disponibili.

Distribuire con una connessione Studio

Sezione intitolata Distribuire con una connessione Studio

Puoi distribuire il tuo progetto Astro DB con una connessione attiva al tuo database Studio. Questo è possibile con qualsiasi piattaforma di distribuzione utilizzando build statiche o un adattatore SSR.

Prima di tutto, configura il tuo comando di build per connettersi con Studio utilizzando il flag --remote. Questo esempio applica il flag a uno script "build" nel package.json del tuo progetto. Se la tua piattaforma di distribuzione accetta un comando di build, assicurati che sia impostato su npm run build.

package.json

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

Crea un token per l’app Studio

Sezione intitolata Crea un token per l’app Studio

Hai bisogno di creare un token per l’app per accedere al tuo database Studio da una distribuzione in produzione. Puoi creare un token per l’app dalla dashboard del tuo progetto Studio navigando nella scheda Impostazioni e selezionando Token.

Copia il token generato e applicalo come variabile d’ambiente / segreto d’ambiente nella tua piattaforma di distribuzione utilizzando il nome ASTRO_STUDIO_APP_TOKEN.

Configura l’azione CI di GitHub

Sezione intitolata Configura l’azione CI di GitHub

Puoi spingere automaticamente le modifiche allo schema al tuo database Studio con l’azione CI di Studio. Questo verifica che le modifiche possano essere effettuate in sicurezza e mantiene la tua configurazione aggiornata ogni volta che effettui il merge su main.

Segui la documentazione di GitHub per configurare un nuovo segreto nel tuo repository con il nome ASTRO_STUDIO_APP_TOKEN e il tuo token per l’app Studio come valore per il segreto.

Una volta configurato il tuo segreto, crea un nuovo file di workflow di GitHub Actions nella directory .github/workflows del tuo progetto per effettuare il checkout del repository e installare Node.js come passaggi, e usa l’azione withastro/action-studio per sincronizzare le modifiche allo schema.

L’azione eseguirà astro db verify su tutti i trigger di evento per assicurarsi che le modifiche allo schema possano essere applicate in sicurezza. Se aggiungi specificamente il trigger push, l’azione spingerà quelle modifiche al tuo database Studio.

Questo esempio di GitHub Action _studio.yml spinge le modifiche ogni volta che il ramo main viene aggiornato:

.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