publica un sitio desde tu repo de github
Importa un repositorio, sírvelo en tu propio nombre y vuelve a desplegar en cada push. Sin servidor de build, sin DNS y con HTTPS incluido.
Aquí un subdominio puede hacer más que apuntar a otro sitio: puede servir los ficheros él mismo. Si tu web ya es una carpeta de HTML, CSS e imágenes en un repositorio git, puedes tenerla en marcha bajo tu propio nombre en unos dos minutos y mantenerla al día con el repo a partir de ahí.
qué consigues
Tu repositorio se descarga, se revisa y se publica bajo tunombre.does.software, servido por HTTPS desde nuestros servidores. No hay DNS que configurar ni certificado que renovar, porque el nombre ya es nuestro y el certificado comodín ya lo cubre.
Cada publicación conserva la anterior, así que puedes volver atrás desde el panel cuando un despliegue sale mal. También tienes un editor de ficheros en el panel, para el arreglo de una línea que no te apetece hacer abriendo el portátil.
qué tiene que contener tu repo
Aquí no se construye nada. Servimos lo que hay en el repositorio, tal cual, así que el repo tiene que guardar los ficheros terminados: un index.html en la raíz de la rama que le indiques, más todo lo que cargue.
Si tu proyecto necesita un paso de build, ejecútalo donde ya lo ejecutas y commitea el resultado, o empuja una rama ya construida. Un repositorio que solo contiene fuentes publicará tus fuentes, que no es lo que quieres.
- Comprueba que hay un
index.htmlen el nivel superior de la rama que vas a importar. - Comprueba los tipos de fichero. Solo se publican
html, css, js, mjs, json, txt, pdf, webmanifest, las imágenespng, jpg, jpeg, webp, gif, svg, icoy las fuenteswoff, woff2, ttf; lo demás se descarta. - Comprueba el tamaño. Ningún fichero suelto por encima de 15 MB, y el sitio entero por debajo de 100 MB en los planes gratis y Starter, 300 MB en Pro.
impórtalo
Conecta el proveedor una vez desde tu cuenta y la lista de importación te mostrará tus repositorios, privados incluidos.
- En cuenta, conexiones, conecta GitHub o GitLab. Es la misma conexión con la que puedes iniciar sesión.
- Abre tu subdominio, ve a la sección sitio y elige importar desde un repositorio.
- Elige el repositorio y la rama. Deja la rama vacía para seguir la que sea la principal.
- Publica. El primer despliegue tarda unos segundos; cuando termina, el nombre ya está sirviendo.
desplegar en cada push
Activa desplegar al hacer push y creamos un webhook en el repositorio. A partir de ahí, cada push a la rama que elegiste publica una versión nueva por su cuenta.
Solo cuentan los push a esa rama exacta. Un push a otra rama, una rama borrada o una etiqueta se ignoran, así que puedes seguir trabajando sin publicar media funcionalidad.
Si un despliegue falla, el sitio que ya estaba en marcha sigue en marcha. El fallo y su motivo aparecen en el panel, y no se cambia nada hasta que la versión nueva se ha descargado y revisado entera.
aplicaciones de una sola página y 404
El router de un framework necesita que cada URL devuelva el mismo index.html. Activa el interruptor de aplicación de una sola página y cualquier ruta que no sea un fichero real recibe index.html con un 200, que es lo que espera un router de cliente.
Con el interruptor apagado, una ruta que no existe busca un 404.html en tu propio sitio y lo sirve con un 404 de verdad. Si no incluyes ninguno, al visitante le sale nuestra página de error, que al menos le dice que el nombre existe.
los límites
Servir ficheros y redirigir son excluyentes. Mientras el sitio está encendido, la redirección de la raíz y las reglas por ruta siguen configuradas pero dejan de servir. El reenvío de correo no se toca y sigue funcionando a la vez.
Las versiones que se guardan para volver atrás van con el plan: una en el gratis, tres en Starter, diez en Pro. El número de ficheros se corta en 1000, o 5000 en Pro.
Si tu repositorio ya guarda el sitio construido, esto son dos minutos y el push que ibas a hacer de todos modos se convierte en el despliegue. Si necesita un paso de build, commitea antes el resultado.