You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@brooklyn.apache.org by dr...@apache.org on 2017/09/20 14:13:34 UTC

[1/2] brooklyn-docs git commit: Update Azure ARM documentation for Azure CLI 2.0

Repository: brooklyn-docs
Updated Branches:
  refs/heads/master 4ba464b0f -> e7fc7ec2b


Update Azure ARM documentation for Azure CLI 2.0

The existing instructions are for Azure CLI 1.0. Searching for "Azure CLI" returns hits for 2.0 so it's likely our users will end up with CLI 2.0.

Project: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/commit/1c7406a5
Tree: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/tree/1c7406a5
Diff: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/diff/1c7406a5

Branch: refs/heads/master
Commit: 1c7406a5e32b833cfa70b897dba430b5e319fb3b
Parents: 4ba464b
Author: Richard Downer <ri...@apache.org>
Authored: Wed Sep 20 14:13:18 2017 +0100
Committer: GitHub <no...@github.com>
Committed: Wed Sep 20 14:13:18 2017 +0100

----------------------------------------------------------------------
 guide/locations/_azure-ARM.md | 73 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 73 insertions(+)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/brooklyn-docs/blob/1c7406a5/guide/locations/_azure-ARM.md
----------------------------------------------------------------------
diff --git a/guide/locations/_azure-ARM.md b/guide/locations/_azure-ARM.md
index 9c3f193..3fced19 100644
--- a/guide/locations/_azure-ARM.md
+++ b/guide/locations/_azure-ARM.md
@@ -10,6 +10,79 @@ Azure Resource Manager (ARM) is a framework for deploying and managing applicati
 
 #### Setup the Azure credentials
 
+##### Azure CLI 2.0
+
+Firstly, install and configure Azure CLI following [these steps](https://docs.microsoft.com/en-us/cli/azure/install-azure-cli?view=azure-cli-latest).
+
+You will need to obtain your *subscription ID* and *tenant ID* from Azure. To do this using the CLI, first, log in:
+
+    az login
+
+Or, if you are already logged in, request an account listing:
+
+    az account list
+
+In either case, this will return a subscription listing, similar to that shown below.
+
+    [
+      {
+        "cloudName": "AzureCloud",
+        "id": "012e832d-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
+        "isDefault": true,
+        "name": "QA Team",
+        "state": "Enabled",
+        "tenantId": "ba85e8cd-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
+        "user": {
+          "name": "qa@example.com",
+          "type": "user"
+        }
+      },
+      {
+        "cloudName": "AzureCloud",
+        "id": "341751b0-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
+        "isDefault": false,
+        "name": "Developer Team",
+        "state": "Enabled",
+        "tenantId": "ba85e8cd-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
+        "user": {
+          "name": "dev@example.com",
+          "type": "user"
+        }
+      }
+    ]
+
+Choose one of the subscriptions and make a note of its *id* - henceforth the subscription ID - and the *tenantId*.
+
+Next we need to create an *application* and a *service principle*, and grant permissions to the service principle. Use these commands:
+
+    # Create an AAD application with your information.
+    az ad app create --display-name <name> --password <Password> --homepage <home-page> --identifier-uris <identifier-uris>
+    
+    # For example: az ad app create --display-name "myappname"  --password abcd --homepage "https://myappwebsite" --identifier-uris "https://myappwebsite"
+
+Take a note of the *appId* shown.
+
+    # Create a Service Principal
+    az ad sp create --id <Application-id>
+
+Take a note of the *objectId* shown - this will be the service principal object ID. (Note that any of the *servicePrincipalNames* can also be used in place of the object ID.)
+
+    # Assign roles for this service principal. The "principal" can be the "objectId" or any one of the "servicePrincipalNames" from the previous step
+    az role assignment create --assignee <Service-Principal> --role Contributor --scope /subscriptions/<Subscription-ID>/
+
+By this stage you should have the following information:
+
+* A subscription ID
+* A tenant ID
+* An application ID
+* A service principle (either by its object ID, or by any one of its names)
+
+We can now verify this information that this information can be used to log in to Azure:
+
+    az login --service-principal -u <Application-ID> --password abcd --tenant <Tenant-ID>
+
+##### Azure CLI 1.0
+
 Firstly, install and configure Azure CLI following [these steps](https://docs.microsoft.com/en-us/azure/cli-install-nodejs).
 
 Using the Azure CLI, run the following commands to create a service principal


[2/2] brooklyn-docs git commit: This closes #215

Posted by dr...@apache.org.
This closes #215


Project: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/commit/e7fc7ec2
Tree: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/tree/e7fc7ec2
Diff: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/diff/e7fc7ec2

Branch: refs/heads/master
Commit: e7fc7ec2b5c3fea33f57a8e34bdf9bb982a85ace
Parents: 4ba464b 1c7406a
Author: Duncan Godwin <dr...@googlemail.com>
Authored: Wed Sep 20 15:13:12 2017 +0100
Committer: Duncan Godwin <dr...@googlemail.com>
Committed: Wed Sep 20 15:13:12 2017 +0100

----------------------------------------------------------------------
 guide/locations/_azure-ARM.md | 73 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 73 insertions(+)
----------------------------------------------------------------------