Skip to content

Commit 62ae031

Browse files
ktoliverktoliver
committed
edits
1 parent 52b53fe commit 62ae031

File tree

5 files changed

+42
-36
lines changed

5 files changed

+42
-36
lines changed

‎articles/cloud-services-extended-support/deploy-portal.md

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -17,15 +17,17 @@ This article shows you how to use the Azure portal to create an Azure Cloud Serv
1717

1818
Review the [deployment prerequisites](deploy-prerequisite.md) for Cloud Services (extended support) and create the required resources.
1919

20-
## Deploy Cloud Services (extended support) in the portal
20+
## Deploy Cloud Services (extended support)
21+
22+
To deploy Cloud Services (extended support) by using the portal:
2123

2224
1. Sign in to the [Azure portal](https://portal.azure.com).
2325

2426
1. In the search bar, enter **Cloud Services (extended support)**, and then select it in the search results.
2527

2628
:::image type="content" source="media/deploy-portal-1.png" alt-text="Screenshot that shows a Cloud Services (extended support) search in the Azure portal, and selecting the result.":::
2729

28-
1. On the **Cloud Services (extended support)** services pane, select **Create**.
30+
1. On the **Cloud services (extended support)** services pane, select **Create**.
2931

3032
:::image type="content" source="media/deploy-portal-2.png" alt-text="Screenshot that shows selecting Create in the menu to create a new instance of Cloud Services (extended support).":::
3133

@@ -41,7 +43,7 @@ Review the [deployment prerequisites](deploy-prerequisite.md) for Cloud Services
4143

4244
:::image type="content" source="media/deploy-portal-3.png" alt-text="Image shows the Cloud Services (extended support) Basics tab.":::
4345

44-
1. On the **Basics** tab under **Cloud service configuration, package, and service definition**, add your package (.cspkg or .zip) file, configuration (.cscfg) file, and definition (.csdef) file for the deployment. You can add existing files from blob storage or upload the files from your local machine. If you upload the files from your local machine, the files are stored in a storage account in Azure.
46+
1. On the **Basics** tab under **Cloud service configuration, package, and service definition**, add your package (.cspkg or .zip) file, configuration (.cscfg) file, and definition (.csdef) file for the deployment. You can add existing files from blob storage or upload the files from your local machine. If you upload the files from your local machine, the files are then stored in a storage account in Azure.
4547

4648
:::image type="content" source="media/deploy-portal-4.png" alt-text="Screenshot that shows the section of the Basics tab where you upload files and select storage.":::
4749

@@ -54,13 +56,13 @@ Review the [deployment prerequisites](deploy-prerequisite.md) for Cloud Services
5456

5557
- **Public IP**: Select an existing public IP address to associate with the cloud service, or create a new one.
5658

57-
- If you have IP input endpoints defined in your service definition (.csdef) file, create a public IP address for your cloud service.
59+
- If you have IP input endpoints defined in your definition (.csdef) file, create a public IP address for your cloud service.
5860
- Cloud Services (extended support) supports only a Basic SKU public IP address.
5961
- If your configuration (.cscfg) file contains a reserved IP address, set the allocation type for the public IP address to **Static**.
60-
- (Optional). You can assign a DNS name for your cloud service endpoint by updating the DNS label property of the public IP address associated with the cloud service.
62+
- (Optional) You can assign a DNS name for your cloud service endpoint by updating the DNS label property of the public IP address that's associated with the cloud service.
6163
- (Optional) **Start cloud service**: Select the checkbox if you want to start the service immediately after it's deployed.
6264
- **Key vault**: Select a key vault.
63-
- A key vault is required when you specify one or more certificates in your configuration (.cscfg) file. When you select a key vault, we attempt to find the selected certificates that are defined in your configuration (.cscfg) file based on the certificate thumbprints. If any certificates are missing from your key vault, you can upload them, and then select **Refresh**.
65+
- A key vault is required when you specify one or more certificates in your configuration (.cscfg) file. When you select a key vault, we attempt to find the selected certificates that are defined in your configuration (.cscfg) file based on the certificate thumbprints. If any certificates are missing from your key vault, you can upload them now , and then select **Refresh**.
6466

6567
:::image type="content" source="media/deploy-portal-5.png" alt-text="Screenshot that shows the Configuration tab in the Azure portal when you create a Cloud Services (extended support) deployment.":::
6668

‎articles/cloud-services-extended-support/deploy-powershell.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -39,9 +39,9 @@ Complete the following steps as prerequisites to creating your deployment by usi
3939
$container = New-AzStorageContainer -Name “contosocontainer” -Context $storageAccount.Context -Permission Blob
4040
```
4141
42-
## Deploy Cloud Services (extended support) by using PowerShell
42+
## Deploy Cloud Services (extended support)
4343
44-
Use any of the following Azure PowerShell cmdlets to deploy Cloud Services (extended support):
44+
Use any of the following PowerShell cmdlet options to deploy Cloud Services (extended support):
4545
4646
- Quick-create a deployment by using a [storage account](#quick-create-a-deployment-by-using-a-storage-account)
4747
@@ -51,18 +51,18 @@ Use any of the following Azure PowerShell cmdlets to deploy Cloud Services (exte
5151
5252
- Quick-create a deployment by using a [shared access signature URI](#quick-create-a-deployment-by-using-an-sas-uri)
5353
54-
- This parameter set inputs the shared access signature (SAS) URI of the package (.cspkg) file with the local paths to the configuration (.cscfg) file and definition (.csdef) file. No storage account input is required.
54+
- This parameter set inputs the shared access signature (SAS) URI of the package (.cspkg or .zip) file with the local paths to the configuration (.cscfg) file and definition (.csdef) file. No storage account input is required.
5555
- The cloud service role profile, network profile, and OS profile are created by the cmdlet with minimal input.
5656
- To input a certificate, you must specify a key vault name. The certificate thumbprints in the key vault are validated against the certificates that you specify in the configuration (.cscfg) file for the deployment.
5757
5858
- Create a deployment by using a [role profile, OS profile, network profile, and extension profile with shared access signature URIs](#create-a-deployment-by-using-profile-objects-and-sas-uris)
5959
60-
- This parameter set inputs the SAS URIs of the package (.cspkg) file and configuration (.cscfg) file.
60+
- This parameter set inputs the SAS URIs of the package (.cspkg or .zip) file and configuration (.cscfg) file.
6161
- You must specify profile objects: role profile, network profile, OS profile, and extension profile. The profiles must match the values that you set in the configuration (.cscfg) file and definition (.csdef) file.
6262
6363
### Quick-create a deployment by using a storage account
6464
65-
Create a Cloud Services (extended support) deployment by using the package (.cspkg) file, configuration (.cscfg) file, and definition (.csdef) files:
65+
Create a Cloud Services (extended support) deployment by using the package (.cspkg or .zip) file, configuration (.cscfg) file, and definition (.csdef) files:
6666
6767
```azurepowershell-interactive
6868
$cspkgFilePath = "<Path to .cspkg file>"
@@ -83,7 +83,7 @@ New-AzCloudService
8383

8484
### Quick-create a deployment by using an SAS URI
8585

86-
1. Upload the package (.cspkg) file for the deployment to the storage account:
86+
1. Upload the package (.cspkg or .zip) file for the deployment to the storage account:
8787

8888
```azurepowershell-interactive
8989
$tokenStartTime = Get-Date
@@ -95,7 +95,7 @@ New-AzCloudService
9595
$csdefFilePath = "<Path to csdef file>"
9696
```
9797
98-
1. Create the Cloud Services (extended support) deployment by using the package (.cspkg) file, configuration (.cscfg) file, and definition (.csdef) file SAS URI:
98+
1. Create the Cloud Services (extended support) deployment by using the package (.cspkg or .zip) file, configuration (.cscfg) file, and definition (.csdef) file SAS URI:
9999
100100
```azurepowershell-interactive
101101
New-AzCloudService
@@ -118,7 +118,7 @@ New-AzCloudService
118118
$cscfgUrl = $cscfgBlob.ICloudBlob.Uri.AbsoluteUri + $cscfgToken
119119
```
120120
121-
1. Upload your Cloud Services (extended support) package (.cspkg) file to the storage account:
121+
1. Upload your Cloud Services (extended support) package (.cspkg or .zip) file to the storage account:
122122
123123
```azurepowershell-interactive
124124
$tokenStartTime = Get-Date
@@ -171,7 +171,7 @@ New-AzCloudService
171171
Set-AzKeyVaultAccessPolicy -VaultName 'ContosKeyVault' -ResourceGroupName 'ContosOrg' -ObjectId 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx' -PermissionsToCertificates create,get,list,delete
172172
```
173173
174-
1. Th following example adds a self-signed certificate to a key vault. You must add the certificate thumbprint via the configuration (.cscfg) file for Cloud Services (extended support) roles.
174+
1. The following example adds a self-signed certificate to a key vault. You must add the certificate thumbprint via the configuration (.cscfg) file for Cloud Services (extended support) roles.
175175
176176
```azurepowershell-interactive
177177
$Policy = New-AzKeyVaultCertificatePolicy -SecretContentType "application/x-pkcs12" -SubjectName "CN=contoso.com" -IssuerName "Self" -ValidityInMonths 6 -ReuseKeyOnRenewal
@@ -187,7 +187,7 @@ New-AzCloudService
187187
$osProfile = @{secret = @($secretGroup)}
188188
```
189189
190-
1. Create a role profile in-memory object. A role profile defines a role SKU-specific properties such as name, capacity, and tier. In this example, two roles are defined: frontendRole and backendRole. Role profile information must match the role configuration that's defined in the deployment configuration (.cscfg) file and definition (.csdef) file.
190+
1. Create a role profile in-memory object. A role profile defines a role's SKU-specific properties such as name, capacity, and tier. In this example, two roles are defined: frontendRole and backendRole. Role profile information must match the role configuration that's defined in the deployment configuration (.cscfg) file and definition (.csdef) file.
191191
192192
```azurepowershell-interactive
193193
$frontendRole = New-AzCloudServiceRoleProfilePropertiesObject -Name 'ContosoFrontend' -SkuName 'Standard_D1_v2' -SkuTier 'Standard' -SkuCapacity 2

‎articles/cloud-services-extended-support/deploy-sdk.md

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -14,11 +14,13 @@ ms.custom: devx-track-azurepowershell
1414

1515
This article shows how to use the [Azure SDK](https://azure.microsoft.com/downloads/) to create an Azure Cloud Services (extended support) deployment that has multiple roles (WebRole and WorkerRole) and the Remote Desktop Protocol (RDP) extension. Cloud Services (extended support) is a deployment model of Azure Cloud Services that's based on Azure Resource Manager.
1616

17-
## Before you begin
17+
## Prerequisites
1818

1919
Review the [deployment prerequisites](deploy-prerequisite.md) for Cloud Services (extended support) and create the required resources.
2020

21-
## Deploy Cloud Services (extended support) by using the SDK
21+
## Deploy Cloud Services (extended support)
22+
23+
To deploy Cloud Services (extended support) by using the SDK:
2224

2325
1. Install the [Azure Compute SDK NuGet package](https://www.nuget.org/packages/Microsoft.Azure.Management.Compute/43.0.0-preview) and initialize the client by using a standard authentication method:
2426

@@ -67,7 +69,7 @@ Review the [deployment prerequisites](deploy-prerequisite.md) for Cloud Services
6769
resourceGroup = await resourceGroups.CreateOrUpdateAsync(resourceGroupName, resourceGroup);
6870
```
6971

70-
1. Create a storage account and container where you'll store the package (.cspkg) file and configuration (.cscfg) file for the deployment. Install the [Azure Storage NuGet package](https://www.nuget.org/packages/Azure.Storage.Common/). This step is optional if you're using an existing storage account. The storage account name must be unique.
72+
1. Create a storage account and container where you'll store the package (.cspkg or .zip) file and configuration (.cscfg) file for the deployment. Install the [Azure Storage NuGet package](https://www.nuget.org/packages/Azure.Storage.Common/). This step is optional if you're using an existing storage account. The storage account name must be unique.
7173

7274
```csharp
7375
string storageAccountName = “ContosoSAS”
@@ -208,13 +210,13 @@ Review the [deployment prerequisites](deploy-prerequisite.md) for Cloud Services
208210
New-AzKeyVault -Name "ContosKeyVault” -ResourceGroupName “ContosoOrg” -Location “East US”
209211
```
210212

211-
1. Update the key vault's access policy and grant certificate permissions to your user account.
213+
1. Update the key vault's access policy and grant certificate permissions to your user account:
212214

213215
```powershell
214216
Set-AzKeyVaultAccessPolicy -VaultName 'ContosKeyVault' -ResourceGroupName 'ContosoOrg' -UserPrincipalName '[email protected]' -PermissionsToCertificates create,get,list,delete
215217
```
216218

217-
Alternatively, set the access policy via object ID (which you can get by running `Get-AzADUser`).
219+
Alternatively, set the access policy via object ID (which you can get by running `Get-AzADUser`):
218220

219221
```powershell
220222
Set-AzKeyVaultAccessPolicy -VaultName 'ContosKeyVault' -ResourceGroupName 'ContosOrg' -ObjectId 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx' -PermissionsToCertificates create,get,list,delete

‎articles/cloud-services-extended-support/deploy-template.md

Lines changed: 12 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -27,12 +27,14 @@ Complete the following steps as prerequisites to creating your deployment by usi
2727

2828
1. (Optional) Create a key vault and upload the certificates.
2929

30-
- You can attach certificates to your deployment for secure communication to and from the service. If you use certificate, the certificate thumbprints must be specified in your configuration (.cscfg) file and be uploaded to a key vault. You can create a key vault by using the [Azure portal](../key-vault/general/quick-create-portal.md) or [Azure PowerShell](../key-vault/general/quick-create-powershell.md).
31-
- The associated key vault must be located in the same region and subscription as your Cloud Services (extended support) deployment.
32-
- The associated key vault must have the relevant permissions so that Cloud Services (extended support) resources can retrieve certificates from the key vault. For more information, see [Use certificates with Cloud Services (extended support](certificates-and-key-vault.md).
30+
- You can attach certificates to your deployment for secure communication to and from the service. If you use certificates, the certificate thumbprints must be specified in your configuration (.cscfg) file and be uploaded to a key vault. You can create a key vault by using the [Azure portal](../key-vault/general/quick-create-portal.md) or [Azure PowerShell](../key-vault/general/quick-create-powershell.md).
31+
- The associated key vault must be in the same region and subscription as your Cloud Services (extended support) deployment.
32+
- The associated key vault must have the relevant permissions so that Cloud Services (extended support) resources can retrieve certificates from the key vault. For more information, see [Use certificates with Cloud Services (extended support)](certificates-and-key-vault.md).
3333
- The key vault must be referenced in the `osProfile` section of the ARM template as shown in a later step.
3434

35-
## Deploy Cloud Services (extended support) by using a template
35+
## Deploy Cloud Services (extended support)
36+
37+
To deploy Cloud Services (extended support) by using a template:
3638

3739
> [!NOTE]
3840
> An easier and faster way to generate your ARM template and parameter file is by using the [Azure portal](https://portal.azure.com). You can [download the generated ARM template](generate-template-portal.md) in the portal to create your Cloud Services (extended support) via Azure PowerShell.
@@ -73,7 +75,7 @@ Complete the following steps as prerequisites to creating your deployment by usi
7375
]
7476
```
7577

76-
1. Create a public IP address and (optionally) set the DNS label property of the public IP address. If you use a static IP address, you must reference it as a reserved IP address in the configuration (.cscfg) file. If you use an existing IP address, skip this step and add the IP address information directly in the load balancer configuration settings of your ARM template.
78+
1. Create a public IP address and (optionally) set the DNS label property of the public IP address. If you use a static IP address, you must reference it as a reserved IP address in the configuration (.cscfg) file. If you use an existing IP address, skip this step and add the IP address information directly in the load balancer configuration settings in your ARM template.
7779

7880
```json
7981
"resources": [
@@ -208,11 +210,11 @@ Complete the following steps as prerequisites to creating your deployment by usi
208210
> [!NOTE]
209211
> The password for RDP must from 8 to 123 characters and must satisfy at least *three* of the following password-complexity requirements:
210212
>
211-
> Contains an uppercase character.
212-
> Contains a lowercase character.
213-
> Contains a numeric digit.
214-
> Contains a special character.
215-
> Cannot contain a control character.
213+
> Contains an uppercase character.
214+
> Contains a lowercase character.
215+
> Contains a numeric digit.
216+
> Contains a special character.
217+
> Cannot contain a control character.
216218

217219
```json
218220
"extensionProfile": {

‎articles/cloud-services-extended-support/toc.yml

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -13,15 +13,15 @@ items:
1313
href: faq.yml
1414
- name: Quickstarts
1515
items:
16-
- name: Deploy Cloud Services (extended support) - Portal
16+
- name: Deploy the cloud service - Portal
1717
href: deploy-portal.md
18-
- name: Deploy Cloud Services (extended support) - PowerShell
18+
- name: Deploy the cloud service - PowerShell
1919
href: deploy-powershell.md
20-
- name: Deploy Cloud Services (extended support) - ARM template
20+
- name: Deploy the cloud service - ARM template
2121
href: deploy-template.md
22-
- name: Deploy Cloud Services (extended support) - SDK
22+
- name: Deploy the cloud service - SDK
2323
href: deploy-sdk.md
24-
- name: Deploy Cloud Services (extended support) - Visual Studio
24+
- name: Deploy the cloud service - Visual Studio
2525
href: /visualstudio/azure/cloud-services-extended-support?context=%2fazure%2fcloud-services-extended-support%2fcontext%2fcontext
2626
expanded: true
2727
- name: Concepts

0 commit comments

Comments
 (0)