walinuxagentUpdates

Differences between revisions 2 and 15 (spanning 13 versions)
⇤ ← Revision 2 as of 2016-11-09 11:49:15 →
Size: 1469
Editor: localhost
Comment:
← Revision 15 as of 2016-11-10 10:00:29 → ⇥
Size: 2758
Editor: localhost
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
= walinuxagentUpdates = = walinuxagent Updates =
Line 3: Line 3:
Package walinuxagent is an ubuntu distribution of upstream Microsoft Azure Linux Agent that manages Linux provisioning, and VM interaction with the Azure Fabric Controller. It provides the following functionality for Linux and FreeBSD IaaS deployments: This document describes the process to update and test new versions of the walinuxagent package in SRUs.
Line 5: Line 5:
'''Image Provisioning''' 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.
Line 7: Line 7:
* Creation of a user account It provides the following functionality for Ubuntu cloud image deployments:
Line 9: Line 9:
* Configuring SSH authentication types  * Image Provisioning.
 * Networking setup.
 * Kernel setup.
 * Diagnostics setup.
 * SCVMM Deployments
 * VM Extensions Management
Line 11: Line 16:
* Deployment of SSH public keys and key pairs 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 13: Line 18:
* Setting the host name == SRU Verification Process ==
Line 15: Line 20:
* Publishing the host name to the platform DNS This is the QA process that proposed walinuxagent packages are subjected to:
 * The new package candidate version is built in a PPA and tested on the target suite before being uploaded to the archive at all. This will involve one or both of:
  * Installing the PPA packages on an Azure VM, manually restoring the VM to a first boot state and rebooting it,
  * Generating a fresh image with the PPA package version preinstalled and testing that directly
 * Once the manual packaging tests pass successfully and the package requires no further changes, it will be uploaded to the archive.
 * 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]]
Line 17: Line 30:
* Reporting SSH host key fingerprint to the platform == Pre-SRU Test Cases ==
Line 19: Line 32:
* Resource Disk Management These are the test cases that all walinuxagent are subjected to before even getting to SRU:
Line 21: Line 34:
* Formatting and mounting the resource disk {{{
[Test case 1]: Upgrade testing
1.) Launch instance on Azure
2.) Upgrade walinuxagent usually from PPA
3.) Confirm that "waagent" is running, check /var/log/waagent.log
4.) Reboot, repeat step 3
5.) Capture instance and provision new instances; repeat step 3
  
[Test Case 2]: New instance
1.) Build new cloud image with PPA package
2.) Boot instance
3.) Confirm that instance provisioned
}}}
Line 23: Line 48:
* Configuring swap space == SRU Test Cases ==
Line 25: Line 50:
'''Networking'''

* Manages routes to improve compatibility with platform DHCP servers

* Ensures the stability of the network interface name

'''Kernel'''

* Configure virtual NUMA (disable for kernel <2.6.37)

* Consume Hyper-V entropy for /dev/random

* Configure SCSI timeouts for the root device (which could be remote)

'''Diagnostics'''

* Console redirection to the serial port

'''SCVMM Deployments'''

* Detect and bootstrap the VMM agent for Linux when running in a System Center Virtual Machine Manager 2012R2 environment

'''VM Extension'''

* Inject component authored by Microsoft and Partners into Linux VM (IaaS) to enable software and configuration automation

* VM Extension reference implementation on https://github.com/Azure/azure-linux-extensions		 These are automated tests:
{{{
1.) Build new cloud image with -purposed 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.
}}}

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.

It provides the following functionality for Ubuntu cloud image deployments:

  • Image Provisioning.
  • Networking setup.
  • Kernel setup.
  • Diagnostics setup.
  • SCVMM Deployments
  • VM Extensions Management

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

SRU Verification Process

This is the QA process that proposed walinuxagent packages are subjected to:

  • The new package candidate version is built in a PPA and tested on the target suite before being uploaded to the archive at all. This will involve one or both of:
    • Installing the PPA packages on an Azure VM, manually restoring the VM to a first boot state and rebooting it,
    • Generating a fresh image with the PPA package version preinstalled and testing that directly
  • Once the manual packaging tests pass successfully and the package requires no further changes, it will be uploaded to the archive.
  • 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: 

[Test case 1]: Upgrade testing
1.) Launch instance on Azure
2.) Upgrade walinuxagent usually from PPA
3.) Confirm that "waagent" is running, check /var/log/waagent.log
4.) Reboot, repeat step 3
5.) Capture instance and provision new instances; repeat step 3
  
[Test Case 2]: New instance
1.) Build new cloud image with PPA package
2.) Boot instance
3.) Confirm that instance provisioned

SRU Test Cases

These are automated tests: 

1.) Build new cloud image with -purposed 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.

walinuxagentUpdates (last edited 2019-06-05 22:02:31 by vorlon)