Neon/QtUpdates: Difference between revisions

From KDE Community Wiki
No edit summary
No edit summary
Line 1: Line 1:
= How to Update Qt in Neon =
= How to Update Qt in Neon =


== Testing phase ==
Testing phase is initial preparation stage of Qt updates, where new Qt version is prepared in the experimental repo, reasoning behind preparing it in experimental is sometime Qt updates can take days to prepare, preparing it in separate repo doesn't affect the production.
*  For these Qt packages merge in order Neon/release into Neon/testing
* For these the Qt packages merge in order latest tagged release from master into Neon/testing
* If debian hasn't prepared the tag for the specific release, you would need to
* [https://packaging.neon.kde.org/qt/qtbase.git/tree/debian/README.source#n24 List of packages for qtdoc rebuilds]
** Drop the changelog delta with debian
** Bump the Build-Depends and Build-Depends-Indep of the qt dependencies in debian/control to the Qt version being prepared
** Add the changelog entry with the packaging version set to -0neon or +dfsg-0+neon, (i.e 5.12.1+dfsg-0+neon) it is used to avoid the merge conflicts with the debian merge.
** git push all changes at once.
* Let them build, and fix the remaining errors. Once the qtdoc related packages are rebuilt, you need to build them again in same order to make sure they are green.
* After that follow procedure in previous step for rest of Qt packages
* Once all Qt packages are done, build the other kde related packages in experimental view.
If builds are completed, you can test them on user edition by enabling /release and /experimental repositories, and upgrading your system. You would also have to pin the packages in experimental repo.
    Package: *
    Pin: release l=KDE neon - Experimental Edition
    Pin-Priority: 1001
If everything looks good, and week day is Mon-Wed, you can proceed to landing them in Neon/release
= Landing Qt =
* Run both stable and unstable divert [https://build.neon.kde.org/view/mgmt/ mgmt jobs] to make developer builds go to /tmp/dev/unstable instead of /dev/unstable
* Run both stable and unstable divert [https://build.neon.kde.org/view/mgmt/ mgmt jobs] to make developer builds go to /tmp/dev/unstable instead of /dev/unstable
* Cherry-pick [https://github.com/pangea-project/pangea-tooling/commit/e609823b8fd312b9c4ce21cf367f6fa90ebc63c8 this commit] into pangea-tooling and let is deploy to move builds into /tmp archives
* Cherry-pick [https://github.com/pangea-project/pangea-tooling/commit/e609823b8fd312b9c4ce21cf367f6fa90ebc63c8 this commit] into pangea-tooling and let it deploy to move builds into /tmp archives.
* Notify other neon developers to NOT snapshot either Neon/release or Neon/release-lts.
* [https://packaging.neon.kde.org/qt/qtbase.git/tree/debian/README.source#n24 List of packages for qtdoc rebuilds]
* [https://packaging.neon.kde.org/qt/qtbase.git/tree/debian/README.source#n24 List of packages for qtdoc rebuilds]
*For these Qt packages merge in order Neon/release into Neon/testing
* For this packages,
** For these the Qt packages merge in order latest tagged release from master into Neon/testing
** Merge the Neon/testing branch to Neon/release.
** Let them build
** Wait for builds to finish
** Trigger the builds again and check the turn green in Jenkins so they have built the new qtdoc stuff
** Rebuild same packages again.
* Merge other Qt bits and build
* Merge Neon/testing branch into Neon/release for other Qt packages, and wait for them to finish building.
 
* Build stuff which deps on Qt-private-ABI in all editions.
* Build stuff which deps on Qt-private-ABI:
** akonadi
** akonadi
** kio-extras
** kio-extras
Line 23: Line 48:
** plasma-integration
** plasma-integration
** skrooge
** skrooge
* Test both user edition with /release repo enabled, and dev unstable edition at least with archive link changed to /tmp/unstable instead of /unstable.
* Once at least 2 days of testing is done, snapshot user and user-lts
* Undivert the dev unstable and dev stable repos.
= Process improvements =


* Test
* Document release/lts wrt Qt.
* Copy Qt packages to release-lts, release, stable, unstable
* Build Qt-private-ABI-deps in each edition ''FIXME but this doesn't work for diverted dev editions''
* Test
* Snapshot user and user-lts
* Undivert
* ''FIXME openQA checks?''
* ''FIXME openQA checks?''

Revision as of 05:57, 22 May 2019

How to Update Qt in Neon

Testing phase

Testing phase is initial preparation stage of Qt updates, where new Qt version is prepared in the experimental repo, reasoning behind preparing it in experimental is sometime Qt updates can take days to prepare, preparing it in separate repo doesn't affect the production.

  • For these Qt packages merge in order Neon/release into Neon/testing
  • For these the Qt packages merge in order latest tagged release from master into Neon/testing
  • If debian hasn't prepared the tag for the specific release, you would need to
  • List of packages for qtdoc rebuilds
    • Drop the changelog delta with debian
    • Bump the Build-Depends and Build-Depends-Indep of the qt dependencies in debian/control to the Qt version being prepared
    • Add the changelog entry with the packaging version set to -0neon or +dfsg-0+neon, (i.e 5.12.1+dfsg-0+neon) it is used to avoid the merge conflicts with the debian merge.
    • git push all changes at once.
  • Let them build, and fix the remaining errors. Once the qtdoc related packages are rebuilt, you need to build them again in same order to make sure they are green.
  • After that follow procedure in previous step for rest of Qt packages
  • Once all Qt packages are done, build the other kde related packages in experimental view.

If builds are completed, you can test them on user edition by enabling /release and /experimental repositories, and upgrading your system. You would also have to pin the packages in experimental repo.

   Package: *
   Pin: release l=KDE neon - Experimental Edition
   Pin-Priority: 1001

If everything looks good, and week day is Mon-Wed, you can proceed to landing them in Neon/release

Landing Qt

  • Run both stable and unstable divert mgmt jobs to make developer builds go to /tmp/dev/unstable instead of /dev/unstable
  • Cherry-pick this commit into pangea-tooling and let it deploy to move builds into /tmp archives.
  • Notify other neon developers to NOT snapshot either Neon/release or Neon/release-lts.
  • List of packages for qtdoc rebuilds
  • For this packages,
    • Merge the Neon/testing branch to Neon/release.
    • Wait for builds to finish
    • Rebuild same packages again.
  • Merge Neon/testing branch into Neon/release for other Qt packages, and wait for them to finish building.
  • Build stuff which deps on Qt-private-ABI in all editions.
    • akonadi
    • kio-extras
    • pyqt5
    • python-qt4
    • sip4
    • kdeclarative
    • kwayland
    • plasma-framework
    • breeze
    • kwin
    • plasma-integration
    • skrooge
  • Test both user edition with /release repo enabled, and dev unstable edition at least with archive link changed to /tmp/unstable instead of /unstable.
  • Once at least 2 days of testing is done, snapshot user and user-lts
  • Undivert the dev unstable and dev stable repos.

Process improvements

  • Document release/lts wrt Qt.
  • FIXME openQA checks?