Skip to content

i18n(fr): update guides/deploy/deno.mdx #11209

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.

Sign up for GitHub

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

Merged
thomasbnt merged 2 commits into from
Mar 12, 2025
Merged

i18n(fr): update guides/deploy/deno.mdx #11209

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
999b6f1
i18n(fr): update `guides/deploy/deno.mdx`
ArmandPhilippot Mar 12, 2025
09366e7
Merge branch 'main' into i18n/fr-update-guides/deploy/deno.mdx
thomasbnt Mar 12, 2025
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
178 changes: 136 additions & 42 deletions src/content/docs/fr/guides/deploy/deno.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,48 +1,55 @@
---
title: Déployez votre site Astro sur Deno
title: Déployez votre site Astro avec Deno
description: Comment déployer votre site Astro sur le web en utilisant Deno.
sidebar:
label: Deno
type: deploy
i18nReady: true
---
import ReadMore from '~/components/ReadMore.astro';
import { Steps } from '@astrojs/starlight/components';
import StaticSsrTabs from '~/components/tabs/StaticSsrTabs.astro';
import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'

Vous pouvez déployer un site Astro rendu côté serveur sur [Deno Deploy](https://deno.com/deploy), un système distribué qui exécute JavaScript, TypeScript et WebAssembly à la pointe de la technologie, dans le monde entier.
Vous pouvez déployer un site Astro statique ou rendu à la demande à l'aide de Deno, soit sur votre propre serveur, soit sur [Deno Deploy](https://deno.com/deploy), un système distribué qui exécute JavaScript, TypeScript et WebAssembly à la pointe de la technologie, dans le monde entier.

Ce guide comprend des instructions pour le déploiement vers Deno Deploy via les actions sur GitHub ou la CLI de Deno Deploy.
Ce guide comprend des instructions pour exécuter votre site Astro sur votre propre serveur avec Deno et le déployer sur Deno Deploy via GitHub Actions ou la CLI de Deno Deploy.

## Prérequis

Ce guide suppose que vous avez déjà installé [Deno](https://deno.com/).

## Configuration du projet

Votre projet Astro peut être déployé sur [Deno Deploy](https://deno.com/deploy) en tant que site statique, ou en utilisant le rendu côté serveur (SSR).
Votre projet Astro peut être déployé en tant que site statique ou en tant que site rendu à la demande.

### Site statique
Votre projet Astro est un site statique par défaut. Vous n'avez besoin d'aucune configuration supplémentaire pour déployer un site Astro statique dans Deno Deploy.

### Adaptateur pour le SSR
Votre projet Astro est un site statique par défaut. Aucune configuration supplémentaire n'est requise pour déployer un site Astro statique avec Deno ou Deno Deploy.

Pour activer SSR dans votre projet Astro et le déployer sur Deno Deploy :
### Adaptateur pour le rendu à la demande

Ajoutez [l'adaptateur Deno][Deno adapter] pour activer SSR dans votre projet Astro avec la commande `astro add` suivante. Cela installera l'adaptateur et apportera les changements appropriés à votre fichier `astro.config.mjs` en une seule étape.

```bash
npx astro add deno
```

Si vous préférez installer l'adaptateur manuellement, suivez les deux étapes suivantes :
Pour activer le rendu à la demande dans votre projet Astro à l'aide de Deno et pour déployer sur Deno Deploy :

<Steps>
1. Installez [l'adaptateur `@deno/astro-adapter`][Deno adapter] aux dépendances de votre projet en utilisant votre gestionnaire de paquets préféré. Si vous utilisez npm ou si vous n'êtes pas sûr, exécutez ceci dans le terminal :

```bash
npm install @deno/astro-adapter
```
1. Installez [l'adaptateur `@deno/astro-adapter`][Deno adapter] aux dépendances de votre projet en utilisant votre gestionnaire de paquets préféré:

<PackageManagerTabs>
<Fragment slot="npm">
```shell
npm install @deno/astro-adapter
```
</Fragment>
<Fragment slot="pnpm">
```shell
pnpm install @deno/astro-adapter
```
</Fragment>
<Fragment slot="yarn">
```shell
yarn add @deno/astro-adapter
```
</Fragment>
</PackageManagerTabs>

2. Mettez à jour votre fichier de configuration du projet `astro.config.mjs` avec les changements ci-dessous.

Expand All @@ -57,7 +64,7 @@ Si vous préférez installer l'adaptateur manuellement, suivez les deux étapes
});
```

Ensuite, mettez à jour votre script `preview` dans `package.json` avec le changement ci-dessous.
3. Mettez à jour votre script `preview` dans `package.json` avec la modification ci-dessous.

```json del={8} ins={9}
// package.json
Expand All @@ -75,16 +82,92 @@ Si vous préférez installer l'adaptateur manuellement, suivez les deux étapes

Vous pouvez maintenant utiliser cette commande pour prévisualiser votre site Astro de façon locale avec Deno.

```bash
npm run preview
```
<PackageManagerTabs>
<Fragment slot="npm">
```shell
npm run preview
```
</Fragment>
<Fragment slot="pnpm">
```shell
pnpm run preview
```
</Fragment>
<Fragment slot="yarn">
```shell
yarn run preview
```
</Fragment>
</PackageManagerTabs>
</Steps>

## Comment déployer un site Astro
## Comment déployer

Vous pouvez déployer Deno Deploy via les actions GitHub ou en utilisant l'interface de ligne de commande (CLI) de Deno Deploy.

### Déploiement des actions GitHub
### Sur votre propre serveur

<Steps>
1. Copiez votre projet sur votre serveur.

2. Installez les dépendances du projet à l’aide de votre gestionnaire de paquets préféré :

<PackageManagerTabs>
<Fragment slot="npm">
```shell
npm install
```
</Fragment>
<Fragment slot="pnpm">
```shell
pnpm install
```
</Fragment>
<Fragment slot="yarn">
```shell
yarn
```
</Fragment>
</PackageManagerTabs>

3. Créez votre site Astro avec votre gestionnaire de paquets préféré :

<PackageManagerTabs>
<Fragment slot="npm">
```shell
npm run build
```
</Fragment>
<Fragment slot="pnpm">
```shell
pnpm run build
```
</Fragment>
<Fragment slot="yarn">
```shell
yarn run build
```
</Fragment>
</PackageManagerTabs>

4. Démarrez votre application avec la commande suivante :

<StaticSsrTabs>
<Fragment slot="static">
```bash
deno run -A jsr:@std/http/file-server dist
```
</Fragment>

<Fragment slot="ssr">
```bash
deno run -A ./dist/server/entry.mjs
```
</Fragment>
</StaticSsrTabs>
</Steps>

### Déploiement avec les actions GitHub

Si votre projet est stocké sur GitHub, le [site Deno Deploy](https://dash.deno.com/) vous guidera dans la mise en place des actions GitHub pour déployer votre site Astro.

Expand Down Expand Up @@ -167,46 +250,57 @@ Si votre projet est stocké sur GitHub, le [site Deno Deploy](https://dash.deno.
uses: denoland/deployctl@v1
with:
project: my-deno-project # TODO : remplacer par le nom du projet Deno Deploy
entrypoint: server/entry.mjs
root: dist
entrypoint: dist/server/entry.mjs
```
</Fragment>
</StaticSsrTabs>

5. Après avoir validé ce fichier YAML et l'avoir poussé sur GitHub sur la branche de déploiement configurée, le déploiement devrait commencer automatiquement !

Vous pouvez suivre la progression en utilisant l'onglet "Actions" sur votre page de dépôt GitHub, ou sur [Deno Deploy](https://dash.deno.com).
Vous pouvez suivre la progression en utilisant l'onglet « Actions » sur votre page de dépôt GitHub, ou sur [Deno Deploy](https://dash.deno.com).
</Steps>

### Déploiement CLI

<Steps>
1. Installez le [Deno Deploy CLI](https://docs.deno.com/deploy/manual/deployctl).
1. Installez le [CLI de Deno Deploy](https://docs.deno.com/deploy/manual/deployctl).

```bash
deno install -gArf jsr:@deno/deployctl
```

2. Exécutez l'étape de compilation de votre Astro.

```bash
npm run build
```
2. Créez votre site Astro avec votre gestionnaire de paquets préféré :

<PackageManagerTabs>
<Fragment slot="npm">
```shell
npm run build
```
</Fragment>
<Fragment slot="pnpm">
```shell
pnpm run build
```
</Fragment>
<Fragment slot="yarn">
```shell
yarn run build
```
</Fragment>
</PackageManagerTabs>

3. Exécutez `deployctl` pour déployer !

Dans la commande ci-dessous, remplacez `<ACCESS-TOKEN>` par votre [Personal Access Token](https://dash.deno.com/account#access-tokens) et `<MY-DENO-PROJECT>` par le nom de votre projet Deno Deploy.

<StaticSsrTabs>
<Fragment slot="static">
```bash
cd dist && DENO_DEPLOY_TOKEN=<ACCESS-TOKEN> deployctl deploy --project=<MY-DENO-PROJECT> jsr:@std/http/file-server
cd dist && deployctl deploy jsr:@std/http/file-server
```
</Fragment>

<Fragment slot="ssr">
```bash
DENO_DEPLOY_TOKEN=<ACCESS-TOKEN> deployctl deploy --project=<MY-DENO-PROJECT> --no-static --include=./dist ./dist/server/entry.mjs
deployctl deploy ./dist/server/entry.mjs
```
</Fragment>
</StaticSsrTabs>
Expand All @@ -226,7 +320,7 @@ Si votre projet est stocké sur GitHub, le [site Deno Deploy](https://dash.deno.
"start": "astro dev",
"build": "astro build",
"preview": "astro preview",
"deno-deploy": "npm run build && cd dist && deployctl deploy --project=<MY-DENO-PROJECT> jsr:@std/http/file-server"
"deno-deploy": "npm run build && cd dist && deployctl deploy jsr:@std/http/file-server"
}
}
```
Expand All @@ -241,7 +335,7 @@ Si votre projet est stocké sur GitHub, le [site Deno Deploy](https://dash.deno.
"start": "astro dev",
"build": "astro build",
"preview": "deno run --allow-net --allow-read --allow-env ./dist/server/entry.mjs",
"deno-deploy": "npm run build && deployctl deploy --project=<MY-DENO-PROJECT> --no-static --include=./dist ./dist/server/entry.mjs"
"deno-deploy": "npm run build && deployctl deploy ./dist/server/entry.mjs"
}
}
```
Expand All @@ -251,7 +345,7 @@ Si votre projet est stocké sur GitHub, le [site Deno Deploy](https://dash.deno.
Vous pouvez alors utiliser cette commande pour construire et déployer votre site Astro en une seule étape.

```bash
DENO_DEPLOY_TOKEN=<ACCESS-TOKEN> npm run deno-deploy
npm run deno-deploy
```
</Steps>

Expand Down