docs: prepare server Codex deployment handoff for ThothII and Omics
This commit is contained in:
Codex
@@ -239,60 +239,23 @@ CSS esistente con i token light/dark; non mescolarlo con la nuova Theming API di
|
||||
|
||||
### Acquisire prima le modifiche al repository Omics
|
||||
|
||||
Procedura concordata il 13 settembre 2026: **Mac → GitHub → server → Gitea PSD**.
|
||||
Il Mac pubblica il branch Omics `codex/thothii-embedded-shell` su
|
||||
`https://github.com/Dallavilla-Tiziano/omics_portal.git`; l'operatore lo recupera
|
||||
dal server e lo pubblica su `ssh://git@localhost:2222/aritmolab/omics_portal.git`.
|
||||
Il secondo passaggio è un **push** a Gitea, non un pull. Questa scelta evita di
|
||||
richiedere al Mac credenziali Gitea PSD. Non cambia l'origine Gitea TYL di ThothII.
|
||||
Procedura aggiornata il 14 settembre 2026: acquisire il codice Omics da GitHub
|
||||
e integrarlo con il codice operativo del server. Non è richiesta alcuna replica
|
||||
del repository su altri servizi; l'eventuale copia è un'attività distinta del
|
||||
proprietario. Questa indicazione sostituisce le precedenti note di trasporto,
|
||||
anche se ancora presenti nei documenti storici del branch Omics.
|
||||
|
||||
Consegna GitHub verificata il 13 settembre 2026:
|
||||
`fca10901a73666ca257d8f4cc4b77066295c400a`, che include il commit funzionale
|
||||
`95154e1` e la guida per il server. Per questa consegna lo SHA acquisito sul
|
||||
server deve coincidere esattamente. Eventuali consegne successive richiedono un
|
||||
nuovo SHA comunicato e approvato, non l'accettazione implicita della testa del branch.
|
||||
La [consegna corrente a Codex sul server](server-codex-handoff.md) contiene i
|
||||
comandi esatti di acquisizione, gli SHA, i file da adeguare, la configurazione
|
||||
embedded/upstream, i test, i gate di rilascio e il rollback. Usarla come procedura
|
||||
ordinata per l'aggiornamento; le sezioni qui sotto restano il riepilogo tecnico.
|
||||
|
||||
I comandi completi sono nella
|
||||
[guida del repository Omics](https://github.com/Dallavilla-Tiziano/omics_portal/blob/codex/thothii-embedded-shell/docs/thothii-integration.md#consegna-via-github-e-pubblicazione-su-gitea-psd).
|
||||
Sul server, per recuperare il branch e leggere la guida senza cambiare i file
|
||||
del portale in esecuzione:
|
||||
|
||||
```bash
|
||||
cd /home/chirone/omics_portal
|
||||
git status --short --branch
|
||||
git fetch --no-tags https://github.com/Dallavilla-Tiziano/omics_portal.git \
|
||||
refs/heads/codex/thothii-embedded-shell:refs/remotes/github-relay/codex/thothii-embedded-shell
|
||||
git rev-parse refs/remotes/github-relay/codex/thothii-embedded-shell
|
||||
git show refs/remotes/github-relay/codex/thothii-embedded-shell:docs/thothii-integration.md
|
||||
```
|
||||
|
||||
Confrontare lo SHA con la consegna dal Mac prima di procedere con il push
|
||||
documentato nella guida. Non usare `git pull` nel checkout condiviso né
|
||||
`git push origin`: quest'ultimo può avere due destinazioni. Non cambiare
|
||||
`master` o riavviare Omics durante il trasferimento. L'integrazione e il deploy
|
||||
richiedono una successiva approvazione, con revisione/immagini di rollback
|
||||
registrate e rilascio coordinato con ThothII embedded/upstream.
|
||||
|
||||
Dopo il confronto positivo con
|
||||
`fca10901a73666ca257d8f4cc4b77066295c400a`, il trasferimento verso Gitea si
|
||||
completa **sempre dal repository Omics sul server** con:
|
||||
|
||||
```bash
|
||||
cd /home/chirone/omics_portal
|
||||
git ls-remote ssh://git@localhost:2222/aritmolab/omics_portal.git \
|
||||
HEAD refs/heads/codex/thothii-embedded-shell
|
||||
git push ssh://git@localhost:2222/aritmolab/omics_portal.git \
|
||||
refs/remotes/github-relay/codex/thothii-embedded-shell:refs/heads/codex/thothii-embedded-shell
|
||||
git ls-remote ssh://git@localhost:2222/aritmolab/omics_portal.git \
|
||||
refs/heads/codex/thothii-embedded-shell
|
||||
git status --short --branch
|
||||
git rev-parse HEAD
|
||||
```
|
||||
|
||||
Lo SHA Gitea deve coincidere; branch, HEAD e modifiche del checkout devono
|
||||
rimanere quelli registrati prima del fetch. Se diverge o il push viene rifiutato,
|
||||
fermarsi senza force push, reset, modifica di credenziali o merge improvvisato.
|
||||
Questo passaggio non pubblica ThothII, non cambia `master` e non fa deploy.
|
||||
Consegna GitHub riverificata: branch `codex/thothii-embedded-shell` di
|
||||
`https://github.com/Dallavilla-Tiziano/omics_portal.git`, SHA
|
||||
`fca10901a73666ca257d8f4cc4b77066295c400a`, incluso il commit funzionale
|
||||
`95154e179144e2453b37ef2a63a65d6f377e4cf8`. Il pull di ThothII non aggiorna
|
||||
Omics: il checkout del portale, normalmente `/home/chirone/omics_portal`, va
|
||||
verificato e integrato separatamente preservando le modifiche successive del server.
|
||||
|
||||
### Preparare il rilascio coordinato
|
||||
|
||||
@@ -330,8 +293,8 @@ Questo passaggio non pubblica ThothII, non cambia `master` e non fa deploy.
|
||||
immagini e configurazioni registrate, senza cancellare volumi. Il rollback
|
||||
deve conservare una coppia compatibile di template Omics e frontend ThothII.
|
||||
|
||||
La consegna GitHub è verificata; il push Gitea PSD e il deploy del nuovo branch
|
||||
Omics rimangono da confermare dall'operatore. I test locali non attestano lo stato
|
||||
La consegna GitHub è verificata; il deploy della revisione integrata
|
||||
Omics rimane da confermare dall'operatore. I test locali non attestano lo stato
|
||||
attuale del server remoto.
|
||||
|
||||
### Accettazione dell'integrazione
|
||||
|
||||
Reference in New Issue
Block a user