Hızlı Başlangıç: Python Dayanıklı İşlevler uygulaması oluşturma

3. İstemlerde aşağıdaki bilgileri sağlayın:

   İstem	Eylem	Açıklama
   İşlev uygulaması projeniz için bir dil seçin	Python'ı seçin.	Yerel bir Python İşlevleri projesi oluşturur.
   Bir sürüm seçin	Azure İşlevleri v4'i seçin.	Bu seçeneği yalnızca Çekirdek Araçlar henüz yüklü olmadığında görürsünüz. Bu durumda, uygulamayı ilk kez çalıştırdığınızda Core Tools yüklenir.
   Python sürümü	Python 3.7, Python 3.8, Python 3.9 veya Python 3.10'ı seçin.	Visual Studio Code, seçtiğiniz sürümü kullanarak bir sanal ortam oluşturur.
   Projenizin ilk işlevi için bir şablon seçin	Şimdilik atla'yı seçin.
   Projenizi nasıl açmak istediğinizi seçin	Geçerli pencerede aç'ı seçin.	Seçtiğiniz klasörde Visual Studio Code'un açılmasını sağlar.

3. İstemlerde aşağıdaki bilgileri sağlayın:

   İstem	Value	Açıklama
   Dil seçin	Python (Programlama Modeli V2) öğesini seçin.	V2 programlama modelini kullanarak yerel bir Python İşlevleri projesi oluşturur.
   Bir sürüm seçin	Azure İşlevleri v4'i seçin.	Bu seçeneği yalnızca Çekirdek Araçlar henüz yüklü olmadığında görürsünüz. Bu durumda, uygulamayı ilk kez çalıştırdığınızda Core Tools yüklenir.
   Python sürümü	Python 3.7, Python 3.8, Python 3.9 veya Python 3.10'ı seçin.	Visual Studio Code, seçtiğiniz sürümü kullanarak bir sanal ortam oluşturur.
   Projenizi nasıl açmak istediğinizi seçin	Geçerli pencerede aç'ı seçin.	Seçtiğiniz klasörde Visual Studio Code'un açılmasını sağlar.

Orchestrator işlevi

Projenizde Dayanıklı İşlevler uygulama kodunu oluşturmak için bir şablon kullanırsınız.

1. Komut paletine girin ve Azure İşlevleri: İşlev Oluştur'u seçin.

2. İstemlerde aşağıdaki bilgileri sağlayın:

   İstem	Eylem	Açıklama
   İşleviniz için şablon seçme	Dayanıklı İşlevler düzenleyici'yi seçin.	Dayanıklı İşlevler uygulama düzenlemesi oluşturur.
   İşlev adı belirtin	HelloOrchestrator'ı seçin.	Dayanıklı işlevinizin adı.

Etkinlik işlevlerini koordine etmek için bir düzenleyici eklediniz. Orchestrator işlevini görmek için HelloOrchestrator/__init__.py açın. Çağrısının context.call_activity her birinde adlı Hellobir etkinlik işlevi çağrılır.

Ardından, başvuruda Hello bulunan etkinlik işlevini eklersiniz.

Activity işlevi

1. Komut paletine girin ve Azure İşlevleri: İşlev Oluştur'u seçin.

2. İstemlerde aşağıdaki bilgileri sağlayın:

   İstem	Eylem	Açıklama
   İşleviniz için şablon seçme	Dayanıklı İşlevler etkinliği seçin.	Etkinlik işlevi oluşturur.
   İşlev adı belirtin	Merhaba yazın.	Etkinlik işlevinizin adı.

Düzenleyici tarafından çağrılan etkinlik işlevini eklediniz Hello . Giriş olarak bir ad alıp selamlama döndürdüğünü görmek için Hello/__init__.py açın. Etkinlik işlevi, veritabanı çağrısı yapma veya hesaplama gerçekleştirme gibi eylemleri gerçekleştirdiğiniz yerdir.

Son olarak, düzenlemeyi başlatan HTTP ile tetiklenen bir işlev eklersiniz.

İstemci işlevi (HTTP starter)

1. Komut paletine girin ve Azure İşlevleri: İşlev Oluştur'u seçin.

2. İstemlerde aşağıdaki bilgileri sağlayın:

   İstem	Eylem	Açıklama
   İşleviniz için şablon seçme	HTTP başlatıcı Dayanıklı İşlevler seçin.	BIR HTTP starter işlevi oluşturur.
   İşlev adı belirtin	DurableFunctionsHttpStart girin.	İstemci işlevinizin adı
   Yetkilendirme düzeyi	Anonim'i seçin.	Tanıtım amacıyla bu değer, işlevin kimlik doğrulaması kullanılmadan çağrılmasını sağlar.

Düzenlemeyi başlatan HTTP ile tetiklenen bir işlev eklediniz. Yeni bir düzenleme başlatmak için kullandığını client.start_new görmek için DurableFunctionsHttpStart/__init__.py açın. Ardından, yeni düzenlemeyi izlemek ve yönetmek için kullanılabilecek URL'leri içeren bir HTTP yanıtı döndürmek için kullanır client.create_check_status_response .

Artık yerel olarak çalıştırılıp Azure'a dağıtılabilir bir Dayanıklı İşlevler uygulamanız var.

Gereksinimler

Python programlama modelinin 2. sürümü aşağıdaki en düşük sürümleri gerektirir:

• Azure İşlevleri Runtime v4.16+
• Azure İşlevleri Core Tools v4.0.5095+ (yerel olarak çalışıyorsa)
• azure-functions-durable v1.2.4+

v2 programlama modelini etkinleştirme

v2 programlama modelini çalıştırmak için aşağıdaki uygulama ayarı gereklidir:

• Ad: AzureWebJobsFeatureFlags
• Değer: EnableWorkerIndexing

Azure İşlevleri Çekirdek Araçları'nı kullanarak yerel olarak çalıştırıyorsanız bu ayarı local.settings.json dosyanıza ekleyin. Azure'da çalıştırıyorsanız ilgili bir aracı kullanarak şu adımları tamamlayın:

az functionapp config appsettings set --name <FUNCTION_APP_NAME> --resource-group <RESOURCE_GROUP_NAME> --settings AzureWebJobsFeatureFlags=EnableWorkerIndexing

Update-AzFunctionAppSetting -Name <FUNCTION_APP_NAME> -ResourceGroupName <RESOURCE_GROUP_NAME> -AppSetting @{"AzureWebJobsFeatureFlags" = "EnableWorkerIndexing"}

Bu üç işlev türünü kullanarak temel bir Dayanıklı İşlevler uygulaması oluşturmak için function_app.py içeriğini aşağıdaki Python koduyla değiştirin:

import azure.functions as func
import azure.durable_functions as df

myApp = df.DFApp(http_auth_level=func.AuthLevel.ANONYMOUS)

# An HTTP-triggered function with a Durable Functions client binding
@myApp.route(route="orchestrators/{functionName}")
@myApp.durable_client_input(client_name="client")
async def http_start(req: func.HttpRequest, client):
    function_name = req.route_params.get('functionName')
    instance_id = await client.start_new(function_name)
    response = client.create_check_status_response(req, instance_id)
    return response

# Orchestrator
@myApp.orchestration_trigger(context_name="context")
def hello_orchestrator(context):
    result1 = yield context.call_activity("hello", "Seattle")
    result2 = yield context.call_activity("hello", "Tokyo")
    result3 = yield context.call_activity("hello", "London")

    return [result1, result2, result3]

# Activity
@myApp.activity_trigger(input_name="city")
def hello(city: str):
    return f"Hello {city}"

Örnekteki her işlevin ve amacının açıklaması için aşağıdaki tabloyu gözden geçirin:

1. İşlevinizi test etmek için etkinlik işlev kodunda Hello ( Hello/__init__.py) bir kesme noktası ayarlayın. İşlev uygulaması projesini başlatmak için F5'i seçin veya komut paletinde Hata Ayıkla: Hata Ayıklamayı Başlat'ı seçin. Temel Araçlar'dan alınan çıkış, terminal panelinde görünür.

   Not

   Hata ayıklama hakkında daha fazla bilgi için bkz. tanılama Dayanıklı İşlevler.

1. İşlevinizi test etmek için etkinlik işlev kodunda hello bir kesme noktası ayarlayın. İşlev uygulaması projesini başlatmak için F5'i seçin veya komut paletinde Hata Ayıkla: Hata Ayıklamayı Başlat'ı seçin. Temel Araçlar'dan alınan çıkış, terminal panelinde görünür.

   Not

   Hata ayıklama hakkında daha fazla bilgi için bkz. tanılama Dayanıklı İşlevler.

5. URL uç noktasına HTTP POST isteği göndermek için tarayıcınızı veya bir HTTP test aracını kullanın.

   Son segmenti orchestrator işlevinin (HelloOrchestrator) adıyla değiştirin. URL ile benzer http://localhost:7071/api/orchestrators/HelloOrchestratorolmalıdır.

   Yanıt, HTTP işlevinin ilk sonucudur. Dayanıklı düzenlemenin başarıyla başladığını size bildirir. Henüz düzenlemenin sonunu görüntülemez. Yanıt birkaç yararlı URL içerir. Şimdilik düzenlemenin durumunu sorgula.

6. url statusQueryGetUrideğerini kopyalayın, tarayıcınızın adres çubuğuna yapıştırın ve isteği yürütür. AYRıCA, GET isteğini vermek için HTTP test aracınızı kullanmaya devam edebilirsiniz.

   İstek, durum için düzenleme örneğini sorgular. Örneğin tamamlandığını ve dayanıklı işlevin çıkışlarını veya sonuçlarını içerdiğini görmeniz gerekir. Bu örneğe benzer:

   {
       "name": "HelloOrchestrator",
       "instanceId": "9a528a9e926f4b46b7d3deaa134b7e8a",
       "runtimeStatus": "Completed",
       "input": null,
       "customStatus": null,
       "output": [
           "Hello Tokyo!",
           "Hello Seattle!",
           "Hello London!"
       ],
       "createdTime": "2020-03-18T21:54:49Z",
       "lastUpdatedTime": "2020-03-18T21:54:54Z"
   }
   

5. URL uç noktasına HTTP POST isteği göndermek için tarayıcınızı veya bir HTTP test aracını kullanın.

   Son segmenti orchestrator işlevinin (HelloOrchestrator) adıyla değiştirin. URL ile benzer http://localhost:7071/api/orchestrators/HelloOrchestratorolmalıdır.

   Yanıt, HTTP işlevinin ilk sonucudur. Dayanıklı düzenlemenin başarıyla başladığını size bildirir. Henüz düzenlemenin sonunu görüntülemez. Yanıt birkaç yararlı URL içerir. Şimdilik düzenlemenin durumunu sorgula.

6. url statusQueryGetUrideğerini kopyalayın, tarayıcınızın adres çubuğuna yapıştırın ve isteği yürütür. AYRıCA, GET isteğini vermek için HTTP test aracınızı kullanmaya devam edebilirsiniz.

   İstek, durum için düzenleme örneğini sorgular. Örneğin tamamlandığını ve dayanıklı işlevin çıkışlarını veya sonuçlarını içerdiğini görmeniz gerekir. Bu örneğe benzer:

   {
       "name": "hello_orchestrator",
       "instanceId": "9a528a9e926f4b46b7d3deaa134b7e8a",
       "runtimeStatus": "Completed",
       "input": null,
       "customStatus": null,
       "output": [
           "Hello Tokyo!",
           "Hello Seattle!",
           "Hello London!"
       ],
       "createdTime": "2020-03-18T21:54:49Z",
       "lastUpdatedTime": "2020-03-18T21:54:54Z"
   }
   

1. Çıkış panelinden HTTP tetikleyicisinin URL'sini kopyalayın. HTTP ile tetiklenen işlevinizi çağıran URL şu biçimde olmalıdır:

   https://<functionappname>.azurewebsites.net/api/orchestrators/HelloOrchestrator

1. Çıkış panelinden HTTP tetikleyicisinin URL'sini kopyalayın. HTTP ile tetiklenen işlevinizi çağıran URL şu biçimde olmalıdır:

   https://<functionappname>.azurewebsites.net/api/orchestrators/hello_orchestrator