-
Notifications
You must be signed in to change notification settings - Fork 24
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Update README.md with azure-sdk changes
- Loading branch information
Showing
1 changed file
with
36 additions
and
8 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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) |