docs/README.stable-point-release

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