Despliega tu sitio Astro
¿Listo para construir y desplegar tu proyecto Astro? Sigue una de nuestras guías para diferentes servicios de despliegue o desplázate hacia abajo para obtener orientación general sobre el despliegue de un proyecto de Astro.
Guías de despliegue
Sección titulada Guías de despliegueOpciones de despliegue rápido
Sección titulada Opciones de despliegue rápidoPuedes crear y desplegar tu proyecto de Astro en varias plataformas rápidamente utilizando la interfaz de usuario (UI) en su página web o la interfaz de línea de comando (CLI).
Web UI
Sección titulada Web UIUna forma rápida de desplegar tu página web es conectar un repositorio de Git remoto a tu proyecto de Astro (por ejemplo, GitHub, GitLab, Bitbucket) a un servicio de hosting y aprovechar continuous integration con Git.
Estas plataformas de hosting detectan automáticamente los cambios en el repositorio de origen de tu proyecto de Astro, construyen tu proyecto y lo despliegan en una URL personalizada o en tu dominio personal. A menudo, configurar el despliegue en estas plataformas seguirá pasos como los siguientes:
-
Agrega tu repositorio a un repositorio remoto de Git (por ejemplo, en GitHub, GitLab, Bitbucket)
-
Elige un host que admita continuous integration (por ejemplo, Netlify o Vercel) e importa tu repositorio Git como un nuevo sitio/proyecto.
Muchos hosts comunes reconocerán su proyecto como un sitio de Astro y elegirán los ajustes de configuración apropiados para construir y desplegar tu proyecto como se muestra a continuación. (De lo contrario, estos ajustes se pueden cambiar).
- Comando de construcción:
astro build
onpm run build
- Directorio de publicación:
dist
- Comando de construcción:
-
Haz clic en “Desplegar” y tu nuevo sitio web se creará en una URL única para ese host (por ejemplo,
new-astro-site.netlify.app
).
El host se configurará automáticamente para observar la rama principal del repositorio de Git en busca de cambios, para reconstruir y volver a publicar tu proyecto en cada push. Estos ajustes normalmente se pueden configurar en la UI del panel de control de su proveedor de hosting.
Despliegue desde el CLI
Sección titulada Despliegue desde el CLIAlgunos hosts tendrán su propia interfaz de línea de comandos (CLI) que puedes instalar globalmente en tu máquina usando npm. A menudo, el uso de una CLI para desplegar se parece a lo siguiente:
-
Instala la CLI del host globalmente, por ejemplo:
-
Ejecuta la CLI y sigue las instrucciones de autorización, configuración, etc.
-
Crea tu proyecto y despliégalo en el host
Muchos proveedores de hosting construirán y desplegarán tu proyecto por ti. Por lo general, reconocerán tu proyecto como un sitio de Astro y elegirán los ajustes de configuración apropiados para construir y desplegar como se muestra a continuación. (De lo contrario, estos ajustes se pueden cambiar).
- Comando de construcción:
astro build
onpm run build
- Directorio de publicación:
dist
Otros proveedores de hosting requerirán que construyas tu sitio localmente y realizes el despliegue usando la línea de comandos.
- Comando de construcción:
Construyendo tu proyecto localmente
Sección titulada Construyendo tu proyecto localmenteMuchos hosts como Netlify y Vercel construirán tu proyecto por ti y lo publicarán en la web automáticamente. Sin embargo, algunos hosts requerirán que construyas tu proyecto localmente y luego ejecutes el comando de despliegue o subas el resultado de la compilación.
También es posible que desees compilar tu proyecto localmente para obtener una vista previa o para detectar posibles errores y advertencias en el entorno.
Ejecuta el comando npm run build
para construir tu proyecto Astro.
De forma predeterminada, el resultado de compilación se colocará en dist/
. Esta ubicación se puede cambiar usando la opción de configuración outDir
.
Adición de un adaptador para SSR
Sección titulada Adición de un adaptador para SSRAntes de implementar tu proyecto de Astro con SSR (renderizado en el servidor) (EN) habilitado, asegúrate de tener:
- Instalado el adaptador apropiado (EN) en tus dependencias (ya sea manualmente, o usando el comando
astro add
, p. ej.npx astro add netlify
). - Agregado el adaptador a tu import y default export en tu archivo
astro.config.mjs
cuando es instalado manualmente. (¡El comandoastro add
se hará cargo de este paso por ti!)