From 17c39a0dfaaca7b1bb6414615f29aeae2f12179d Mon Sep 17 00:00:00 2001 From: HiDeoo <494699+HiDeoo@users.noreply.github.com> Date: Thu, 6 Jun 2024 16:46:57 +0200 Subject: [PATCH 1/2] docs: remove studio recipe from `es`, `it` & `ru` --- src/content/docs/es/guides/astro-db.mdx | 79 +++++++++- .../docs/es/guides/integrations-guide/db.mdx | 4 +- src/content/docs/es/recipes/studio.mdx | 74 ---------- src/content/docs/it/guides/astro-db.mdx | 136 ++++++++++++++++- .../docs/it/guides/integrations-guide/db.mdx | 4 +- src/content/docs/it/recipes/studio.mdx | 127 ---------------- src/content/docs/ru/guides/astro-db.mdx | 138 +++++++++++++++++- .../docs/ru/guides/integrations-guide/db.mdx | 4 +- src/content/docs/ru/recipes/studio.mdx | 132 ----------------- 9 files changed, 343 insertions(+), 355 deletions(-) delete mode 100644 src/content/docs/es/recipes/studio.mdx delete mode 100644 src/content/docs/it/recipes/studio.mdx delete mode 100644 src/content/docs/ru/recipes/studio.mdx diff --git a/src/content/docs/es/guides/astro-db.mdx b/src/content/docs/es/guides/astro-db.mdx index d7eb291237940..b36c363809217 100644 --- a/src/content/docs/es/guides/astro-db.mdx +++ b/src/content/docs/es/guides/astro-db.mdx @@ -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 @@ -335,13 +335,78 @@ Consulta la documentación de [Drizzle `db.batch()`](https://orm.drizzle.team/do ## Astro Studio -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. +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). -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) +Desde tu panel de Studio, tienes acceso a la gestión de cuentas, artículos de ayuda y una consola de mensajes de soporte. -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. +Visita [Astro Studio](http://studio.astro.build) para registrarte o iniciar sesión. + + +### Despliega con una conexión a Studio + + +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" + } +} +``` + + +#### Crear un token de aplicación para Studio + + +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`. + + +### Configurar la acción de CI de GitHub + + +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/action-npm-install@v1.2.1 + - uses: withastro/action-studio@main +``` ### Subiendo esquemas de tablas @@ -425,7 +490,7 @@ Para usar una conexión remota, necesitarás un token de aplicación para autent -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). diff --git a/src/content/docs/es/guides/integrations-guide/db.mdx b/src/content/docs/es/guides/integrations-guide/db.mdx index 71e20b775d5a2..ac4422bb54caa 100644 --- a/src/content/docs/es/guides/integrations-guide/db.mdx +++ b/src/content/docs/es/guides/integrations-guide/db.mdx @@ -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. @@ -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`. diff --git a/src/content/docs/es/recipes/studio.mdx b/src/content/docs/es/recipes/studio.mdx deleted file mode 100644 index 19a68d17627bd..0000000000000 --- a/src/content/docs/es/recipes/studio.mdx +++ /dev/null @@ -1,74 +0,0 @@ ---- -title: 'Astro Studio' -description: Un panel interactivo para gestionar Astro DB. -i18nReady: true ---- -import ReadMore from '~/components/ReadMore.astro'; - - -El [portal web de Astro Studio](http://studio.astro.build) te permite conectar y gestionar tus [bases de datos de Astro DB](/es/guides/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). - -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. - -## Despliega con una conexión a Studio - -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" - } -} -``` - -### Crear un token de aplicación para Studio - -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`. - -## Configurar la acción de CI de GitHub - -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/action-npm-install@v1.2.1 - - uses: withastro/action-studio@main -``` diff --git a/src/content/docs/it/guides/astro-db.mdx b/src/content/docs/it/guides/astro-db.mdx index 15e1bb7d3894d..daaea81847345 100644 --- a/src/content/docs/it/guides/astro-db.mdx +++ b/src/content/docs/it/guides/astro-db.mdx @@ -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 @@ -339,9 +339,135 @@ Vedi i [documenti `db.batch()` di Drizzle](https://orm.drizzle.team/docs/batch-a ## Astro Studio -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. + + +### Crea un nuovo progetto Studio + + +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: + + + + ```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 + ``` + + + ```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 + ``` + + + ```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 + ``` + + + + 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](/it/guides/integrations-guide/db/#riferimento-per-la-cli-di-astro-db) per tutti i comandi disponibili. + + +### 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](/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" + } +} +``` + + +#### 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 + + +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/action-npm-install@v1.2.1 + - uses: withastro/action-studio@main +``` ### Pubblicazione degli schemi delle tabelle @@ -520,7 +646,7 @@ Per utilizzare una connessione remota, avrai bisogno di un token dell'app per au -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). @@ -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. diff --git a/src/content/docs/it/guides/integrations-guide/db.mdx b/src/content/docs/it/guides/integrations-guide/db.mdx index ea6c0ce47e8aa..7d61892495218 100644 --- a/src/content/docs/it/guides/integrations-guide/db.mdx +++ b/src/content/docs/it/guides/integrations-guide/db.mdx @@ -12,7 +12,7 @@ import ReadMore from '~/components/ReadMore.astro'; import Badge from '~/components/Badge.astro'; -Astro DB è un database SQL completamente gestito progettato per l'ecosistema Astro: sviluppa localmente in Astro e distribuisci dal tuo [dashboard di Astro Studio](/it/recipes/studio/). +Astro DB è un database SQL completamente gestito progettato per l'ecosistema Astro: sviluppa localmente in Astro e distribuisci dal tuo [dashboard di Astro Studio](/it/guides/astro-db/#astro-studio). Con Astro DB hai uno strumento potente, locale e type-safe per interrogare e modellare contenuti come un database relazionale. Visualizza, gestisci e distribuisci i tuoi dati remoti ospitati attraverso la tua dashboard interattiva di Studio. @@ -196,7 +196,7 @@ Ogni oggetto di configurazione della chiave esterna accetta le seguenti propriet ## Riferimento per la CLI di Astro DB -Astro DB include un insieme di comandi CLI per interagire con il tuo database di progetto ospitato e il tuo account [Astro Studio](/it/recipes/studio/). +Astro DB include un insieme di comandi CLI per interagire con il tuo database di progetto ospitato e il tuo account [Astro Studio](/it/guides/astro-db/#astro-studio). Questi comandi vengono chiamati automaticamente quando si utilizza un'azione CI di GitHub e possono essere chiamati manualmente utilizzando la CLI `astro db`. diff --git a/src/content/docs/it/recipes/studio.mdx b/src/content/docs/it/recipes/studio.mdx deleted file mode 100644 index f46af8aebc722..0000000000000 --- a/src/content/docs/it/recipes/studio.mdx +++ /dev/null @@ -1,127 +0,0 @@ ---- -title: 'Astro Studio' -description: Una dashboard interattiva per gestire Astro DB. -i18nReady: true ---- -import ReadMore from '~/components/ReadMore.astro'; -import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'; - -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. - -## Crea un nuovo progetto Studio - -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: - - - - ```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 - ``` - - - ```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 - ``` - - - ```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 - ``` - - - - 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](/it/guides/integrations-guide/db/#riferimento-per-la-cli-di-astro-db) per tutti i comandi disponibili. - -## 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](/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" - } -} -``` - -### 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 - -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/action-npm-install@v1.2.1 - - uses: withastro/action-studio@main -``` diff --git a/src/content/docs/ru/guides/astro-db.mdx b/src/content/docs/ru/guides/astro-db.mdx index fa65c863266c1..c670e54cf257f 100644 --- a/src/content/docs/ru/guides/astro-db.mdx +++ b/src/content/docs/ru/guides/astro-db.mdx @@ -10,7 +10,7 @@ import ReadMore from '~/components/ReadMore.astro'; import StudioHeading from '~/components/StudioHeading.astro'; import { Steps } from '@astrojs/starlight/components'; -Astro DB — это полностью управляемая база данных SQL, специально разработанная для Astro. Разрабатывайте локально или подключайтесь к хостингу базы данных, управляемой на нашей платформе [Astro Studio](/ru/recipes/studio/). +Astro DB — это полностью управляемая база данных SQL, специально разработанная для Astro. Разрабатывайте локально или подключайтесь к хостингу базы данных, управляемой на нашей платформе [Astro Studio](#astro-studio). ## Установка @@ -339,9 +339,139 @@ export default async function () { ## Astro Studio -Astro DB может [подключаться к платформе Astro Studio](/ru/recipes/studio/), чтобы быстро добавить хостинг базы данных в ваш проект. Вы можете просматривать, управлять и развёртывать новые хостинговые базы данных прямо из панели управления Astro Studio. +Astro DB может подключаться к платформе Astro Studio, чтобы быстро добавить хостинг базы данных в ваш проект. Вы можете просматривать, управлять и развёртывать новые хостинговые базы данных прямо из панели управления Astro Studio. -Чтобы создать новый проект, вы можете воспользоваться [готовым шаблоном](https://studio.astro.build) или обратиться к руководству [Astro Studio](/ru/recipes/studio/#создание-нового-проекта-studio). +[Веб-портал Astro Studio](http://studio.astro.build) позволяет вам подключаться и управлять вашими удаленными [базами данных Astro DB](/ru/guides/astro-db/) через веб-интерфейс или с использованием [CLI-команд](/ru/reference/cli-reference/#astro-studio-cli). + +Из вашей панели управления Studio у вас есть доступ к управлению учетной записью, справочным статьям и консоли сообщений поддержки. + +Посетите [Astro Studio](http://studio.astro.build), чтобы зарегистрироваться или войти в систему. + + +### Создание нового проекта Studio + + +Существует два способа создания проекта в Astro Studio: + +1. [**Использовать веб-интерфейс Astro Studio**](https://studio.astro.build) для создания из нового или существующего репозитория GitHub. + + Чтобы начать, нажмите кнопку "create project" в заголовке и следуйте инструкциям. Astro Studio подключится к вашему репозиторию GitHub и создаст новую хостинговую базу данных для вашего проекта. + +2. **Использовать Astro Studio CLI** для создания из любого локального проекта Astro. Для начала можно выполнить следующие команды: + + + + ```shell + # Войдите в Astro Studio с помощью вашей учетной записи GitHub + npx astro login + + # Свяжите новый проект, следуя инструкциям + npx astro link + + # (Необязательно) Отправьте вашу локальную конфигурацию базы данных на удаленную базу данных + npx astro db push + ``` + + + ```shell + # Войдите в Astro Studio с помощью вашей учетной записи GitHub + pnpm astro login + + # Свяжите новый проект, следуя инструкциям + pnpm astro link + + # (Необязательно) Отправьте вашу локальную конфигурацию базы данных на удаленную базу данных + pnpm astro db push + ``` + + + ```shell + # Log in to Astro Studio with your GitHub account + yarn astro login + + # Свяжите новый проект, следуя инструкциям + yarn astro link + + # (Необязательно) Отправьте вашу локальную конфигурацию базы данных на удаленную базу данных + yarn astro db push + ``` + + + + После того как вы вошли в систему и успешно подключились, вы можете выполнять все команды Astro DB для управления удаленной базой данных. + + О всех доступных командах см. в [справочнике Astro DB CLI](/ru/guides/integrations-guide/db/#справочник-по-cli-astro-db). + + +### Развёртывание с подключением к Studio + + +Вы можете развернуть свой проект Astro DB с живым подключением к вашей базе данных Studio. Это возможно на любой платформе развёртывания с использованием статических сборок или [адаптера SSR](/ru/guides/server-side-rendering/). + +Сначала настройте свою команду сборки для подключения к Studio с использованием флага `--remote`. В этом примере флаг применяется к скрипту `"build"` в файле `package.json` вашего проекта. Если ваша платформа развёртывания принимает команду сборки, убедитесь, что она установлена на `npm run build`. + + +```json title="package.json" "--remote" +{ + "scripts": { + "build": "astro build --remote" + } +} +``` + + +#### Создание токена приложения Studio + + +Для доступа к вашей базе данных Studio из продакшн-развёртывания вам нужно создать токен приложения. Вы можете создать токен приложения на панели управления вашего проекта Studio, перейдя на вкладку **Settings** и выбрав **Tokens**. + +Скопируйте сгенерированный токен и примените его в качестве переменной окружения / секрета окружения на вашей платформе развёртывания, используя имя `ASTRO_STUDIO_APP_TOKEN`. + + +### Настройте действие GitHub CI + + +Вы можете автоматически отправлять изменения схемы в вашу базу данных Studio с использованием действия Studio CI. Это позволит убедиться, что изменения могут быть внесены безопасно, и поддерживать конфигурацию в актуальном состоянии при каждом слиянии с `main`. + +[Следуйте документации GitHub](https://docs.github.com/en/actions/security-guides/using-secrets-in-github-actions#creating-secrets-for-a-repository), чтобы настроить новый секрет в вашем репозитории с именем `ASTRO_STUDIO_APP_TOKEN` и вашим токеном приложения Studio в качестве значения секрета. + +После того как секрет настроен, создайте новый файл рабочего процесса GitHub Actions в директории проекта `.github/workflows` для проверки репозитория и установки Node.js в качестве шагов, а также используйте действие `withastro/action-studio` для синхронизации изменений схемы. + +После настройки секрета создайте новый файл рабочего процесса GitHub Actions в директории проекта `.github/workflows` для проверки репозитория и установки Node.js в качестве шагов, а также используйте действие `withastro/action-studio` для синхронизации изменений схемы. + +Действие запустит `astro db verify` на всех [событиях-триггерах](https://docs.github.com/en/actions/using-workflows/events-that-trigger-workflows), чтобы убедиться, что изменения схемы могут быть применены безопасно. Если вы специально добавите триггер **[push](https://docs.github.com/en/actions/using-workflows/events-that-trigger-workflows#push)**, действие перенесет эти изменения в базу данных Studio. + +Приведенный пример GitHub Action `_studio.yml` отправляет изменения при каждом обновлении ветки `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/action-npm-install@v1.2.1 + - uses: withastro/action-studio@main +``` ### Отправка схем таблиц @@ -520,7 +650,7 @@ astro dev --remote -Когда вы будете готовы к развёртыванию, ознакомьтесь с нашим [Руководством по развёртыванию с подключением к Studio](/ru/recipes/studio/#развёртывание-с-подключением-к-studio). +Когда вы будете готовы к развёртыванию, ознакомьтесь с нашим [Руководством по развёртыванию с подключением к Studio](#развёртывание-с-подключением-к-studio). diff --git a/src/content/docs/ru/guides/integrations-guide/db.mdx b/src/content/docs/ru/guides/integrations-guide/db.mdx index d4c47ec7aeec3..6baf33e0f774b 100644 --- a/src/content/docs/ru/guides/integrations-guide/db.mdx +++ b/src/content/docs/ru/guides/integrations-guide/db.mdx @@ -12,7 +12,7 @@ import ReadMore from '~/components/ReadMore.astro'; import Badge from '~/components/Badge.astro'; -Astro DB - это полностью управляемая база данных SQL, разработанная для экосистемы Astro: разрабатывайте локально в Astro и развертывайте из вашей [панели управления Astro Studio](/ru/recipes/studio/). +Astro DB - это полностью управляемая база данных SQL, разработанная для экосистемы Astro: разрабатывайте локально в Astro и развертывайте из вашей [панели управления Astro Studio](/ru/guides/astro-db/#astro-studio). С Astro DB у вас есть мощное, локальное, типобезопасное средство для запросов и моделирования контента в виде реляционной базы данных. Просматривайте, управляйте и развертывайте свои удаленные хостинговые данные через вашу интерактивную панель управления Studio. @@ -192,7 +192,7 @@ const Comment = defineTable({ ## Справочник по CLI Astro DB -Astro DB включает в себя набор команд CLI для взаимодействия с базой данных вашего проекта на хостинге и учетной записью [Astro Studio](/ru/recipes/studio/). +Astro DB включает в себя набор команд CLI для взаимодействия с базой данных вашего проекта на хостинге и учетной записью [Astro Studio](/ru/guides/astro-db/#astro-studio). Эти команды вызываются автоматически при использовании действия GitHub CI, а также могут быть вызваны вручную с помощью CLI `astro db`. diff --git a/src/content/docs/ru/recipes/studio.mdx b/src/content/docs/ru/recipes/studio.mdx deleted file mode 100644 index 7b240e69c1c37..0000000000000 --- a/src/content/docs/ru/recipes/studio.mdx +++ /dev/null @@ -1,132 +0,0 @@ ---- -title: 'Astro Studio' -description: Интерактивная панель для управления Astro DB. -i18nReady: true ---- -import ReadMore from '~/components/ReadMore.astro'; -import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'; - -[Веб-портал Astro Studio](http://studio.astro.build) позволяет вам подключаться и управлять вашими удаленными [базами данных Astro DB](/ru/guides/astro-db/) через веб-интерфейс или с использованием [CLI-команд](/ru/reference/cli-reference/#astro-studio-cli). - -Из вашей панели управления Studio у вас есть доступ к управлению учетной записью, справочным статьям и консоли сообщений поддержки. - -Посетите [Astro Studio](http://studio.astro.build), чтобы зарегистрироваться или войти в систему. - -## Создание нового проекта Studio - -Существует два способа создания проекта в Astro Studio: - -1. [**Использовать веб-интерфейс Astro Studio**](https://studio.astro.build) для создания из нового или существующего репозитория GitHub. - - Чтобы начать, нажмите кнопку "create project" в заголовке и следуйте инструкциям. Astro Studio подключится к вашему репозиторию GitHub и создаст новую хостинговую базу данных для вашего проекта. - -2. **Использовать Astro Studio CLI** для создания из любого локального проекта Astro. Для начала можно выполнить следующие команды: - - - - ```shell - # Войдите в Astro Studio с помощью вашей учетной записи GitHub - npx astro login - - # Свяжите новый проект, следуя инструкциям - npx astro link - - # (Необязательно) Отправьте вашу локальную конфигурацию базы данных на удаленную базу данных - npx astro db push - ``` - - - ```shell - # Войдите в Astro Studio с помощью вашей учетной записи GitHub - pnpm astro login - - # Свяжите новый проект, следуя инструкциям - pnpm astro link - - # (Необязательно) Отправьте вашу локальную конфигурацию базы данных на удаленную базу данных - pnpm astro db push - ``` - - - ```shell - # Log in to Astro Studio with your GitHub account - yarn astro login - - # Свяжите новый проект, следуя инструкциям - yarn astro link - - # (Необязательно) Отправьте вашу локальную конфигурацию базы данных на удаленную базу данных - yarn astro db push - ``` - - - - После того как вы вошли в систему и успешно подключились, вы можете выполнять все команды Astro DB для управления удаленной базой данных. - - О всех доступных командах см. в [справочнике Astro DB CLI](/ru/guides/integrations-guide/db/#справочник-по-cli-astro-db). - - -## Развёртывание с подключением к Studio - -Вы можете развернуть свой проект Astro DB с живым подключением к вашей базе данных Studio. Это возможно на любой платформе развёртывания с использованием статических сборок или [адаптера SSR](/ru/guides/server-side-rendering/). - -Сначала настройте свою команду сборки для подключения к Studio с использованием флага `--remote`. В этом примере флаг применяется к скрипту `"build"` в файле `package.json` вашего проекта. Если ваша платформа развёртывания принимает команду сборки, убедитесь, что она установлена на `npm run build`. - - -```json title="package.json" "--remote" -{ - "scripts": { - "build": "astro build --remote" - } -} -``` - -### Создание токена приложения Studio - -Для доступа к вашей базе данных Studio из продакшн-развёртывания вам нужно создать токен приложения. Вы можете создать токен приложения на панели управления вашего проекта Studio, перейдя на вкладку **Settings** и выбрав **Tokens**. - -Скопируйте сгенерированный токен и примените его в качестве переменной окружения / секрета окружения на вашей платформе развёртывания, используя имя `ASTRO_STUDIO_APP_TOKEN`. - -## Настройте действие GitHub CI - -Вы можете автоматически отправлять изменения схемы в вашу базу данных Studio с использованием действия Studio CI. Это позволит убедиться, что изменения могут быть внесены безопасно, и поддерживать конфигурацию в актуальном состоянии при каждом слиянии с `main`. - -[Следуйте документации GitHub](https://docs.github.com/en/actions/security-guides/using-secrets-in-github-actions#creating-secrets-for-a-repository), чтобы настроить новый секрет в вашем репозитории с именем `ASTRO_STUDIO_APP_TOKEN` и вашим токеном приложения Studio в качестве значения секрета. - -После того как секрет настроен, создайте новый файл рабочего процесса GitHub Actions в директории проекта `.github/workflows` для проверки репозитория и установки Node.js в качестве шагов, а также используйте действие `withastro/action-studio` для синхронизации изменений схемы. - -После настройки секрета создайте новый файл рабочего процесса GitHub Actions в директории проекта `.github/workflows` для проверки репозитория и установки Node.js в качестве шагов, а также используйте действие `withastro/action-studio` для синхронизации изменений схемы. - -Действие запустит `astro db verify` на всех [событиях-триггерах](https://docs.github.com/en/actions/using-workflows/events-that-trigger-workflows), чтобы убедиться, что изменения схемы могут быть применены безопасно. Если вы специально добавите триггер **[push](https://docs.github.com/en/actions/using-workflows/events-that-trigger-workflows#push)**, действие перенесет эти изменения в базу данных Studio. - -Приведенный пример GitHub Action `_studio.yml` отправляет изменения при каждом обновлении ветки `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/action-npm-install@v1.2.1 - - uses: withastro/action-studio@main -``` \ No newline at end of file From 4b0f2966a61a9b9f09769176f938198e5cd38915 Mon Sep 17 00:00:00 2001 From: HiDeoo <494699+HiDeoo@users.noreply.github.com> Date: Fri, 7 Jun 2024 13:01:52 +0200 Subject: [PATCH 2/2] docs: add missing `es` sentence Co-authored-by: Sarah Rainsberger --- src/content/docs/es/guides/astro-db.mdx | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/src/content/docs/es/guides/astro-db.mdx b/src/content/docs/es/guides/astro-db.mdx index b36c363809217..d9963e7ac261b 100644 --- a/src/content/docs/es/guides/astro-db.mdx +++ b/src/content/docs/es/guides/astro-db.mdx @@ -335,7 +335,9 @@ Consulta la documentación de [Drizzle `db.batch()`](https://orm.drizzle.team/do ## Astro Studio -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). +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. + +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). Desde tu panel de Studio, tienes acceso a la gestión de cuentas, artículos de ayuda y una consola de mensajes de soporte.