walinuxagentUpdates

Differences between revisions 1 and 10 (spanning 9 versions)
⇤ ← Revision 1 as of 2016-11-09 11:47:42 →
Size: 1445
Editor: localhost
Comment:
← Revision 10 as of 2016-11-09 12:59:31 → ⇥
Size: 2078
Editor: oddbloke
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
* Configuring SSH authentication types
* Deployment of SSH public keys and key pairs
* Setting the host name
* Publishing the host name to the platform DNS
* Reporting SSH host key fingerprint to the platform
* Resource Disk Management
* Formatting and mounting the resource disk
* Configuring swap space		 It provides the following functionality for Ubuntu cloud image deployments:
Line 17: Line 9:
'''Networking'''  * Image Provisioning.
 * Networking setup.
 * Kernel setup.
 * Diagnostics setup.
 * SCVMM Deployments
 * VM Extensions Management
Line 19: Line 16:
* Manages routes to improve compatibility with platform DHCP servers
* Ensures the stability of the network interface name		 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 22: Line 18:
'''Kernel''' == QA Process ==
Line 24: Line 20:
* 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)		 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:
  * ...
Line 28: Line 28:
'''Diagnostics''' == SRU Test Cases ==
Line 30: Line 30:
* Console redirection to the serial port These are the test cases that all walinuxagent SRUs are subjected to:
Line 32: Line 32:
'''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		 {{{
[Test case 1]: Upgrade testing
1.) Launch instance on Azure
2.) Upgrade walinuxagent from -proposed
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 from -proposed
2.) Boot instance
3.) Confirm that instance provisioned
}}}

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

QA 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:
    • ...

SRU Test Cases

These are the test cases that all walinuxagent SRUs are subjected to: 

[Test case 1]: Upgrade testing
1.) Launch instance on Azure
2.) Upgrade walinuxagent from -proposed
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 from -proposed
2.) Boot instance
3.) Confirm that instance provisioned

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