Skip to content

i18n(fr): update integrations-guide/cloudflare.mdx #13600

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
ArmandPhilippot merged 2 commits into from
Mar 30, 2026
+37 −27
Merged

i18n(fr): update integrations-guide/cloudflare.mdx #13600

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
96bcd23
i18n(fr): update `integrations-guide/cloudflare.mdx`
ArmandPhilippot Mar 26, 2026
52e8d86
Merge branch 'main' into i18n/fr-update-integrations-guide/cloudflare
ArmandPhilippot Mar 30, 2026
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
64 changes: 37 additions & 27 deletions src/content/docs/fr/guides/integrations-guide/cloudflare.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -234,7 +234,7 @@ Définissez des [variables d'environnement](https://developers.cloudflare.com/wo

```jsonc title="wrangler.jsonc"
{
"vars" : {
"vars": {
"MA_VARIABLE": "test"
}
}
Expand Down Expand Up @@ -442,7 +442,7 @@ Ce changement vous aide à détecter les problèmes pendant le développement qu

Ce changement est transparent pour la plupart des projets. Si votre projet comportait une configuration spéciale pour `astro dev` ou s'appuyait sur un comportement spécifique à Node.js en développement, ajustez votre code ou votre configuration en conséquence.

### Nouveau : Option `prerenderEnvironment`
### Nouveau : Option `prerenderEnvironment`

Dans Astro 6, les pages pré-rendues s'exécutent désormais par défaut dans l'environnement d'exécution `workerd` de Cloudflare pendant le développement et la compilation. Auparavant, ces pages s'exécutaient toujours dans Node.js.

Expand All @@ -458,7 +458,7 @@ Le nouvel environnement workerd ne prend pas en charge la syntaxe CommonJS, nota

Si vous avez le contrôle sur la dépendance, vous pouvez créer un module d'extension pour Vite et précompiler la dépendance à l'aide de l'option `optimizeDeps.include`.

Par exemple, vous pouvez créer un module d'extension pour Vite afin de précompiler la dépendance `postcss` et d'utiliser le colorateur syntaxique Expressive Code :
Par exemple, vous pouvez créer un module d'extension pour Vite afin de précompiler la dépendance `postcss` et d'utiliser le colorateur syntaxique Expressive Code :

```js ins={8-14}
function noExternalPlugin() {
Expand All @@ -482,11 +482,11 @@ function noExternalPlugin() {
}
```

### Modifié : Configuration du point d'entrée de Wrangler
### Modifié : Configuration du point d'entrée de Wrangler

Auparavant, le champ `main` de votre configuration Wrangler pointait vers le fichier worker compilé (par exemple, `dist/_worker.js/index.js`). Avec Astro 6, ce champ pointe désormais vers un nouveau point d'entrée unifié fourni par l'adaptateur Cloudflare : `@astrojs/cloudflare/entrypoints/server`.
Auparavant, le champ `main` de votre configuration Wrangler pointait vers le fichier worker compilé (par exemple, `dist/_worker.js/index.js`). Avec Astro 6, ce champ pointe désormais vers un nouveau point d'entrée unifié fourni par l'adaptateur Cloudflare : `@astrojs/cloudflare/entrypoints/server`.

Mettez à jour votre fichier `wrangler.jsonc` pour utiliser le nouveau point d'entrée :
Mettez à jour votre fichier `wrangler.jsonc` pour utiliser le nouveau point d'entrée :

```jsonc title="wrangler.jsonc" del={2} ins={3}
{
Expand All @@ -499,52 +499,52 @@ Mettez à jour votre fichier `wrangler.jsonc` pour utiliser le nouveau point d'e

Ce point d'entrée unique gère à la fois les déploiements `astro dev` et de production.

### Supprimé : API `Astro.locals.runtime`
### Supprimé : API `Astro.locals.runtime`

L'objet `Astro.locals.runtime` a été supprimé au profit d'un accès direct aux API de Cloudflare Workers. Accédez directement aux variables d'environnement, à l'objet `cf`, aux caches et au contexte d'exécution via les interfaces fournies.

**Accéder aux variables d'environnement :**
**Accéder aux variables d'environnement :**

Auparavant, les variables d'environnement étaient accessibles via `Astro.locals.runtime.env`. Désormais, importez directement `env` :
Auparavant, les variables d'environnement étaient accessibles via `Astro.locals.runtime.env`. Désormais, importez directement `env` :

```js del={1} ins={2}
const { env } = Astro.locals.runtime;
import { env } from 'cloudflare:workers';
```

**Accéder à l'objet `cf` :**
**Accéder à l'objet `cf` :**

Auparavant, l'objet `cf` était accessible via `Astro.locals.runtime.cf`. Désormais, accédez-y directement depuis la requête :
Auparavant, l'objet `cf` était accessible via `Astro.locals.runtime.cf`. Désormais, accédez-y directement depuis la requête :

```js del={1} ins={2}
const { cf } = Astro.locals.runtime;
const cf = Astro.request.cf;
```

**Accès à l'API des caches :**
**Accès à l'API des caches :**

Auparavant, l'API des caches était accessible via `Astro.locals.runtime.caches`. Utilisez désormais directement l'objet global `caches` :
Auparavant, l'API des caches était accessible via `Astro.locals.runtime.caches`. Utilisez désormais directement l'objet global `caches` :

```js del={1}
const { caches } = Astro.locals.runtime;

caches.default.put(request, response);
```

**Accès au contexte d'exécution :**
**Accès au contexte d'exécution :**

L'objet `Astro.locals.runtime.ctx` est remplacé par `Astro.locals.cfContext`, qui contient le contexte d'exécution (`ExecutionContext`) de Cloudflare :
L'objet `Astro.locals.runtime.ctx` est remplacé par `Astro.locals.cfContext`, qui contient le contexte d'exécution (`ExecutionContext`) de Cloudflare :

```js del={1} ins={2}
const ctx = Astro.locals.runtime.ctx;
const ctx = Astro.locals.cfContext;
```

### Modifié : Le fichier de configuration Wrangler est désormais optionnel
### Modifié : Le fichier de configuration Wrangler est désormais optionnel

Le fichier de configuration Wrangler est désormais facultatif pour les projets simples. Si vous ne disposez pas d'une configuration personnalisée, telle que des liaisons Cloudflare (KV, D1, Durable Objects, etc.), Astro générera automatiquement une configuration par défaut pour vous.

Si votre fichier `wrangler.jsonc` ne contient qu'une configuration de base comme celle-ci :
Si votre fichier `wrangler.jsonc` ne contient qu'une configuration de base comme celle-ci :

```jsonc
{
Expand All @@ -557,20 +557,20 @@ Si votre fichier `wrangler.jsonc` ne contient qu'une configuration de base comme
}
```

Vous pouvez supprimer ce fichier sans risque. Astro gère cette configuration automatiquement. Sinon, créez un fichier `wrangler.jsonc` minimal contenant uniquement le nom de votre projet et vos autres paramètres personnalisés :
Vous pouvez supprimer ce fichier sans risque. Astro gère cette configuration automatiquement. Sinon, créez un fichier `wrangler.jsonc` minimal contenant uniquement le nom de votre projet et vos autres paramètres personnalisés :

```jsonc title="wrangler.jsonc"
{
"name": "mon-app-astro",
}
```

### Modifié : Point d'entrée d'API personnalisé
### Modifié : Point d'entrée d'API personnalisé

Si vous utilisiez une configuration `workerEntryPoint` personnalisée dans les options de l'adaptateur, celle-ci a été supprimée. Spécifiez plutôt votre point d'entrée personnalisé dans votre configuration Wrangler et créez directement un objet d'exportation Cloudflare Worker standard, plutôt que d'utiliser la fonction `createExports()`.

<Steps>
1. Supprimez l'option `workerEntryPoint` de la configuration de votre adaptateur :
1. Supprimez l'option `workerEntryPoint` de la configuration de votre adaptateur :

```js title="astro.config.mjs" del={6-9}
import { defineConfig } from 'astro/config';
Expand All @@ -586,15 +586,15 @@ Si vous utilisiez une configuration `workerEntryPoint` personnalisée dans les o
});
```

2. Indiquez plutôt le point d'entrée dans `wrangler.jsonc` :
2. Indiquez plutôt le point d'entrée dans `wrangler.jsonc` :

```jsonc title="wrangler.jsonc"
{
"main": "./src/worker.ts"
}
```

3. Mettez à jour votre fichier d'entrée Worker personnalisé pour utiliser la syntaxe Worker standard. Importez le gestionnaire depuis `@astrojs/cloudflare/handler` et exportez un objet Cloudflare Worker standard, ainsi que toutes les exportations personnalisées telles que les objets durables :
3. Mettez à jour votre fichier d'entrée Worker personnalisé pour utiliser la syntaxe Worker standard. Importez le gestionnaire depuis `@astrojs/cloudflare/handler` et exportez un objet Cloudflare Worker standard, ainsi que toutes les exportations personnalisées telles que les objets durables :

```ts title="src/worker.ts"
import { handle } from '@astrojs/cloudflare/handler';
Expand All @@ -619,11 +619,11 @@ Si vous utilisiez une configuration `workerEntryPoint` personnalisée dans les o

Le manifeste est désormais créé en interne par l'adaptateur, il n'est donc plus nécessaire de le transmettre à votre gestionnaire.

### Supprimé : Option `cloudflareModules`
### Supprimé : Option `cloudflareModules`

L'option `cloudflareModules` de l'adaptateur a été supprimée car elle n'est plus nécessaire. Cloudflare prend en charge nativement l'importation de modules `.sql`, `.wasm` et d'autres types de modules.

Supprimez l'option `cloudflareModules` de la configuration de votre adaptateur Cloudflare si vous l'utilisiez :
Supprimez l'option `cloudflareModules` de la configuration de votre adaptateur Cloudflare si vous l'utilisiez :

```ts title="astro.config.mjs" del={5}
import cloudflare from '@astrojs/cloudflare';
Expand All @@ -636,22 +636,32 @@ export default defineConfig({
```


### Nouveau : Prise en charge d'`astro preview`
### Nouveau : Prise en charge d'`astro preview`

Utilisez `astro preview` pour tester localement votre application Cloudflare Workers avant son déploiement. L'aperçu s'exécute avec l'environnement d'exécution `workerd` de Cloudflare, reproduisant fidèlement le comportement en production. Exécutez `astro build` puis `astro preview` pour démarrer le serveur de prévisualisation.

### Supprimée : Prise en charge de Cloudflare Pages
### Supprimée : Prise en charge de Cloudflare Pages

L'adaptateur Cloudflare d'Astro ne prend plus en charge le déploiement sur Cloudflare Pages. Pour une expérience optimale et une prise en charge complète des fonctionnalités, vous devriez migrer vers Cloudflare Workers.

<ReadMore>Consultez le [guide de migration de Pages vers Workers](https://developers.cloudflare.com/workers/static-assets/migration-guides/migrate-from-pages/) de Cloudflare pour obtenir des instructions de migration détaillées.</ReadMore>

### Modifiée : Valeur par défaut de `imageService`
### Modifiée : Valeur par défaut de `imageService`

La valeur par défaut de `imageService` est passée de `'compile'` à `'cloudflare-binding'` pour une expérience améliorée lors de la manipulation d'images.

Le service `cloudflare-binding` utilise la [liaison Cloudflare Images](https://developers.cloudflare.com/images/transform-images/bindings/) pour transformer les images au moment de l'exécution, et la liaison est automatiquement configurée lors du déploiement.

Pour revenir au comportement précédent, où la transformation d'image n'était disponible que sur les routes pré-rendues au moment de la compilation, définissez explicitement `imageService: 'compile'` dans la configuration de votre adaptateur.

### Modifiée : Déploiement vers l'environnement Cloudflare

Dans Astro 5.x, vous pouviez créer votre projet Astro une seule fois et le déployer dans un environnement Cloudflare spécifique avec `wrangler deploy --env un-env`.

Depuis Astro 6.0, l'intégration repose sur le module d'extension Vite de Cloudflare et ce comportement a changé. L'environnement est désormais déterminé lors de la phase de compilation. Par conséquent, vous devez compiler votre projet séparément pour chaque environnement.

Pour déployer votre application dans un environnement Cloudflare spécifique, préfixez votre commande avec la variable `CLOUDFLARE_ENV`. Par exemple, la commande `CLOUDFLARE_ENV=un-env astro build && wrangler deploy` compilera votre projet Astro et le déploiera avec Wrangler en utilisant l'environnement `un-env`.

<ReadMore>Découvrez comment mettre à jour vos [environnements Cloudflare](https://developers.cloudflare.com/workers/vite-plugin/reference/cloudflare-environments/) dans le [guide du développeur « Migrate from wrangler »](https://developers.cloudflare.com/workers/vite-plugin/reference/migrating-from-wrangler-dev/#cloudflare-environments).</ReadMore>

[astro-integration]: /fr/guides/integrations/
Loading