JavaScript로 첫 번째 지속형 함수 만들기

아티클
04/14/2024

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

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

Important

이 문서의 내용은 페이지 상단의 선택기에서 선택한 Node.js 프로그래밍 모델에 따라 변경됩니다. v4 모델은 일반적으로 사용 가능하며 JavaScript 및 TypeScript 개발자를 위해 보다 유연하고 직관적인 환경을 제공하도록 설계되었습니다. 마이그레이션 가이드에서 v3과 v4의 차이점에 대해 자세히 알아봅니다.

Edge 창의 스크린샷 Azure에서 간단한 지속성 함수를 호출하는 출력을 표시하는 창

필수 조건

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

Visual Studio Code를 설치합니다.

Azure Functions와 VS Code 확장 설치 비교

Azure Functions VS Code 확장 버전 1.10.4 이상을 설치합니다.

최신 버전의 Azure Functions Core Tools가 있는지 확인합니다.

Azure Functions Core Tools 버전 v4.0.5382 이상이 설치되어 있는지 확인합니다.

Durable Functions를 사용하려면 Azure 스토리지 계정이 필요합니다. Azure 구독이 필요합니다.

16.x+ 버전의 Node.js가 설치되어 있는지 확인합니다.

18.x+ 버전의 Node.js가 설치되어 있는지 확인합니다.

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

로컬 프로젝트 만들기

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

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

지시에 따라 다음 정보를 제공합니다.

prompt	값	설명
함수 앱 프로젝트에 대한 언어를 선택합니다.	JavaScript	로컬 Node.js Functions 프로젝트를 만듭니다.
JavaScript 프로그래밍 모델 선택	모델 V3	V3 프로그래밍 모델을 선택합니다.
버전 선택	Azure Functions v4	핵심 도구가 아직 설치되지 않은 경우에만 이 옵션이 표시됩니다. 이 경우 앱을 처음 실행할 때 핵심 도구가 설치됩니다.
프로젝트의 첫 번째 함수에 대한 템플릿 선택	지금은 건너뛰기
프로젝트를 여는 방법을 선택합니다.	현재 창에서 열기	선택한 폴더에서 VS Code를 다시 엽니다.

지시에 따라 다음 정보를 제공합니다.

prompt	값	설명
함수 앱 프로젝트에 대한 언어를 선택합니다.	JavaScript	로컬 Node.js Functions 프로젝트를 만듭니다.
JavaScript 프로그래밍 모델 선택	모델 v4	V4 프로그래밍 모델을 선택합니다.
버전 선택	Azure Functions v4	핵심 도구가 아직 설치되지 않은 경우에만 이 옵션이 표시됩니다. 이 경우 앱을 처음 실행할 때 핵심 도구가 설치됩니다.
프로젝트의 첫 번째 함수에 대한 템플릿 선택	지금은 건너뛰기
프로젝트를 여는 방법을 선택합니다.	현재 창에서 열기	선택한 폴더에서 VS Code를 다시 엽니다.

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

package.json 파일도 루트 폴더에 생성됩니다.

Durable Functions npm 패키지 설치

Node.js 함수 앱에서 Durable Functions를 작업하려면 durable-functions 라이브러리를 사용합니다.

V4 프로그래밍 모델을 사용하려면 durable-functions 버전의 미리 보기 v3.x을(를) 설치해야 합니다.

보기 메뉴 또는 Ctrl + Shift + ` 키를 사용하여 VS Code에서 새 터미널을 엽니다.

함수 앱의 루트 디렉터리에서 npm install durable-functions를 실행하여 durable-functions npm 패키지를 설치합니다.

함수 앱의 루트 디렉터리에서 npm install durable-functions@preview를 실행하여 durable-functions npm 패키지 미리 보기 버전을 설치합니다.

함수 만들기

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

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

오케스트레이터 함수

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

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

지시에 따라 다음 정보를 제공합니다.

prompt	값	설명
함수의 템플릿 선택	Durable Functions 오케스트레이터	Durable Functions 오케스트레이션 만들기
지속성 스토리지 유형을 선택합니다.	Azure Storage(기본값)	Durable Functions에 사용되는 스토리지 백 엔드를 선택합니다.
함수 이름 제공	HelloOrchestrator	지속성 함수의 이름

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

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

작업 함수

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

prompt 값 설명

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

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

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

오케스트레이터에서 호출하는 Hello 작업 함수를 추가했습니다. Hello/index.js를 열고, 입력으로 이름을 가져오고 인사말을 반환하는지 확인합니다. 작업 함수는 워크플로에서 "실제 작업"을 수행하는 위치입니다. 즉, 데이터베이스 호출을 수행하거나 일부 결정적이지 않은 계산을 수행하는 등의 작업을 수행합니다.

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

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

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

지시에 따라 다음 정보를 제공합니다.

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

오케스트레이션을 시작하는 HTTP 트리거 함수를 추가했습니다. DurableFunctionsHttpStart/index.js를 열면 client.startNew를 사용하여 새 오케스트레이션을 시작한 다음, client.createCheckStatusResponse를 사용하여 새 오케스트레이션을 모니터링하고 관리하는 데 사용할 수 있는 URL이 포함된 HTTP 응답이 반환되는 것을 볼 수 있습니다.

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

V4 프로그래밍 모델의 이점 중 하나는 함수를 작성하는 곳의 유연성입니다. V4 모델에서 단일 템플릿을 사용하여 프로젝트의 한 파일에 세 가지 함수를 모두 만들 수 있습니다.

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

지시에 따라 다음 정보를 제공합니다.

prompt	값	설명
함수의 템플릿 선택	Durable Functions 오케스트레이터	Durable Functions 오케스트레이션, 작업 함수 및 지속성 클라이언트 시작 함수를 사용하여 파일을 만듭니다.
지속성 스토리지 유형 선택	Azure Storage(기본값)	Durable Functions에 사용되는 스토리지 백 엔드를 선택합니다.
함수 이름 제공	hello	지속성 함수에 사용되는 이름

src/functions/hello.js를 열어 만든 함수를 봅니다.

작업 함수를 조정하기 위한 helloOrchestrator(이)라는 오케스트레이터를 추가했습니다. context.df.callActivity을(를) 호출할 때마다 hello(이)라는 작업 함수가 호출됩니다.

또한, 오케스트레이터에서 호출하는 hello 작업 함수를 추가했습니다. 동일한 파일에서 이름을 입력으로 사용하고 인사말을 반환하는 것을 볼 수 있습니다. 작업 함수는 워크플로에서 "실제 작업"을 수행하는 위치입니다. 즉, 데이터베이스 호출을 수행하거나 일부 결정적이지 않은 계산을 수행하는 등의 작업을 수행합니다.

마지막으로 오케스트레이션을 시작하는 HTTP 트리거 함수를 추가했습니다. 동일한 파일에서 client.startNew을(를) 사용하여 새 오케스트레이션을 시작하는 것을 볼 수 있습니다. client.createCheckStatusResponse를 사용하여 새 오케스트레이션을 모니터링하고 관리하는 데 사용할 수 있는 URL이 포함된 HTTP 응답이 반환되는 것을 볼 수 있습니다.

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

로컬에서 함수 테스트

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

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

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

참고 항목

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

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

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

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

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

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

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

응답은 지속성 오케스트레이션이 성공적으로 시작되었음을 알리는 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": "helloOrchestrator",
    "instanceId": "6ba3f77933b1461ea1a3828c013c9d56",
    "runtimeStatus": "Completed",
    "input": "",
    "customStatus": null,
    "output": [
        "Hello, Tokyo",
        "Hello, Seattle",
        "Hello, Cairo"
    ],
    "createdTime": "2023-02-13T23:02:21Z",
    "lastUpdatedTime": "2023-02-13T23:02:25Z"
}

디버깅을 중지하려면 VS 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에서 함수 테스트

참고 항목

V4 노드 프로그래밍 모델을 사용하려면 앱이 Azure Functions 런타임의 버전 4.25 이상에서 실행되고 있는지 확인합니다.

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

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

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

다음 단계

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

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

Share via

JavaScript로 첫 번째 지속형 함수 만들기

필수 조건

로컬 프로젝트 만들기

Durable Functions npm 패키지 설치

함수 만들기

오케스트레이터 함수

작업 함수

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

로컬에서 함수 테스트

Azure에서 함수 앱 만들기

Azure에 프로젝트 배포

Azure에서 함수 테스트

다음 단계

추가 리소스