https://github.com/redturtle/iocomune-backend
Repository with updated version for an AGID site with Plone 6.0+ and Volto
https://github.com/redturtle/iocomune-backend
hacktoberfest italia plone
Last synced: 5 months ago
JSON representation
Repository with updated version for an AGID site with Plone 6.0+ and Volto
- Host: GitHub
- URL: https://github.com/redturtle/iocomune-backend
- Owner: RedTurtle
- Created: 2023-01-27T08:21:39.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-04-30T14:36:28.000Z (5 months ago)
- Last Synced: 2025-05-06T23:18:50.225Z (5 months ago)
- Topics: hacktoberfest, italia, plone
- Language: Python
- Homepage:
- Size: 539 KB
- Stars: 2
- Watchers: 10
- Forks: 0
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# Design Plone Versions
Repository con le versioni aggiornate delle dipendenze che servono per un sito agid con le nuove specifiche per il pnrr creato con backend Plone 6.0+ e https://github.com/italia/design-comuni-plone-theme (Frontend Volto/ReactJS).
## Come utilizzare questo file
## Staging e sviluppo
Il file **versions.cfg** che si trova nel branch __main__ è da utilizzare in sviluppo o per i siti di staging, in quanto potrebbe avere delle versioni che non sono ancora pronte per finire in produzione.
```
[buildout]
extends =
...
https://raw.githubusercontent.com/RedTurtle/iocomune-backend/main/versions.cfg
```
E' possibile eventualmente anche usare il buildout.cfg presente in questo repository
```bash
python3.11 -m venv .
bin/pip install -r requirements.txt
bin/buildout
```
O il docker compose::
```bash
docker compose build
docker compose up
```
## Produzione
Nei buildout di produzione, va messo il file **versions.cfg** preso da un tag.
In questo modo si ha sempre una lista di versioni consistenti e immutabili.
```
[buildout]
extends =
...
https://raw.githubusercontent.com/RedTurtle/iocomune-backend/*tag*/versions.cfg
```
# Docker images
Dal branch __main__ e dai tag vengono create automaticamente immagini Docker linux/amd64 e linux/arm64 rilasciate sul repository gihub
https://github.com/RedTurtle/iocomune-backend/pkgs/container/iocomune-backend
## Immagini di sviluppo
E' possibile generare delle immagini per demo con pacchetti in sviluppo non ancora rilasciati.
Per fare questo, basta creare un branch e modificare il file mx.ini (file di configurazione per [mxdev](https://pypi.org/project/mxdev)).
Nel file si possono impostare versioni custom e anche attivare pacchetti in sviluppo.
Non viene generata in automatico l'immagine (per evitare build inutili).
Per far partire una nuova build, basta far partire l'azione manualmente: https://github.com/RedTurtle/iocomune-backend/actions
Verrà creata un'immagine chiamata `nome_del_branch_development` (dove nome_del_branch è il nome del branch ovviamente) su https://ghcr.io/redturtle/iocomune-backend
# Quando fare un nuovo tag
Quando si devono fare degli aggiornamenti in produzione, e tutto è pronto e testato, allora si può fare un nuovo tag per fissarle.
Creando anche una release, è possibile andare a descrivere le modifiche che ci sono in quel determinato tag.
Esempio di comando per il tag:
```shell
git tag -a 20211126-01 -m "versioni congelate al 2021-11-26"
```
Con il tag viene triggerata una pipeline all'interno di questo repo gitlab: https://gitlab.com/redturtle/io-comune/dist.backend.iocittadino, che aggiorna gli altri siti di test