Despliega tu sitio de Astro
¿Listo para compilar y desplegar tu sitio de Astro? Sigue una de nuestras guías sobre los diferentes servicios de despliegue o desplázate hacia abajo para obtener orientación general sobre el despliegue de un sitio de Astro.
Guías de implementación
Sección titulada “Guías de implementación”Opciones de despliegue rápido
Sección titulada “Opciones de despliegue rápido”Puedes compilar y desplegar un sitio de Astro en varios servidores rápidamente utilizando tanto la interfaz del panel de control de su sitio web como una CLI.
Interfaz de usuario del sitio web
Sección titulada “Interfaz de usuario del sitio web”Una forma rápida de desplegar tu sitio web es conectar el repositorio Git en línea de tu proyecto de Astro (por ejemplo, GitHub, GitLab, Bitbucket) a un proveedor de hosting y aprovechar el despliegue continuo mediante Git.
Estas plataformas de hosting detectan automáticamente los pushes al repositorio fuente de tu proyecto de Astro, compilan tu sitio y lo despliegan en la web en una URL personalizada o en tu dominio personal. A menudo, la configuración de un despliegue en estas plataformas seguirá pasos similares a los siguientes:
-
Agrega tu repositorio a un proveedor de Git en línea (por ejemplo, en GitHub, GitLab, Bitbucket)
-
Elige un proveedor de hosting que admita despliegue continuo (por ejemplo, Netlify o Vercel) e importa tu repositorio de Git como un nuevo sitio/proyecto.
Muchos proveedores comunes reconocerán tu proyecto como un sitio de Astro, y deberían elegir los ajustes de configuración adecuados para compilar y desplegar tu sitio como se muestra a continuación. (Si no es así, estos ajustes se pueden cambiar).
- Comando de compilación (Build Command):
astro buildonpm run build - Publish directory:
dist
- Comando de compilación (Build Command):
-
Haz clic en “Deploy” (Desplegar) y tu nuevo sitio web se creará en una URL única para ese proveedor de hosting (por ejemplo,
new-astro-site.netlify.app).
El host se configurará automáticamente para vigilar la rama principal de tu proveedor de Git en busca de cambios, y para volver a compilar y volver a publicar tu sitio en cada nuevo commit. Estos ajustes se pueden configurar normalmente en la interfaz del panel de control de tu proveedor de hosting.
Despliegue con la CLI
Sección titulada “Despliegue con la CLI”Algunos proveedores de hosting tendrán su propia interfaz de línea de comandos (CLI) que puedes instalar globalmente en tu máquina usando npm. A menudo, usar una CLI para realizar el despliegue se parece a lo siguiente:
-
Instala la CLI de tu proveedor de hosting globalmente, por ejemplo:
Ventana de la terminal npm install --global netlify-cliVentana de la terminal pnpm add --global netlify-cliVentana de la terminal yarn global add netlify-cli -
Ejecuta la CLI y sigue las instrucciones para la autorización, configuración, etc.
-
Compila tu sitio y despliégalo en tu proveedor de hosting
Muchos proveedores comunes compilará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 compilar y desplegar como se muestra a continuación. (Si no es así, estos ajustes se pueden cambiar).
- Comando de compilación (Build Command):
astro buildonpm run build - Publish directory:
dist
Otros proveedores de hosting requerirán que compiles tu sitio localmente y lo despliegues usando la línea de comandos.
- Comando de compilación (Build Command):
Compilación de tu sitio localmente
Sección titulada “Compilación de tu sitio localmente”Muchos proveedores de hosting como Netlify y Vercel compilarán tu sitio por ti y luego publicarán esa salida de compilación en la web. Sin embargo, algunos sitios requerirán que compiles localmente y luego ejecutes un comando de despliegue o subas tu salida de compilación.
Es posible que también desees compilar localmente para obtener una vista previa de tu sitio o para capturar cualquier posible error y advertencia en tu propio entorno.
Ejecuta el comando npm run build para compilar tu sitio de Astro.
npm run buildpnpm run buildyarn run buildPor defecto, la salida de la compilación se colocará en dist/. Esta ubicación se puede cambiar mediante la opción de configuración outDir.
Agregar un adaptador para el renderizado bajo demanda
Sección titulada “Agregar 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 usando el comando
astro adddel adaptador, por ejemplo,npx astro add netlify). - Agregado el adaptador a la importación y exportación predeterminada de tu archivo
astro.config.mjscuando realizas la instalación manualmente. (¡El comandoastro addse encargará de este paso por ti!).