Saltearse al contenido
Astro Astro

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 implementación

Filtrar por tipo de implementación

Opciones de despliegue rápido

Sección titulada Opciones de despliegue rápido

Puedes 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 UI

Una 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:

  1. Agrega tu repositorio a un repositorio remoto de Git (por ejemplo, en GitHub, GitLab, Bitbucket)

  2. 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).

  3. 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 CLI

Algunos 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:

  1. Instala la CLI del host globalmente, por ejemplo:

    Terminal window
    npm install --global netlify-cli

  2. Ejecuta la CLI y sigue las instrucciones de autorización, configuración, etc.

  3. 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).

    Otros proveedores de hosting requerirán que construyas tu sitio localmente y realizes el despliegue usando la línea de comandos.

Construyendo tu proyecto localmente

Sección titulada Construyendo tu proyecto localmente

Muchos 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.

Terminal window
npm run build

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 SSR