Versioni e attivazione

TCAF installa ogni release nella propria directory di versione e mantiene una versione attiva esplicita. In questo modo il developer può provare o conservare più runtime senza copiare i file del framework nei repository dei progetti.

La gestione delle versioni è separata dall’adozione dei progetti e dall’esecuzione dei task. Cambiare il runtime attivo non riscrive automaticamente i documenti di progetto e non migra un target.

Mostra la versione attiva del framework

Esegui:

tcaf version

L’output testuale contiene soltanto la versione del runtime attivo.

Per un output leggibile da altri strumenti:

tcaf version --format json

Elenca le versioni installate

Esegui:

tcaf versions

Il comando riporta la versione attiva ed elenca ogni directory di versione trovata nella home di installazione. La versione attiva è contrassegnata con *.

Esempio:

Active: 0.3.3
  0.3.2
* 0.3.3

Per l’output JSON:

tcaf versions --format json

Il risultato distingue:

• se il comando viene eseguito tramite un launcher installato;
• versione attiva;
• tutte le versioni installate rilevate.

Installa un’altra versione

Esegui lo script install.py appartenente alla release che vuoi aggiungere:

python install.py

L’installer valida la release e la copia sotto:

<runtime-home>/versions/<versione>

L’installazione di una nuova versione la registra anche come versione attiva.

Poiché ogni release contiene registri, manifest, adapter e runtime propri, l’attivazione cambia l’intera versione del framework invece di sostituire selettivamente singoli moduli.

Attiva una versione installata

Esegui:

tcaf activate <versione>

Prima dell’attivazione, TCAF verifica che:

• la directory della versione installata esista;
• contenga un file VERSION;
• la validazione del framework riesca per quella versione.

Se la validazione fallisce, la versione non viene attivata.

Un comando riuscito riporta:

Activated TCAF <versione>

Poi verifica il runtime attivo:

tcaf doctor
tcaf version

Reinstalla la stessa versione

Per impostazione predefinita l’installer rifiuta di sovrascrivere una versione esistente.

Per una reinstallazione intenzionale:

python install.py --replace

--replace sostituisce soltanto la directory della stessa versione e conserva temporaneamente la directory precedente durante il completamento della copia. Non deve essere usato come comando generico di recupero prima di aver diagnosticato il problema.

Sequenza consigliata:

tcaf doctor
tcaf versions
python install.py --replace
tcaf doctor

Preferenza dell’adapter e attivazione della versione

La home di installazione conserva insieme versione attiva e preferenza dell’adapter. L’attivazione di un’altra versione modifica la versione preservando le altre impostazioni attive dell’installazione.

Esegui sempre tcaf doctor dopo l’attivazione, perché disponibilità degli adapter e comportamento dei registri appartengono alla release selezionata.

Compatibilità dei progetti

I documenti di progetto TCAF riportano la versione del framework rispetto alla quale sono stati preparati, ma evidenze di progetto e installazione del runtime restano separate.

Quando cambi versione del runtime:

• non riscrivere silenziosamente i documenti canonici del progetto;
• leggi note di rilascio o differenze del repository relative a schemi e procedure modificati;
• esegui tcaf validate --target <percorso-progetto>;
• riconcilia la documentazione di progetto soltanto quando la nuova versione richiede un cambiamento reale;
• mantieni autorevoli le modifiche del developer e lo stato corrente del repository.

Un runtime più recente non rende automaticamente non valide le evidenze precedenti e un timestamp recente non dimostra la compatibilità.

Cautela pre-1.0

TCAF 0.3.3 è una versione pre-1.0. Finché non viene pubblicata una politica di compatibilità stabile, tratta i cambi di versione come modifiche ingegneristiche esplicite, non come aggiornamenti trasparenti di un pacchetto.

Preferisci:

1. installare la nuova versione accanto a quella corrente;
2. validare il nuovo runtime;
3. provarlo su un target o workflow delimitato;
4. attivarlo deliberatamente;
5. conservare la precedente versione validata finché la transizione non viene accettata.

Home di installazione personalizzate

Se TCAF è stato installato con un valore personalizzato di --home, i comandi di versione operano tramite il launcher creato per quell’installazione.

Non modificare manualmente active.json a meno che tu non stia riparando l’installazione conoscendone completamente la struttura attesa. Usa tcaf activate affinché la validazione avvenga prima del cambio di versione attiva.