Il codice sorgente "stampa" al rilascio

4

Esiste una best practice su come documentare il codice sorgente che stai pubblicando?

Al momento disponiamo di una tabella delle versioni del software, di quale tag SVN è etichettato, di quale SVN rev è stato creato e dell'URL SVN.

Quindi, il nostro dipartimento CM (Configuration Management) ci chiede di includere un elenco di file di tutti i file sorgente che includiamo per il file .zip che forniamo loro, che è solo uno zip del tag che stiamo pubblicando.

Ho più voglia di idee per aggiornare il nostro modello di stampa, si spera che con buoni argomenti rimuova la lista dei file.

    
posta pksublime 07.08.2013 - 14:39
fonte

4 risposte

9

Configuration Management (CM) la gente non pensa come programmatori. Pensano più come auditor. Il motivo per cui vogliono un elenco dei file è perché vogliono verificare che li abbiano tutti. Sì, questo sembra stupido per un programmatore, ma sembra naturale per qualcuno che non si fida di una singola fonte di informazioni. Idealmente, il tuo elenco di file non sarebbe semplicemente un svn status -v o un ls -lR , ma un elenco mediato dall'uomo dei file specifici necessari per costruire il tuo sistema e che intendi fornire. Pertanto, ad esempio, non devi elencare o fornire i file di origine generati da un generatore di codice che viene eseguito durante il processo di generazione, anche se si trovano nello spazio di lavoro al momento della creazione del file ZIP.

    
risposta data 08.08.2013 - 00:21
fonte
1

Non sono sicuro di cosa stai chiedendo esattamente. Se hai bisogno di un file zip di un certo rilascio / tag, ecco cosa offre git :

git archive --output myzip.tar.gz mytag

Forse c'è un concetto simile anche per 'svn'.

    
risposta data 07.08.2013 - 15:25
fonte
0

La parte che aggiungo è un hash. Questa è una stringa molto più breve, eppure dipende da ogni carattere nel sorgente compilato.

    
risposta data 08.08.2013 - 14:31
fonte
0

Molto dipende dalla tua definizione di "rilascio".

Nel complesso militare-industriale, una versione è descritta da un documento di descrizione della versione. Contiene, tra le altre cose, un elenco completo di tutti i file che entrano nel rilascio, con il numero esatto della versione per ogni file (da qualunque sistema CM), un elenco completo di tutti gli strumenti necessari per ricreare il rilascio dai media di distribuzione, e le procedure per (a) ricreare il software rilasciato utilizzando esattamente quegli strumenti e il supporto di distribuzione e (b) caricando il rilascio ricreato sull'hardware. Idealmente, quelle procedure dovrebbero essere "manuali di Heathkit": procedure dettagliate, che sono state attentamente testate da persone che normalmente NON fanno quelle cose, ma ho visto un sacco di lavoro sciatto in questo dipartimento (e almeno una volta mi è stato detto di sedermi e stare zitto quando ho indicato una procedura VDD che era scorretta).

Sono sicuro di aver trascurato qualcosa. Google "Descrizione della versione documento" per ulteriori informazioni.

    
risposta data 08.08.2013 - 16:35
fonte

Leggi altre domande sui tag