Changes between Version 11 and Version 12 of Documentatie/Ontwikkelaar/Procedures/Release


Ignore:
Timestamp:
10/29/12 13:58:39 (13 years ago)
Author:
adriaan
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • Documentatie/Ontwikkelaar/Procedures/Release

    v11 v12  
    1414 * week na releasedatum: test bij 2 pilot-AC's, changes overnemen, bericht productieversie live 
    1515 
    16 == Testen en maken van een OpenAC release == 
     16== Stappenplan == 
    1717 
    1818Je zit in een werkkopie van de tak 'development'. Doe nu de volgende stappen:  
    … …  
    4242   svn commit 
    4343   }}} 
    44    * Werk '''VERSIES.txt''' bij door de releasedatum aan de laatste versie toe te voegen en de omschrijving af te maken. Daardoor verschijnt het in de beschikbare versies lijst van de ACs. 
    4544   * Draai {{{bin/clean}}} en commit eventuele bestanden die nog geen eol-style LF hadden. 
    4645   * Draai nog 1x de unit tests,  {{{python unittests.py --enable-all}}} 
    4746   * Doe nog eens reindent om de code style recht te trekken, {{{python bin/reindent.py `find . -name *.py`}}} 
    4847 - '''Branch''' - in SVN de branch maken 
    49    * Draai {{{bin/release 1.XXX}}} om development te kopiëren naar de nieuwe release in SVN. 
    50    * Maak de adaptatiemap in de nieuwe release schrijfbaar voor centra door 3 regels te kopiëren in de TRAC configuratie. Zie daarvoor de TRAC configuratie wiki elders. 
     48   * Draai {{{bin/release 1.XXX}}} om development te kopiëren naar de nieuwe release in SVN. Geef een versie-nummer op, met of zonder "v", die overeenkomt met de gewenste branch-naam onder `release/`. 
    5149 - '''Test nogmaals''' - of het na de branch nog doet. 
    5250   * Check de nieuwe versie uit en controleer nogmaals dat het -- nu als eigen release -- nog steeds start. Loop nogmaals 
    5351   cluchtig het test protocol door. 
    5452   * Start een eerdere versie op, ga naar versiebeheer en controleer dat (1) de nieuwe release in de versies lijst staat en (2) opschakelen naar de nieuwe release kan. 
     53 - '''TRAC Bijwerken''' -  
     54   * Maak de adaptatiemap in de nieuwe release schrijfbaar voor centra door 3 regels te kopiëren in de TRAC configuratie. Pas `apache/auth/openac-svn.auth` in sysconfig aan. 
     55   * Maak in TRAC via de Admin panel een nieuwe versie aan in [/admin/ticket/versions] zodat die voortaan te selecteren is in de web-interface. Zet geen "v" in deze versienummers. 
     56   * Maak eventueel een nieuwe milstone aan voor een nieuw en toekomstig te plannen release. Meestal hebben we nu drie releases vooruit milestones. 
     57   * Maak ook in het voren alvast een release-notes pagina aan voor een volgende release. 
    5558 - '''Announce''' - maak de nieuwe versie bekend 
    5659   * Maak een nieuwe starterkit. 
     60   * Werk '''VERSIES.txt''' bij door de releasedatum aan de laatste versie toe te voegen en de omschrijving af te maken. Daardoor verschijnt het in de beschikbare versies lijst van de ACs. 
    5761   * Stuur een release-bericht naar openac@fenac.nl. Denk daarbij goed na welke migraties er allemaal gebeuren bij deze nieuwe versie.  
    5862 
    59 === Maken van een nieuwe starter kit === 
     63== Starter Kit == 
    6064 
    6165De starterkit wordt gemaakt met NSIS ([http://nsis.sourceforge.net/Main_Page NullSoft Scriptable Installation System]). Die kan een paar configuratie-vragen stellen en OpenAC met een specifieke configuratie op een bepaalde plek installeren. 
    6266 
    63 Op de OpenAC server is `makensis` geinstalleerd. Soms zijn er Linux packages voor; op SourceForge is in ieder geval een `setup.exe` beschikbaar voor Windows. Om een starterkit te maken heb je een checkout van development nodig (of in ieder geval `development/bin`), makensis en een shell. 
     67Op de OpenAC server is `makensis` geinstalleerd. Soms zijn er Linux packages voor; op !SourceForge is in ieder geval een `setup.exe` beschikbaar voor Windows. Om een starterkit te maken heb je een checkout van development nodig (of in ieder geval `development/bin`), makensis en een shell. 
    6468 
    6569De starterkit wordt gemaakt door het script `bin/starterkit.py`. Gebruik `--help` voor configuratie-opties bij het maken van de starterkit. Over het algemeen is dit voldoende: 
    … …  
    6973}}} 
    7074 
    71 Waarbij VERSIE een '''inmiddels aangemaakte''' `release/` branch is. De "v" is optioneel, dus `-v 2.002` is hetzelfde als `-v v2.002`. Er wordt dan een checkout gemaakt van die versie, samen met de Python runtime, dan wordt van de template NSIS-file een specifiek installer-script gemaakt en met makensis tot een `starterkit.exe` gemaakt. Op de OpenAC server duurt dit ongeveer 20 minuten in totaal. 
     75Waarbij VERSIE een '''inmiddels aangemaakte''' `release/` branch is. De "v" in een versie-nummer is optioneel, dus `-v 2.002` is hetzelfde als `-v v2.002`. Er wordt dan een checkout gemaakt van die versie, samen met de Python runtime, dan wordt van de template NSIS-file een specifiek installer-script gemaakt en met makensis tot een `starterkit.exe` gemaakt. Op de OpenAC server duurt dit ongeveer 20 minuten in totaal. 
    7276 
    7377De resulterende executable mag naar de downloads folder worden gekopieerd. Er worden MD5 en SHA1 checksums geprint voor gebruik in de release notes of op de starterkitpagina.