Allotjar un lloc web estàtic al teu subdomini

Cada subdomini té dos modes de servei, la redirecció clàssica o un petit lloc estàtic. Canvies el mode des del teu tauler i puges un ZIP, o gestiones els fitxers un a un des de l'explorador integrat. Després paraula.does.software el servirà per HTTPS.

index.html és la porta d'entrada, i si inclous un 404.html el farem servir per a les pàgines que no existeixin. Els desplegaments són atòmics, la versió nova substitueix la vella de cop.

Subdominis › Configura el subdomini › Redirecció / lloc web › Mode de servei: Lloc web

Durant la prova i amb el pla Starter tens 100MB per web i 1000 fitxers. Amb el pla Pro són 300MB i 5000 fitxers. El pla gratis no inclou allotjament web. Un fitxer sol pot pesar fins a 15MB a qualsevol pla. La barra d'ús del gestor de fitxers et diu per on vas.

Només fitxers estàtics, HTML, CSS, JS, imatges, fonts i companyia. Aquí no hi ha codi de servidor, un .php no s'executa, directament no s'accepta.

Subdominis › Configura el subdomini › Redirecció / lloc web › Els teus arxius

Tot el que respecti la política d'ús acceptable dels Termes. Res de phishing, malware, esquers d'spam ni contingut il·legal. Qualsevol visitant pot denunciar un web. Cada denúncia la llegeix una persona, i podem retirar un web infractor sense avís previ.

Sí, tots els subdominis se serveixen per HTTPS automàticament, tant les redireccions com els webs allotjats. No hi ha res a configurar ni certificats a gestionar, ve amb el nom.

Sí. En mode web, enganxa la URL del repositori de github.com o gitlab.com i nosaltres el descarregarem i el publicarem. Si vols una branca concreta, enganxa la URL que ja hi apunti, si no, farem servir la que el repositori tingui per defecte. Els repositoris privats també funcionen un cop connectes GitHub o GitLab a compte › connexions.

Per defecte és una foto, un push nou no canviarà el teu web per si sol. Activa «desplegar automàticament amb cada push» sota el repositori vinculat. Crearem una branca de desplegament (does-software-deploy per defecte, el nom el canvies tu) a partir de la importada i hi afegirem un webhook al repositori, a partir d'aquí cada push a aquesta branca tornarà a publicar el web.

Subdominis › Configura el subdomini › Redirecció / lloc web › Importa des d'un repositori

Sí. El gestor de fitxers del tauler et deixa crear, editar i esborrar fitxers un a un, i cada canvi es publica sol. Entre ZIPs i fitxers solts pots fer 10 pujades per hora.

Subdominis › Configura el subdomini › Redirecció / lloc web › Els teus arxius

Perquè aquestes apps són un sol index.html. Les rutes que veus (/about, /projectes/3) se les inventa el router al navegador, no existeixen com a fitxers al disc. Navegar a base de clics funciona, però prémer F5 a /about, o compartir aquest enllaç, demana al nostre servidor un fitxer que no hi és, i el visitant acaba a la pàgina d'error.

Es resol amb una casella, <b>Aplicació d'una sola pàgina (SPA)</b> al tauler del teu web. L'activem nosaltres quan un desplegament té pinta de ser una d'aquestes apps, així que gairebé mai no hauràs de fer res. A partir d'aquí, qualsevol ruta sense fitxer servirà el teu index.html amb un 200, l'app arrencarà, llegirà la URL i pintarà la vista correcta. Les peticions d'un fitxer real (Qualsevol cosa amb extensió, com /app.js) continuaran retornant un 404 normal, així que un asset que falta se seguirà notant.

Subdominis › Configura el subdomini › Redirecció / lloc web › Aplicació d'una sola pàgina

Primer comprova que el desplegament automàtic està activat sota el repositori vinculat, i que el push va anar a la branca vinculada, perquè un push a qualsevol altra branca s'ignora a propòsit. Si el webhook s'ha esborrat dels ajustos del repositori, apaga i encén l'interruptor i el crearem de nou.

Quan el push sí que ens ha arribat però el desplegament ha fallat, el motiu apareixerà sota el repositori al teu tauler, normalment un ZIP per sobre de la quota del pla o un index.html que falta. Arregla-ho i torna a fer push, o prem reimporta.

Subdominis › Configura el subdomini › Redirecció / lloc web › Importa des d'un repositori

No. Servim els fitxers tal qual i mai executem un build, ni npm install, ni compilador, res teu s'executa als nostres servidors. Importar el repositori amb el codi font deixa un web sense index.html a l'arrel (El de debò és dins de src/), i els visitants cauran a la pàgina d'error. El que necessitem és la sortida del build, la carpeta dist/ que genera el teu framework.

Hi ha dues maneres de portar-la. La ràpida, compila a la teva màquina i puja el ZIP de dist/ (A Angular, dist/<app>/browser). La duradora, activa el desplegament automàtic (Crearem la branca does-software-deploy i un webhook) i deixa que una GitHub Action compili amb cada push a main i publiqui dist/ en aquesta branca. Des d'aleshores cada push a main recompilarà i republicarà sol. El workflow de sota fa exactament això, desa'l com a .github/workflows/does-software.yml i ajusta publish_dir.

name: does.software
on:
  push:
    branches: [main]
permissions:
  contents: write
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 22
      - run: npm ci && npm run build
      - uses: peaceiris/actions-gh-pages@v4
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          publish_dir: ./dist   # Angular: ./dist/<app>/browser
          publish_branch: does-software-deploy

Subdominis › Configura el subdomini › Redirecció / lloc web › Importa des d'un repositori