1 Rough Guide to doing Stable Point Releases in Debian
2 ----------------------------------------------------
9 export SCRIPTVARS=/srv/ftp-master.debian.org/dak/config/debian/vars
11 . "${configdir}/common"
12 . "${configdir}/dinstall.functions"
17 suite=$(psql -qAtc "SELECT suite_name FROM suite WHERE codename='${suitename}'")
18 oldrev=$(psql -qAtc "SELECT version FROM suite WHERE codename='${suitename}'")
20 stable) pusuite=proposed-updates ;;
21 oldstable) pusuite=oldstable-proposed-updates ;;
25 echo "Point release for ${suite} (${suitename}); old version: ${oldrev}, new: ${newrev}"
26 echo "Updates come from ${pusuite}"
28 pg_timestamp pre_${suite}_${newrev}
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
35 - ask SRMs if there is anything to be skipped from this release. If so
36 edit ${pusuite}.list (and later the Changelog too)
38 # skip: list of *source* packages to skip, whitespace seperated
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
45 tmpfile=$(mktemp -p "${TMPDIR}" changelog.XXXXXX)
46 dak make-changelog -s ${pusuite} -b ${suite} | cat - ${ftpdir}/dists/${suite}/ChangeLog > ${tmpfile}
48 mv ${tmpfile} ${ftpdir}/dists/${suite}/ChangeLog
49 if [ -n "${skip}" ]; then
50 $EDITOR ${ftpdir}/dists/${suite}/ChangeLog
53 dak control-suite --add ${suite} < ${pusuite}.list
54 dak control-suite --remove ${pusuite} < ${pusuite}.list
56 - clean up *.changes from proposed-updates:
57 # Be careful if uploads were not included in the point release.
58 pumorguedir="${base}/morgue/queues/$(date +%Y/%m)"
59 mkdir -p "${pumorguedir}"
60 cd ${ftpdir}/dists/${pusuite}
61 mv -t "${pumorguedir}" -n -- *.changes
62 if [ -n "${skip}" ]; then
63 for pack in ${skip}; do
64 mv -t "${ftpdir}/dists/${pusuite}" ${pumorguedir}/${pack}*.changes
68 # do r0 and propups, if any
69 cd ~/${suitename}_${newrev}
70 if [[ -f /srv/release.debian.org/www/${suitename}/${newrev%%.*}/${newrev}/${suitename}-r0-additions.cs ]]; then
71 cp /srv/release.debian.org/www/${suitename}/${newrev%%.*}/${newrev}/${suitename}-r0-additions.cs .
72 dak control-suite --add ${suitename}-r0 < ${suitename}-r0-additions.cs
74 if [[ -f /srv/release.debian.org/www/${suitename}/${newrev%%.*}/${newrev}/propups.unstable ]]; then
75 cp /srv/release.debian.org/www/${suitename}/${newrev%%.*}/${newrev}/propups.unstable .
76 dak control-suite --force --add unstable <propups.unstable
78 if [[ -f /srv/release.debian.org/www/${suitename}/${newrev%%.*}/${newrev}/propups.testing ]]; then
79 cp /srv/release.debian.org/www/${suitename}/${newrev%%.*}/${newrev}/propups.testing .
80 dak control-suite --force --add testing <propups.testing
83 - ask rms if they have RMs to do.
84 # dak rm -s ${suite} -R -p -d ### -m '###' ###
85 - Copy in entries from /srv/ftp.debian.org/web/removals.txt:
86 # $EDITOR ${ftpdir}/dists/${suite}/ChangeLog
88 - and then check if they have a d-i update. if so, bash:
90 dak copy-installer -s ${pusuite} -d ${suite} ${diver}
92 # set dioldver to "empty" if there is no old to remove
93 dioldver=20150422+deb8u3+b1
94 if [ "${dioldver}" != "empty" ]; then
95 cd $ftpdir/dists/${suite}/main
96 for iarch in $(dak admin s-a list-arch ${suite}); do
97 if [ -d "installer-${iarch}/${dioldver}" ]; then
98 echo "Moving installer-${iarch}/${dioldver} to morgue"
99 mkdir -p "${base}/morgue/d-i/installer-${iarch}/"
100 mv "installer-${iarch}/${dioldver}" "${base}/morgue/d-i/installer-${iarch}/"
104 # Remove old version also from proposed-updates
105 cd $ftpdir/dists/${pusuite}/main
106 for iarch in $(dak admin s-a list-arch ${suite}); do
107 rm -rf -- "installer-${iarch}/${dioldver}"
110 cd $ftpdir/dists/${suite}
112 - Updates for win32-loader?
113 cd ${ftpdir}/tools/win32-loader
114 if [ -d ${suitename}-proposed-updates ]; then
116 mv ${suitename}-proposed-updates ${suite}
120 - Update version number in README, README.html and dists/README,
121 Clean up dists/stable/ChangeLog (add header, basically). bash:
123 cd ${ftpdir}/dists/${suite}
125 date_long=$(date "+%A, %-dth %B %Y" | sed 's/1th/1st/; s/2th/2nd/; s/3th/3rd/')
126 date_iso=$(date "+%Y-%m-%d")
127 date_short=$(date "+%a, %d %b %Y")
128 sed -e "1i======================================\n${date_short} - Debian ${newrev} released\n======================================" -i ChangeLog
129 sed -e "/^${suite}/ s/Debian ${oldrev}/Debian ${newrev}/" -i ../README
130 sed -e "s/Debian ${oldrev}/Debian ${newrev}/g; /Debian ${newrev}/ s/released .*\\./released ${date_long}./" -i ../../README
131 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
133 # Inspect changes. Regular expressions might be a bit fragile.
134 for f in README README.html dists/README dists/${suite}/ChangeLog; do
135 diff -u ${mirrordir}/ftp-master/${f} ${ftpdir}/${f}
138 # If changes are needed:
139 cd ${ftpdir}/dists/${suite}
140 $EDITOR ChangeLog ../README ../../README ../../README.html
141 rm -f -- ./*~ ../*~ ../../*~
143 - Update the 'Debian<n>.<n>r<n>' symlink in dists/
145 rm -f Debian${oldrev}
146 ln -s ${suitename} Debian${newrev}
148 - Update fields in suite table in postgresql.
151 mdate=$(date +"%d %B %Y")
154 update suite set version = '${newrev}' where suite_name = '${suite}';
155 update suite set description = 'Debian ${newrev} Released ${mdate}' where suite_name = '${suite}';
159 - prepare for gps. bash:
160 dak dominate --force -s ${suite}
161 - check output from cruft report:
162 dak cruft-report -s ${suite}
163 - if cruft was removed: go back to run dominate again
165 - if cruft was removed: update changelog from /srv/ftp.debian.org/web/removals.txt:
166 # $EDITOR ${ftpdir}/dists/${suite}/ChangeLog
168 - Let SRM see if all is ok
171 dak generate-packages-sources2 --force -s ${suite},${pusuite} && dak contents generate -f -s ${suite} -a ftp-master
173 - For wheezy: update main/i18n/Index
174 if [[ ${suitename} == wheezy ]]; then
175 ${scriptsdir}/generate-i18n-Index "${ftpdir}/dists/${suite}"
179 dak generate-releases -f -s ${suite} ${pusuite}
180 # Remove InRelease: Release can be signed by both ftpmaster & stable release keys
181 rm ${ftpdir}/dists/${suite}/InRelease
182 cd ${ftpdir}/dists/${suite}
184 if [[ -f /srv/release.debian.org/www/${suitename}/${newrev%%.*}/${newrev}/Release-${newrev}.gpg ]]; then
185 cat /srv/release.debian.org/www/${suitename}/${newrev%%.*}/${newrev}/Release-${newrev}.gpg >> Release.gpg
186 gpg --no-default-keyring --keyring /usr/share/keyrings/debian-archive-keyring.gpg --trust-model=always --verify Release.gpg Release
195 - Check if a mirror push is needed or next dinstall is enough. for a push, bash:
197 ${configdir}/cronscript mirror