Skip to content

Commit 510aee8

Browse files
i18n(fr): update guides/deploy/cloudflare.mdx (withastro#12628)
Co-authored-by: Thomas Bonnet <thomasbnt@protonmail.com>
1 parent 514b9ff commit 510aee8

File tree

1 file changed

+142
-32
lines changed

1 file changed

+142
-32
lines changed

src/content/docs/fr/guides/deploy/cloudflare.mdx

Lines changed: 142 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@ i18nReady: true
99
import ReadMore from '~/components/ReadMore.astro';
1010
import { Steps } from '@astrojs/starlight/components';
1111
import StaticSsrTabs from '~/components/tabs/StaticSsrTabs.astro';
12+
import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'
1213

1314
Vous pouvez déployer des applications full-stack, y compris des ressources statiques front-end et des API back-end, ainsi que des sites rendus à la demande, sur [Cloudflare Workers](https://developers.cloudflare.com/workers/static-assets/) et [Cloudflare Pages](https://pages.cloudflare.com/).
1415

@@ -45,46 +46,53 @@ Pour commencer, vous aurez besoin :
4546

4647
Cela installera l'adaptateur et apportera les modifications appropriées à votre fichier `astro.config.mjs` en une seule étape.
4748

48-
```bash
49+
<PackageManagerTabs>
50+
<Fragment slot="npm">
51+
```sh
4952
npx astro add cloudflare
5053
```
51-
52-
Ensuite, créez un fichier `.assetsignore` dans votre dossier `public/` et ajoutez-y les lignes suivantes :
53-
```txt title="public/.assetsignore"
54-
_worker.js
55-
_routes.json
54+
</Fragment>
55+
<Fragment slot="pnpm">
56+
```sh
57+
pnpm astro add cloudflare
58+
```
59+
</Fragment>
60+
<Fragment slot="yarn">
61+
```sh
62+
yarn astro add cloudflare
5663
```
64+
</Fragment>
65+
</PackageManagerTabs>
5766

5867
<ReadMore>En savoir plus sur [le rendu à la demande dans Astro](/fr/guides/on-demand-rendering/).</ReadMore>
5968

6069
3. Créez un [fichier de configuration Wrangler](https://developers.cloudflare.com/workers/wrangler/configuration/).
6170

71+
L'exécution de `astro add cloudflare` créera ceci pour vous ; si vous n'utilisez pas l'adaptateur, vous devrez le créer vous-même.
72+
6273
<StaticSsrTabs>
6374
<Fragment slot="static">
64-
```jsonc
65-
// wrangler.jsonc
75+
```jsonc title="wrangler.jsonc"
6676
{
67-
"$schema": "node_modules/wrangler/config-schema.json",
68-
"name": "my-astro-app",
69-
// Mettre à jour à la date d'aujourd'hui
70-
"compatibility_date": "2025-03-25",
77+
"name": "mon-appli-astro",
78+
"compatibility_date": "2025-03-25", // Mettre à jour avec le jour de votre déploiement
7179
"assets": {
80+
"binding": "ASSETS",
7281
"directory": "./dist",
73-
"not_found_handling": "404-page" // Si vous avez une page `src/pages/404.astro` personnalisée
7482
}
7583
}
7684
```
7785
</Fragment>
7886
<Fragment slot="ssr">
79-
```jsonc
80-
// wrangler.jsonc
87+
```jsonc title="wrangler.jsonc"
8188
{
82-
"$schema": "node_modules/wrangler/config-schema.json",
83-
"name": "my-astro-app",
8489
"main": "./dist/_worker.js/index.js",
85-
// Mettre à jour à la date d'aujourd'hui
86-
"compatibility_date": "2025-03-25",
87-
"compatibility_flags": ["nodejs_compat"],
90+
"name": "mon-appli-astro",
91+
"compatibility_date": "2025-03-25", // Mettre à jour avec le jour de votre déploiement
92+
"compatibility_flags": [
93+
"nodejs_compat",
94+
"global_fetch_strictly_public"
95+
],
8896
"assets": {
8997
"binding": "ASSETS",
9098
"directory": "./dist"
@@ -141,36 +149,123 @@ Si vous utilisez Workers Builds :
141149
<Steps>
142150
1. Installez [la CLI de Wrangler](https://developers.cloudflare.com/workers/wrangler/get-started/).
143151

144-
```bash
145-
npm install wrangler@latest --save-dev
146-
```
152+
<PackageManagerTabs>
153+
<Fragment slot="npm">
154+
```sh
155+
npm install wrangler@latest --save-dev
156+
```
157+
</Fragment>
158+
<Fragment slot="pnpm">
159+
```sh
160+
pnpm add wrangler@latest --save-dev
161+
```
162+
</Fragment>
163+
<Fragment slot="yarn">
164+
```sh
165+
yarn add wrangler@latest --dev
166+
```
167+
</Fragment>
168+
</PackageManagerTabs>
147169

148170
2. Si votre site utilise le rendu à la demande, installez l'[adaptateur `@astrojs/cloudflare`](/fr/guides/integrations-guide/cloudflare/).
149171

150172
Cela installera l'adaptateur et apportera les modifications appropriées à votre fichier `astro.config.mjs` en une seule étape.
151173

152-
```bash
153-
npx astro add cloudflare
174+
<PackageManagerTabs>
175+
<Fragment slot="npm">
176+
```sh
177+
npx astro add cloudflare
178+
```
179+
</Fragment>
180+
<Fragment slot="pnpm">
181+
```sh
182+
pnpm astro add cloudflare
183+
```
184+
</Fragment>
185+
<Fragment slot="yarn">
186+
```sh
187+
yarn astro add cloudflare
188+
```
189+
</Fragment>
190+
</PackageManagerTabs>
191+
192+
3. Créez un [fichier de configuration Wrangler](https://developers.cloudflare.com/workers/wrangler/configuration/).
193+
194+
Étant donné que Cloudflare recommande aux nouveaux projets d'utiliser Workers au lieu de Pages, la commande `astro add cloudflare` crée les fichiers `wrangler.jsonc` et `public/.assetsignore`, qui sont spécifiques aux projets Workers. Vous devrez supprimer le fichier `public/.assetsignore` et modifier votre fichier `wrangler.jsonc`. Si vous n'utilisez pas l'adaptateur, vous devrez le créer vous-même.
195+
196+
Assurez-vous que votre fichier `wrangler.jsonc` est structuré comme ceci :
197+
198+
<StaticSsrTabs>
199+
<Fragment slot="static">
200+
```jsonc title="wrangler.jsonc"
201+
{
202+
"name": "mon-appli-astro",
203+
"compatibility_date": "YYYY-MM-DD", // Mettre à jour avec le jour de votre déploiement
204+
"pages_build_output_dir": "./dist"
205+
}
154206
```
207+
</Fragment>
208+
<Fragment slot="ssr">
209+
```jsonc title="wrangler.jsonc"
210+
{
211+
"name": "mon-appli-astro",
212+
"compatibility_date": "YYYY-MM-DD", // Mettre à jour avec le jour de votre déploiement
213+
"compatibility_flags": [
214+
"nodejs_compat",
215+
"disable_nodejs_process_v2"
216+
],
217+
"pages_build_output_dir": "./dist"
218+
}
219+
```
220+
</Fragment>
221+
</StaticSsrTabs>
155222

156223
<ReadMore>En savoir plus sur [le rendu à la demande dans Astro](/fr/guides/on-demand-rendering/).</ReadMore>
157224

158225
3. Prévisualisez votre projet localement avec Wrangler.
159226

160-
```bash
161-
npx astro build && npx wrangler pages dev ./dist
162-
```
227+
<PackageManagerTabs>
228+
<Fragment slot="npm">
229+
```sh
230+
npx astro build && wrangler pages dev ./dist
231+
```
232+
</Fragment>
233+
<Fragment slot="pnpm">
234+
```sh
235+
pnpm astro build && wrangler pages dev ./dist
236+
```
237+
</Fragment>
238+
<Fragment slot="yarn">
239+
```sh
240+
yarn astro build && wrangler pages dev ./dist
241+
```
242+
</Fragment>
243+
</PackageManagerTabs>
163244

164245
4. Déployez en utilisant `npx wrangler deploy`.
165246

166-
```bash
167-
npx astro build && npx wrangler pages deploy ./dist
168-
```
247+
<PackageManagerTabs>
248+
<Fragment slot="npm">
249+
```sh
250+
npx astro build && wrangler pages deploy ./dist
251+
```
252+
</Fragment>
253+
<Fragment slot="pnpm">
254+
```sh
255+
pnpm astro build && wrangler pages deploy ./dist
256+
```
257+
</Fragment>
258+
<Fragment slot="yarn">
259+
```sh
260+
yarn astro build && wrangler pages deploy ./dist
261+
```
262+
</Fragment>
263+
</PackageManagerTabs>
169264
</Steps>
170265

171266
Une fois vos ressources téléchargées, Wrangler vous fournira une URL d'aperçu pour inspecter votre site.
172267

173-
### Comment déployer un site avec Git
268+
### Comment déployer un site en utilisant le CI/CD
174269

175270
<Steps>
176271
1. Envoyez votre code vers votre dépôt Git (par exemple GitHub, GitLab).
@@ -187,6 +282,21 @@ Une fois vos ressources téléchargées, Wrangler vous fournira une URL d'aperç
187282

188283
## Dépannage
189284

285+
### Comportement 404
286+
287+
Pour les projets Workers, vous devrez définir « not_found_handling » si vous souhaitez afficher une page 404 personnalisée. Vous pouvez en savoir plus à ce sujet dans la section [Comportement du routage](https://developers.cloudflare.com/workers/static-assets/#routing-behavior) de la documentation de Cloudflare.
288+
289+
```jsonc title="wrangler.jsonc"
290+
{
291+
"assets": {
292+
"directory": "./dist",
293+
"not_found_handling": "404-page"
294+
}
295+
}
296+
```
297+
298+
Pour les projets Pages, si vous incluez une page 404 personnalisée, elle sera affichée par défaut. Sinon, Pages adoptera par défaut le [comportement de rendu d'application monopage de Cloudflare](https://developers.cloudflare.com/pages/configuration/serving-pages/#single-page-application-spa-rendering) et redirigera vers la page d'accueil au lieu d'afficher une page 404.
299+
190300
### Hydratation côté client
191301

192302
L'hydratation côté client peut échouer à cause du paramètre Auto Minify de Cloudflare. Si vous voyez `Hydration completed but contains mismatches` dans la console, assurez-vous de désactiver Auto Minify dans les paramètres de Cloudflare.

0 commit comments

Comments
 (0)