Skip to content

Commit

Permalink
i18n(es): update deploy/cloudflare & integrations-guide/cloudflare (
Browse files Browse the repository at this point in the history
withastro#7778)

* i18n(es): update `deploy/cloudflare` & `integrations-guide/cloudflare`

* Apply suggestions from code review

Co-authored-by: Waxer59 <[email protected]>

* Update src/content/docs/es/guides/integrations-guide/cloudflare.mdx

Co-authored-by: Waxer59 <[email protected]>

* Apply last suggestion

* update: `/integrations-guide/cloudflare` with withastro#7813

---------

Co-authored-by: Waxer59 <[email protected]>
  • Loading branch information
dreyfus92 and Waxer59 authored Apr 16, 2024
1 parent e5f6b03 commit 945f77c
Show file tree
Hide file tree
Showing 2 changed files with 162 additions and 348 deletions.
31 changes: 5 additions & 26 deletions src/content/docs/es/guides/deploy/cloudflare.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -107,41 +107,20 @@ Si prefieres instalar el adaptador manualmente, sigue los siguientes pasos:
});
```
### Modos
Actualmente existen dos modos soportados cuando utilizas Pages Functions con el adaptador [`@astrojs/cloudflare`](https://github.com/withastro/astro/tree/main/packages/integrations/cloudflare#readme).
1. Modo **Advanced**: Este modo es usado cuando deseas ejecutar tu función en modo `advanced` el cual toma el archivo `_worker.js` en `dist`, o un modo directorio donde las páginas compilarán el worker fuera de un directorio de funciones en la raíz de tu proyecto.
Si no hay modo establecido, por defecto será `"advanced"`.
2. Modo **directory**: Este modo es usado cuando deseas ejecutar tu función en modo `directory`, lo que significa que el adaptador compilará la parte del cliente de tu app del mismo modo, pero moverá el script de worker dentro de un directorio `functions` en la raíz de tu proyecto. El adaptador solo colocará un `[[path]].js` en ese directorio, permitiéndote añadir plugins adicionales y middleware que se puede verificar en el control de versiones.
```ts title="astro.config.mjs" "directory"
export default defineConfig({
adapter: cloudflare({ mode: "directory" }),
});
```
### Usando Pages Functions
[Pages Functions](https://developers.cloudflare.com/pages/platform/functions/) te permiten ejecutar código en el servidor para habilitar funcionalidades dinámicas sin ejecutar un servidor dedicado.
Para comenzar, crea un directorio `/functions` en la raíz de tu proyecto. Al escribir tus archivos de funciones en este directorio generará de forma automática un Worker con funcionalidad personalizada en las rutas previamente designadas. Para aprender más sobre las funciones, consulta la [documentación de Pages Functions](https://developers.cloudflare.com/pages/platform/functions/).
<ReadMore>Aprende más sobre [SSR en Astro](/es/guides/server-side-rendering/).</ReadMore>
## Solución de problemas
Si encuentras errores, vuelve a verificar que la versión de `node` que estás usando localmente (`node -v`) coincida con la versión que estás especificando en la variable de entorno.
Cloudflare requiere [Node v16.13](https://miniflare.dev/get-started/cli#installation), la cual es una versión más reciente que el mínimo por defecto de Astro, así que verifica que estés usando al menos v16.13.
### Hidratación del lado del cliente
La hidratación del lado del cliente puede fallar como resultado de la configuración de Auto Minify de Cloudflare. Si ves `Hydration completed but contains mismatches` en la consola, asegúrate de deshabilitar Auto Minify en la configuración de Cloudflare.
### APIs de tiempo de ejecución de Node.js
Si estás construyendo un proyecto que está usando renderizado bajo demanda con [el Adaptador de SSR de Cloudflare](/es/guides/integrations-guide/cloudflare/) y el servidor falla en construir con un mensaje de error como `[Error] Could not resolve "XXXX. The package "XXXX" wasn't found on the file system but is built into node.`:
- Esto significa que un paquete o importación que estás utilizando en el entorno del lado del servidor no es compatible con las [APIs de tiempo de ejecución de los Cloudflare Workers](https://developers.cloudflare.com/workers/runtime-apis/nodejs/).
- Esto significa que un paquete o importación que estás utilizando en el entorno del lado del servidor no es compatible con las [APIs de tiempo de ejecución de Cloudflare](https://developers.cloudflare.com/workers/runtime-apis/nodejs/).
- Si estás importando directamente una API de tiempo de ejecución de Node.js, por favor consulta la documentación de Astro en [compatibilidad con Node.js](/es/guides/integrations-guide/cloudflare/#compatibilidad-con-nodejs) de Cloudflare para conocer los pasos adicionales sobre como resolver esto.
- Si estás importando un paquete que importa una API de tiempo de ejecución de Node.js, verifica con el autor del paquete si admiten la sintaxis de importación `node:*`. Si no lo hacen, es posible que necesites encontrar un paquete alternativo o utilizar un adaptador diferente.
- Si estás importando un paquete que importa una API de tiempo de ejecución de Node.js, verifica con el autor del paquete si admiten la sintaxis de importación `node:*`. Si no lo hacen, es posible que necesites encontrar un paquete alternativo.
Loading

0 comments on commit 945f77c

Please sign in to comment.