From 091596f1370f2f9b57e4b443d1db9ef55045dce8 Mon Sep 17 00:00:00 2001 From: Alexander Niebuhr Date: Fri, 5 Jan 2024 07:27:58 +0100 Subject: [PATCH 1/3] Update cloudflare.mdx --- .../guides/integrations-guide/cloudflare.mdx | 20 ++++++++++++++++++- 1 file changed, 19 insertions(+), 1 deletion(-) diff --git a/src/content/docs/en/guides/integrations-guide/cloudflare.mdx b/src/content/docs/en/guides/integrations-guide/cloudflare.mdx index 1f0fac8290ed3..48c14619abed8 100644 --- a/src/content/docs/en/guides/integrations-guide/cloudflare.mdx +++ b/src/content/docs/en/guides/integrations-guide/cloudflare.mdx @@ -201,12 +201,30 @@ export default defineConfig({ ### `imageService` -`imageService: "passthrough" | "cloudflare"` +`imageService: "passthrough" | "cloudflare" | "compile"` Determines which image service is used by the adapter. The adapter will default to `passthrough` mode when an incompatible image service is configured. Otherwise, it will use the globally configured image service: * **`cloudflare`:** Uses the [Cloudflare Image Resizing](https://developers.cloudflare.com/images/image-resizing/) service. * **`passthrough`:** Uses the existing [`noop`](/en/guides/images/#configure-no-op-passthrough-service) service. +* **`compile`:** Uses Astro's default service (sharp) to optimize images during build. + +```js title="astro.config.mjs" ins={6} +import {defineConfig} from "astro/config"; +import cloudflare from '@astrojs/cloudflare'; + +export default defineConfig({ + adapter: cloudflare({ + imageService: 'cloudflare' + }), + output: 'server' +}) +``` + +:::caution +While the option `compile`, allows you to optimize Images using sharp, during build, it disables any support for image optimization during SSR. You need to make sure that you don't use any Image features in SSR routes (e.g. ``, ``, `getImage()`. +That means all images to be optimized need to be placed on routes which are pre-rendered. +::: ### `wasmModuleImports` From fe997fff5e7939215cbedc743caeadc756fa41d9 Mon Sep 17 00:00:00 2001 From: Alexander Niebuhr Date: Fri, 5 Jan 2024 14:12:23 +0100 Subject: [PATCH 2/3] Update src/content/docs/en/guides/integrations-guide/cloudflare.mdx Co-authored-by: Sarah Rainsberger --- src/content/docs/en/guides/integrations-guide/cloudflare.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/en/guides/integrations-guide/cloudflare.mdx b/src/content/docs/en/guides/integrations-guide/cloudflare.mdx index 48c14619abed8..376b5f20b40bf 100644 --- a/src/content/docs/en/guides/integrations-guide/cloudflare.mdx +++ b/src/content/docs/en/guides/integrations-guide/cloudflare.mdx @@ -207,7 +207,7 @@ Determines which image service is used by the adapter. The adapter will default * **`cloudflare`:** Uses the [Cloudflare Image Resizing](https://developers.cloudflare.com/images/image-resizing/) service. * **`passthrough`:** Uses the existing [`noop`](/en/guides/images/#configure-no-op-passthrough-service) service. -* **`compile`:** Uses Astro's default service (sharp) to optimize images during build. +* **`compile`:** Uses Astro's default service (sharp), but only on pre-rendered routes at build time. During SSR for pages rendered on-demand, all `astro:assets` features are disabled. ```js title="astro.config.mjs" ins={6} import {defineConfig} from "astro/config"; From 0642da7face7a2f9e85f5cfb5234fc71591e8b62 Mon Sep 17 00:00:00 2001 From: Alexander Niebuhr Date: Fri, 5 Jan 2024 14:12:56 +0100 Subject: [PATCH 3/3] Update cloudflare.mdx --- src/content/docs/en/guides/integrations-guide/cloudflare.mdx | 5 ----- 1 file changed, 5 deletions(-) diff --git a/src/content/docs/en/guides/integrations-guide/cloudflare.mdx b/src/content/docs/en/guides/integrations-guide/cloudflare.mdx index 376b5f20b40bf..3a0202e51466a 100644 --- a/src/content/docs/en/guides/integrations-guide/cloudflare.mdx +++ b/src/content/docs/en/guides/integrations-guide/cloudflare.mdx @@ -221,11 +221,6 @@ export default defineConfig({ }) ``` -:::caution -While the option `compile`, allows you to optimize Images using sharp, during build, it disables any support for image optimization during SSR. You need to make sure that you don't use any Image features in SSR routes (e.g. ``, ``, `getImage()`. -That means all images to be optimized need to be placed on routes which are pre-rendered. -::: - ### `wasmModuleImports` `wasmModuleImports: boolean`