/simple-orchestration-adf

Primary LanguageC#MIT LicenseMIT

Simple orchestration with Azure Durable Functions

This repo contains the following:

  • Simple HTTP trigger to kickoff an orchestration
  • Simple orchestration function that handles two activities
    • EngagementActivity: responsible for creating and deleting engagements
    • WorkbenchStorageActivity: responsible for creating and deleting storage
flowchart LR
    A[HttpTrigger] -->B(Start Orchestration)
    B -->C(CreateEngagement)
    C -->|succeed or fail| B(Start Orchestration)
    B -->|CreateEngagementSucceeds|D(WorkbenchStorageCreate)
    D -->|succeed or fail| B(Start Orchestration)
    B -->|WorkbenchStorageCreateFails|E(DeleteEngagement)
Loading

Retry Options

This repo implements retry policies in a few different ways to demonstrate the various options available:

  • SimpleOrchestrator relies on retry capabilities built into the DurableTask framework. It uses the Automatic retry but custom handlers may be used instead.
  • The HTTP client for use within the EngagementActivity is configured to use .NET HTTP resiliency extensions to enable retries upon registration at startup.
  • The WorkbenchActivity implements custom retry policies with .NET resiliency

This is for demo purposes and users should be careful to avoid stacking retry policies.

Develop and run locally

This repo comes equipped with a VS Code Dev Container additional methods to develop and run Azure Functions locally can be found in the official docs.

Deploy to Azure

Assuming an existing Azure subscription exists and you have permissions to create the following resources:

RG_NAME='simple-orchestration'
LOCATION='eastus'
STORAGE_NAME='mysimplestore' # must be globally unique
FN_NAME='SimpleOrchestration' # must be globally unique

az login
az group create -n $RG_NAME -l $LOCATION
az storage account create \
  --name $STORAGE_NAME \
  -l $LOCATION \
  -g $RG_NAME \
  --sku Standard_LRS \
  --allow-blob-public-access false

az functionapp create \
  --name $FN_NAME \
  -g $RG_NAME \
  --consumption-plan-location $LOCATION \
  --runtime dotnet-isolated \
  --functions-version 4  \
  --storage-account $STORAGE_NAME \
  --os-type Linux

cd src
func azure functionapp publish $FN_NAME