[xen master] docs: consolidate release related documents

classic Classic list List threaded Threaded
1 message Options
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

[xen master] docs: consolidate release related documents

patchbot
commit 1c1df9b7665a586f9ec5887a627fdae837c3d667
Author:     Wei Liu <[hidden email]>
AuthorDate: Mon Jul 31 12:22:46 2017 +0100
Commit:     Wei Liu <[hidden email]>
CommitDate: Fri Aug 4 12:01:37 2017 +0100

    docs: consolidate release related documents
   
    Move the existing docs from misc to docs/process.
   
    Signed-off-by: Wei Liu <[hidden email]>
    Acked-by: Ian Jackson <[hidden email]>
---
 docs/process/branching-checklist.txt | 103 ++++++++++++++++++++++++++
 docs/process/release-checklist.txt   | 136 +++++++++++++++++++++++++++++++++++
 misc/branching-checklist.txt         | 103 --------------------------
 misc/release-checklist.txt           | 136 -----------------------------------
 4 files changed, 239 insertions(+), 239 deletions(-)

diff --git a/docs/process/branching-checklist.txt b/docs/process/branching-checklist.txt
new file mode 100644
index 0000000..8899432
--- /dev/null
+++ b/docs/process/branching-checklist.txt
@@ -0,0 +1,103 @@
+v=4.1
+ov=4.0
+
+##* tag branchpoint
+##        hg tag $v.0-branched
+##        hg sign -k 'Xen tree' 4.1.0-branched
+
+* make branch in qemu-iwj.git
+        git-branch $v-testing master
+
+# make branches in xenbits.xen.org qemus
+        ssh [hidden email]
+ cd ~/git/qemu-xen.git
+ git branch staging-$v staging
+ git branch stable-$v master
+ cd ~/git/qemu-xen-traditional.git
+ git branch stable-$v master
+
+# make branch in libvirt
+        ssh [hidden email]
+        cd ~/git/libvirt.git/
+ git branch osstest/frozen/xen-$v-testing   xen-tested-master
+
+# make branches in xenbits.xen.org xen.git
+        ssh [hidden email]
+        cd ~/git/xen.git
+ git branch staging-$v staging
+ git branch stable-$v master
+
+# update xendocs@xenbits docs generator to generate new stable branch
+#  docs too. commit to git.
+* make 13:37 <ijc> http://xenbits.xen.org/docs/4.2-testing/ is now live true
+#14:17 <ijc> HOWTO: login to xenbits. become "xendocs" . cd cronjobs . edit
+#            xenbits-docs-all.sh in the obvious way. git commit
+ ssh [hidden email]
+ su - xendocs
+ cd cronjobs
+ ed xenbits-docs-all.sh
+ /for branch
+ s/$/ 4.6-testing
+ # ^ OR SIMILAR
+ w
+ q
+        git add -p
+ git commit -m "Branch for $v"
+
+### * make symlink on mariner for qemu
+###        cd /var/www/git/
+###        ln -s /usr/groups/xencore/HG/qemu-xen-$v-testing.git .
+
+* make branches etc. in osstest
+        ssh [hidden email]-lab
+ cd testing.git
+ OSSTEST_CONFIG=production-config ./mg-branch-setup xen-$v-testing bisect
+ OSSTEST_CONFIG=production-config ./mg-branch-setup qemu-upstream-$v-testing bisect
+
+# make branches etc. in Cambridge osstest
+        ssh [hidden email]
+ cd testing.git
+ OSSTEST_CONFIG=production-config-cambridge ./mg-branch-setup xen-$v-testing bisect
+ OSSTEST_CONFIG=production-config-cambridge ./mg-branch-setup qemu-upstream-$v-testing bisect
+
+* add branch to osstest
+        ie add both eg qemu-upstream-4.2-testing and xen-4.2-testing to BRANCHES in cr-for-branches
+
+* add to patchbot
+        on xenbits
+        cd ~/HG/patchbot/
+
+ cp xen--master.patchbot-reported-heads xen--stable-$v.patchbot-reported-heads
+ cp xen--staging.patchbot-reported-heads xen--staging-$v.patchbot-reported-heads
+        cp qemu-xen--master.patchbot-reported-heads  qemu-xen--stable-$v.patchbot-reported-heads
+        cp qemu-xen--staging.patchbot-reported-heads  qemu-xen--staging-$v.patchbot-reported-heads
+        cp qemu-xen-traditional--master.patchbot-reported-heads qemu-xen-traditional--stable-$v.patchbot-reported-heads
+
+        #emacs versions
+ perl -i~ -pe 'next unless m/\b\Q'$ov'\E\b/; $x=$_; $x=~ s/\b\Q'$ov'\E\b/'$v'/g; print $x;' versions
+        git diff
+ git add versions
+ git commit -m "Branch for $v"
+
+#* update xenbits web page
+        ssh [hidden email]
+        cd /var/xenbits-www/html
+        emacs index.html
+ # - search for previous version number, and update in each place found
+ # - in general, drop one old release in favour of the new one
+
+Ensure references to qemu trees in xen.git's Config.mk are updated.
+Check this with
+        grep unstable Config.mk
+which should produce no output.  Replace as necessary.
+
+Update both new branches according to release-checklist.txt section re
+README etc.
+
+Update new stable tree's MAINTAINERS to contain correct info for this stable branch
+
+###* fix new trees' vcs descriptions
+#* make old trees' descriptions "historical"
+# cd ~/git
+# perl -i~ -pe "s/unstable/4.6-testing/" qemu-upstream-$v-testing.git/description
+
diff --git a/docs/process/release-checklist.txt b/docs/process/release-checklist.txt
new file mode 100644
index 0000000..b96964e
--- /dev/null
+++ b/docs/process/release-checklist.txt
@@ -0,0 +1,136 @@
+
+s=master
+#b=unstable
+v=$v-rc1
+
+OR
+
+x=4.1
+m=1
+rc=-rc2
+
+r=$x.$m
+s=$x-testing
+#b=$x-testing
+v=$r$rc
+
+t=$r$rc
+OR
+t=RELEASE-$r
+
+
+# FIRSTLY
+#  - check (for point releases, but not RCs) all XSAs have been applied (Lars)
+#
+* check, even for point releases
+*  http://logs.test-lab.xenproject.org/osstest/results/all-branch-statuses.txt
+
+
+# QEMU
+
+  git checkout $s
+  git show # should show appropriate intended commit
+  git-tag -u 'Xen.org Xen tree code signing' -m "Xen $v" xen-$v
+
+  git-push xenbits.xen.org:/home/xen/git/qemu-xen-traditional.git $s:stable-$x xen-$v
+
+# consider making tag in minios, and updating xen.git Config.mk
+  git checkout SOMETHING
+  git show # should show appropriate intended commit
+  git-tag -u 'xen tree' -s -m "Xen $r$rc" xen-$t
+  git push [hidden email]:/home/xen/git/mini-os.git xen-$t
+
+* Also tag upstream qemu tree (Stefano)
+  git checkout SOMETHING
+  git show # should show appropriate intended commit
+  git tag -u 'xen tree' -s -m "Xen $r$rc" qemu-xen-$v
+  git push [hidden email]:/home/xen/git/qemu-xen.git qemu-xen-$v
+
+* consider bumping sonames of shlibs
+
+* change xen-unstable README (should say "Xen 4.5" in releases and on stable branches, "Xen 4.5-unstable" on unstable)
+* change xen-unstable Config.mk (QEMU_UPSTREAM_REVISION, QEMU_TRADITIONAL_REVISION, MINIOS_UPSTREAM_REVISION)
+* change xen-unstable xen/Makefile XEN_EXTRAVERSION
+# if main version number has changed (eg 4.7 -> 4.8) rerun ./autogen.sh
+* rerun ./autogen.sh to update version number in configure
+#    - XEN_EXTRAVERSION should be `.0-rc$(XEN_VENDORVERSION)'
+#    - debug ?= n on stable branches
+#    - Kconfig.debug default n on stable branches
+* tag xen-unstable
+
+# In xen.git
+  git-fetch origin
+  git-checkout staging-$x
+  git-pull
+  git-show # should show commit updating version to right version
+  git-tag -u 'xen tree' -s -m "Xen $r$rc" $t
+  git-push origin $t
+##  hg tag <tag_name> ; hg sign -k "Xen tree" <tag_name>
+
+
+
+HANDLING TAG GENERATED BY RELEASE MANAGER
+
+   fetch the tag into my tree
+   make the tarball (RELEASE TARBALL, below)
+   test build (see below)
+   website (see below)
+   merge tag into staging and push to staging
+   maybe force push into master
+   definitely push tag to xenbits
+        git-push origin $t
+
+
+
+
+RELEASE TARBALL
+
+   for 4.5 and later, use tarball target
+       git checkout $t
+       git clean -xdff
+       # export http_proxy=http://localhost:3128/
+       ./configure
+       make src-tarball-release   # must be used for actual releases
+       make src-tarball           # uses git-describe (best for RCs)
+        # ^find some way to add git-cache-proxy to this (done in ~iwj/.gitconfig)
+       mkdir /volatile/iwj/website-thing/xen.org/oss-xen/release/$v
+       mv dist/xen-$v.tar.gz /volatile/iwj/website-thing/xen.org/oss-xen/release/$v/.
+
+       # website-thing/xen.org is cvs -d mail.xenproject.org:/home/downloads-cvs/cvs-repos co xen.org
+ cd /volatile/iwj/website-thing/xen.org
+
+# test build
+                cd /volatile/iwj/d
+                mkdir build
+                cd build
+                tar zxf /volatile/iwj/website-thing/xen.org/oss-xen/release/$v/xen-$v.tar.gz
+#                rsync -a --delete xen-$v build/
+                cd xen-$v
+                export http_proxy=http://localhost:3128/
+                (./configure && make -j4 KERNELS='' && echo ok.) 2>&1 | tee ../log.$v       # post 4.2
+
+# [[ test build amd64 ]]
+
+ cvs add -kb oss-xen/release/$v/
+
+        cd oss-xen/release/$v
+        gpg --digest-algo=SHA256 --detach-sign -u 'xen tree' xen-$v.tar.gz
+ cvs add -kb xen-$v.tar.gz
+        cvs add -kb xen-$v.tar.gz.sig
+        cd ../../..
+
+ cvs ci -m $v
+
+        ssh [hidden email]
+ cd /data/downloads.xenproject.org/xen.org
+ cvs -q up -d
+ # should show something like
+ #   U oss-xen/release/4.8.0-rc2/xen-4.8.0-rc2.tar.gz
+ #   U oss-xen/release/4.8.0-rc2/xen-4.8.0-rc2.tar.gz.sig
+
+
+update xenbits front page to change references to old stable branch
+ into references to new stable branch
+
+Edit website
+
diff --git a/misc/branching-checklist.txt b/misc/branching-checklist.txt
deleted file mode 100644
index 8899432..0000000
--- a/misc/branching-checklist.txt
+++ /dev/null
@@ -1,103 +0,0 @@
-v=4.1
-ov=4.0
-
-##* tag branchpoint
-##        hg tag $v.0-branched
-##        hg sign -k 'Xen tree' 4.1.0-branched
-
-* make branch in qemu-iwj.git
-        git-branch $v-testing master
-
-# make branches in xenbits.xen.org qemus
-        ssh [hidden email]
- cd ~/git/qemu-xen.git
- git branch staging-$v staging
- git branch stable-$v master
- cd ~/git/qemu-xen-traditional.git
- git branch stable-$v master
-
-# make branch in libvirt
-        ssh [hidden email]
-        cd ~/git/libvirt.git/
- git branch osstest/frozen/xen-$v-testing   xen-tested-master
-
-# make branches in xenbits.xen.org xen.git
-        ssh [hidden email]
-        cd ~/git/xen.git
- git branch staging-$v staging
- git branch stable-$v master
-
-# update xendocs@xenbits docs generator to generate new stable branch
-#  docs too. commit to git.
-* make 13:37 <ijc> http://xenbits.xen.org/docs/4.2-testing/ is now live true
-#14:17 <ijc> HOWTO: login to xenbits. become "xendocs" . cd cronjobs . edit
-#            xenbits-docs-all.sh in the obvious way. git commit
- ssh [hidden email]
- su - xendocs
- cd cronjobs
- ed xenbits-docs-all.sh
- /for branch
- s/$/ 4.6-testing
- # ^ OR SIMILAR
- w
- q
-        git add -p
- git commit -m "Branch for $v"
-
-### * make symlink on mariner for qemu
-###        cd /var/www/git/
-###        ln -s /usr/groups/xencore/HG/qemu-xen-$v-testing.git .
-
-* make branches etc. in osstest
-        ssh [hidden email]-lab
- cd testing.git
- OSSTEST_CONFIG=production-config ./mg-branch-setup xen-$v-testing bisect
- OSSTEST_CONFIG=production-config ./mg-branch-setup qemu-upstream-$v-testing bisect
-
-# make branches etc. in Cambridge osstest
-        ssh [hidden email]
- cd testing.git
- OSSTEST_CONFIG=production-config-cambridge ./mg-branch-setup xen-$v-testing bisect
- OSSTEST_CONFIG=production-config-cambridge ./mg-branch-setup qemu-upstream-$v-testing bisect
-
-* add branch to osstest
-        ie add both eg qemu-upstream-4.2-testing and xen-4.2-testing to BRANCHES in cr-for-branches
-
-* add to patchbot
-        on xenbits
-        cd ~/HG/patchbot/
-
- cp xen--master.patchbot-reported-heads xen--stable-$v.patchbot-reported-heads
- cp xen--staging.patchbot-reported-heads xen--staging-$v.patchbot-reported-heads
-        cp qemu-xen--master.patchbot-reported-heads  qemu-xen--stable-$v.patchbot-reported-heads
-        cp qemu-xen--staging.patchbot-reported-heads  qemu-xen--staging-$v.patchbot-reported-heads
-        cp qemu-xen-traditional--master.patchbot-reported-heads qemu-xen-traditional--stable-$v.patchbot-reported-heads
-
-        #emacs versions
- perl -i~ -pe 'next unless m/\b\Q'$ov'\E\b/; $x=$_; $x=~ s/\b\Q'$ov'\E\b/'$v'/g; print $x;' versions
-        git diff
- git add versions
- git commit -m "Branch for $v"
-
-#* update xenbits web page
-        ssh [hidden email]
-        cd /var/xenbits-www/html
-        emacs index.html
- # - search for previous version number, and update in each place found
- # - in general, drop one old release in favour of the new one
-
-Ensure references to qemu trees in xen.git's Config.mk are updated.
-Check this with
-        grep unstable Config.mk
-which should produce no output.  Replace as necessary.
-
-Update both new branches according to release-checklist.txt section re
-README etc.
-
-Update new stable tree's MAINTAINERS to contain correct info for this stable branch
-
-###* fix new trees' vcs descriptions
-#* make old trees' descriptions "historical"
-# cd ~/git
-# perl -i~ -pe "s/unstable/4.6-testing/" qemu-upstream-$v-testing.git/description
-
diff --git a/misc/release-checklist.txt b/misc/release-checklist.txt
deleted file mode 100644
index b96964e..0000000
--- a/misc/release-checklist.txt
+++ /dev/null
@@ -1,136 +0,0 @@
-
-s=master
-#b=unstable
-v=$v-rc1
-
-OR
-
-x=4.1
-m=1
-rc=-rc2
-
-r=$x.$m
-s=$x-testing
-#b=$x-testing
-v=$r$rc
-
-t=$r$rc
-OR
-t=RELEASE-$r
-
-
-# FIRSTLY
-#  - check (for point releases, but not RCs) all XSAs have been applied (Lars)
-#
-* check, even for point releases
-*  http://logs.test-lab.xenproject.org/osstest/results/all-branch-statuses.txt
-
-
-# QEMU
-
-  git checkout $s
-  git show # should show appropriate intended commit
-  git-tag -u 'Xen.org Xen tree code signing' -m "Xen $v" xen-$v
-
-  git-push xenbits.xen.org:/home/xen/git/qemu-xen-traditional.git $s:stable-$x xen-$v
-
-# consider making tag in minios, and updating xen.git Config.mk
-  git checkout SOMETHING
-  git show # should show appropriate intended commit
-  git-tag -u 'xen tree' -s -m "Xen $r$rc" xen-$t
-  git push [hidden email]:/home/xen/git/mini-os.git xen-$t
-
-* Also tag upstream qemu tree (Stefano)
-  git checkout SOMETHING
-  git show # should show appropriate intended commit
-  git tag -u 'xen tree' -s -m "Xen $r$rc" qemu-xen-$v
-  git push [hidden email]:/home/xen/git/qemu-xen.git qemu-xen-$v
-
-* consider bumping sonames of shlibs
-
-* change xen-unstable README (should say "Xen 4.5" in releases and on stable branches, "Xen 4.5-unstable" on unstable)
-* change xen-unstable Config.mk (QEMU_UPSTREAM_REVISION, QEMU_TRADITIONAL_REVISION, MINIOS_UPSTREAM_REVISION)
-* change xen-unstable xen/Makefile XEN_EXTRAVERSION
-# if main version number has changed (eg 4.7 -> 4.8) rerun ./autogen.sh
-* rerun ./autogen.sh to update version number in configure
-#    - XEN_EXTRAVERSION should be `.0-rc$(XEN_VENDORVERSION)'
-#    - debug ?= n on stable branches
-#    - Kconfig.debug default n on stable branches
-* tag xen-unstable
-
-# In xen.git
-  git-fetch origin
-  git-checkout staging-$x
-  git-pull
-  git-show # should show commit updating version to right version
-  git-tag -u 'xen tree' -s -m "Xen $r$rc" $t
-  git-push origin $t
-##  hg tag <tag_name> ; hg sign -k "Xen tree" <tag_name>
-
-
-
-HANDLING TAG GENERATED BY RELEASE MANAGER
-
-   fetch the tag into my tree
-   make the tarball (RELEASE TARBALL, below)
-   test build (see below)
-   website (see below)
-   merge tag into staging and push to staging
-   maybe force push into master
-   definitely push tag to xenbits
-        git-push origin $t
-
-
-
-
-RELEASE TARBALL
-
-   for 4.5 and later, use tarball target
-       git checkout $t
-       git clean -xdff
-       # export http_proxy=http://localhost:3128/
-       ./configure
-       make src-tarball-release   # must be used for actual releases
-       make src-tarball           # uses git-describe (best for RCs)
-        # ^find some way to add git-cache-proxy to this (done in ~iwj/.gitconfig)
-       mkdir /volatile/iwj/website-thing/xen.org/oss-xen/release/$v
-       mv dist/xen-$v.tar.gz /volatile/iwj/website-thing/xen.org/oss-xen/release/$v/.
-
-       # website-thing/xen.org is cvs -d mail.xenproject.org:/home/downloads-cvs/cvs-repos co xen.org
- cd /volatile/iwj/website-thing/xen.org
-
-# test build
-                cd /volatile/iwj/d
-                mkdir build
-                cd build
-                tar zxf /volatile/iwj/website-thing/xen.org/oss-xen/release/$v/xen-$v.tar.gz
-#                rsync -a --delete xen-$v build/
-                cd xen-$v
-                export http_proxy=http://localhost:3128/
-                (./configure && make -j4 KERNELS='' && echo ok.) 2>&1 | tee ../log.$v       # post 4.2
-
-# [[ test build amd64 ]]
-
- cvs add -kb oss-xen/release/$v/
-
-        cd oss-xen/release/$v
-        gpg --digest-algo=SHA256 --detach-sign -u 'xen tree' xen-$v.tar.gz
- cvs add -kb xen-$v.tar.gz
-        cvs add -kb xen-$v.tar.gz.sig
-        cd ../../..
-
- cvs ci -m $v
-
-        ssh [hidden email]
- cd /data/downloads.xenproject.org/xen.org
- cvs -q up -d
- # should show something like
- #   U oss-xen/release/4.8.0-rc2/xen-4.8.0-rc2.tar.gz
- #   U oss-xen/release/4.8.0-rc2/xen-4.8.0-rc2.tar.gz.sig
-
-
-update xenbits front page to change references to old stable branch
- into references to new stable branch
-
-Edit website
-
--
generated by git-patchbot for /home/xen/git/xen.git#master

_______________________________________________
Xen-changelog mailing list
[hidden email]
https://lists.xenproject.org/xen-changelog
Loading...