Foreman AzureRm Plugin

Description

foreman_azure_rm adds Microsoft Azure Resource Manager as a compute resource for The Foreman

Installation

Bundle (Gem)

Add the following to bundler.d/Gemfile.local.rb in your Foreman installation directory (/usr/share/foreman by default)

$ gem 'foreman_azure_rm'

Or simply:

$ echo "gem 'foreman_azure_rm'" > /usr/share/foreman/bundler.d/Gemfile.local.rb

Then run bundle install from the same directory

Package

# yum install tfm-rubygem-foreman_azure_rm

Foreman Installer

# foreman-installer --enable-foreman-plugin-azure

Development Setup

Clone the repo from github:

git clone https://github.com/theforeman/foreman_azure_rm.git

Add the following to bundler.d/Gemfile.local.rb in your Foreman development directory

gem 'foreman_azure_rm', :path => 'path to foreman_azure_rm directory'

Then run bundle install from the same directory

Features

  • Support for most typical IaaS operations
    • VM creation
    • Provisions using Finish and User data templates from Foreman
    • Supports cloud-config provisioning
    • Currently supports only provisioning of Linux platforms
    • Provisioning using Public Images
    • Provision using custom images
    • Provision using shared image galleries
    • Provision using RHEL byos images
    • Multiple NICs support
    • Support to add multiple data disks/volumes (standard or premium)
    • VM Extension with Custom Script and File URIs support
    • Static or dynamic addresses on a per NIC basis
  • Limited extension support
    • Microsoft's custom script extension
    • Puppet Lab's Puppet agent extension for Windows

Configuration

Go to Infrastructure > Compute Resources and click on "New Compute Resource".

Choose the Azure Resource Manager provider, and fill in all the fields. You need a Subscription ID, Tenant ID, Client ID and a Client Secret which you can generate from your Microsoft Azure subscription

That's it. You're now ready to create and manage Azure resources in your new Azure Resource Manager compute resource. You should see something like this in the Compute Resource page:

Planned Features

  • Azure Gov Cloud Support
  • Support for http_proxy

Known Limitations

  • Please note that currently username is expected to be the same on both Virtual Machine tab for Host creation and during Image creation for Compute Resource. The password field for Image creation is optional.
  • Unable to provision using Windows Images