From 5b8bb1b3910ebaafb0ed3136e6e6477efa7cf4ad Mon Sep 17 00:00:00 2001 From: Armand Philippot Date: Mon, 21 Apr 2025 18:07:58 +0200 Subject: [PATCH 1/2] i18n(fr): translate new `guides` pages See #73 --- .../docs/fr/guides/database/sqld-server.mdx | 156 ++++++++++++++++++ src/content/docs/fr/guides/index.mdx | 20 +++ .../upgrade/version-guides/0-1-0-beta-16.mdx | 35 ++++ 3 files changed, 211 insertions(+) create mode 100644 src/content/docs/fr/guides/database/sqld-server.mdx create mode 100644 src/content/docs/fr/guides/index.mdx create mode 100644 src/content/docs/fr/guides/upgrade/version-guides/0-1-0-beta-16.mdx diff --git a/src/content/docs/fr/guides/database/sqld-server.mdx b/src/content/docs/fr/guides/database/sqld-server.mdx new file mode 100644 index 00000000..693d71b6 --- /dev/null +++ b/src/content/docs/fr/guides/database/sqld-server.mdx @@ -0,0 +1,156 @@ +--- +i18nReady: true +title: Serveur libSQL auto-hébergé +description: Hébergez votre propre serveur sqld libSQL avec Docker +--- + +import ReadMore from '~/components/ReadMore.astro' +import { PackageManagers } from 'starlight-package-managers' +import { FileTree, TabItem, Tabs, Steps, Aside } from '@astrojs/starlight/components'; + +Le projet `sqld` (« démon SQL ») est un mode serveur pour libSQL créé par Turso. Ce guide explique comment configurer `sqld` pour qu’il fonctionne depuis un conteneur Docker pour votre projet StudioCMS. + +Apprenez-en plus sur `sqld` en utilisant leur [Documentation][sql-docs] + +## Prérequis + +- [Docker et Docker Compose][docker-docs] (exécuté sur un serveur ou localement) +- [OpenSSL][openssl-docs] installé +- CLI de StudioCMS (disponible depuis la racine de votre projet StudioCMS) + +La structure finale du fichier ressemblera à ceci si vous effectuez un test local : + + + +- docker-compose.yml +- data/ +- keys/ +- mon-projet-studiocms/ + - astro.config.mjs + - studiocms.config.mjs + - package.json + - src/ + + + +## Générer des clés privées et publiques + +Depuis le répertoire `keys`, exécutez la commande suivante pour créer une nouvelle paire de clés Ed25519 encodées en PKCS#8 : +```bash +openssl genpkey -algorithm Ed25519 -out ./libsql.pem +``` + +Extrayez ensuite la clé publique avec : + +```bash +openssl pkey -in ./libsql.pem -pubout -out ./libsql.pub +``` + +Cela générera une nouvelle paire de clés PKCS#8 qui sera utilisée pour le serveur `sqld`. + +## Générez votre jeton JWT + +Accédez au répertoire de votre projet StudioCMS et exécutez la commande suivante : + + + +Le résultat est le jeton d'authentification JWT chiffré avec votre clé privée, qui sera utilisé pour l’authentification libSQL. Gardez à l’esprit que le token sera valable 1 an ! + +### Mettez à jour votre fichier `.env` de StudioCMS avec les éléments suivants : + +```sh +ASTRO_DB_REMOTE_URL=http://localhost:8080 # Cela devrait pointer vers votre serveur Docker/système local +ASTRO_DB_APP_TOKEN= # collez ici votre jeton d’authentification JWT encodé en base64URL +``` + +## Mise en place du conteneur Docker + +Créez un nouveau fichier `docker-compose.yml` en dehors du répertoire du projet StudioCMS, pour l’instance libSQL. Vous disposez alors de deux options pour configurer l’authentification libSQL : + +- En utilisant le fichier de clé publique lui-même +- En utilisant le jeton JWT comme variable d’environnement (la même valeur `ASTRO_DB_APP_TOKEN` que celle que vous avez utilisée dans votre fichier `.env`) + + + + + +```yml +services: + libsql: + image: ghcr.io/tursodatabase/libsql-server:latest + platform: linux/amd64 + ports: + - "8080:8080" + - "5001:5001" + environment: + - SQLD_NODE=primary + - SQLD_AUTH_JWT_KEY_FILE=/home/.ssh/libsql.pub + volumes: + - ./data/libsql:/var/lib/sqld + - ./keys/libsql.pub:/home/.ssh/libsql.pub +``` + + + + + +```yml +services: + libsql: + image: ghcr.io/tursodatabase/libsql-server:latest + platform: linux/amd64 + ports: + - "8080:8080" + - "5001:5001" + environment: + - SQLD_NODE=primary + - SQLD_AUTH_JWT_KEY=collez ici votre jeton JWT + volumes: + - ./data/libsql:/var/lib/sqld +``` + + + + + + + +## Tout démarrer + + + +1. Démarrez le conteneur Docker : + + À partir du répertoire de base (ou du serveur si vous avez suivi cette voie), exécutez la commande suivante pour démarrer le conteneur du serveur libSQL + + ```sh + docker compose up -d + ``` + +2. Synchronisez votre schéma de base de données StudioCMS : + + Allez dans le répertoire de votre projet StudioCMS et exécutez la commande suivante : + + + +3. Suivez la configuration initiale de votre nouvelle base de données. + + - Consultez [Mise en route][getting-started] + + :::note + Si ce n’est pas la première fois que vous configurez un projet StudioCMS, vous devrez peut-être activer l’option `dbStartPage` dans votre fichier `studiocms.config.mjs` + ::: + + + +## Réflexions finales + +Si vous recherchez une option pour auto-héberger votre propre base de données libSQL avec StudioCMS, `sqld` est une option viable et n’est pas très compliqué à mettre en place et à exécuter si vous le faites correctement. Suivre ce guide vous fournit un serveur libSQL sécurisé à utiliser avec votre projet StudioCMS. + +{/* Liens */} +[sql-docs]: https://github.com/tursodatabase/libsql/blob/main/docs/USER_GUIDE.md +[docker-docs]: https://docs.docker.com/get-started/get-docker/ +[openssl-docs]: https://docs.openssl.org/3.2/man7/ossl-guide-introduction/#getting-and-installing-openssl +[getting-started]: /fr/start-here/getting-started/#first-time-setup-or-during-updates-if-the-tables-schema-is-updated diff --git a/src/content/docs/fr/guides/index.mdx b/src/content/docs/fr/guides/index.mdx new file mode 100644 index 00000000..211981e7 --- /dev/null +++ b/src/content/docs/fr/guides/index.mdx @@ -0,0 +1,20 @@ +--- +i18nReady: true +title: Guides et tutoriels +description: Guides et tutoriels pour StudioCMS +--- + +## Guides pour les contributeurs + +- [Bien démarrer](/fr/guides/contributing/getting-started/) - Découvrez les bases pour contribuer à StudioCMS +- [Contributions au code](/fr/guides/contributing/code-contributions/) - Apprenez à contribuer au code de StudioCMS +- [Traductions](/fr/guides/contributing/translations/) - Apprenez à contribuer aux traductions de StudioCMS + +## Guides de mise à niveau + +- [Notes de version](/fr/guides/upgrade/release-notes/) - Notes de version automatisées générées à partir des journaux des modifications de StudioCMS +- Consultez la barre latérale pour plus d’options pour cette catégorie, telles que les guides de version spécifiques. + +## Bases de données + +- [Serveur libSQL auto-hébergé](/fr/guides/database/sqld-server/) - Hébergez votre propre serveur sqld libSQL avec Docker diff --git a/src/content/docs/fr/guides/upgrade/version-guides/0-1-0-beta-16.mdx b/src/content/docs/fr/guides/upgrade/version-guides/0-1-0-beta-16.mdx new file mode 100644 index 00000000..8d21badd --- /dev/null +++ b/src/content/docs/fr/guides/upgrade/version-guides/0-1-0-beta-16.mdx @@ -0,0 +1,35 @@ +--- +i18nReady: true +title: "Mise à niveau : 0.1.0-beta.16" +description: Mettre à niveau StudioCMS vers la version bêta 16 +sidebar: + label: 0.1.0-beta.16 + badge: + text: NOUVEAU + variant: success + order: 999999 +--- + +import ReadMore from '~/components/ReadMore.astro' +import QuickUpdate from '~/components/QuickUpdate.astro' + + + +## Modifications avec rupture de compatibilité + +- Version minimale d’Astro mise à jour vers `Astro v5.7.1` +- Sécurité des mots de passe mise à jour + - Les utilisateurs doivent être informés de la nécessité de mettre à jour leurs mots de passe après la mise à jour. La prise en charge du hachage des mots de passe hérités sera supprimée à l’avenir. + +## Nouvelles caractéristiques/fonctionnalités + +- Mises à jour/modifications de la CLI + - Nouvelle commande : `studiocms add ` pour ajouter rapidement de nouveaux modules d’extension à votre projet StudioCMS. + - Nouvelle commande : `studiocms crypto [command]` pour de nouveaux utilitaires de sécurité. + - Nouvelle commande : `studiocms crypto gen-jwt ` pour générer des jetons JWT à partir de la CLI. + - Correctif : la modification des utilisateurs à partir de la CLI est désormais possible grâce au nouveau schéma Drizzle de base de données partielle pour les utilisateurs et les autorisations. + +Pour plus d’informations sur les nouvelles commandes CLI, consultez la documentation de [la CLI][cli-docs] + +{/* Liens */} +[cli-docs]: /fr/how-it-works/cli/ From dbe9f5b3bb1c617658dd8fdadc4052390fa86401 Mon Sep 17 00:00:00 2001 From: Armand Philippot Date: Mon, 21 Apr 2025 18:15:29 +0200 Subject: [PATCH 2/2] fix link --- src/content/docs/fr/guides/database/sqld-server.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/fr/guides/database/sqld-server.mdx b/src/content/docs/fr/guides/database/sqld-server.mdx index 693d71b6..83b673c0 100644 --- a/src/content/docs/fr/guides/database/sqld-server.mdx +++ b/src/content/docs/fr/guides/database/sqld-server.mdx @@ -153,4 +153,4 @@ Si vous recherchez une option pour auto-héberger votre propre base de données [sql-docs]: https://github.com/tursodatabase/libsql/blob/main/docs/USER_GUIDE.md [docker-docs]: https://docs.docker.com/get-started/get-docker/ [openssl-docs]: https://docs.openssl.org/3.2/man7/ossl-guide-introduction/#getting-and-installing-openssl -[getting-started]: /fr/start-here/getting-started/#first-time-setup-or-during-updates-if-the-tables-schema-is-updated +[getting-started]: /fr/start-here/getting-started/#première-configuration-ou-lors-des-mises-à-jour-si-le-schéma-des-tables-est-mis-à-jour