Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[studio-DB] Move Studio recipe to DB guide in es, it & ru #8452

Merged
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
81 changes: 74 additions & 7 deletions src/content/docs/es/guides/astro-db.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro';
import ReadMore from '~/components/ReadMore.astro';
import StudioHeading from '~/components/StudioHeading.astro';

Astro DB es una base de datos SQL de gestión integral diseñada exclusivamente para Astro. Desarrolla localmente o conéctate a una base de datos alojada gestionada en nuestra plataforma [Astro Studio](/es/recipes/studio/).
Astro DB es una base de datos SQL de gestión integral diseñada exclusivamente para Astro. Desarrolla localmente o conéctate a una base de datos alojada gestionada en nuestra plataforma [Astro Studio](#astro-studio).

## Instalación

Expand Down Expand Up @@ -335,13 +335,80 @@ Consulta la documentación de [Drizzle `db.batch()`](https://orm.drizzle.team/do
## Astro Studio
</StudioHeading>

Astro DB puede [conectarse a la plataforma Astro Studio](/es/recipes/studio/) para agregar rápidamente una base de datos alojada a tu proyecto. Puedes ver, gestionar y implementar nuevas bases de datos alojadas, todo desde el portal web de Astro Studio.
Astro DB puede conectarse a la plataforma Astro Studio para agregar rápidamente una base de datos alojada a tu proyecto. Puedes ver, gestionar y implementar nuevas bases de datos alojadas, todo desde el portal web de Astro Studio.

Hay dos formas de crear un proyecto en Astro Studio:
1. A través del [CLI de Astro Studio](/es/reference/cli-reference/#cli-de-astro-studio) utilizando `astro link`
2. A través de la [interfaz de usuario web de Astro Studio](https://studio.astro.build)
El [portal web de Astro Studio](http://studio.astro.build/) te permite conectar y gestionar tus bases de datos de Astro DB alojadas de forma remota a través de una interfaz web o mediante [comandos de CLI](/es/reference/cli-reference/#cli-de-astro-studio).

Para crear una nueva base de datos en la interfaz web de Astro Studio, haz clic en el botón "crear proyecto" en el encabezado y sigue las instrucciones presentadas. Astro Studio te guiará a través de los pasos necesarios, y al final del proceso tendrás una base de datos alojada configurada para tu proyecto.
Desde tu panel de Studio, tienes acceso a la gestión de cuentas, artículos de ayuda y una consola de mensajes de soporte.

Visita [Astro Studio](http://studio.astro.build) para registrarte o iniciar sesión.

<StudioHeading>
### Despliega con una conexión a Studio
</StudioHeading>

Puedes desplegar tu proyecto de Astro DB con una conexión en vivo a tu base de datos de Studio. Esto es posible con cualquier plataforma de despliegue que utilice compilaciones estáticas o un [adaptador SSR](/es/guides/server-side-rendering/).

Primero, configura tu comando de compilación para conectar con Studio utilizando el indicador `--remote`. Este ejemplo aplica el indicador a un script `"build"` en el archivo `package.json` de tu proyecto. Si tu plataforma de despliegue acepta un comando de compilación, asegúrate de configurarlo como `npm run build`.

```json title="package.json" "--remote"
{
"scripts": {
"build": "astro build --remote"
}
}
```

<StudioHeading>
#### Crear un token de aplicación para Studio
</StudioHeading>

Necesitas crear un token de aplicación para acceder a tu base de datos de Studio desde un despliegue de producción. Puedes crear un token de aplicación desde el panel de tu proyecto de Studio navegando a la pestaña **Settings** y seleccionando **Tokens**.

Copia el token generado y aplícalo como una variable de entorno / secreto de entorno en tu plataforma de despliegue usando el nombre `ASTRO_STUDIO_APP_TOKEN`.

<StudioHeading>
### Configurar la acción de CI de GitHub
</StudioHeading>

Puedes enviar automáticamente los cambios de esquema a tu base de datos de Studio con la acción de CI de Studio. Esto verifica que los cambios se puedan realizar de manera segura y mantiene tu configuración actualizada cada vez que fusionas a `main`.

[Sigue la documentación de GitHub](https://docs.github.com/es/actions/security-guides/using-secrets-in-github-actions#creating-secrets-for-a-repository) para configurar un nuevo secreto en tu repositorio con el nombre `ASTRO_STUDIO_APP_TOKEN` y tu token de aplicación de Studio como el valor del secreto.

Una vez configurado tu secreto, crea un nuevo archivo de flujo de trabajo de GitHub Actions en el directorio `.github/workflows` de tu proyecto para verificar el repositorio e instala Node.js siguiendo los pasos, y usa la acción `withastro/action-studio` para sincronizar los cambios de esquema.

La acción ejecutará `astro db verify` en todos los [activadores de eventos](https://docs.github.com/es/actions/using-workflows/events-that-trigger-workflows) para asegurar que los cambios de esquema se puedan aplicar de manera segura. Si agregas específicamente el activador **[push](https://docs.github.com/es/actions/using-workflows/events-that-trigger-workflows#push)**, la acción enviará esos cambios a tu base de datos de Studio.

Este ejemplo de acción de GitHub `_studio.yml` envía cambios siempre que se actualice la rama `main`:

```yaml title=".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/[email protected]
- uses: withastro/action-studio@main
```

<StudioHeading>
### Subiendo esquemas de tablas
Expand Down Expand Up @@ -425,7 +492,7 @@ Para usar una conexión remota, necesitarás un token de aplicación para autent

<ReadMore>

Cuando estés listo para implementar, consulta nuestra [guía de Implementación con una Conexión a Studio](/es/recipes/studio/#despliega-con-una-conexión-a-studio).
Cuando estés listo para implementar, consulta nuestra [guía de Implementación con una Conexión a Studio](#despliega-con-una-conexión-a-studio).

</ReadMore>

Expand Down
4 changes: 2 additions & 2 deletions src/content/docs/es/guides/integrations-guide/db.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ import ReadMore from '~/components/ReadMore.astro';
import Badge from '~/components/Badge.astro';


Astro DB es una base de datos SQL completamente administrada diseñada para el ecosistema de Astro: desarrolla localmente en Astro y despliega desde tu [panel de Astro Studio](/es/recipes/studio/).
Astro DB es una base de datos SQL completamente administrada diseñada para el ecosistema de Astro: desarrolla localmente en Astro y despliega desde tu [panel de Astro Studio](/en/guides/astro-db/#astro-studio).

Con Astro DB tienes una herramienta potente, local y segura para consultar y modelar contenido como una base de datos relacional. Visualiza, administra y despliega tus datos remotos alojados a través de tu panel interactivo de Studio.

Expand Down Expand Up @@ -196,7 +196,7 @@ Cada objeto de configuración de clave foránea acepta las siguientes propiedade

## Referencia de la CLI de Astro DB

Astro DB incluye un conjunto de comandos CLI para interactuar con tu base de datos de proyecto alojada y tu cuenta de [Astro Studio](/es/recipes/studio/).
Astro DB incluye un conjunto de comandos CLI para interactuar con tu base de datos de proyecto alojada y tu cuenta de [Astro Studio](/es/guides/astro-db/#astro-studio).

Estos comandos se ejecutan automáticamente al usar una acción de GitHub CI, y se pueden llamar manualmente utilizando el CLI `astro db`.

Expand Down
74 changes: 0 additions & 74 deletions src/content/docs/es/recipes/studio.mdx

This file was deleted.

136 changes: 131 additions & 5 deletions src/content/docs/it/guides/astro-db.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ import ReadMore from '~/components/ReadMore.astro';
import StudioHeading from '~/components/StudioHeading.astro';
import { Steps } from '@astrojs/starlight/components';

Astro DB è un database SQL completamente gestito progettato esclusivamente per Astro. Sviluppa localmente o connettiti a un database ospitato gestito sulla nostra piattaforma [Astro Studio](/it/recipes/studio/).
Astro DB è un database SQL completamente gestito progettato esclusivamente per Astro. Sviluppa localmente o connettiti a un database ospitato gestito sulla nostra piattaforma [Astro Studio](#astro-studio).

## Installazione

Expand Down Expand Up @@ -339,9 +339,135 @@ Vedi i [documenti `db.batch()` di Drizzle](https://orm.drizzle.team/docs/batch-a
## Astro Studio
</StudioHeading>

Astro DB può [connettersi alla piattaforma Astro Studio](/it/recipes/studio/) per aggiungere rapidamente un database ospitato al tuo progetto. Puoi visualizzare, gestire e distribuire nuovi database ospitati direttamente dalla dashboard di Astro Studio.
Astro DB può connettersi alla piattaforma Astro Studio per aggiungere rapidamente un database ospitato al tuo progetto. Puoi visualizzare, gestire e distribuire nuovi database ospitati direttamente dalla dashboard di Astro Studio.

Per creare un nuovo progetto, puoi utilizzare un [template già pronto](https://studio.astro.build) o visitare la [guida di Astro Studio](/it/recipes/studio/#crea-un-nuovo-progetto-studio).
Il [portale web di Astro Studio](http://studio.astro.build) ti permette di connetterti e gestire i tuoi database Astro DB ospitati in remoto attraverso un'interfaccia web o utilizzando [comandi CLI](/it/reference/cli-reference/#astro-studio-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](http://studio.astro.build) per registrarti o accedere.

<StudioHeading>
### Crea un nuovo progetto Studio
</StudioHeading>

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

1. [**Usa l'interfaccia web di Astro Studio**](https://studio.astro.build) 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:

<PackageManagerTabs>
<Fragment slot="npm">
```shell
# 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
```
</Fragment>
<Fragment slot="pnpm">
```shell
# 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
```
</Fragment>
<Fragment slot="yarn">
```shell
# 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
```
</Fragment>
</PackageManagerTabs>

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

<ReadMore>Consulta [il riferimento della CLI di Astro DB](/it/guides/integrations-guide/db/#riferimento-per-la-cli-di-astro-db) per tutti i comandi disponibili.</ReadMore>

<StudioHeading>
### Distribuire con una connessione Studio
</StudioHeading>

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](/it/guides/server-side-rendering/).

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

```json title="package.json" "--remote"
{
"scripts": {
"build": "astro build --remote"
}
}
```

<StudioHeading>
#### Crea un token per l'app Studio
</StudioHeading>

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

<StudioHeading>
### Configura l'azione CI di GitHub
</StudioHeading>

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](https://docs.github.com/en/actions/security-guides/using-secrets-in-github-actions#creating-secrets-for-a-repository) 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](https://docs.github.com/en/actions/using-workflows/events-that-trigger-workflows) per assicurarsi che le modifiche allo schema possano essere applicate in sicurezza. Se aggiungi specificamente il trigger **[push](https://docs.github.com/en/actions/using-workflows/events-that-trigger-workflows#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:

```yaml title=".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/[email protected]
- uses: withastro/action-studio@main
```

<StudioHeading>
### Pubblicazione degli schemi delle tabelle
Expand Down Expand Up @@ -520,7 +646,7 @@ Per utilizzare una connessione remota, avrai bisogno di un token dell'app per au

<ReadMore>

Quando sei pronto per il deploy, consulta la nostra [guida al Deploy con una Connessione Studio](/it/recipes/studio/#distribuire-con-una-connessione-studio).
Quando sei pronto per il deploy, consulta la nostra [guida al Deploy con una Connessione Studio](#distribuire-con-una-connessione-studio).

</ReadMore>

Expand Down Expand Up @@ -604,7 +730,7 @@ L'utilizzo di un file di database è una funzionalità avanzata e occorre presta

Inoltre, questo metodo non funzionerà nelle distribuzioni serverless, poiché il file system non viene persistito in tali ambienti.

Per una soluzione completamente gestita, [connettiti invece ai database ospitati sulla piattaforma Astro Studio](/it/recipes/studio/).
Per una soluzione completamente gestita, [connettiti invece ai database ospitati sulla piattaforma Astro Studio](#astro-studio).
:::

Se sei a tuo agio con i rischi e puoi gestire la distribuzione autonomamente, puoi utilizzare un file di database invece di connetterti a Studio.
Expand Down
Loading
Loading