Saltearse al contenido

Despliega tu sitio Astro en Azion

Puedes desplegar tu proyecto Astro en Azion, una plataforma para que los desarrolladores frontend colaboren y desplieguen sitios web estáticos (JAMstack) y SSR.

Prerrequisitos

Sección titulada Prerrequisitos

Para comenzar, necesitarás:

  • Una cuenta de Azion. Si no tienes una, puedes registrarte para obtener una cuenta gratuita.
  • El código de tu aplicación almacenado en un repositorio de GitHub.
  • Azion CLI instalado para una configuración y despliegue de proyectos más rápidos.

Cómo desplegar a través del panel de la consola de Azion

Sección titulada Cómo desplegar a través del panel de la consola de Azion

Para comenzar a construir, sigue estos pasos:

  1. Accede a la Consola de Azion.
  2. En la página de inicio, haz clic en el botón + Crear.
    • Esto abre un modal con las opciones para crear nuevas aplicaciones y recursos.
  3. Selecciona la opción Importar desde GitHub y haz clic en la tarjeta.
    • Esta acción abre la página de configuración.
  4. Conecta tu cuenta de Azion con GitHub.
    • Aparecerá una ventana emergente solicitando autorización.
  5. Selecciona el repositorio que deseas importar desde GitHub.
  6. Configura los ajustes de construcción:
    • Preajuste de framework: Selecciona el framework apropiado (por ejemplo, Astro).
    • Directorio raíz: Se refiere al directorio en el que se encuentra tu código. Tu código debe estar ubicado en el directorio raíz, no en un subdirectorio. Aparece un símbolo ./ en este campo, lo que indica que es un directorio raíz.
    • Comando de instalación: el comando que compila tu configuración para construir para producción. Los comandos de construcción se ejecutan a través de scripts. Por ejemplo: npm run build o npm install para un paquete NPM.
  7. Haz clic en Guardar y desplegar.
  8. Monitorea el despliegue usando Métricas en tiempo real de Azion y verifica que tu sitio esté en vivo en el borde.

Cómo desplegar un sitio estático usando Azion CLI

Sección titulada Cómo desplegar un sitio estático usando Azion CLI

  1. Instala Azion CLI:

    • Descarga e instala Azion CLI para una gestión y despliegue más sencillos.

  2. Autentica la CLI:

    • Ejecuta el siguiente comando para autenticar tu CLI con tu cuenta de Azion.
    Ventana de terminal
    azion login

  3. Configura tu aplicación:

    • Usa los siguientes comandos para inicializar y configurar tu proyecto:
    Ventana de terminal
    azion init

  4. Construye tu proyecto Astro:

    • Ejecuta tu comando de construcción localmente:
    Ventana de terminal
    azion build

  5. Despliega tus archivos estáticos:

    • Despliega tus archivos estáticos usando Azion CLI:
    Ventana de terminal
    azion deploy

Esta guía proporciona una visión general del despliegue de aplicaciones estáticas.

Habilitar el desarrollo local usando Azion CLI

Sección titulada Habilitar el desarrollo local usando Azion CLI

Para que la vista previa funcione, debes ejecutar el siguiente comando:

Ventana de terminal
azion dev

Una vez que hayas inicializado el servidor de desarrollo local, la aplicación pasa por el proceso build.

Ventana de terminal
Construyendo tu aplicación Edge. Este proceso puede tardar unos minutos
Ejecutando el comando del paso de construcción:
...

Luego, cuando la construcción esté completa, se solicita el acceso a la aplicación:

Ventana de terminal
[Azion Bundler] [Servidor] › ✔ éxito Función ejecutándose en el puerto http://localhost:3000

Solución de problemas

Sección titulada Solución de problemas

APIs de tiempo de ejecución de Node.js

Sección titulada APIs de tiempo de ejecución de Node.js

Un proyecto que utiliza un paquete NPM falla en la construcción 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 no es compatible con las APIs de tiempo de ejecución de Azion.

Si estás importando directamente una API de tiempo de ejecución de Node.js, consulta la compatibilidad de Azion Node.js para obtener más información sobre cómo resolver esto.

Si estás importando un paquete que importa una API de tiempo de ejecución de Node.js, consulta con el autor del paquete para ver si admite la sintaxis de importación node:*. Si no lo hacen, es posible que necesites encontrar un paquete alternativo.

Más guías de implementación

Contribuir Comunidad Patrocinador