walinuxagentUpdates
Differences between revisions 5 and 26 (spanning 21 versions)
|
Size: 1637
Comment:
|
← Revision 26 as of 2019-06-05 22:02:31 ⇥
Size: 4958
Comment: the SRU exception approval requires post-upload validation of the exact binaries built in the archive.
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 1: | Line 1: |
| = walinuxagentUpdates = | = walinuxagent Updates = |
| Line 5: | Line 5: |
| The walinuxagent package is an ubuntu distribution of the upstream Microsoft Azure Linux Agent that manages Linux provisioning, and VM interaction with the Azure Fabric Controller. | The walinuxagent package is an Ubuntu distribution of the upstream Microsoft Azure Linux Agent that manages Linux provisioning, and VM interaction with the Azure Fabric Controller. For a detailed list of functionality this package provides to Ubuntu cloud images, refer to the upstream project page at Git``Hub: https://github.com/Azure/WALinuxAgent |
| Line 7: | Line 7: |
| It provides the following functionality for ubuntu cloud image deployments: | Cloud platforms evolve at a rate that can't be handled in six-month increments, and they will often develop features that they would like to be available to customers who don't want to upgrade from earlier Ubuntu releases. As such, updating walinuxagent to more recent upstream releases is required within all Ubuntu releases, so they continue to function properly in their environment. |
| Line 9: | Line 9: |
| * Image Provisioning. * Networking setup. * Kernel setup. * Diagnostics setup. * SCVMM Deployments * VM Extensions Management |
New versions of walinuxagent can be SRUed into older releases provided the following process is followed. |
| Line 16: | Line 11: |
| For a more detailed list of functionallity this package provides to ubuntu cloud images, refer to the upstream project page at github: https://github.com/Azure/WALinuxAgent | |
| Line 20: | Line 14: |
| This is the mandatory QA process that the proposed packages have to pass. The following requirements must be met: * The new package candidate version is to be placed on a PPA and tested manually on the target suite during upstream changes packaging phase. This tests include: * Installing the PPA packages, restore the machine to a first boot state and reboot it. * Or might require to generate an image with the PPA package version preinstalled and test that directly. * Once the manual packaging tests pass succesfully and the package seems to require no more changes, a test image is required to be generated having the PPA package version preinstalled before automated testing can be done. * Automatic testing will run the test image for the target suite through a series of tests for all relevant Azure VM sizes. Currently those tests include: * Azure general tests * LXD test |
When a new version of walinuxagent is uploaded to -proposed, the following will be done: * the CPC team will write new automated tests to cover new testable functionality (if any) in the new package * the automated testing that the CPC team normally runs against Azure images before they are published will be run against the -proposed package * the Microsoft Azure Linux Agent team will be asked to validate * that the new package addresses the issues it is expected to address, and * that the new package passes their internal image validation, with emphasis on walinuxagent extension support. In addition, the CPC team does the following testing * The new package candidate version is built in devel-proposed and tested on the target suite. This will involve one or both of: * Installing the devel-proposed packages on an Azure VM, manually restoring the VM to a first boot state and rebooting it, * Generating a fresh image with the devel-proposed package version preinstalled and testing that directly * Once the manual packaging tests pass successfully and the package requires no further changes, it will be marked as such on the tracking bug. On the development release, this is done by removing the '''block-proposed''' tag. '''''If appropriate due to the nature of the changes (embargo on publication), the steps above may be done in a private PPA prior to landing in devel-proposed.''''' The following additional steps also apply for the SRUs to supported releases once the packages have been accepted into the development release (if applicable): * Once accepted in to -proposed, a test image is built from -proposed, which is subjected to the full CPC image tests; this tests for more regressions across multiple Azure instance sizes. This includes tests for the following bugs: * [[https://bugs.launchpad.net/ubuntu/+source/walinuxagent/+bug/1479610|Bug #1479610 regression on dhcp configuration]] * [[https://bugs.launchpad.net/ubuntu/+source/walinuxagent/+bug/1079897|Bug #1079897 mangled server identity and access on upgrade]] * [[https://bugs.launchpad.net/ubuntu/+source/walinuxagent/+bug/1305418|Bug #1305418 breaks sshd configuration]] === Pre-SRU Test Cases === These are the test cases that all walinuxagent are subjected to before even getting to SRU: {{{ 1.) Launch instance on Azure 2.) Upgrade walinuxagent (usually from PPA) 3.) Confirm that "waagent" is running, check /var/log/waagent.log for errors 4.) Reboot, repeat step 3 }}} === SRU Test Cases === These are automated tests: {{{ 1.) Build new cloud image with -proposed package 2.) Boot instance 3.) Confirm that instance provisioned 4.) Run standard tests and regression tests 5.) Repeat from step 2 for all other Azure VM Sizes. }}} == Releasing the SRU == Since the only consumer of the walinuxagent is the Azure cloud, the SRU may be released without meeting the aging period of 7 days provided all the above steps have been completed. == SRU Template == {{{ == Begin SRU Template == [Impact] This release contains both bug-fixes and new features and we would like to make sure all of our supported customers have access to these improvements. The notable ones are: * <TODO: list any LP: # included> See the changelog entry below for a full list of changes and bugs. [Test Case] The following development and SRU process was followed: https://wiki.ubuntu.com/walinuxagentUpdates The Microsoft Azure Linux Agent team will execute their testsuite, which includes extension testing , against the walinuxagent that is in -proposed. A successful run will be required before the proposed walinuxagent can be let into -updates. The CPC team will be in charge of attaching a summary of testing to the bug. CPC team members will not mark ‘verification-done’ until this has happened. == End SRU Template == <TODO: Paste in change log entry> }}} |
walinuxagent Updates
This document describes the process to update and test new versions of the walinuxagent package in SRUs.
The walinuxagent package is an Ubuntu distribution of the upstream Microsoft Azure Linux Agent that manages Linux provisioning, and VM interaction with the Azure Fabric Controller. For a detailed list of functionality this package provides to Ubuntu cloud images, refer to the upstream project page at GitHub: https://github.com/Azure/WALinuxAgent
Cloud platforms evolve at a rate that can't be handled in six-month increments, and they will often develop features that they would like to be available to customers who don't want to upgrade from earlier Ubuntu releases. As such, updating walinuxagent to more recent upstream releases is required within all Ubuntu releases, so they continue to function properly in their environment.
New versions of walinuxagent can be SRUed into older releases provided the following process is followed.
QA Process
When a new version of walinuxagent is uploaded to -proposed, the following will be done:
- the CPC team will write new automated tests to cover new testable functionality (if any) in the new package
- the automated testing that the CPC team normally runs against Azure images before they are published will be run against the -proposed package
- the Microsoft Azure Linux Agent team will be asked to validate
- that the new package addresses the issues it is expected to address, and
- that the new package passes their internal image validation, with emphasis on walinuxagent extension support.
In addition, the CPC team does the following testing
- The new package candidate version is built in devel-proposed and tested on the target suite. This will involve one or both of:
- Installing the devel-proposed packages on an Azure VM, manually restoring the VM to a first boot state and rebooting it,
- Generating a fresh image with the devel-proposed package version preinstalled and testing that directly
Once the manual packaging tests pass successfully and the package requires no further changes, it will be marked as such on the tracking bug. On the development release, this is done by removing the block-proposed tag.
If appropriate due to the nature of the changes (embargo on publication), the steps above may be done in a private PPA prior to landing in devel-proposed.
The following additional steps also apply for the SRUs to supported releases once the packages have been accepted into the development release (if applicable):
- Once accepted in to -proposed, a test image is built from -proposed, which is subjected to the full CPC image tests; this tests for more regressions across multiple Azure instance sizes. This includes tests for the following bugs:
Pre-SRU Test Cases
These are the test cases that all walinuxagent are subjected to before even getting to SRU:
1.) Launch instance on Azure 2.) Upgrade walinuxagent (usually from PPA) 3.) Confirm that "waagent" is running, check /var/log/waagent.log for errors 4.) Reboot, repeat step 3
SRU Test Cases
These are automated tests:
1.) Build new cloud image with -proposed package 2.) Boot instance 3.) Confirm that instance provisioned 4.) Run standard tests and regression tests 5.) Repeat from step 2 for all other Azure VM Sizes.
Releasing the SRU
Since the only consumer of the walinuxagent is the Azure cloud, the SRU may be released without meeting the aging period of 7 days provided all the above steps have been completed.
SRU Template
== Begin SRU Template == [Impact] This release contains both bug-fixes and new features and we would like to make sure all of our supported customers have access to these improvements. The notable ones are: * <TODO: list any LP: # included> See the changelog entry below for a full list of changes and bugs. [Test Case] The following development and SRU process was followed: https://wiki.ubuntu.com/walinuxagentUpdates The Microsoft Azure Linux Agent team will execute their testsuite, which includes extension testing , against the walinuxagent that is in -proposed. A successful run will be required before the proposed walinuxagent can be let into -updates. The CPC team will be in charge of attaching a summary of testing to the bug. CPC team members will not mark ‘verification-done’ until this has happened. == End SRU Template == <TODO: Paste in change log entry>
walinuxagentUpdates (last edited 2019-06-05 22:02:31 by vorlon)