Skip to content

Commit

Permalink
Update README.md with azure-sdk changes
Browse files Browse the repository at this point in the history
  • Loading branch information
apuntamb committed Aug 20, 2019
1 parent 590fb36 commit 29dfc9e
Showing 1 changed file with 36 additions and 8 deletions.
44 changes: 36 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,23 +1,51 @@
# Foreman Azure
# Foreman AzureRM Plugin

## Description
Plugin to add [Microsoft Azure Resource Manager](http://azure.com/) as a compute resource for [The Foreman](http://theforeman.org/)
```foreman_azure_rm``` adds [Microsoft Azure Resource Manager](http://azure.com/) as a compute resource for The Foreman

* Website: [TheForeman.org](http://theforeman.org)
* Support: [Foreman support](http://theforeman.org/support.html)

## Features
* Managed disks support
* Support for most typical IaaS operations
* VM creation
* Multiple NICs
* Multiple data disks, premium or not
* Provisions using Finish and User data templates from Foreman
* Supports cloud-config provisioning
* Currently supports single NIC
* Currently supports single default OS Disk
* Currently supports only provisioning of Linux platforms
* Provisioning using [Public Images](https://docs.microsoft.com/en-us/azure/virtual-machines/linux/cli-ps-findimage)
* 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 **AzureRM 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](https://docs.bmc.com/docs/cloudlifecyclemanagement/46/setting-up-a-tenant-id-client-id-and-client-secret-for-azure-resource-manager-provisioning-669202145.html#SettingupaTenantID,ClientID,andClientSecretforAzureResourceManagerprovisioning-SetupTenantIDPrereqPrerequisites)

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


![](https://i.imgur.com/9J7tPJa.png)


![](https://i.imgur.com/eFHucdb.png)


![](https://i.imgur.com/RTBlMeE.png)


## Planned Features
* Multiple NICs support
* Support to add multiple data disks (standard or premium)
* Provision using custom images
* Provision using shared image galleries
* Improved extension support

## Known Limitations
* Most Azure marketplace images (likely all of them) disallow direct root login, which means SSH provisioning
with The Foreman has limited functionality. A workaround is to provide a dummy user data template and do all
post-provisioning with the custom script extension
* Unable to provision using Windows Images

## Links
* [Issue tracker](https://projects.theforeman.org/projects/azurerm)

0 comments on commit 29dfc9e

Please sign in to comment.