docs/README.stable-point-release

   1 Rough Guide to doing Stable Point Releases in Debian
   2 ----------------------------------------------------
   3
   4 - sudo to dak
   5 - bash:
   6 suitename=wheezy
   7 newrev=7.10
   8
   9 export SCRIPTVARS=/srv/ftp-master.debian.org/dak/config/debian/vars
  10 . $SCRIPTVARS
  11 . "${configdir}/common"
  12 . "${configdir}/dinstall.functions"
  13 umask 022
  14 export LANG=C
  15 export LC_ALL=C
  16
  17 suite=$(psql -qAtc "SELECT suite_name FROM suite WHERE codename='${suitename}'")
  18 oldrev=$(psql -qAtc "SELECT version FROM suite WHERE codename='${suitename}'")
  19 case "${suite}" in
  20   stable)    pusuite=proposed-updates ;;
  21   oldstable) pusuite=oldstable-proposed-updates ;;
  22   *)         pusuite=INVALID ;;
  23 esac
  24
  25 echo "Point release for ${suite} (${suitename}); old version: ${oldrev}, new: ${newrev}"
  26 echo "Updates come from ${pusuite}"
  27
  28 pg_timestamp pre_${suite}_${newrev}
  29 cd ~
  30 mkdir -p ${suitename}_${newrev}
  31 cd ${suitename}_${newrev}
  32 dak control-suite -l ${pusuite} > ${pusuite}.list
  33 dak control-suite -l ${suite} > ${suite}.list
  34
  35 - ask SRMs if there is anything to be skipped from this release. If so
  36   edit ${pusuite}.list (and later the Changelog too)
  37 - bash:
  38 # skip: list of *source* packages to skip, whitespace seperated
  39 skip=""
  40 if [ -n "${skip}" ]; then
  41   mv ${pusuite}.list ${pusuite}.list.ori
  42   grep -vFf <(dak ls -f heidi -S -s ${pusuite} ${skip}) ${pusuite}.list.ori > ${pusuite}.list
  43 fi
  44
  45 dak make-changelog -s ${pusuite} -b ${suite} | cat - ${ftpdir}/dists/${suite}/ChangeLog | sponge ${ftpdir}/dists/${suite}/ChangeLog
  46 if [ -n "${skip}" ]; then
  47   $EDITOR ${ftpdir}/dists/${suite}/ChangeLog
  48 fi
  49
  50 dak control-suite --add ${suite} < ${pusuite}.list
  51 dak control-suite --remove ${pusuite} < ${pusuite}.list
  52
  53 - clean up *.changes from proposed-updates:
  54 # Be careful if uploads were not included in the point release.
  55 pumorguedir="${base}/morgue/queues/$(date +%Y/%m)"
  56 mkdir -p "${pumorguedir}"
  57 cd ${ftpdir}/dists/${pusuite}
  58 mv -t "${pumorguedir}" -n -- *.changes
  59
  60 - -r0 additions?
  61   For example new d-i. If so:
  62 cd ~/${suitename}_${newrev}
  63 cp /srv/release.debian.org/www/${suitename}/${newrev%%.*}/${newrev}/${suitename}-r0-additions.cs .
  64 dak control-suite --add ${suitename}-r0 < ${suitename}-r0-additions.cs
  65
  66 - sync with stable RM if there is any propup needed. do it, if so:
  67 cp /srv/release.debian.org/www/${suitename}/${newrev%%.*}/${newrev}/propups.unstable .
  68 dak control-suite --force --add unstable <propups.unstable
  69 cp /srv/release.debian.org/www/${suitename}/${newrev%%.*}/${newrev}/propups.testing .
  70 dak control-suite --force --add testing <propups.testing
  71
  72 - ask rms if they have RMs to do.
  73 # dak rm -s ${suite} -R -p -d ### -m '###' ###
  74 - Copy in entries from /srv/ftp.debian.org/web/removals.txt:
  75 # $EDITOR ${ftpdir}/dists/${suite}/ChangeLog
  76
  77 - and then check if they have a d-i update. if so, bash:
  78 diver=20130613+deb7u3+b1
  79 dak copy-installer -s ${pusuite} -d ${suite} ${diver}
  80
  81 # set dioldver to "empty" if there is no old to remove
  82 dioldver=20130613+deb7u3
  83 if [ "${dioldver}" != "empty" ]; then
  84     cd $ftpdir/dists/${suite}/main
  85     for iarch in $(dak admin s-a list-arch ${suite}); do
  86         if [ -d "installer-${iarch}/${dioldver}" ]; then
  87             echo "Moving installer-${iarch}/${dioldver} to morgue"
  88             mkdir -p "${base}/morgue/d-i/installer-${iarch}/"
  89             mv "installer-${iarch}/${dioldver}" "${base}/morgue/d-i/installer-${iarch}/"
  90         fi
  91     done
  92
  93     # Remove old version also from proposed-updates
  94     cd $ftpdir/dists/${pusuite}/main
  95     for iarch in $(dak admin s-a list-arch ${suite}); do
  96         rm -rf -- "installer-${iarch}/${dioldver}"
  97     done
  98 fi
  99 cd $ftpdir/dists/${suite}
 100
 101 - Updates for win32-loader?
 102 cd ${ftpdir}/tools/win32-loader
 103 if [ -d ${suitename}-proposed-updates ]; then
 104     rm -r ${suite}
 105     mv ${suitename}-proposed-updates ${suite}
 106 fi
 107 cd ${ftpdir}
 108
 109 - Update version number in README, README.html and dists/README,
 110   Clean up dists/stable/ChangeLog (add header, basically). bash:
 111
 112 cd ${ftpdir}/dists/${suite}
 113
 114 date_long=$(date "+%A, %-dth %B %Y" | sed 's/1th/1st/; s/2th/2nd/; s/3th/3rd/')
 115 date_iso=$(date "+%Y-%m-%d")
 116 date_short=$(date "+%a, %d %b %Y")
 117 sed -e "1i======================================\n${date_short} - Debian ${newrev} released\n======================================" -i ChangeLog
 118 sed -e "/^${suite}/ s/Debian ${oldrev}/Debian ${newrev}/" -i ../README
 119 sed -e "s/Debian ${oldrev}/Debian ${newrev}/g; /Debian ${newrev}/ s/released .*\\./released ${date_long}./" -i ../../README
 120 sed -e "s/Debian ${oldrev}/Debian ${newrev}/g; /Debian ${newrev}/ s/released .*\\./released ${date_long}./; /meta name=\"Modified\"/ s/content=\".*\"/content=\"${date_iso}\"/" -i ../../README.html
 121
 122 # Inspect changes. Regular expressions might be a bit fragile.
 123 for f in README README.html dists/README dists/${suite}/ChangeLog; do
 124   diff -u ${mirrordir}/ftp-master/${f} ${ftpdir}/${f}
 125 done
 126
 127 # If changes are needed:
 128 cd ${ftpdir}/dists/${suite}
 129 $EDITOR ChangeLog ../README ../../README ../../README.html
 130 rm -f -- ./*~ ../*~ ../../*~
 131
 132 - Update the 'Debian<n>.<n>r<n>' symlink in dists/
 133 cd $ftpdir/dists/
 134 rm -f Debian${oldrev}
 135 ln -s ${suitename} Debian${newrev}
 136
 137 - Update fields in suite table in postgresql.
 138   bash:
 139
 140 mdate=$(date +"%d %B %Y")
 141 psql projectb <<EOF
 142 begin;
 143 update suite set version = '${newrev}' where suite_name = '${suite}';
 144 update suite set description = 'Debian ${newrev} Released ${mdate}' where suite_name = '${suite}';
 145 commit;
 146 EOF
 147
 148 - prepare for gps. bash:
 149 dak dominate --force -s ${suite}
 150 - check output from cruft report:
 151 dak cruft-report -s ${suite}
 152 - if cruft was removed: go back to run dominate again
 153
 154 - if cruft was removed: update changelog from /srv/ftp.debian.org/web/removals.txt:
 155 # $EDITOR ${ftpdir}/dists/${suite}/ChangeLog
 156
 157 - Let SRM see if all is ok
 158
 159 - then:
 160 dak generate-packages-sources2 --force -s ${suite},${pusuite} && dak contents generate -f -s ${suite} -a ftp-master
 161
 162 - For wheezy: update main/i18n/Index
 163 if [[ ${suitename} == wheezy ]]; then
 164   ${scriptsdir}/generate-i18n-Index "${ftpdir}/dists/${suite}"
 165 fi
 166
 167 - Generate Releases:
 168 dak generate-releases -f -s ${suite} ${pusuite}
 169 # Remove InRelease: Release can be signed by both ftpmaster & stable release keys
 170 rm ${ftpdir}/dists/${suite}/InRelease
 171
 172 - have the SRMs sign it and put the signature in.
 173 cd ${ftpdir}/dists/${suite}
 174 cat /srv/release.debian.org/www/${suitename}/${newrev%%.*}/${newrev}/Release-${newrev}.gpg >> Release.gpg
 175 gpg --no-default-keyring --keyring /usr/share/keyrings/debian-archive-keyring.gpg --trust-model=always --verify Release.gpg Release
 176
 177 - Check if a mirror push is needed or next dinstall is enough. for a push
 178 o if so, bash:
 179 cd
 180 ${configdir}/cronscript mirror