brooklyn-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Graeme-Miller <...@git.apache.org>
Subject [GitHub] brooklyn-docs pull request #140: Add Azure Classic and ARM docs
Date Thu, 19 Jan 2017 14:58:22 GMT
Github user Graeme-Miller commented on a diff in the pull request:

    https://github.com/apache/brooklyn-docs/pull/140#discussion_r96876124
  
    --- 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 
    +setting up your credentials. In addition; several keys, not required in other locations
need to be specified in order to 
    +use the Azure Compute ARM location. These are:
    +
    +    jclouds.azurecompute.arm.publishers: OpenLogic
    +
    +The publishers is any item from the list available here: [https://docs.microsoft.com/en-us/azure/virtual-machines/virtual-machines-linux-cli-ps-findimage](https://docs.microsoft.com/en-us/azure/virtual-machines/virtual-machines-linux-cli-ps-findimage)
    +    
    +    region: southeastasia    
    +
    +The region is any region from the list available here: [https://azure.microsoft.com/en-us/regions/](https://azure.microsoft.com/en-us/regions/)
    +
    +    loginUser: brooklyn
    +    templateOptions:
    +        overrideAuthenticateSudo: true
    +        
    +The loginUser can be anything, as long as it's specified.
    --- End diff --
    
    should mention what overrideAuthenticateSudo does


---
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 infrastructure@apache.org or file a JIRA ticket
with INFRA.
---

Mime
View raw message