Skip to content

Commit fc88a7c

Browse files
committed
Add bundles v2 instructions to Python Durable docs
1 parent 32d111a commit fc88a7c

File tree

3 files changed

+30
-8
lines changed

3 files changed

+30
-8
lines changed

articles/azure-functions/durable/durable-functions-overview.md

+5-3
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Durable Functions Overview - Azure
33
description: Introduction to the Durable Functions extension for Azure Functions.
44
author: cgillum
55
ms.topic: overview
6-
ms.date: 03/12/2020
6+
ms.date: 12/23/2020
77
ms.author: cgillum
88
ms.reviewer: azfuncdf
99
#Customer intent: As a < type of user >, I want < what? > so that < why? >.
@@ -18,11 +18,13 @@ ms.reviewer: azfuncdf
1818
Durable Functions currently supports the following languages:
1919

2020
* **C#**: both [precompiled class libraries](../functions-dotnet-class-library.md) and [C# script](../functions-reference-csharp.md).
21-
* **JavaScript**: supported only for version 2.x of the Azure Functions runtime. Requires version 1.7.0 of the Durable Functions extension, or a later version.
22-
* **Python**: requires version 1.8.5 of the Durable Functions extension, or a later version. Support for Durable Functions is currently in public preview.
21+
* **JavaScript**: supported only for version 2.x of the Azure Functions runtime. Requires version 1.7.0 of the Durable Functions extension, or a later version.
22+
* **Python**: requires version 2.3.1 of the Durable Functions extension, or a later version. Support for Durable Functions is currently in public preview.
2323
* **F#**: precompiled class libraries and F# script. F# script is only supported for version 1.x of the Azure Functions runtime.
2424
* **PowerShell**: support for Durable Functions is currently in public preview. Supported only for version 3.x of the Azure Functions runtime and PowerShell 7. Requires version 2.2.2 of the Durable Functions extension, or a later version. Only the following patterns are currently supported: [Function chaining](#chaining), [Fan-out/fan-in](#fan-in-out), [Async HTTP APIs](#async-http).
2525

26+
To access the latest features and updates, it is recommended that you use the latest versions of the Durable Functions extension and language-specific libraries. Learn more about [Durable Functions versions](durable-functions-versions.md).
27+
2628
Durable Functions has a goal of supporting all [Azure Functions languages](../supported-languages.md). See the [Durable Functions issues list](https://github.com/Azure/azure-functions-durable-extension/issues) for the latest status of work to support additional languages.
2729

2830
Like Azure Functions, there are templates to help you develop Durable Functions using [Visual Studio 2019](durable-functions-create-first-csharp.md), [Visual Studio Code](quickstart-js-vscode.md), and the [Azure portal](durable-functions-create-portal.md).

articles/azure-functions/durable/durable-functions-versions.md

+6-1
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Durable Functions versions overview - Azure Functions
33
description: Learn about Durable Functions versions.
44
author: cgillum
55
ms.topic: conceptual
6-
ms.date: 08/20/2020
6+
ms.date: 12/23/2020
77
ms.author: azfuncdf
88
---
99

@@ -45,6 +45,8 @@ Install the latest 2.x version of the Durable Functions bindings extension in yo
4545

4646
Durable Functions 2.x is available in version 2.x of the [Azure Functions extension bundle](../functions-bindings-register.md#extension-bundles).
4747

48+
Python support in Durable Functions requires Durable Functions 2.x.
49+
4850
To update the extension bundle version in your project, open host.json and update the `extensionBundle` section to use version 2.x (`[2.*, 3.0.0)`).
4951

5052
```json
@@ -57,6 +59,9 @@ To update the extension bundle version in your project, open host.json and updat
5759
}
5860
```
5961

62+
> [!NOTE]
63+
> If Visual Studio Code is not displaying the correct templates after you change the extension bundle version, reload the window by running the *Developer: Reload Window* command (<kbd>Ctrl+R</kbd> on Windows and Linux, <kbd>Command+R</kbd> on macOS).
64+
6065
#### .NET
6166

6267
Update your .NET project to use the latest version of the [Durable Functions bindings extension](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.DurableTask).

articles/azure-functions/durable/quickstart-python-vscode.md

+19-4
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Create and publish an Azure Durable Function in Python using Visual
44
author: anthonychu
55

66
ms.topic: quickstart
7-
ms.date: 04/04/2020
7+
ms.date: 12/23/2020
88
ms.reviewer: azfuncdf, antchu
99
---
1010

@@ -36,7 +36,7 @@ To complete this tutorial:
3636

3737
In this section, you use Visual Studio Code to create a local Azure Functions project.
3838

39-
1. In Visual Studio Code, press F1 (or Ctrl/Cmd+Shift+P) to open the command palette. In the command palette, search for and select `Azure Functions: Create New Project...`.
39+
1. In Visual Studio Code, press F1 (or <kbd>Ctrl/Cmd+Shift+P</kbd>) to open the command palette. In the command palette, search for and select `Azure Functions: Create New Project...`.
4040

4141
![Create function](media/quickstart-python-vscode/functions-create-project.png)
4242

@@ -56,6 +56,21 @@ Visual Studio Code installs the Azure Functions Core Tools, if needed. It also c
5656

5757
A requirements.txt file is also created in the root folder. It specifies the Python packages needed to run your function app.
5858

59+
## Update Azure Functions extension bundles version
60+
61+
Python Azure Functions require version 2.x of [Azure Functions extension bundles](../functions-bindings-register#access-extensions-in-non-net-languages). Extension bundles are configured in *host.json*.
62+
63+
Open *host.json* in the project. Update the extension bundle `version` to `[2.*, 3.0.0)`. This specifies a version range that is greater than or equal to 2.0, and less than 3.0.
64+
65+
```json
66+
"extensionBundle": {
67+
"id": "Microsoft.Azure.Functions.ExtensionBundle",
68+
"version": "[2.*, 3.0.0)"
69+
}
70+
```
71+
72+
VS Code must be reloaded before the updated extension bundle version is reflected. In the command palette, run search for the *Developer: Reload Window* command and run it.
73+
5974
## Install azure-functions-durable from PyPI
6075

6176
When you created the project, the Azure Functions VS Code extension automatically created a virtual environment with your selected Python version. You will activate the virtual environment in a terminal and install some dependencies required by Azure Functions and Durable Functions.
@@ -64,10 +79,10 @@ When you created the project, the Azure Functions VS Code extension automaticall
6479

6580
```
6681
azure-functions
67-
azure-functions-durable>=1.0.0b6
82+
azure-functions-durable>=1.0.0b12
6883
```
6984
70-
1. Open the editor's integrated terminal in the current folder (`` Ctrl-Shift-` ``).
85+
1. Open the editor's integrated terminal in the current folder (<kbd>Ctrl-Shift-`</kbd>).
7186
7287
1. In the integrated terminal, activate the virtual environment in the current folder:
7388

0 commit comments

Comments
 (0)