You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/content/docs/fr/guides/integrations-guide/cloudflare.mdx
+37-27Lines changed: 37 additions & 27 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -234,7 +234,7 @@ Définissez des [variables d'environnement](https://developers.cloudflare.com/wo
234
234
235
235
```jsonc title="wrangler.jsonc"
236
236
{
237
-
"vars": {
237
+
"vars": {
238
238
"MA_VARIABLE":"test"
239
239
}
240
240
}
@@ -442,7 +442,7 @@ Ce changement vous aide à détecter les problèmes pendant le développement qu
442
442
443
443
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.
444
444
445
-
### Nouveau: Option `prerenderEnvironment`
445
+
### Nouveau: Option `prerenderEnvironment`
446
446
447
447
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.
448
448
@@ -458,7 +458,7 @@ Le nouvel environnement workerd ne prend pas en charge la syntaxe CommonJS, nota
458
458
459
459
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`.
460
460
461
-
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:
461
+
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:
462
462
463
463
```js ins={8-14}
464
464
functionnoExternalPlugin() {
@@ -482,11 +482,11 @@ function noExternalPlugin() {
482
482
}
483
483
```
484
484
485
-
### Modifié: Configuration du point d'entrée de Wrangler
485
+
### Modifié: Configuration du point d'entrée de Wrangler
486
486
487
-
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`.
487
+
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`.
488
488
489
-
Mettez à jour votre fichier `wrangler.jsonc` pour utiliser le nouveau point d'entrée:
489
+
Mettez à jour votre fichier `wrangler.jsonc` pour utiliser le nouveau point d'entrée:
490
490
491
491
```jsonc title="wrangler.jsonc" del={2} ins={3}
492
492
{
@@ -499,52 +499,52 @@ Mettez à jour votre fichier `wrangler.jsonc` pour utiliser le nouveau point d'e
499
499
500
500
Ce point d'entrée unique gère à la fois les déploiements `astro dev` et de production.
501
501
502
-
### Supprimé: API `Astro.locals.runtime`
502
+
### Supprimé: API `Astro.locals.runtime`
503
503
504
504
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.
505
505
506
-
**Accéder aux variables d'environnement:**
506
+
**Accéder aux variables d'environnement:**
507
507
508
-
Auparavant, les variables d'environnement étaient accessibles via `Astro.locals.runtime.env`. Désormais, importez directement `env`:
508
+
Auparavant, les variables d'environnement étaient accessibles via `Astro.locals.runtime.env`. Désormais, importez directement `env`:
509
509
510
510
```js del={1} ins={2}
511
511
const { env } =Astro.locals.runtime;
512
512
import { env } from'cloudflare:workers';
513
513
```
514
514
515
-
**Accéder à l'objet `cf`:**
515
+
**Accéder à l'objet `cf`:**
516
516
517
-
Auparavant, l'objet `cf` était accessible via `Astro.locals.runtime.cf`. Désormais, accédez-y directement depuis la requête:
517
+
Auparavant, l'objet `cf` était accessible via `Astro.locals.runtime.cf`. Désormais, accédez-y directement depuis la requête:
518
518
519
519
```js del={1} ins={2}
520
520
const { cf } =Astro.locals.runtime;
521
521
constcf=Astro.request.cf;
522
522
```
523
523
524
-
**Accès à l'API des caches:**
524
+
**Accès à l'API des caches:**
525
525
526
-
Auparavant, l'API des caches était accessible via `Astro.locals.runtime.caches`. Utilisez désormais directement l'objet global `caches`:
526
+
Auparavant, l'API des caches était accessible via `Astro.locals.runtime.caches`. Utilisez désormais directement l'objet global `caches`:
527
527
528
528
```js del={1}
529
529
const { caches } =Astro.locals.runtime;
530
530
531
531
caches.default.put(request, response);
532
532
```
533
533
534
-
**Accès au contexte d'exécution:**
534
+
**Accès au contexte d'exécution:**
535
535
536
-
L'objet `Astro.locals.runtime.ctx` est remplacé par `Astro.locals.cfContext`, qui contient le contexte d'exécution (`ExecutionContext`) de Cloudflare:
536
+
L'objet `Astro.locals.runtime.ctx` est remplacé par `Astro.locals.cfContext`, qui contient le contexte d'exécution (`ExecutionContext`) de Cloudflare:
537
537
538
538
```js del={1} ins={2}
539
539
constctx=Astro.locals.runtime.ctx;
540
540
constctx=Astro.locals.cfContext;
541
541
```
542
542
543
-
### Modifié: Le fichier de configuration Wrangler est désormais optionnel
543
+
### Modifié: Le fichier de configuration Wrangler est désormais optionnel
544
544
545
545
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.
546
546
547
-
Si votre fichier `wrangler.jsonc` ne contient qu'une configuration de base comme celle-ci:
547
+
Si votre fichier `wrangler.jsonc` ne contient qu'une configuration de base comme celle-ci:
548
548
549
549
```jsonc
550
550
{
@@ -557,20 +557,20 @@ Si votre fichier `wrangler.jsonc` ne contient qu'une configuration de base comme
557
557
}
558
558
```
559
559
560
-
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:
560
+
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:
561
561
562
562
```jsonc title="wrangler.jsonc"
563
563
{
564
564
"name":"mon-app-astro",
565
565
}
566
566
```
567
567
568
-
### Modifié: Point d'entrée d'API personnalisé
568
+
### Modifié: Point d'entrée d'API personnalisé
569
569
570
570
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()`.
571
571
572
572
<Steps>
573
-
1. Supprimez l'option `workerEntryPoint` de la configuration de votre adaptateur:
573
+
1. Supprimez l'option `workerEntryPoint` de la configuration de votre adaptateur:
574
574
575
575
```js title="astro.config.mjs" del={6-9}
576
576
import { defineConfig } from'astro/config';
@@ -586,15 +586,15 @@ Si vous utilisiez une configuration `workerEntryPoint` personnalisée dans les o
586
586
});
587
587
```
588
588
589
-
2. Indiquez plutôt le point d'entrée dans `wrangler.jsonc`:
589
+
2. Indiquez plutôt le point d'entrée dans `wrangler.jsonc`:
590
590
591
591
```jsonc title="wrangler.jsonc"
592
592
{
593
593
"main":"./src/worker.ts"
594
594
}
595
595
```
596
596
597
-
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:
597
+
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:
@@ -619,11 +619,11 @@ Si vous utilisiez une configuration `workerEntryPoint` personnalisée dans les o
619
619
620
620
Le manifeste est désormais créé en interne par l'adaptateur, il n'est donc plus nécessaire de le transmettre à votre gestionnaire.
621
621
622
-
### Supprimé: Option `cloudflareModules`
622
+
### Supprimé: Option `cloudflareModules`
623
623
624
624
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.
625
625
626
-
Supprimez l'option `cloudflareModules` de la configuration de votre adaptateur Cloudflare si vous l'utilisiez:
626
+
Supprimez l'option `cloudflareModules` de la configuration de votre adaptateur Cloudflare si vous l'utilisiez:
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.
642
642
643
-
### Supprimée: Prise en charge de Cloudflare Pages
643
+
### Supprimée: Prise en charge de Cloudflare Pages
644
644
645
645
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.
646
646
647
647
<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>
648
648
649
-
### Modifiée: Valeur par défaut de `imageService`
649
+
### Modifiée: Valeur par défaut de `imageService`
650
650
651
651
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.
652
652
653
653
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.
654
654
655
655
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.
656
656
657
+
### Modifiée : Déploiement vers l'environnement Cloudflare
658
+
659
+
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`.
660
+
661
+
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.
662
+
663
+
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`.
664
+
665
+
<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>
0 commit comments