This repository has been archived by the owner on Aug 4, 2018. It is now read-only.
forked from cloudfoundry/docs-bosh
-
Notifications
You must be signed in to change notification settings - Fork 1
/
azure-resources.html.md.erb
271 lines (217 loc) · 12.4 KB
/
azure-resources.html.md.erb
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
---
title: Creating Azure Resources
---
## <a id="subscription"></a> Subscription
To find out subscription and tenant ID use following commands:
<p class="note">Note: All azure commands were tested with the azure-cli v[0.10.11] on Ubuntu 14.04. The azure commands may vary based on your version and OS.</p>
<pre class="terminal">
$ azure config mode arm
$ azure login --environment AzureCloud
$ azure account list --json
[
{
"id": "3c39a033-c306-4615-a4cb-260418d63879",
"name": "subscription-name",
"user": { "name": "Sample Account", "type": "user" },
"tenantId": "0412d4fa-43d2-414b-b392-25d5ca46561da",
"state": "Enabled",
"isDefault": true,
"registeredProviders": [],
"environmentName": "AzureCloud"
}
]
</pre>
<p class="note">
Note:
If `tenantId` is not present, you may be using a personal account to log in to your Azure subscription. Switch to using work or school account.
If you are using Azure cloud in China, you should switch the environment from `AzureCloud` to `AzureChinaCloud`.
If you are using Azure cloud in Azure Government, you should switch the environment from `AzureCloud` to `AzureUSGovernment`.
</p>
Once you've determined your subscription ID, switch to using that account:
<pre class="terminal">
$ azure account set 3c39a033-c306-4615-a4cb-260418d63879
</pre>
Register the required providers:
<pre class="terminal">
$ azure provider register Microsoft.Network
$ azure provider register Microsoft.Storage
$ azure provider register Microsoft.Compute
</pre>
---
## <a id="client"></a> Client
Azure CPI needs client ID and secret to make authenticated requests.
<pre class="terminal extra-wide">
$ azure ad app create --name "BOSH CPI" --password client-secret --identifier-uris "http://BOSHAzureCPI" --home-page "http://BOSHAzureCPI"
info: Executing command ad app create
+ Creating application Service Principal for BOSH
data: Application Id: 33e56099-0bde-8z93-a005-89c0f6df7465
data: Application Object Id: a4f0d442-af80-4d98-9cba-6bf1459ad1ea
data: Application Permissions:
data: claimValue: user_impersonation
data: description: Allow the application to access Service Principal for BOSH on behalf of the signed-in user.
data: directAccessGrantTypes:
data: displayName: Access Service Principal for BOSH
data: impersonationAccessGrantTypes: impersonated=User, impersonator=Application
data: isDisabled:
data: origin: Application
data: permissionId: 1a1eb6d1-26ca-47de-abdb-365f54560e55
data: resourceScopeType: Personal
data: userConsentDescription: Allow the applicationto access Service Principal for BOSH on your behalf.
data: userConsentDisplayName: Access Service Principal for BOSH
data: lang:
info: ad app create command OK
</pre>
Application ID (`33e56099-0bde-8z93-a005-89c0f6df7465` in the above output) is the client ID and specified password (`client-secret` in above example) is the client secret.
Finally create service principal to enable authenticated access:
<pre class="terminal">
$ azure ad sp create service_principal --applicationId 33e56099-0bde-8z93-a005-89c0f6df7465
$ azure role assignment create --roleName "Contributor" --spn "http://BOSHAzureCPI" --subscription 3c39a033-c306-4615-a4cb-260418d63879
</pre>
---
## <a id="res-group"></a> Resource Group
Create a resource group in one of the supported [Azure locations](http://azure.microsoft.com/en-us/regions/):
<pre class="terminal">
$ azure group create --name bosh-res-group --location "Central US"
$ azure group show --name bosh-res-group
info: Executing command group show
+ Listing resource groups
+ Listing resources for the group
data: Id: /subscriptions/3c39a033-c306-4615-a4cb-260418d63879/resourceGroups/bosh-res-group
data: Name: bosh-res-group
data: Location: eastasia
data: Provisioning State: Succeeded
data: Tags: null
data: Resources: []
data: Permissions:
data: Actions: *
data: NotActions: Microsoft.Authorization/*/Write,Microsoft.Authorization/*/Delete
data:
info: group show command OK
</pre>
Make sure to wait for 'Provisioning State' to become `Succeeded`.
---
## <a id="virtual-network"></a> Virtual Network & Subnet
Create a virtual network:
<pre class="terminal extra-wide">
$ azure network vnet create --name boshnet --address-prefixes 10.0.0.0/8 --resource-group bosh-res-group --location "Central US" --dns-server 168.64.129.16
$ azure network vnet subnet create --name bosh --address-prefix 10.0.0.0/24 --vnet-name boshnet --resource-group bosh-res-group
$ azure network vnet show --name boshnet --resource-group bosh-res-group
info: Executing command network vnet show
+ Looking up virtual network "boshvnet-crp"
data: Id : /subscriptions/3c39a033-c306-4615-a4cb-260418d63879/resourceGroups/bosh-res-group/providers/Microsoft.Network/virtualNetworks/boshvnet-crp
data: Name : boshvnet-crp
data: Type : Microsoft.Network/virtualNetworks
data: Location : eastasia
data: ProvisioningState : Succeeded
data: Address prefixes:
data: 10.0.0.0/8
data: Subnets:
data: Name : BOSH
data: Address prefix : 10.0.0.0/20
data:
data: Name : CloudFoundry
data: Address prefix : 10.0.16.0/20
data:
info: network vnet show command OK
</pre>
---
## <a id="network-security-group"></a> Network Security Group
Create two network security groups:
<pre class="terminal extra-wide">
$ azure network nsg create --resource-group bosh-res-group --location "Central US" --name nsg-bosh
$ azure network nsg create --resource-group bosh-res-group --location "Central US" --name nsg-cf
$ azure network nsg rule create --resource-group bosh-res-group --nsg-name nsg-bosh --access Allow --protocol Tcp --direction Inbound --priority 200 --source-address-prefix Internet --source-port-range '*' --destination-address-prefix '*' --name 'ssh' --destination-port-range 22
$ azure network nsg rule create --resource-group bosh-res-group --nsg-name nsg-bosh --access Allow --protocol Tcp --direction Inbound --priority 201 --source-address-prefix Internet --source-port-range '*' --destination-address-prefix '*' --name 'bosh-agent' --destination-port-range 6868
$ azure network nsg rule create --resource-group bosh-res-group --nsg-name nsg-bosh --access Allow --protocol Tcp --direction Inbound --priority 202 --source-address-prefix Internet --source-port-range '*' --destination-address-prefix '*' --name 'bosh-director' --destination-port-range 25555
$ azure network nsg rule create --resource-group bosh-res-group --nsg-name nsg-bosh --access Allow --protocol '*' --direction Inbound --priority 203 --source-address-prefix Internet --source-port-range '*' --destination-address-prefix '*' --name 'dns' --destination-port-range 53
$ azure network nsg rule create --resource-group bosh-res-group --nsg-name nsg-cf --access Allow --protocol Tcp --direction Inbound --priority 201 --source-address-prefix Internet --source-port-range '*' --destination-address-prefix '*' --name 'cf-https' --destination-port-range 443
$ azure network nsg rule create --resource-group bosh-res-group --nsg-name nsg-cf --access Allow --protocol Tcp --direction Inbound --priority 202 --source-address-prefix Internet --source-port-range '*' --destination-address-prefix '*' --name 'cf-log' --destination-port-range 4443
</pre>
---
## <a id="public-ips"></a> Public IPs
To make certain VMs publicly accessible, you will need to create a Public IP:
<pre class="terminal extra-wide">
$ azure network public-ip create --name my-public-ip --allocation-method Static --resource-group bosh-res-group --location "Central US"
$ azure network public-ip show --name my-public-ip --resource-group bosh-res-group
info: Executing command network public-ip show
+ Looking up the public ip "my-public-ip"
data: Id : /subscriptions/3c39a033-c306-4615-a4cb-260418d63879/resourceGroups/bosh-res-group/providers/Microsoft.Network/publicIPAddresses/my-public-ip
data: Name : my-public-ip
data: Type : Microsoft.Network/publicIPAddresses
data: Location : eastasia
data: Provisioning state : Succeeded
data: Allocation method : Static
data: Idle timeout : 4
data: IP Address : 23.99.103.110
info: network public-ip show command OK
</pre>
<p class="note">
Note:
You can skip below section if you are using managed disks with Azure CPI v21+
</p>
---
## <a id="storage-account"></a> Storage Account
Create a default storage account to hold root disks, persistent disks, stemcells, etc.
If unsure of desired SKU Name, choose `LRS`, desired Kind, choose `Storage`:
<pre class="terminal">
$ azure storage account create boshstore --resource-group bosh-res-group --location "Central US"
$ azure storage account show boshstore --resource-group bosh-res-group
+ Getting storage account
data: Name: boshstore
data: Url: /subscriptions/3c39a033-c306-4615-a4cb-260418d63879/resourceGroups/bosh-res-group/providers/Microsoft.Storage/storageAccounts/boshstore
data: Type: Standard_GRS
data: Resource Group: bosh-res-group
data: Location: East Asia
data: Provisioning State: Succeeded
data: Primary Location: East Asia
data: Primary Status: available
data: Secondary Location: Southeast Asia
data: Creation Time: 2015-11-02T05:35:27.0572370Z
data: Primary Endpoints: blob https://boshstore.blob.core.windows.net/
data: Primary Endpoints: queue https://boshstore.queue.core.windows.net/
data: Primary Endpoints: table https://boshstore.table.core.windows.net/
info: storage account show command OK
</pre>
<p class="note">Note: Even if create command returns an error, check whether the storage account is created successfully via `storage account show` command.</a>
Once storage account is created you can retrieve primary storage access key:
<pre class="terminal">
$ azure storage account keys list boshstore --resource-group bosh-res-group
info: Executing command storage account keys list
Resource group name: bosh-res-group
+ Getting storage account keys
data: Primary: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
data: Secondary: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
info: storage account keys list command OK
</pre>
---
### <a id="storage-account-container"></a> Storage Account Containers
CPI expects to find `bosh` and `stemcell` containers within a default storage account:
- `bosh` container is used for storing root and persistent disks.
- `stemcell` container is used for storing uploaded stemcells.
<p class="note">Note: If you are planning to use multiple storage accounts, make sure to set stemcell container permissions to "Public read access for blobs only".</a>
<pre class="terminal">
$ azure storage container create --container bosh --account-name boshstore --account-key xxx
$ azure storage container create --container stemcell --account-name boshstore --account-key xxx --permission Blob
$ azure storage container list --account-name boshstore --account-key xxx
info: Executing command storage container list
+ Getting storage containers
data: Name Public-Access Last-Modified
data: -------- ------------- -----------------------------
data: bosh Off Mon, 02 Nov 2015 01:52:33 GMT
data: stemcell Blob Mon, 02 Nov 2015 02:02:59 GMT
info: storage container list command OK
</pre>
---
### <a id="storage-account-tables"></a> Storage Account Tables
To support multiple storage accounts, you need to create the following tables in the default storage account:
- `stemcells` is used to store metadata of stemcells in multiple storage accounts
<pre class="terminal">
$ azure storage table create --table stemcells --account-name boshstore --account-key xxx
$ azure storage table list --account-name boshstore --account-key xxx
info: Executing command storage table list
+ Getting storage tables
data: Name
data: ---------
data: stemcells
info: storage table list command OK
</pre>