Python에서 첫 번째 지속성 함수 만들기

아티클
07/11/2023

Durable Functions는 서버리스 환경에서 상태 저장 함수를 작성할 수 있게 하는 Azure Functions의 확장입니다. 확장은 상태, 검사점 및 다시 시작을 관리합니다.

이 문서에서는 Visual Studio Code Azure Functions를 사용하여 로컬로 “hello world” 지속성 함수를 만들고 테스트하는 방법에 대해 알아봅니다. 이 함수는 다른 함수에 대한 호출을 오케스트레이션하고 함께 연결합니다. 그러면 함수 코드를 Azure에 게시할 수 있습니다.

Azure에서 지속성 함수 실행의 스크린샷

필수 조건

이 자습서를 완료하려면 다음이 필요합니다.

Visual Studio Code를 설치합니다.
Azure Functions Visual Studio Code 확장을 설치합니다.
최신 버전의 Azure Functions Core Tools가 있는지 확인합니다.
Durable Functions를 사용하려면 Azure 스토리지 계정이 필요합니다. Azure 구독이 필요합니다.
3.7, 3.8, 3.9 또는 3.10 버전의 Python이 설치되어 있는지 확인합니다.

Azure를 구독하고 있지 않다면 시작하기 전에 Azure 체험 계정을 만듭니다.

로컬 프로젝트 만들기

이 섹션에서는 Visual Studio Code를 사용하여 로컬 Azure Functions 프로젝트를 만듭니다.

Visual Studio Code에서 F1(또는 Ctrl/Cmd+Shift+P)을 눌러 명령 팔레트를 엽니다. 명령 팔레트에서 Azure Functions: Create New Project...을 검색하여 선택합니다.
프로젝트에 대한 빈 폴더 위치를 선택하고, 선택을 누릅니다.

프롬프트에 따라 다음 정보를 제공합니다.

prompt	값	설명
함수 앱 프로젝트에 대한 언어를 선택합니다.	Python	로컬 Python Functions 프로젝트를 만듭니다.
버전 선택	Azure Functions v4	핵심 도구가 아직 설치되지 않은 경우에만 이 옵션이 표시됩니다. 이 경우 앱을 처음 실행할 때 핵심 도구가 설치됩니다.
Python 버전	Python 3.7, 3.8, 3.9, 3.10	Visual Studio Code는 선택한 버전으로 가상 환경을 만듭니다.
프로젝트의 첫 번째 함수에 대한 템플릿 선택	지금은 건너뛰기
프로젝트를 여는 방법을 선택합니다.	현재 창에서 열기	선택한 폴더에서 Visual Studio Code를 다시 엽니다.

프롬프트에 따라 다음 정보를 제공합니다.

prompt	값	설명
언어 선택	Python(프로그래밍 모델 V2)	V2 프로그래밍 모델을 사용하여 로컬 Python Functions 프로젝트를 만듭니다.
버전 선택	Azure Functions v4	핵심 도구가 아직 설치되지 않은 경우에만 이 옵션이 표시됩니다. 이 경우 앱을 처음 실행할 때 핵심 도구가 설치됩니다.
Python 버전	Python 3.7, 3.8, 3.9, 3.10	Visual Studio Code는 선택한 버전으로 가상 환경을 만듭니다.
프로젝트를 여는 방법을 선택합니다.	현재 창에서 열기	선택한 폴더에서 Visual Studio Code를 다시 엽니다.

필요한 경우 Visual Studio Code가 Azure Functions Core Tools를 설치합니다. 또한 폴더에서 함수 앱 프로젝트를 만듭니다. 이 프로젝트에는 host.json 및 local.settings.json 구성 파일이 포함되어 있습니다.

requirements.txt 파일도 루트 폴더에 생성됩니다. 함수 앱을 실행하는 데 필요한 Python 패키지를 지정합니다.

PyPI에서 azure-functions-durable 설치

프로젝트를 만들면 Azure Functions Visual Studio Code 확장은 선택한 Python 버전으로 가상 환경을 자동으로 만듭니다. 그런 다음, 터미널에서 가상 환경을 활성화하고 Azure Functions 및 Durable Functions에 필요한 일부 종속성을 설치해야 합니다.

편집기에서 requirements.txt를 열고 해당 콘텐츠를 다음 코드로 변경합니다.
```
azure-functions
azure-functions-durable
```
현재 폴더(Ctrl+Shift+`)에서 편집기의 통합 터미널을 엽니다.
통합 터미널에서 운영 체제에 따라 현재 폴더의 가상 환경을 활성화합니다.
- Linux
- MacOS
- Windows
```
source .venv/bin/activate
```
```
source .venv/bin/activate
```
```
.venv\scripts\activate
```
가상 환경이 활성화된 통합 터미널에서 pip를 사용하여 사용자가 정의한 패키지를 설치합니다.
```
python -m pip install -r requirements.txt
```

함수 만들기

기본 Durable Functions 앱에는 다음 세 가지 함수가 포함되어 있습니다.

Orchestrator 함수: 다른 함수를 오케스트레이션하는 워크플로를 설명합니다.
작업 함수: 오케스트레이터 함수에 의해 호출되며, 작업을 수행하고 경우에 따라 반환합니다.
클라이언트 함수: 오케스트레이터 함수를 시작하는 일반 Azure Function입니다. 이 예제에서는 HTTP 트리거 함수를 사용합니다.

오케스트레이터 함수

템플릿을 사용하여 프로젝트에 지속성 함수 코드를 만듭니다.

명령 팔레트에서 Azure Functions: Create Function...을 검색하여 선택합니다.

프롬프트에 따라 다음 정보를 제공합니다.

prompt	값	설명
함수의 템플릿 선택	Durable Functions 오케스트레이터	Durable Functions 오케스트레이션 만들기
함수 이름 제공	HelloOrchestrator	지속성 함수의 이름

작업 함수를 조정하기 위한 오케스트레이터를 추가했습니다. 오케스트레이터 함수를 보려면 HelloOrchestrator/__init__.py를 엽니다. context.call_activity를 호출할 때마다 Hello라는 작업 함수가 호출됩니다.

다음으로, 참조된 Hello 작업 함수를 추가하겠습니다.

작업 함수

명령 팔레트에서 Azure Functions: Create Function...을 검색하여 선택합니다.
프롬프트에 따라 다음 정보를 제공합니다.

prompt 값 설명

함수의 템플릿 선택 Durable Functions 활동 작업 함수 만들기

함수 이름 제공 Hello 작업 함수의 이름

prompt	값	설명
함수의 템플릿 선택	Durable Functions 활동	작업 함수 만들기
함수 이름 제공	Hello	작업 함수의 이름

오케스트레이터에서 호출하는 Hello 작업 함수를 추가했습니다. Hello/__init__.py를 열어 이름을 입력으로 사용하고 인사말을 반환하는지 확인합니다. 작업 함수에서는 데이터베이스 호출, 컴퓨팅 수행 등의 작업을 수행할 것입니다.

마지막으로, 오케스트레이션을 시작하는 HTTP 트리거 함수를 추가합니다.

클라이언트 함수(HTTP 스타터)

명령 팔레트에서 Azure Functions: Create Function...을 검색하여 선택합니다.

프롬프트에 따라 다음 정보를 제공합니다.

prompt	값	설명
함수의 템플릿 선택	Durable Functions HTTP 스타터	HTTP 스타터 함수 만들기
함수 이름 제공	DurableFunctionsHttpStart	클라이언트 함수의 이름
권한 부여 수준	익명	데모용으로 인증 없이 함수를 호출할 수 있도록 허용합니다.

오케스트레이션을 시작하는 HTTP 트리거 함수를 추가했습니다. DurableFunctionsHttpStart/__init__.py를 열어 client.start_new를 사용하여 새 오케스트레이션을 시작하는지 확인합니다. client.create_check_status_response를 사용하여 새 오케스트레이션을 모니터링하고 관리하는 데 사용할 수 있는 URL이 포함된 HTTP 응답이 반환되는 것을 볼 수 있습니다.

이제 로컬로 실행하고 Azure에 배포할 수 있는 Durable Functions 앱이 생겼습니다.

요구 사항

Python 프로그래밍 모델의 버전 2에는 다음과 같은 최소 버전이 필요합니다.

Azure Functions 런타임 v4.16+
Azure Functions Core Tools v4.0.5095+(로컬로 실행되는 경우)
azure-functions-durable v1.2.4+

v2 프로그래밍 모델 사용

v2 프로그래밍 모델을 실행하려면 다음 애플리케이션 설정이 필요합니다.

이름: AzureWebJobsFeatureFlags
값: EnableWorkerIndexing

Azure Functions Core Tools를 사용하여 로컬로 실행하는 경우 이 설정을 local.settings.json 파일에 추가해야 합니다. Azure에서 실행하는 경우 선택한 도구를 사용하여 다음 단계를 수행합니다.

<FUNCTION_APP_NAME> 및 <RESOURCE_GROUP_NAME>을 각각 함수 앱의 이름과 리소스 그룹의 이름으로 바꿉니다.

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

<FUNCTION_APP_NAME> 및 <RESOURCE_GROUP_NAME>을 각각 함수 앱의 이름과 리소스 그룹의 이름으로 바꿉니다.

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

VS Code에 대한 Azure Functions 확장이 설치되어 있는지 확인합니다.
F1 키를 눌러 명령 팔레트를 엽니다. 명령 팔레트에서 Azure Functions: Add New Setting...을 검색하여 선택합니다.
메시지가 표시되면 구독 및 함수 앱 선택
이름으로 AzureWebJobsFeatureFlags를 입력하고 Enter 키를 누릅니다.
값에 EnableWorkerIndexing을 입력하고 Enter를 누릅니다.

이러한 3가지 함수 형식을 사용하여 기본 Durable Functions 앱을 만들려면 function_app.py의 내용을 다음 Python 코드로 바꿉니다.

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}"

샘플의 각 함수 및 용도에 대한 설명은 아래 표를 검토하세요.

메서드	설명
`hello_orchestrator`	워크플로를 설명하는 오케스트레이터 함수입니다. 이 경우 오케스트레이션이 시작되고, 시퀀스에서 세 개의 함수를 호출하고, 목록에 있는 3개 함수 모두의 순서가 지정된 결과를 반환합니다.
`hello`	오케스트레이션되는 작업을 수행하는 활동 함수입니다. 함수는 인수로 전달된 도시에 대한 간단한 인사말을 반환합니다.
`http_start`	오케스트레이션 인스턴스를 시작하고 상태 확인 응답을 반환하는 HTTP 트리거 함수입니다.

참고 항목

Durable Functions는 Python V2의 청사진도 지원합니다. 이를 사용하려면 여기에 표시된 것처럼 azure-functions-durableBlueprint 클래스를 사용하여 청사진 함수를 등록해야 합니다. 그러면 결과 청사진을 정상적으로 등록할 수 있습니다. 예제는 샘플을 참조하세요.

로컬에서 함수 테스트

Azure Functions Core Tools를 사용하면 로컬 개발 컴퓨터에서 Azure Functions 프로젝트를 실행할 수 있습니다. 설치되지 않은 경우 Visual Studio Code에서 처음으로 함수를 시작할 때 이러한 도구를 설치하라는 메시지가 표시됩니다.

함수를 테스트하려면 Hello 작업 함수 코드(Hello/__init__.py)에서 중단점을 설정합니다. F5를 누르거나 명령 팔레트에서 Debug: Start Debugging을 선택하여 함수 앱 프로젝트를 시작합니다. 핵심 도구의 출력이 터미널 패널에 표시됩니다.

함수를 테스트하려면 hello 작업 함수 코드에서 중단점을 설정합니다. F5를 누르거나 명령 팔레트에서 Debug: Start Debugging을 선택하여 함수 앱 프로젝트를 시작합니다. 핵심 도구의 출력이 터미널 패널에 표시됩니다.

참고 항목

디버깅에 대한 자세한 내용은 Durable Functions 진단을 참조하세요.

Durable Functions를 사용하려면 Azure 스토리지 계정을 실행해야 합니다. Visual Studio Code에서 스토리지 계정을 선택하라는 메시지가 표시되면 스토리지 계정 선택을 선택합니다.

메시지에 따라 다음 정보를 제공하여 Azure에서 새 스토리지 계정을 만듭니다.

prompt	값	설명
구독 선택	구독 이름	Azure 구독 선택
스토리지 계정 선택	새 스토리지 계정 만들기
새 스토리지 계정의 이름 입력	고유 이름	만들 스토리지 계정의 이름
리소스 그룹 선택	고유 이름	만들 리소스 그룹의 이름
위치 선택	region	가까운 지역 선택

터미널 패널에서 HTTP 트리거 함수의 URL 엔드포인트를 복사합니다.

브라우저 또는 Postman, cURL과 같은 도구를 사용하여 HTTP 요청을 URL 엔드포인트로 보냅니다. 마지막 세그먼트를 오케스트레이터 함수의 이름(HelloOrchestrator)으로 바꿉니다. URL은 http://localhost:7071/api/orchestrators/HelloOrchestrator와 유사해야 합니다.

응답은 지속성 오케스트레이션이 성공적으로 시작되었음을 알리는 HTTP 함수의 초기 결과입니다. 아직 오케스트레이션의 최종 결과는 아닙니다. 응답에는 몇 가지 유용한 URL이 포함되어 있습니다. 현재로는 오케스트레이션의 상태를 쿼리해보겠습니다.

브라우저 또는 Postman, cURL과 같은 도구를 사용하여 HTTP 요청을 URL 엔드포인트로 보냅니다. 마지막 세그먼트를 오케스트레이터 함수의 이름(hello_orchestrator)으로 바꿉니다. URL은 http://localhost:7071/api/orchestrators/hello_orchestrator와 유사해야 합니다.

응답은 지속성 오케스트레이션이 성공적으로 시작되었음을 알리는 HTTP 함수의 초기 결과입니다. 아직 오케스트레이션의 최종 결과는 아닙니다. 응답에는 몇 가지 유용한 URL이 포함되어 있습니다. 현재로는 오케스트레이션의 상태를 쿼리해보겠습니다.

statusQueryGetUri에 대한 URL 값을 복사하여 브라우저의 주소 표시줄에 붙여넣고 요청을 실행합니다. 또는 Postman을 사용하여 GET 요청을 계속 발행할 수도 있습니다.

요청은 상태에 대한 오케스트레이션 인스턴스를 쿼리합니다. 인스턴스가 완료되었음을 나타내고 지속성 함수의 출력 또는 결과를 포함하는 최종 응답을 가져와야 합니다. 다음과 같이 표시됩니다.

{
    "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"
}

{
    "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"
}

디버깅을 중지하려면 Visual Studio Code에서 Shift+F5를 누릅니다.

함수가 로컬 컴퓨터에서 제대로 실행되는지 확인한 후에 해당 프로젝트를 Azure에 게시해야 합니다.

Azure 리소스를 만들거나 앱을 게시하기 전에 Azure에 로그인해야 합니다.

아직 로그인하지 않은 경우, 작업 막대에서 Azure 아이콘을 선택합니다. 그런 다음, 리소스 영역에서 Azure에 로그인...을 선택합니다.

이미 로그인되어 있고 기존 구독을 볼 수 있는 경우 다음 섹션으로 이동합니다. 아직 Azure 계정이 없는 경우 만들기 및 Azure 계정...을 선택합니다. 학생은 Azure for Students 계정 만들기...를 선택할 수 있습니다.
브라우저에 메시지가 표시되면 Azure 계정을 선택하고 Azure 계정 자격 증명을 사용하여 로그인합니다. 새 계정을 만드는 경우 계정을 만든 후 로그인할 수 있습니다.
성공적으로 로그인한 후에는 브라우저 창을 닫을 수 있습니다. Azure 계정에 속하는 구독은 사이드바에 표시됩니다.

Azure에서 함수 앱 만들기

이 섹션에서는 함수 앱 및 관련 리소스를 Azure 구독에서 만듭니다.

작업 표시줄에서 Azure 아이콘을 선택합니다. 그런 다음, 리소스 영역에서 + 아이콘을 선택하고 Azure에서 함수 앱 만들기 옵션을 선택합니다.

프롬프트에서 다음 정보를 제공합니다.

프롬프트	선택 사항
구독 선택	사용할 구독을 선택합니다. 리소스 아래에 하나의 구독만 표시되는 경우 이 메시지가 표시되지 않습니다.
함수 앱에 대해 전역적으로 고유한 이름 입력	URL 경로에 유효한 이름을 입력합니다. 입력한 이름이 Azure Functions에서 고유한지 확인하기 위해 유효성을 검사합니다.
런타임 스택 선택	로컬로 실행한 언어 버전을 선택합니다.
새 리소스의 위치 선택	성능을 향상시키려면 근처에 있는 지역을 선택합니다.

확장은 Azure에서 생성되는 개별 리소스의 상태를 Azure: Activity Log 패널에 표시합니다.

Azure 리소스 만들기의 로그

생성이 완료되면 구독에 다음과 같은 Azure 리소스가 생성됩니다. 리소스 이름은 함수 앱 이름에 따라 지정됩니다.
- 리소스 그룹 - 관련 리소스에 대한 논리 컨테이너입니다.
- 표준 Azure Storage 계정 - 프로젝트에 대한 상태 및 기타 정보를 유지 관리합니다.
- 함수 앱 - 함수 코드를 실행할 수 있는 환경을 제공합니다. 함수 앱을 사용하면 함수를 논리 단위로 그룹화하여 동일한 호스팅 계획 내에서 더 쉽게 리소스를 관리, 배포 및 공유할 수 있습니다.
- 함수 앱의 기본 호스트를 정의하는 App Service 플랜입니다.
- 앱에서 함수의 사용을 추적하는 함수 앱에 연결된 Application Insights 인스턴스입니다.
함수 앱을 만들고 배포 패키지가 적용되면 알림이 표시됩니다.

팁

기본적으로 함수 앱에 필요한 Azure 리소스는 사용자가 제공하는 함수 앱 이름을 기반으로 만들어집니다. 기본적으로 함수 앱과 동일한 새 리소스 그룹에도 만들어집니다. 이러한 리소스의 이름을 사용자 지정하거나 기존 리소스를 다시 사용하려면 대신 고급 만들기 옵션을 사용하여 프로젝트를 게시해야 합니다.

Azure에 프로젝트 배포

Important

기존 함수 앱에 배포하면 항상 Azure에서 해당 앱의 콘텐츠를 덮어씁니다.

Azure 작업의 리소스 영역에서 방금 만든 함수 앱 리소스를 찾아 마우스 오른쪽 단추로 클릭한 다음, 함수 앱에 배포...를 선택합니다.
이전 배포를 덮어쓰라는 메시지가 표시되면 배포를 선택하여 함수 코드를 새 함수 앱 리소스에 배포합니다.
배포가 완료되면 출력 보기를 선택하여 사용자가 만든 Azure 리소스를 포함한 만들기 및 배포 결과를 봅니다. 알림이 누락된 경우 오른쪽 아래 모서리에 있는 종 모양 아이콘을 선택하여 다시 확인합니다.

Azure에서 함수 테스트

출력 패널에서 HTTP 트리거의 URL을 복사합니다. HTTP 트리거 함수를 호출하는 URL은 https://<functionappname>.azurewebsites.net/api/orchestrators/HelloOrchestrator 형식입니다.

출력 패널에서 HTTP 트리거의 URL을 복사합니다. HTTP 트리거 함수를 호출하는 URL은 https://<functionappname>.azurewebsites.net/api/orchestrators/hello_orchestrator 형식입니다.

HTTP 요청에 대한 이 새 URL을 브라우저의 주소 표시줄에 붙여넣습니다. 게시된 앱을 사용하는 경우 앞으로 같은 상태 응답을 가져와야 합니다.

다음 단계

Visual Studio Code를 사용하여 Python 지속성 함수 앱을 만들고 게시했습니다.

일반적인 지속성 함수 패턴에 대해 알아보기

Python에서 첫 번째 지속성 함수 만들기

필수 조건

로컬 프로젝트 만들기

PyPI에서 azure-functions-durable 설치

함수 만들기

오케스트레이터 함수

작업 함수

클라이언트 함수(HTTP 스타터)

요구 사항

v2 프로그래밍 모델 사용

로컬에서 함수 테스트

Azure에 로그인

Azure에서 함수 앱 만들기

Azure에 프로젝트 배포

Azure에서 함수 테스트

다음 단계

추가 리소스