Despliega tu sitio Astro
¿Listo para construir y desplegar tu sitio Astro? Sigue una de nuestras guías para diferentes servicios de despliegue o desplázate hacia abajo para obtener orientación general sobre cómo desplegar un sitio Astro.
Guías de despliegue
Sección titulada «Guías de despliegue»Opciones de despliegue rápido
Sección titulada «Opciones de despliegue rápido»Puedes construir y desplegar un sitio de Astro rápidamente en varios proveedores de alojamiento usando la interfaz de su panel de control o una CLI.
Interfaz web
Sección titulada «Interfaz web»Una forma rápida de desplegar tu sitio web es conectar el repositorio Git en línea de tu proyecto de Astro (p. ej. GitHub, GitLab, Bitbucket) a un proveedor de alojamiento y aprovechar el despliegue continuo mediante Git.
Estas plataformas de alojamiento detectan automáticamente los cambios subidos al repositorio de origen de tu proyecto de Astro, construyen tu sitio y lo despliegan en la web en una URL personalizada o en tu dominio personal. Por lo general, la configuración de un despliegue en estas plataformas seguirá una serie de pasos similares a los siguientes:
-
Añade tu repositorio a un proveedor de Git en línea (p. ej. en GitHub, GitLab, Bitbucket)
-
Elige un proveedor de alojamiento que soporte despliegue continuo (p. ej. Netlify (EN) o Vercel (EN)) e importa tu repositorio Git como un nuevo sitio o proyecto.
Muchos proveedores de alojamiento comunes reconocerán tu proyecto como un sitio de Astro y deberían elegir la configuración adecuada para construir y desplegar tu sitio, como se muestra a continuación. (De no ser así, esta configuración se puede cambiar.)
- Comando de construcción:
astro buildonpm run build - Directorio de publicación:
dist
- Comando de construcción:
-
Haz clic en “Deploy” y tu nuevo sitio web se creará en una URL única para ese proveedor (p. ej.
new-astro-site.netlify.app).
El host se configurará automáticamente para monitorear la rama principal de tu proveedor de Git en busca de cambios, y para reconstruir y republicar tu sitio con cada nuevo commit. Por lo general, estos ajustes se pueden configurar en la interfaz del panel de control de tu proveedor de alojamiento.
Despliegue mediante CLI
Sección titulada «Despliegue mediante CLI»Algunos hosts tendrán su propia interfaz de línea de comandos (CLI) que puedes instalar de forma global en tu máquina usando npm. A menudo, el uso de una CLI para realizar el despliegue es similar a lo siguiente:
-
Instala globalmente la CLI de tu host, por ejemplo:
Ventana de terminal npm install --global netlify-cliVentana de terminal pnpm add --global netlify-cliVentana de terminal yarn global add netlify-cli -
Ejecuta la CLI y sigue las instrucciones para la autorización, configuración, etc.
-
Construye tu sitio y despliégalo en tu host
Muchos hosts comunes construirán y desplegarán tu sitio por ti. Por lo general, reconocerán tu proyecto como un sitio de Astro, y deberían elegir los ajustes de configuración adecuados para construir y desplegar como se muestra a continuación. (Si no es así, estos ajustes se pueden cambiar).
- Comando de construcción:
astro buildonpm run build - Directorio de publicación:
dist
Otros hosts requerirán que construyas tu sitio localmente y lo despliegues usando la línea de comandos.
- Comando de construcción:
Construir tu sitio de forma local
Sección titulada «Construir tu sitio de forma local»Muchos proveedores de alojamiento como Netlify y Vercel construirán tu sitio por ti y luego publicarán esos archivos generados en la web. Sin embargo, algunos sitios requerirán que lo construyas localmente y luego ejecutes un comando de despliegue o subas los archivos generados.
También es posible que desees construirlo localmente para obtener una vista previa de tu sitio, o para detectar posibles errores y advertencias en tu propio entorno.
Ejecuta el comando npm run build para construir tu sitio de Astro.
npm run buildpnpm run buildyarn run buildPor defecto, los archivos generados se colocarán en dist/. Esta ubicación se puede cambiar usando la opción de configuración outDir (EN).
Añadir un adaptador para el renderizado bajo demanda
Sección titulada «Añadir un adaptador para el renderizado bajo demanda»Antes de desplegar tu sitio de Astro con el renderizado bajo demanda habilitado, asegúrate de haber:
- Instalado el adaptador adecuado en las dependencias de tu proyecto (ya sea manualmente o utilizando el comando
astro adddel adaptador, p. ej.npx astro add netlify). - Añadido el adaptador (EN) a la importación y exportación por defecto de tu archivo
astro.config.mjscuando lo instalas manualmente. (¡El comandoastro addse encargará de este paso por ti!)