Find file History
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
..
Failed to load latest commit information.
Artifactfile.json
README.md
linux-yum-package.sh

README.md

Linux YUM Package Manager Artifact

This Azure DevTest artifact allows the user to specify packages to install onto their Azure DevTest Lab VM via the YUM package system. This artifact applies to any Linux distribution that is by default managed by the RPM/YUM system (Red Hat, CentOS, and other Red Hat Linux derivatives).

Usage

The script is intended for use in the Azure DevTest Labs artifact system, and the parameters for the artifact are fed directly into the script. However, you can run it from any bash shell using the following format:

    bash> .\linux-yum-package.sh --update (false|true) --packages pkg1 pkg2 pkg3 pkg4 --options *[YUM options for install command]*  

Where:

update

Defaults to false, the 'update' command will be issued before the install command (and optional arguments) are run. For more detailed control over update arguments, the user will have to specify their own bash script and run that using the linux-bash artifact.

packages

The names of the packages to install, separated by spaces. Each package declaration follows the allowable declarations in YUM install. For example, all the following would work:

    pkgnm pkgnm-ver pkgnm-ver-rel.arch -pkgnm @groupnm ^@envgroupname

options

Any other valid arguments that the YUM install command accepts. Since these additional parameters allow for relatively infinite permutations they will likely be susceptible to failure on the images supplied by the Azure DevTest Labs. Advanced users who wish to push the limiatations of the extra options parameter will potentially have to experiment with certain switches to see if they work (and correct the state of the VM using the linux-bash artifact ahead of time if necessary).

Note (1): --assumeyes and --quiet are passed to both the update and install command by default (and cannot be changed).

Note (2): Each comand line parameter has the pattern '--command values' so we can parse the required spaces. As such, there may be some unforeseen limitations where double-spaces will be reduced to a single space, and other edge cases that might arise due to its use. If there is a specific use case that doesn't work within this limitation, there is the linux-bash DevTest artifact that will satisfy your needs.

Notes on YUM

Note that YUM as a utility is an incredibly flexible and powerful tool. To support the use cases of the more advanced users of our Linux DevTest Lab VMs, a reasonable effort has been made to support the nuance of the 'install' command. However, due to the vast number of permutations and combinations that the command can be used to manipulate the state of a machine, we recommend that for the most advanced of users with specific needs use the linux-bash artifact to satisfy their specific needs.

See linux manpages for YUM (man7) for further information.


Tested on images:

  • CentOS 6.5
  • CentOS 6.7
  • RHEL 7.2
  • RHEL 6.7

Working, but problems (with workarounds) exist:

  • CentOS 6.6 - Works without update.
  • CentOS 7.0 - Works without update.
  • CentOS 7.1 - Works without update.
  • CentOS 7.2 - Works without update.