Este es un ejemplo de cómo configurar un sitio estático con Docusaurus en los servicios de Alojamiento de Aplicaciones o Sitios Estáticos de Kinsta desde un repositorio de GitHub.

Docusaurus es un generador de sitios estáticos especializado en la producción de sitios web de documentación que son fáciles de construir con un mínimo de experiencia de programación necesaria para que puedas utilizarlo desde el principio. Más información en el sitio web de Docusaurus.

Durante el proceso de despliegue, Kinsta instala automáticamente las dependencias definidas en su archivo package.json.

Alojamiento de Sitios Estáticos

  1. Inicia sesión en GitHub y crea un nuevo repositorio a partir de esta plantilla (Usar esta plantilla > Crear un nuevo repositorio): Kinsta – Hello World – Docusaurus
  2. En MyKinsta, añade un sitio estático con el repositorio Hello World Docusaurus y la siguiente Configuración de construcción:
    • Comando de construcción: npm run build
    • Versión de Node: 18.16.0
    • Directorio de publicación: build
  3. El sitio estará disponible en cuanto finalice la construcción, y la página por defecto de Docusaurus se cargará en la URL de tu sitio.

Alojamiento de la Aplicación

  1. Inicia sesión en GitHub y crea un nuevo repositorio a partir de esta plantilla (Usa esta plantilla > Crea un nuevo repositorio): Kinsta – Hola Mundo – Docusaurus
  2. En MyKinsta, añade una aplicación con el repositorio Hola Mundo Docusaurus. El Comando de inicio puede dejarse en blanco para el proceso web, ya que Kinsta detecta automáticamente el comando necesario durante el primer despliegue.
  3. La aplicación estará disponible tan pronto como finalice la construcción, y la página por defecto de Docusaurus se cargará en la URL de tu aplicación.

Configuración del Servidor Web

Puerto

Kinsta establece automáticamente la variable de entorno PORT. No necesitas definirla ni codificarla en la aplicación. El paquete serve utiliza el puerto establecido por Kinsta automáticamente.

Comando de Inicio

Cuando despliegas la aplicación, Kinsta crea automáticamente un proceso web con npm start como comando de inicio.

Ciclo de Vida del Despliegue

Cada vez que se inicia un despliegue (a través de la creación de una aplicación o de un nuevo despliegue debido a un commit entrante), se ejecuta el comando npm build, seguido del comando npm start.

Página Predeterminada de Docusaurus

La aplicación o el sitio están disponibles en cuanto finaliza la construcción y se carga una página predeterminada de Docusaurus en la URL de tu aplicación o en la URL de tu sitio estático.

Docusaurus default page after successful deployment.
Página por defecto de Docusaurus después de un despliegue exitoso.