Github user Graeme-Miller commented on a diff in the pull request:
https://github.com/apache/brooklyn-docs/pull/140#discussion_r96904988
--- Diff: guide/ops/locations/_azure-ARM.md ---
@@ -0,0 +1,92 @@
+---
+section: Azure Compute ARM
+section_type: inline
+section_position: 2.1.1
+---
+
+### Azure Compute ARM
+
+Azure Resource Manager (ARM) is a framework for deploying and managing
applications across resources and managing groups of resources as single
logical units on the Microsoft Azure cloud computing platform.
+
+#### Setup the Azure credentials
+
+Firstly, install and configure Azure CLI following [these
steps](http://azure.microsoft.com/en-us/documentation/articles/xplat-cli/).
+
+Using the Azure CLI, run the following commands to create a service
principal
+
+ # Set mode to ARM
+ azure config mode arm
+
+ # Enter your Microsoft account credentials when prompted
+ azure login
+
+ # Set current subscription to create a service principal
+ azure account set <Subscription-id>
+
+ # Create an AAD application with your information.
+ azure ad app create --name <name> --password <Password> --home-page
<home-page> --identifier-uris <identifier-uris>
+
+ # For example: azure ad app create --name "myappname" --password abcd
--home-page "https://myappwebsite"; --identifier-uris "https://myappwebsite";
+
+ # Output will include a value for `Application Id`, which will be used
for the live tests
+
+ # Create a Service Principal
+ azure ad sp create <Application-id>
+
+ # Output will include a value for `Object Id`, to be used in the next
step
+
+
+Run the following commands to assign roles to the service principal
+
+ # Assign roles for this service principal
+ azure role assignment create --objectId <Object-id> -o Contributor -c
/subscriptions/<Subscription-id>/
+
+Look up the the tenant Id
+
+ azure account show -s <Subscription-id> --json
+
+ # output will be a JSON which will include the `Tenant id`
+
+Verify service principal
+
+ azure login -u <Application-id> -p <Password> --service-principal
--tenant <Tenant-id>
+
+#### Using the Azure ARM Location
+
+Below is an example Azure ARM location in YAML which will launch a Ubuntu
instance in south east asia:
+
+ brooklyn.catalog:
+ id: my-azure-arm-location
+ name: "My Azure ARM location"
+ itemType: location
+ item:
+ type: jclouds:azurecompute-arm
+ brooklyn.config:
+ identity: <Application-id>
+ credential: <Password>
+ endpoint:
https://management.azure.com/subscriptions/<Subscription-id>
+ oauth.endpoint:
https://login.microsoftonline.com/<Tenant-id>/oauth2/token
+
+ jclouds.azurecompute.arm.publishers: OpenLogic
+ region: southeastasia
+ loginUser: brooklyn
+ templateOptions:
+ overrideAuthenticateSudo: true
+
+Fill the values `<Application-id>`, `<Password>`, `<Subscription-id>` and
`<Tenant-id>` in from the values generated when
--- End diff --
looks like this might be specific to me. This looks good to merge
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastruct...@apache.org or file a JIRA ticket
with INFRA.
---
