Introducció
L’eXO disposa de https://farga.eXO.cat (la farga) per emmagatzemar els repositoris de codi basat en https://forgejo.org
La farga també està actuant com a proveïdor de SSO (Single SIgn On, que un compte d’usuari sigui prou per tothom) per tots els serveis nous de l’eXO.
A més a més, també disposem d’un sistema d’Integració Contínua (CI, per les sigles en anglès Continuous Integration), basat amb https://woodpecker-ci.org
La Integració Contínua
Aquesta la trobem a https://enclusa.eXO.cat, es pot activar a qualsevol repositori del que tinguem permisos d’administració.
L’inici de sessió és igual que amb https://farga.eXO.cat
Interfície https://enclusa.eXO.cat
Un cop tenim configurat un repositori fa aquesta pinta
On podem veure els detalls de cada tasca:
Si hi hagués errors, els veuríem en vermell.
Interfície des de https://farga.eXO.cat
Quan consultem el repositori, veurem un o al costat dels commits:
Si hi fem click, podrem veure els detalls:
Donant d’alta un repositori
Ho fem des de https://enclusa.eXO.cat, cal que tinguem permisos d’administració al repositori.
Cal fer click en +Add repository
:
I triar el repositori en qüestió fent click en Enable
:
A partir d’aquí, cal configurar les pipelines d’acord amb la documentació de Woodpecker CI
En particular, el més senzill és crear un fitxer a l’arrel del repositori .woodpecker.yml
que documenti la feina a fer i compleixi la sintaxi de pipeline.
A partir d’aquest moment, amb cada canvi s’executen les nostres tasques!
A la configuració del repo a https://enclusa.eXO.cat podem configurar secrets i altres coses més avançades, per si volem automatitzar certes tasques de Desplegament Continu (CD / Continuous Deployment en anglès).
Agents / Workers
Actualment hi ha un únic Agent disponible que fa servir Docker, si voleu donar recursos de computació i afegir algun Agent, poseu-vos en contacte :-).
Polítiques d’ús
Actualment no estem aplicant limitacions, però els comptes d’usuari a https://farga.eXO.cat només es poden crear amb aprovació d’administradors (@exopedro i @evilham actualment).
Tingueu en compte que els recursos disponibles són de l’Associació per a l’expansió de la Xarxa Oberta (eXO) i com a tal, si hi teniu accés, feu-ne un ús raonable.
Si detectem ús anòmal això ens pot portar a posar limitacions, parlem-ne abans si teniu previsions d’alta càrrega.