Note

Les captures d’aquesta pàgina mostren el tauler en castellà, perquè es fan una sola vegada, sobre la interfície en castellà. El teu tauler ensenya les mateixes pantalles amb els noms en català que fa servir aquest text: els botons són al mateix lloc.

Projectes: publicar des del teu repositori

Què aconsegueixes: connectes un repositori de git i, a cada push, el teu web es construeix i es publica sol. Amb HTTPS, sense tocar res i sense pujar fitxers per FTP.

És el que vols si el teu web el genera un framework —Astro, Vite, Next exportat, Hugo, Jekyll…— i treballes amb git. Si el que tens és WordPress o PHP, el que necessites és Donar d’alta un web, no això.

Crear el primer projecte

Al menú, Projectes. La primera vegada només veuràs Connectar un repositori.

A Nou projecte tries d’on surt el codi:

• Des del teu proveïdor de git — connectes GitHub, GitLab o Bitbucket i tries el repositori. Cada push a la branca de producció publica una versió nova.

• O comença amb una plantilla — la copiem al teu compte de git, no al nostre, i la despleguem. El repositori és teu des del primer minut. Per això cal connectar el proveïdor abans.

Després tries domini, i ho pots deixar per a més endavant: el subdomini gratuït funciona des del primer desplegament.

El primer desplegament

Tan bon punt connectes, comença a construir. A la pantalla del projecte veus els desplegaments i, clicant-ne un, el seu registre en viu.

Si falla, el registre es retalla conservant el final, que és on hi ha l’error, i cada error conegut porta un enllaç de Més sobre aquest error.

Note

No cal que encertis la configuració. Mirem què hi ha al repositori i detectem el framework sols. Ho pots forçar després a Ajustos.

El teu domini

A la pestanya Dominis de cada projecte:

• El subdomini gratuït hi és sempre i no caduca.

• Afegir un domini: compra’l allà mateix i queda enganxat sol, o apunta el que ja tinguis.

Veuràs l’estat en què va: Verificant DNS, Emetent certificat, Actiu. No cal fer res entre l’un i l’altre: és esperar.

Un projecte ja publicat, amb el seu repositori, el commit i quant va trigar.

Canviar com es construeix

A Ajustos:

Ajust	Per a què
Framework	Deixa’l en Detectar sol (recomanat) tret que s’equivoqui.
Branca de producció	Quina branca publica. Les altres no publiquen res.
Ordre d’instal·lació	Normalment npm ci. Només si el teu és un altre.
Ordre de construcció	El que genera el web. Normalment npm run build.
Directori de sortida	On deixa els fitxers. dist en gairebé tots.
Subcarpeta del repositori	Si el projecte no és a l’arrel (un monorepo).

Tornar enrere

Cada desplegament queda desat i es pot promocionar a producció. Quan ho fas, la pantalla avisa: Producció està fixada en un desplegament anterior.

Warning

Mentre estigui fixada, un push nou no publica. És a propòsit: si no, el següent commit desfà la teva tornada enrere sense avisar, amb el lloc caigut. Per tornar a la normalitat, promociona l’últim desplegament.

Variables d’entorn

Les que necessiti el teu build. Es desen xifrades i no es mostren un cop desades: es poden substituir, no llegir.

Problemes freqüents

He fet push i no ha passat res

Mira la branca: només publica la de producció. I comprova que la connexió amb el teu proveïdor de git continua autoritzada.

Construeix bé però el web surt en blanc

Gairebé sempre és el Directori de sortida. Mira on deixa els fitxers el teu framework i posa-ho a Ajustos.

Vull el domini que ja tinc

Afegeix-lo a Dominis i apunta el DNS on et digui. Si el DNS el portes tu, El DNS del teu domini explica els registres.