Skip to content

Commit 10e3d7f

Browse files
Merge pull request #281625 from tomvcassidy/28CSDate
ms.date and acrolinx for three articles
2 parents 81bf39a + 7a2ec35 commit 10e3d7f

File tree

3 files changed

+23
-25
lines changed

3 files changed

+23
-25
lines changed

articles/cloud-services/cloud-services-powershell-create-cloud-container.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Create a cloud service (classic) container with PowerShell | Microsoft Do
33
description: This article explains how to create a cloud service container with PowerShell. The container hosts web and worker roles.
44
ms.topic: article
55
ms.service: cloud-services
6-
ms.date: 02/21/2023
6+
ms.date: 07/23/2024
77
author: hirenshah1
88
ms.author: hirshah
99
ms.reviewer: mimckitt
@@ -14,7 +14,7 @@ ms.custom: compute-evergreen, devx-track-azurepowershell
1414

1515
[!INCLUDE [Cloud Services (classic) deprecation announcement](includes/deprecation-announcement.md)]
1616

17-
This article explains how to quickly create a Cloud Services container using Azure PowerShell cmdlets. Please follow the steps below:
17+
This article explains how to quickly create a Cloud Services container using Azure PowerShell cmdlets. Use the following steps:
1818

1919
1. Install the Microsoft Azure PowerShell cmdlet from the [Azure PowerShell downloads](https://aka.ms/webpi-azps) page.
2020
2. Open the PowerShell command prompt.
@@ -45,5 +45,5 @@ Get-help New-AzureService
4545

4646
### Next steps
4747

48-
* To manage the cloud service deployment, refer to the [Get-AzureService](/powershell/module/servicemanagement/azure/Get-AzureService), [Remove-AzureService](/powershell/module/servicemanagement/azure/Remove-AzureService), and [Set-AzureService](/powershell/module/servicemanagement/azure/set-azureservice) commands. You may also refer to [How to configure cloud services](cloud-services-how-to-configure-portal.md) for further information.
48+
* To manage the cloud service deployment, refer to the [Get-AzureService](/powershell/module/servicemanagement/azure/Get-AzureService), [Remove-AzureService](/powershell/module/servicemanagement/azure/Remove-AzureService), and [Set-AzureService](/powershell/module/servicemanagement/azure/set-azureservice) commands. For more information, see [How to configure cloud services](cloud-services-how-to-configure-portal.md).
4949
* To publish your cloud service project to Azure, refer to the **PublishCloudService.ps1** code sample from [archived cloud services repository](https://github.com/MicrosoftDocs/azure-cloud-services-files/tree/master/Scripts/cloud-services-continuous-delivery).

articles/cloud-services/cloud-services-python-how-to-use-service-management.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
---
2-
title: Use the Service Management API (Python) - feature guide
2+
title: Use the classic deployment model (Python) - feature guide
33
description: Learn how to programmatically perform common service management tasks from Python.
44
ms.topic: article
55
ms.service: cloud-services
6-
ms.date: 02/21/2023
6+
ms.date: 07/23/2024
77
author: hirenshah1
88
ms.author: hirshah
99
ms.reviewer: mimckitt
@@ -20,12 +20,12 @@ ms.custom: compute-evergreen, devx-track-python
2020
This guide shows you how to programmatically perform common service management tasks from Python. The **ServiceManagementService** class in the [Azure SDK for Python](https://github.com/Azure/azure-sdk-for-python) supports programmatic access to much of the service management-related functionality that is available in the [Azure portal]. You can use this functionality to create, update, and delete cloud services, deployments, data management services, and virtual machines. This functionality can be useful in building applications that need programmatic access to service management.
2121

2222
## <a name="WhatIs"> </a>What is service management?
23-
The Azure Service Management API provides programmatic access to much of the service management functionality available through the [Azure portal]. You can use the Azure SDK for Python to manage your cloud services and storage accounts.
23+
The Azure classic deployment model provides programmatic access to much of the service management functionality available through the [Azure portal]. You can use the Azure SDK for Python to manage your cloud services and storage accounts.
2424

25-
To use the Service Management API, you need to [create an Azure account](https://azure.microsoft.com/pricing/free-trial/).
25+
To use the classic deployment model, you need to [create an Azure account](https://azure.microsoft.com/pricing/free-trial/).
2626

2727
## <a name="Concepts"> </a>Concepts
28-
The Azure SDK for Python wraps the [Service Management API][svc-mgmt-rest-api], which is a REST API. All API operations are performed over TLS and mutually authenticated by using X.509 v3 certificates. The management service can be accessed from within a service running in Azure. It also can be accessed directly over the Internet from any application that can send an HTTPS request and receive an HTTPS response.
28+
The Azure SDK for Python wraps the [classic deployment model][svc-mgmt-rest-api], which is a REST API. All API operations are performed over Transport Layer Security (TLS) and mutually authenticated by using X.509 v3 certificates. The management service can be accessed from within a service running in Azure. It also can be accessed directly over the Internet from any application that can send an HTTPS request and receive an HTTPS response.
2929

3030
## <a name="Installation"> </a>Installation
3131
All the features described in this article are available in the `azure-servicemanagement-legacy` package, which you can install by using pip. For more information about installation (for example, if you're new to Python), see [Install Python and the Azure SDK](/azure/developer/python/sdk/azure-sdk-install).
@@ -342,7 +342,7 @@ image_name = 'OpenLogic__OpenLogic-CentOS-62-20120531-en-us-30GB.vhd'
342342
# will be created
343343
media_link = 'url_to_target_storage_blob_for_vm_hd'
344344

345-
# Linux VM configuration, you can use WindowsConfigurationSet
345+
# Linux virtual machine (VM) configuration, you can use WindowsConfigurationSet
346346
# for a Windows VM instead
347347
linux_config = LinuxConfigurationSet('myhostname', 'myuser', 'mypassword', True)
348348

@@ -378,7 +378,7 @@ sms.delete_hosted_service(service_name='myvm')
378378
```
379379

380380
## Create a virtual machine from a captured virtual machine image
381-
To capture a VM image, you first call the **capture\_vm\_image** method.
381+
To capture a virtual machine (VM) image, you first call the **capture\_vm\_image** method.
382382

383383
```python
384384
from azure import *
@@ -445,7 +445,7 @@ To learn more about how to capture a Linux virtual machine in the classic deploy
445445
To learn more about how to capture a Windows virtual machine in the classic deployment model, see [Capture a Windows virtual machine](/previous-versions/azure/virtual-machines/windows/classic/capture-image-classic).
446446

447447
## <a name="What's Next"> </a>Next steps
448-
Now that you've learned the basics of service management, you can access the [Complete API reference documentation for the Azure Python SDK](https://azure-sdk-for-python.readthedocs.org/) and perform complex tasks easily to manage your Python application.
448+
Now that you learned the basics of service management, you can access the [Complete API reference documentation for the Azure Python SDK](https://azure-sdk-for-python.readthedocs.org/) and perform complex tasks easily to manage your Python application.
449449

450450
For more information, see the [Python Developer Center](https://azure.microsoft.com/develop/python/).
451451

articles/cloud-services/cloud-services-python-ptvs.md

Lines changed: 12 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Get started with Python and Azure Cloud Services (classic)| Microsoft Doc
33
description: Overview of using Python Tools for Visual Studio to create Azure cloud services including web roles and worker roles.
44
ms.topic: article
55
ms.service: cloud-services
6-
ms.date: 02/21/2023
6+
ms.date: 07/23/2024
77
author: hirenshah1
88
ms.author: hirshah
99
ms.reviewer: mimckitt
@@ -19,15 +19,15 @@ This article provides an overview of using Python web and worker roles using [Py
1919
## Prerequisites
2020
* [Visual Studio 2013, 2015, or 2017](https://www.visualstudio.com/)
2121
* [Python Tools for Visual Studio][Python Tools for Visual Studio] (PTVS)
22-
* [Azure SDK Tools for VS 2013][Azure SDK Tools for VS 2013] or
22+
* [Azure SDK Tools for Visual Studio (VS) 2013][Azure SDK Tools for VS 2013] or
2323
[Azure SDK Tools for VS 2015][Azure SDK Tools for VS 2015] or
2424
[Azure SDK Tools for VS 2017][Azure SDK Tools for VS 2017]
2525
* [Python 2.7 32-bit][Python 2.7 32-bit] or [Python 3.8 32-bit][Python 3.8 32-bit]
2626

2727
[!INCLUDE [create-account-and-websites-note](../../includes/create-account-and-websites-note.md)]
2828

2929
## What are Python web and worker roles?
30-
Azure provides three compute models for running applications: [Web Apps feature in Azure App Service][execution model-web sites], [Azure Virtual Machines][execution model-vms], and [Azure Cloud Services][execution model-cloud services]. All three models support Python. Cloud Services, which include web and worker roles, provide *Platform as a Service (PaaS)*. Within a cloud service, a web role provides a dedicated Internet Information Services (IIS) web server to host front end web applications, while a worker role can run asynchronous, long-running, or perpetual tasks independent of user interaction or input.
30+
Azure provides three compute models for running applications: [Web Apps feature in Azure App Service][execution model-web sites], [Azure Virtual Machines][execution model-vms], and [Azure Cloud Services][execution model-cloud services]. All three models support Python. Cloud Services, which include web and worker roles, provide *Platform as a Service (PaaS)*. Within a cloud service, a web role provides a dedicated Internet Information Services (IIS) web server to host front end web applications. A worker role can run asynchronous, long-running, or perpetual tasks independent of user interaction or input.
3131

3232
For more information, see [What is a Cloud Service?].
3333

@@ -51,19 +51,19 @@ The worker role template comes with boilerplate code to connect to an Azure stor
5151

5252
![Cloud Service Solution](./media/cloud-services-python-ptvs/worker.png)
5353

54-
You can add web or worker roles to an existing cloud service at any time. You can choose to add existing projects in your solution, or create new ones.
54+
You can add web or worker roles to an existing cloud service at any time. You can choose to add existing projects in your solution, or create new ones.
5555

5656
![Add Role Command](./media/cloud-services-python-ptvs/add-new-or-existing-role.png)
5757

58-
Your cloud service can contain roles implemented in different languages. For example, you can have a Python web role implemented using Django, with Python, or with C# worker roles. You can easily communicate between your roles using Service Bus queues or storage queues.
58+
Your cloud service can contain roles implemented in different languages. For example, you can have a Python web role implemented using Django, with Python, or with C# worker roles. You can easily communicate between your roles using Service Bus queues or storage queues.
5959

6060
## Install Python on the cloud service
6161
> [!WARNING]
6262
> The setup scripts that are installed with Visual Studio (at the time this article was last updated) do not work. This section describes a workaround.
6363
>
6464
>
6565
66-
The main problem with the setup scripts is that they do not install python. First, define two [startup tasks](cloud-services-startup-tasks.md) in the [ServiceDefinition.csdef](cloud-services-model-and-package.md#servicedefinitioncsdef) file. The first task (**PrepPython.ps1**) downloads and installs the Python runtime. The second task (**PipInstaller.ps1**) runs pip to install any dependencies you may have.
66+
The main problem with the setup scripts is that they don't install Python. First, define two [startup tasks](cloud-services-startup-tasks.md) in the [ServiceDefinition.csdef](cloud-services-model-and-package.md#servicedefinitioncsdef) file. The first task (**PrepPython.ps1**) downloads and installs the Python runtime. The second task (**PipInstaller.ps1**) runs pip to install any dependencies you may have.
6767

6868
The following scripts were written targeting Python 3.8. If you want to use the version 2.x of python, set the **PYTHON2** variable file to **on** for the two startup tasks and the runtime task: `<Variable name="PYTHON2" value="<mark>on</mark>" />`.
6969

@@ -241,7 +241,7 @@ if (-not $is_emulated){
241241
>
242242
>
243243
244-
The **bin\LaunchWorker.ps1** was originally created to do a lot of prep work but it doesn't really work. Replace the contents in that file with the following script.
244+
The **bin\LaunchWorker.ps1** was originally created to do a lot of prep work, but it doesn't really work. Replace the contents in that file with the following script.
245245

246246
This script calls the **worker.py** file from your Python project. If the **PYTHON2** environment variable is set to **on**, then Python 2.7 is used, otherwise Python 3.8 is used.
247247

@@ -281,7 +281,7 @@ else
281281
```
282282

283283
#### ps.cmd
284-
The Visual Studio templates should have created a **ps.cmd** file in the **./bin** folder. This shell script calls out the PowerShell wrapper scripts above and provides logging based on the name of the PowerShell wrapper called. If this file wasn't created, here is what should be in it.
284+
The Visual Studio templates probably created a **ps.cmd** file in the **./bin** folder. This shell script calls out the preceding PowerShell wrapper scripts and provides logging based on the name of the PowerShell wrapper called. If this file wasn't created, the following script would be in it:
285285

286286
```cmd
287287
@echo off
@@ -292,14 +292,12 @@ if not exist "%DiagnosticStore%\LogFiles" mkdir "%DiagnosticStore%\LogFiles"
292292
%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe -ExecutionPolicy Unrestricted -File %* >> "%DiagnosticStore%\LogFiles\%~n1.txt" 2>> "%DiagnosticStore%\LogFiles\%~n1.err.txt"
293293
```
294294

295-
296-
297295
## Run locally
298296
If you set your cloud service project as the startup project and press F5, the cloud service runs in the local Azure emulator.
299297

300-
Although PTVS supports launching in the emulator, debugging (for example, breakpoints) does not work.
298+
Although PTVS supports launching in the emulator, debugging (for example, breakpoints) doesn't work.
301299

302-
To debug your web and worker roles, you can set the role project as the startup project and debug that instead. You can also set multiple startup projects. Right-click the solution and then select **Set StartUp Projects**.
300+
To debug your web and worker roles, you can set the role project as the startup project and debug that instead. You can also set multiple startup projects. Right-click the solution and then select **Set StartUp Projects**.
303301

304302
![Solution Startup Project Properties](./media/cloud-services-python-ptvs/startup.png)
305303

@@ -310,9 +308,9 @@ To publish, right-click the cloud service project in the solution and then selec
310308

311309
Follow the wizard. If you need to, enable remote desktop. Remote desktop is helpful when you need to debug something.
312310

313-
When you are done configuring settings, click **Publish**.
311+
When you finish configuring settings, choose **Publish**.
314312

315-
Some progress appears in the output window, then you'll see the Microsoft Azure Activity Log window.
313+
Some progress appears in the output window, then you see the Microsoft Azure Activity Log window.
316314

317315
![Microsoft Azure Activity Log Window](./media/cloud-services-python-ptvs/publish-activity-log.png)
318316

0 commit comments

Comments
 (0)