X-Git-Url: https://git.decadent.org.uk/gitweb/?p=dak.git;a=blobdiff_plain;f=docs%2FREADME.stable-point-release;h=304795f1cd890312e493134072318bf9fff39d05;hp=b3c8bde675d537db0a265c83e531bcd9c27f85e4;hb=4f3c7874fd19d380b106a9d4bbab0403ed089359;hpb=55c9457424113af281f88f786042c35dff410d2b diff --git a/docs/README.stable-point-release b/docs/README.stable-point-release index b3c8bde6..304795f1 100644 --- a/docs/README.stable-point-release +++ b/docs/README.stable-point-release @@ -1,101 +1,180 @@ Rough Guide to doing Stable Point Releases in Debian ---------------------------------------------------- -o Dump projectb for backup purposes. -o get everything listed, dak control-suite -l proposed-updates > p-u.list -o generate the changelog using dak make-changelog -s proposed-updates -b stable | cat - ${ftpdir}/dists/stable/ChangeLog | sponge ${ftpdir}/dists/stable/ChangeLog -o add everything to stable: cat p-u.list |dak control-suite --add stable -o remove everything from proposed-updates, dak control-suite -r proposed-updates < p-u.list -o sync with stable RM if there is any propup needed. do it, if so. -o ask rms if they have RMs to do. -o If you installed a debian-installer upload; migrate the relevant - installer-*/$release directory from proposed-updates to stable. - (Including potentially removing older versions) - dak copy-installer helps -o Update version number in README, README.html and dists/README -o Update the 'Debian.r' symlink in dists/ -o Clean up dists/stable/ChangeLog (add header, basically) -o Update fields in suite table in postgresql (see below) - -o dak dominate --force -s stable -o dak generate-filelist -s stable -o Let SRM see if all is ok -o cd $configdir ; apt-ftparchive generate apt.conf.stable -o dak generate-releases --force-touch --apt-conf apt.conf.stable stable -o Check if a mirror push is needed or next dinstall is enough. for a push -o if so: - TRACEFILE="${ftpdir}/project/trace/ftp-master.debian.org" - DATE_SERIAL=$(date +"%Y%m%d01") - FILESOAPLUS1=$(awk '/serial/ { print $3+1 }' ${TRACEFILE} ) - if [ "$DATE_SERIAL" -gt "$FILESOAPLUS1" ]; then - SERIAL="$DATE_SERIAL" - else - SERIAL="$FILESOAPLUS1" - fi - date -u > ${TRACEFILE} - echo "Using dak v1" >> ${TRACEFILE} - echo "Running on host: $(hostname -f)" >> ${TRACEFILE} - echo "Archive serial: ${SERIAL}" >> ${TRACEFILE} - cd ${mirrordir} - rsync -aH --link-dest ${ftpdir} --delete --delete-after --ignore-errors ${ftpdir}/. . - - date -u > /srv/ftp.debian.org/web/mirrorstart - echo "Using dak v1" >> /srv/ftp.debian.org/web/mirrorstart - echo "Running on host $(hostname -f)" >> /srv/ftp.debian.org/web/mirrorstart - sudo -H -u archvsync /home/archvsync/runmirrors > ~dak/runmirrors.log 2>&1 & - - +- sudo to dak +- bash: +suitename=wheezy +newrev=7.10 + +export SCRIPTVARS=/srv/ftp-master.debian.org/dak/config/debian/vars +. $SCRIPTVARS +. "${configdir}/common" +. "${configdir}/dinstall.functions" +umask 022 +export LANG=C +export LC_ALL=C + +suite=$(psql -qAtc "SELECT suite_name FROM suite WHERE codename='${suitename}'") +oldrev=$(psql -qAtc "SELECT version FROM suite WHERE codename='${suitename}'") +case "${suite}" in + stable) pusuite=proposed-updates ;; + oldstable) pusuite=oldstable-proposed-updates ;; + *) pusuite=INVALID ;; +esac + +echo "Point release for ${suite} (${suitename}); old version: ${oldrev}, new: ${newrev}" +echo "Updates come from ${pusuite}" + +pg_timestamp pre_${suite}_${newrev} +cd ~ +mkdir -p ${suitename}_${newrev} +cd ${suitename}_${newrev} +dak control-suite -l ${pusuite} > ${pusuite}.list +dak control-suite -l ${suite} > ${suite}.list + +- ask SRMs if there is anything to be skipped from this release. If so + edit ${pusuite}.list (and later the Changelog too) +- bash: +# skip: list of *source* packages to skip, whitespace seperated +skip="" +if [ -n "${skip}" ]; then + mv ${pusuite}.list ${pusuite}.list.ori + grep -vFf <(dak ls -f heidi -S -s ${pusuite} ${skip}) ${pusuite}.list.ori > ${pusuite}.list +fi + +dak make-changelog -s ${pusuite} -b ${suite} | cat - ${ftpdir}/dists/${suite}/ChangeLog | sponge ${ftpdir}/dists/${suite}/ChangeLog +if [ -n "${skip}" ]; then + $EDITOR ${ftpdir}/dists/${suite}/ChangeLog +fi + +dak control-suite --add ${suite} < ${pusuite}.list +dak control-suite --remove ${pusuite} < ${pusuite}.list + +- clean up *.changes from proposed-updates: +# Be careful if uploads were not included in the point release. +pumorguedir="${base}/morgue/queues/$(date +%Y/%m)" +mkdir -p "${pumorguedir}" +cd ${ftpdir}/dists/${pusuite} +mv -t "${pumorguedir}" -n -- *.changes + +- -r0 additions? + For example new d-i. If so: +cd ~/${suitename}_${newrev} +cp /srv/release.debian.org/www/${suitename}/${newrev%%.*}/${newrev}/${suitename}-r0-additions.cs . +dak control-suite --add ${suitename}-r0 < ${suitename}-r0-additions.cs + +- sync with stable RM if there is any propup needed. do it, if so: +cp /srv/release.debian.org/www/${suitename}/${newrev%%.*}/${newrev}/propups.unstable . +dak control-suite --force --add unstable .r' symlink in dists/ +cd $ftpdir/dists/ +rm -f Debian${oldrev} +ln -s ${suitename} Debian${newrev} + +- Update fields in suite table in postgresql. + bash: + +mdate=$(date +"%d %B %Y") +psql projectb <.r' symlink in dists/ -o Clean up dists/stable/ChangeLog (add header, basically) -o Update version fields in dak.conf -o Update fields in suite table in postgresql (see below) - -o Run 'dak make-suite-file-list --force -s stable' -o Run apt-ftparchive generate apt.conf.stable -o Run 'dak generate-releases --force-touch --apt-conf apt.conf.stable stable' - -[Yes, this sucks and more of it should be automated. c.f. ~ajt/pointupdate] - -####################################################### - -update suite set version = '4.0r3' where suite_name = 'stable'; -update suite set description = 'Debian 4.0r3 Released 16th February 2008' where suite_name = 'stable'; - -Rough Guide to doing Old-Stable Point Releases in Debian --------------------------------------------------------- - -Pretty much as above, except that process-accepted doesn't know about -oldstable, so you have to do some surgery on it first to make it -support that. Probably want to disable cron.daily whilst doing so. -Also watch out for the installing_to_stable detection which doesn't -work well with the current layout of oldstable-proposed-updates (as a -symlink to $distro-proposed-updates). clean-proposed-updates, -cruft-report and most everything else support a -s/--suite so they -sould be fine to use. +update suite set version = '${newrev}' where suite_name = '${suite}'; +update suite set description = 'Debian ${newrev} Released ${mdate}' where suite_name = '${suite}'; +commit; +EOF + +- prepare for gps. bash: +dak dominate --force -s ${suite} +- check output from cruft report: +dak cruft-report -s ${suite} +- if cruft was removed: go back to run dominate again + +- if cruft was removed: update changelog from /srv/ftp.debian.org/web/removals.txt: +# $EDITOR ${ftpdir}/dists/${suite}/ChangeLog + +- Let SRM see if all is ok + +- then: +dak generate-packages-sources2 --force -s ${suite},${pusuite} && dak contents generate -f -s ${suite} -a ftp-master + +- For wheezy: update main/i18n/Index +if [[ ${suitename} == wheezy ]]; then + ${scriptsdir}/generate-i18n-Index "${ftpdir}/dists/${suite}" +fi + +- Generate Releases: +dak generate-releases -f -s ${suite} ${pusuite} +# Remove InRelease: Release can be signed by both ftpmaster & stable release keys +rm ${ftpdir}/dists/${suite}/InRelease + +- have the SRMs sign it and put the signature in. +cd ${ftpdir}/dists/${suite} +cat /srv/release.debian.org/www/${suitename}/${newrev%%.*}/${newrev}/Release-${newrev}.gpg >> Release.gpg +gpg --no-default-keyring --keyring /usr/share/keyrings/debian-archive-keyring.gpg --trust-model=always --verify Release.gpg Release + +- Check if a mirror push is needed or next dinstall is enough. for a push +o if so, bash: +cd +${configdir}/cronscript mirror