Azure App Service 계획에서 Linux로 실행되는 함수 앱 만들기Create a function app on Linux in an Azure App Service plan

Azure Functions를 사용하면 Linux에서 기본 Azure App Service 컨테이너에 함수를 호스트할 수 있습니다.Azure Functions lets you host your functions on Linux in a default Azure App Service container. 이 문서에서는 Azure Portal을 사용하여 App Service 계획에서 실행되는 Linux 호스티드 함수 앱을 만드는 방법을 보여 줍니다.This article walks you through how to use the Azure portal to create a Linux-hosted function app that runs in an App Service plan. 고유한 사용자 지정 컨테이너를 가져올 수도 있습니다.You can also bring your own custom container.

참고

포털 내 편집은 JavaScript, PowerShell, TypeScript 및 c # 스크립트 함수에 대해서만 지원 됩니다.In-portal editing is only supported for JavaScript, PowerShell, TypeScript, and C# Script functions.

C # 클래스 라이브러리, Java 및 Python 함수의 경우 포털에서 함수 앱을 만들 수 있지만 로컬에서 함수를 만든 다음 Azure에 게시 해야 합니다.For C# class library, Java, and Python functions, you can create the function app in the portal, but you must also create the functions locally and then publish them to Azure.

Azure 구독이 아직 없는 경우 시작하기 전에 체험 계정을 만듭니다.If you don't have an Azure subscription, create a free account before you begin.

Azure에 로그인Sign in to Azure

Azure 계정을 사용하여 https://portal.azure.com에서 Azure Portal에 로그인합니다.Sign in to the Azure portal at https://portal.azure.com with your Azure account.

함수 앱 만들기Create a function app

Linux에서 함수 실행을 호스트하는 함수 앱이 있어야 합니다.You must have a function app to host the execution of your functions on Linux. 함수 앱은 함수 코드 실행을 위한 환경을 제공합니다.The function app provides an environment for execution of your function code. 이를 통해 함수를 논리 단위로 그룹화하여 더욱 쉽게 리소스를 관리, 배포, 크기 조정 및 공유할 수 있습니다.It lets you group functions as a logical unit for easier management, deployment, scaling, and sharing of resources. 이 문서에서는 함수 앱을 만들 때 App Service 계획을 만듭니다.In this article, you create an App Service plan when you create your function app.

  1. Azure Portal 메뉴 또는 페이지에서 리소스 만들기 를 선택합니다.From the Azure portal menu or the Home page, select Create a resource.

  2. 새로 만들기 페이지에서 컴퓨팅 > 함수 앱 을 선택합니다.In the New page, select Compute > Function App.

    Azure Portal에서 함수 앱 만들기

  3. 기본 사항 페이지에서 함수 앱 설정을 다음 표에서 지정한 대로 사용합니다.On the Basics page, use the function app settings as specified in the following table.

    설정Setting 제안 값Suggested value 설명Description
    구독Subscription 사용자의 구독Your subscription 이 새 함수 앱이 만들어질 구독입니다.The subscription under which this new function app is created.
    리소스 그룹Resource Group myResourceGroupmyResourceGroup 함수 앱을 만들 새 리소스 그룹의 이름입니다.Name for the new resource group in which to create your function app.
    함수 앱 이름Function App name 전역적으로 고유한 이름Globally unique name 새 함수 앱을 식별하는 이름입니다.Name that identifies your new function app. 유효한 문자는 a-z(대/소문자 구분 안 함), 0-9-입니다.Valid characters are a-z (case insensitive), 0-9, and -.
    게시Publish 코드(기본값)Code (default) 코드 파일 또는 Docker 컨테이너를 게시하는 옵션입니다.Option to publish code files or a Docker container.
    런타임 스택Runtime stack 기본 설정 언어Preferred language 즐겨찾는 함수 프로그래밍 언어를 지원하는 런타임을 선택합니다.Choose a runtime that supports your favorite function programming language. C# 및 F# 함수의 경우 .NET Core 를 선택합니다.Choose .NET Core for C# and F# functions.
    버전Version 버전 번호Version number 설치된 런타임의 버전을 선택합니다.Choose the version of your installed runtime.
    지역Region 기본 지역Preferred region 사용자 근처 또는 함수가 액세스할 기타 서비스에 가까운 지역을 선택합니다.Choose a region near you or near other services your functions access.

    기본 페이지

  4. 다음: 호스팅 을 선택합니다.Select Next : Hosting. 호스팅 페이지에서 다음 설정을 입력합니다.On the Hosting page, enter the following settings.

    설정Setting 제안 값Suggested value DescriptionDescription
    Storage 계정Storage account 전역적으로 고유한 이름Globally unique name 함수 앱에서 사용하는 스토리지 계정을 만듭니다.Create a storage account used by your function app. 스토리지 계정 이름은 3자에서 24자 사이여야 하고 숫자와 소문자만 포함할 수 있습니다.Storage account names must be between 3 and 24 characters in length and can contain numbers and lowercase letters only. 기존 계정을 사용할 수도 있습니다. 여기서는 스토리지 계정 요구 사항을 충족해야 합니다.You can also use an existing account, which must meet the storage account requirements.
    운영 체제Operating system LinuxLinux 운영 체제는 런타임 스택 선택에 따라 미리 선택되지만 필요한 경우 설정을 변경할 수 있습니다.An operating system is pre-selected for you based on your runtime stack selection, but you can change the setting if necessary.
    계획Plan 소모량(서버리스)Consumption (Serverless) 함수 앱에 리소스가 할당되는 방법을 정의하는 호스팅 계획입니다.Hosting plan that defines how resources are allocated to your function app. 기본 소비 계획에서 함수의 필요에 따라 리소스가 동적으로 추가됩니다.In the default Consumption plan, resources are added dynamically as required by your functions. 서버리스 호스팅에서는 함수가 실행되는 시간 만큼만 요금을 지불하면 됩니다.In this serverless hosting, you pay only for the time your functions run. App Service 계획에서 실행하는 경우 함수 앱의 크기 조정을 관리해야 합니다.When you run in an App Service plan, you must manage the scaling of your function app.

    호스팅 페이지

  5. 다음: 모니터링 을 선택합니다.Select Next : Monitoring. 모니터링 페이지에서 다음 설정을 입력합니다.On the Monitoring page, enter the following settings.

    설정Setting 제안 값Suggested value DescriptionDescription
    Application InsightsApplication Insights (기본값)Yes (default) 가장 가까운 지원 영역에 동일한 앱 이름 의 Application Insight 리소스를 만듭니다.Creates an Application Insights resource of the same App name in the nearest supported region. 이 설정을 확장하거나 새로 만들기 를 선택하면 Application Insights 이름을 변경하거나 데이터를 저장하려는 Azure 지리적 위치에서 다른 지역을 선택할 수 있습니다.By expanding this setting or selecting Create new, you can change the Application Insights name or choose a different region in an Azure geography where you want to store your data.

    모니터링 페이지

  6. 검토 + 만들기 를 선택하여 앱 구성 선택을 검토합니다.Select Review + create to review the app configuration selections.

  7. 검토 + 만들기 페이지에서 설정을 검토한 다음, 만들기 를 선택하여 함수 앱을 프로비저닝하고 배포합니다.On the Review + create page, review your settings, and then select Create to provision and deploy the function app.

  8. 포털의 오른쪽 위 모서리에 있는 알림 아이콘을 선택하고 배포 성공 메시지를 확인합니다.Select the Notifications icon in the upper-right corner of the portal and watch for the Deployment succeeded message.

  9. 리소스로 이동 을 선택하여 함수 앱을 봅니다.Select Go to resource to view your new function app. 대시보드에 고정 을 선택할 수도 있습니다.You can also select Pin to dashboard. 고정하면 대시보드에서 이 함수 앱 리소스로 쉽게 돌아올 수 있습니다.Pinning makes it easier to return to this function app resource from your dashboard.

    배포 알림

    함수 앱을 사용할 수 있게 된 이후에도 완전히 초기화될 때까지 몇 분 정도 걸릴 수 있습니다.Even after your function app is available, it may take a few minutes to be fully initialized.

다음으로 새 함수 앱에서 함수를 만듭니다.Next, you create a function in the new function app.

HTTP 트리거 함수 만들기Create an HTTP trigger function

이 섹션에서는 포털의 새 함수 앱에서 함수를 만드는 방법을 보여 줍니다.This section shows you how to create a function in your new function app in the portal.

참고

포털 개발 환경은 Azure Functions를 사용해 보는 데 유용할 수 있습니다.The portal development experience can be useful for trying out Azure Functions. 대부분의 시나리오에서 Visual Studio Code 또는 Azure Functions Core Tools를 사용하여 함수를 개발하고 함수 앱에 프로젝트를 게시하는 것이 좋습니다.For most scenarios, consider developing your functions locally and publishing the project to your function app using either Visual Studio Code or the Azure Functions Core Tools.

  1. Functions 창의 왼쪽 메뉴에서 Functions 를 선택한 다음, 맨 위 메뉴에서 추가 를 선택합니다.From the left menu of the Functions window, select Functions, then select Add from the top menu.

  2. 새 함수 창에서 Http 트리거 를 선택합니다.From the New Function window, select Http trigger.

    HTTP 트리거 함수 선택

  3. 새 함수 창에서 새 함수 의 기본 이름을 적용하거나 새 이름을 입력합니다.In the New Function window, accept the default name for New Function, or enter a new name.

  4. 권한 부여 수준 드롭다운 목록에서 익명 을 선택한 다음, 함수 만들기 를 선택합니다.Choose Anonymous from the Authorization level drop-down list, and then select Create Function.

    Azure에서 HTTP 트리거 함수를 만듭니다.Azure creates the HTTP trigger function. 이제 HTTP 요청을 전송하여 새 함수를 실행할 수 있습니다.Now, you can run the new function by sending an HTTP request.

함수 테스트Test the function

  1. 새 HTTP 트리거 함수의 왼쪽 메뉴에서 코드 + 테스트 를 선택한 다음, 상단 메뉴에서 함수 URL 가져오기 를 선택합니다.In your new HTTP trigger function, select Code + Test from the left menu, then select Get function URL from the top menu.

    [함수 URL 가져오기] 선택

  2. 함수 URL 가져오기 대화 상자의 드롭다운 목록에서 기본값 을 선택한 다음, 클립보드에 복사 아이콘을 선택합니다.In the Get function URL dialog box, select default from the drop-down list, and then select the Copy to clipboard icon.

    Azure Portal에서 함수 URL 복사

  3. 함수 URL을 브라우저의 주소 표시줄에 붙여 넣습니다.Paste the function URL into your browser's address bar. ?name=<your_name> 쿼리 문자열 값을 이 URL의 마지막에 추가하고 Enter 키를 눌러 요청을 실행합니다.Add the query string value ?name=<your_name> to the end of this URL and press Enter to run the request.

    다음 예에서는 브라우저의 응답을 보여 줍니다.The following example shows the response in the browser:

    브라우저에 함수 응답.

    요청 URL에는 기본적으로 HTTP를 통해 함수에 액세스하는 데 필요한 키가 포함됩니다.The request URL includes a key that is required, by default, to access your function over HTTP.

  4. 함수가 실행되면 추적 정보가 로그에 기록됩니다.When your function runs, trace information is written to the logs. 추적 출력을 보려면 포털의 코드 + 테스트 페이지로 돌아가서 페이지 하단에 있는 로그 화살표를 확장합니다.To see the trace output, return to the Code + Test page in the portal and expand the Logs arrow at the bottom of the page.

    Azure Portal에서 함수 로그 뷰어.

리소스 정리Clean up resources

이 컬렉션의 다른 빠른 시작은 이 빠른 시작을 기반으로 구성됩니다.Other quickstarts in this collection build upon this quickstart. 이후의 빠른 시작, 자습서 또는 기타 이 빠른 시작에서 만든 서비스를 사용하여 작업하려는 경우 이 빠른 시작에서 만든 리소스를 정리하지 않습니다.If you plan to work with subsequent quickstarts, tutorials, or with any of the services you have created in this quickstart, do not clean up the resources.

Azure에서 리소스 란 함수 앱, 함수, 스토리지 계정 등을 의미합니다.Resources in Azure refer to function apps, functions, storage accounts, and so forth. 리소스는 리소스 그룹 으로 그룹화되며 그룹을 삭제하면 그룹의 모든 항목을 삭제할 수 있습니다.They're grouped into resource groups, and you can delete everything in a group by deleting the group.

이러한 빠른 시작을 완료하기 위해 리소스를 만들었습니다.You created resources to complete these quickstarts. 계정 상태서비스 가격 책정에 따라 리소스에 대해 요금이 청구될 수 있습니다.You may be billed for these resources, depending on your account status and service pricing. 리소스가 더 이상 필요하지 않게 되면 다음과 같이 삭제합니다.If you don't need the resources anymore, here's how to delete them:

  1. Azure Portal에서 리소스 그룹 페이지로 이동합니다.In the Azure portal, go to the Resource group page.

    함수 앱 페이지에서 해당 페이지로 이동하려면 개요 탭을 선택한 후 리소스 그룹 아래의 링크를 선택합니다.To get to that page from the function app page, select the Overview tab and then select the link under Resource group.

    함수 앱 페이지에서 삭제할 리소스 그룹을 선택합니다.

    대시보드에서 해당 페이지로 이동하려면 리소스 그룹 을 선택한 다음, 이 문서에 사용한 리소스 그룹을 선택합니다.To get to that page from the dashboard, select Resource groups, and then select the resource group that you used for this article.

  2. 리소스 그룹 페이지에서 포함된 리소스 목록을 검토하고 삭제하려는 항목인지 확인합니다.In the Resource group page, review the list of included resources, and verify that they're the ones you want to delete.

  3. 리소스 그룹 삭제 를 선택하고 지시를 따릅니다.Select Delete resource group, and follow the instructions.

    삭제는 몇 분 정도 소요됩니다.Deletion may take a couple of minutes. 완료되면 알림이 잠시 표시됩니다.When it's done, a notification appears for a few seconds. 페이지 위쪽의 종 모양 아이콘을 선택해도 알림을 확인할 수 있습니다.You can also select the bell icon at the top of the page to view the notification.

다음 단계Next steps

간단한 HTTP 트리거 함수가 있는 함수 앱을 만들었습니다.You have created a function app with a simple HTTP trigger function.

첫 번째 함수를 만들었으므로, Storage 큐에 메시지를 작성하는 함수에 출력 바인딩을 추가해 보겠습니다.Now that you've created your first function, let's add an output binding to the function that writes a message to a Storage queue.

자세한 내용은 Azure Functions HTTP 바인딩을 참조하세요.For more information, see Azure Functions HTTP bindings.