You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
# Available sizes for Azure Cloud Services (extended support)
@@ -32,7 +32,7 @@ This article describes the available virtual machine sizes for Cloud Services (e
32
32
33
33
## Configure sizes for Cloud Services (extended support)
34
34
35
-
You can specify the virtual machine size of a role instance as part of the service model in the service definition file. The size of the role determines the number of CPU cores, memory capacity and the local file system size.
35
+
You can specify the virtual machine size of a role instance as part of the service model in the service definition file. The size of the role determines the number of CPU cores, memory capacity, and the local file system size.
36
36
37
37
For example, setting the web role instance size to `Standard_D2`:
38
38
@@ -49,7 +49,7 @@ To change the size of an existing role, change the virtual machine size in the s
49
49
50
50
## Get a list of available sizes
51
51
52
-
To retrieve a list of available sizes see [Resource Skus - List](/rest/api/compute/resourceskus/list) and apply the following filters:
52
+
To retrieve a list of available sizes, see [Resource Skus - List](/rest/api/compute/resourceskus/list) and apply the following filters:
# Use certificates with Azure Cloud Services (extended support)
@@ -15,13 +15,13 @@ Key Vault is used to store certificates that are associated to Cloud Services (e
15
15
16
16
## Upload a certificate to Key Vault
17
17
18
-
1. Sign in to the [Azure portal](https://portal.azure.com) and navigate to the Key Vault. If you do not have a Key Vault set up, you can opt to create one in this same window.
18
+
1. Sign in to the [Azure portal](https://portal.azure.com) and navigate to the Key Vault. If you don't have a Key Vault set up, you can opt to create one in this same window.
19
19
20
20
2. Select **Access Configuration**
21
21
22
22
:::image type="content" source="media/certs-and-key-vault-1.png" alt-text="Image shows selecting access policies from the key vault blade.":::
23
23
24
-
3. Ensure the access configuration include the following property:
24
+
3. Ensure the access configuration includes the following property:
25
25
-**Enable access to Azure Virtual Machines for deployment**
26
26
27
27
:::image type="content" source="media/certs-and-key-vault-2.png" alt-text="Image shows access policies window in the Azure portal.":::
# What is the Azure Cloud Service model and how do I package it?
13
13
14
-
A cloud service is created from three components, the service definition *(.csdef)*, the service config *(.cscfg)*, and a service package *(.cspkg)*. Both the **ServiceDefinition.csdef** and **ServiceConfig.cscfg** files are XML-based and describe the structure of the cloud service and how it's configured; collectively called the model. The **ServicePackage.cspkg** is a zip file that is generated from the **ServiceDefinition.csdef** and among other things, contains all the required binary-based dependencies. Azure creates a cloud service from both the **ServicePackage.cspkg** and the **ServiceConfig.cscfg**.
14
+
A cloud service is created from three components, the service definition *(.csdef)*, the service config *(.cscfg)*, and a service package *(.cspkg)*. Both the **ServiceDefinition.csdef** and **ServiceConfig.cscfg** files are XML-based and describe the structure of the cloud service and its configuration. We collectively call these files the model. The **ServicePackage.cspkg** is a zip file that is generated from the **ServiceDefinition.csdef** and among other things, contains all the required binary-based dependencies. Azure creates a cloud service from both the **ServicePackage.cspkg** and the **ServiceConfig.cscfg**.
15
15
16
-
Once the cloud service is running in Azure, you can reconfigure it through the **ServiceConfig.cscfg** file, but you cannot alter the definition.
16
+
Once the cloud service is running in Azure, you can reconfigure it through the **ServiceConfig.cscfg** file, but you can't alter the definition.
17
17
18
18
## What would you like to know more about?
19
19
* I want to know more about the [ServiceDefinition.csdef](#csdef) and [ServiceConfig.cscfg](#cscfg) files.
@@ -74,7 +74,7 @@ The **ServiceDefinition.csdef** file specifies the settings that are used by Azu
74
74
</ServiceDefinition>
75
75
```
76
76
77
-
You can refer to the [Service Definition Schema](schema-csdef-file.md)) for a better understanding of the XML schema used here, however, here is a quick explanation of some of the elements:
77
+
You can refer to the [Service Definition Schema](schema-csdef-file.md)) for a better understanding of the XML schema used here, however, here's a quick explanation of some of the elements:
78
78
79
79
**Sites**
80
80
Contains the definitions for websites or web applications that are hosted in IIS7.
@@ -105,7 +105,7 @@ Contains tasks that are run when the role starts. The tasks are defined in a .cm
105
105
## ServiceConfiguration.cscfg
106
106
The configuration of the settings for your cloud service is determined by the values in the **ServiceConfiguration.cscfg** file. You specify the number of instances that you want to deploy for each role in this file. The values for the configuration settings that you defined in the service definition file are added to the service configuration file. The thumbprints for any management certificates that are associated with the cloud service are also added to the file. The [Azure Service Configuration Schema (.cscfg File)](schema-cscfg-file.md) provides the allowable format for a service configuration file.
107
107
108
-
The service configuration file is not packaged with the application, but is uploaded to Azure as a separate file and is used to configure the cloud service. You can upload a new service configuration file without redeploying your cloud service. The configuration values for the cloud service can be changed while the cloud service is running. The following example shows the configuration settings that can be defined for the Web and Worker roles:
108
+
The service configuration file isn't packaged with the application. It uploads to Azure as a separate file and is used to configure the cloud service. You can upload a new service configuration file without redeploying your cloud service. The configuration values for the cloud service can be changed while the cloud service is running. The following example shows the configuration settings that can be defined for the Web and Worker roles:
109
109
110
110
```xml
111
111
<?xml version="1.0"?>
@@ -125,10 +125,10 @@ The service configuration file is not packaged with the application, but is uplo
125
125
</ServiceConfiguration>
126
126
```
127
127
128
-
You can refer to the [Service Configuration Schema](schema-cscfg-file.md) for better understanding the XML schema used here, however, here is a quick explanation of the elements:
128
+
You can refer to the [Service Configuration Schema](schema-cscfg-file.md) for better understanding the XML schema used here, however, here's a quick explanation of the elements:
129
129
130
130
**Instances**
131
-
Configures the number of running instances for the role. To prevent your cloud service from potentially becoming unavailable during upgrades, it is recommended that you deploy more than one instance of your web-facing roles. By deploying more than one instance, you are adhering to the guidelines in the [Azure Compute Service Level Agreement (SLA)](https://azure.microsoft.com/support/legal/sla/), which guarantees 99.95% external connectivity for Internet-facing roles when two or more role instances are deployed for a service.
131
+
Configures the number of running instances for the role. To prevent your cloud service from potentially becoming unavailable during upgrades, we recommend you deploy more than one instance of your web-facing roles. By deploying more than one instance, you adhere to the guidelines in the [Azure Compute Service Level Agreement (SLA)](https://azure.microsoft.com/support/legal/sla/), which guarantees 99.95% external connectivity for Internet-facing roles when two or more role instances are deployed for a service.
132
132
133
133
**ConfigurationSettings**
134
134
Configures the settings for the running instances for a role. The name of the `<Setting>` elements must match the setting definitions in the service definition file.
@@ -146,7 +146,7 @@ Configures the certificates that are used by the service. The previous code exam
146
146
## Defining ports for role instances
147
147
Azure allows only one entry point to a web role. Meaning that all traffic occurs through one IP address. You can configure your websites to share a port by configuring the host header to direct the request to the correct location. You can also configure your applications to listen to well-known ports on the IP address.
148
148
149
-
The following sample shows the configuration for a web role with a website and web application. The website is configured as the default entry location on port 80, and the web applications are configured to receive requests from an alternate host header that is called “mail.mysite.cloudapp.net”.
149
+
The following sample shows the configuration for a web role with a website and web application. The website is configured as the default entry location on port 80, and the web applications are configured to receive requests from an alternate host header called `mail.mysite.cloudapp.net`.
150
150
151
151
```xml
152
152
<WebRole>
@@ -182,14 +182,14 @@ The following sample shows the configuration for a web role with a website and w
182
182
183
183
184
184
## Changing the configuration of a role
185
-
You can update the configuration of your cloud service while it is running in Azure, without taking the service offline. To change configuration information, you can either upload a new configuration file, or edit the configuration file in place and apply it to your running service. The following changes can be made to the configuration of a service:
185
+
You can update the configuration of your cloud service while it's running in Azure, without taking the service offline. To change configuration information, you can either upload a new configuration file, or edit the configuration file in place and apply it to your running service. The following changes can be made to the configuration of a service:
186
186
187
187
***Changing the values of configuration settings**
188
188
When a configuration setting changes, a role instance can choose to apply the change while the instance is online, or to recycle the instance gracefully and apply the change while the instance is offline.
189
189
***Changing the service topology of role instances**
190
-
Topology changes do not affect running instances, except where an instance is being removed. All remaining instances generally do not need to be recycled; however, you can choose to recycle role instances in response to a topology change.
190
+
Topology changes don't affect running instances, except where an instance is being removed. All remaining instances generally don't need to be recycled; however, you can choose to recycle role instances in response to a topology change.
191
191
***Changing the certificate thumbprint**
192
-
You can only update a certificate when a role instance is offline. If a certificate is added, deleted, or changed while a role instance is online, Azure gracefully takes the instance offline to update the certificate and bring it back online after the change is complete.
192
+
You can only update a certificate when a role instance is offline. If a certificate is added, deleted, or changed while a role instance is online, Azure gracefully takes the instance offline to update the certificate. Azure brings it back online after the change completes.
193
193
194
194
### Handling configuration changes with Service Runtime Events
195
195
The Azure Runtime Library includes the Microsoft.WindowsAzure.ServiceRuntime namespace, which provides classes for interacting with the Azure environment from a role. The RoleEnvironment class defines the following events that are raised before and after a configuration change:
@@ -256,7 +256,7 @@ Where the variables are defined as follows:
256
256
| --- | --- |
257
257
|\[DirectoryName\]|The subdirectory under the root project directory that contains the .csdef file of the Azure project. |
258
258
|\[ServiceDefinition\]|The name of the service definition file. By default, this file is named ServiceDefinition.csdef. |
259
-
|\[OutputFileName\]|The name for the generated package file. Typically, this is set to the name of the application. If no file name is specified, the application package is created as \[ApplicationName\].cspkg. |
259
+
|\[OutputFileName\]|The name for the generated package file. Typically, this variable is set to the name of the application. If no file name is specified, the application package is created as \[ApplicationName\].cspkg. |
260
260
|\[RoleName\]|The name of the role as defined in the service definition file. |
261
261
|\[RoleBinariesDirectory]|The location of the binary files for the role. |
262
262
|\[VirtualPath\]|The physical directories for each virtual path defined in the Sites section of the service definition. |
Copy file name to clipboardExpand all lines: articles/cloud-services-extended-support/configure-scaling.md
+7-7Lines changed: 7 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,12 +7,12 @@ ms.subservice: autoscale
7
7
author: gachandw
8
8
ms.author: gachandw
9
9
ms.reviewer: mimckitt
10
-
ms.date: 10/13/2020
10
+
ms.date: 07/24/2024
11
11
---
12
12
13
13
# Configure scaling options with Azure Cloud Services (extended support)
14
14
15
-
Conditions can be configured to enable Cloud Services (extended support) deployments to scale in and out. These conditions can be based on CPU usage, disk load and network load.
15
+
Conditions can be configured to enable Cloud Services (extended support) deployments to scale in and out. These conditions can be based on CPU usage, disk load, and network load.
16
16
17
17
Consider the following information when configuring scaling of your Cloud Service deployments:
18
18
- Scaling impacts core usage. Larger role instances consume more cores and you can only scale within the core limit of your subscription. For more information, see [Azure subscription and service limits, quotas, and constraints](../azure-resource-manager/management/azure-subscription-service-limits.md).
@@ -28,18 +28,18 @@ Consider the following information when configuring scaling of your Cloud Servic
28
28
29
29
:::image type="content" source="media/enable-scaling-1.png" alt-text="Image shows selecting the Remote Desktop option in the Azure portal":::
30
30
31
-
4. A page will display a list of all the roles in which scaling can be configured. Select the role you want to configure.
31
+
4. A page displays a list of all the roles in which scaling can be configured. Select the role you want to configure.
32
32
5. Select the type of scale you want to configure
33
-
- **Manual scale** will set the absolute count of instances.
33
+
- **Manual scale** sets the absolute count of instances.
34
34
1. Select **Manual scale**.
35
35
2. Input the number of instances you want to scale up or down to.
36
36
3. Select **Save**.
37
37
38
38
:::image type="content" source="media/enable-scaling-2.png" alt-text="Image shows setting up manual scaling in the Azure portal":::
39
39
40
-
4. The scaling operation will begin immediately.
40
+
4. The scaling operation begins immediately.
41
41
42
-
- **Custom Autoscale** will allow you to set rules that govern how much or how little to scale.
42
+
- **Custom Autoscale** allows you to set rules that govern how much or how little to scale.
43
43
1. Select **Custom autoscale**
44
44
2. Choose to scale based on a metric or instance count.
45
45
@@ -50,7 +50,7 @@ Consider the following information when configuring scaling of your Cloud Servic
50
50
:::image type="content" source="media/enable-scaling-4.png" alt-text="Image shows setting up custom autoscale rules in the Azure portal":::
51
51
52
52
4. Select **Save**.
53
-
5. The scaling operations will begin as soon as a rule is triggered.
53
+
5. The scaling operations begin as soon as a rule is triggered.
54
54
55
55
6. You can view or adjust existing scaling rules applied to your deployments by selecting the **Scale** tab.
# Deploy Cloud Services (extended support) by using the Azure portal
@@ -59,8 +59,8 @@ To deploy Cloud Services (extended support) by using the portal:
59
59
- If you have IP input endpoints defined in your definition (.csdef) file, create a public IP address for your cloud service.
60
60
- Cloud Services (extended support) supports only a Basic SKU public IP address.
61
61
- If your configuration (.cscfg) file contains a reserved IP address, set the allocation type for the public IP address to **Static**.
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.
63
-
- (Optional) **Start cloud service**: Select the checkbox if you want to start the service immediately after it's deployed.
62
+
- (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.
63
+
- (Optional) **Start cloud service**: Select the checkbox if you want to start the service immediately after it deploys.
64
64
-**Key vault**: Select a key vault.
65
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**.
0 commit comments