함수 앱 관리Manage your function app

Azure Functions에서 함수 앱은 개별 함수에 대한 실행 컨텍스트를 제공합니다.In Azure Functions, a function app provides the execution context for your individual functions. 함수 앱 동작은 지정된 함수 앱에서 호스트하는 모든 함수에 적용됩니다.Function app behaviors apply to all functions hosted by a given function app. 함수 앱의 모든 함수는 동일한 언어여야 합니다.All functions in a function app must be of the same language.

함수 앱의 개별 함수는 함께 배포 되며 함께 확장 됩니다.Individual functions in a function app are deployed together and are scaled together. 동일한 함수 앱의 모든 함수는 함수 앱이 확장 될 때 인스턴스당 리소스를 공유 합니다.All functions in the same function app share resources, per instance, as the function app scales.

연결 문자열, 환경 변수 및 기타 응용 프로그램 설정은 각 함수 앱에 대해 개별적으로 정의 됩니다.Connection strings, environment variables, and other application settings are defined separately for each function app. 함수 앱 간에 공유 해야 하는 모든 데이터는 지속형 저장소에 외부적으로 저장 해야 합니다.Any data that must be shared between function apps should be stored externally in a persisted store.

이 문서에서는 함수 앱을 구성 하 고 관리 하는 방법을 설명 합니다.This article describes how to configure and manage your function apps.

Azure CLI를 사용 하 여 많은 구성 옵션을 관리할 수도 있습니다.Many configuration options can also be managed by using the Azure CLI.

Azure Portal에서 시작Get started in the Azure portal

  1. 시작하려면 Azure Portal로 이동한 후 Azure 계정으로 로그인합니다.To begin, go to the Azure portal and sign in to your Azure account. 포털 맨 위에 있는 검색 표시줄에 함수 앱의 이름을 입력 하 고 목록에서 선택 합니다.In the search bar at the top of the portal, enter the name of your function app and select it from the list.

  2. 왼쪽 창의 설정 에서 구성을 선택 합니다.Under Settings in the left pane, select Configuration.

    Azure Portal의 함수 앱 개요

개요 페이지, 특히 응용 프로그램 설정플랫폼 기능 에서 함수 앱을 관리 하는 데 필요한 모든 항목으로 이동할 수 있습니다.You can navigate to everything you need to manage your function app from the overview page, in particular the Application settings and Platform features.

응용 프로그램 설정Application settings

응용 프로그램 설정 탭은 함수 앱에서 사용 하는 설정을 유지 합니다.The Application settings tab maintains settings that are used by your function app. 이러한 설정은 암호화 되어 저장 되므로 값 표시 를 선택 하 여 포털에서 값을 확인 해야 합니다.These settings are stored encrypted, and you must select Show values to see the values in the portal. Azure CLI를 사용 하 여 응용 프로그램 설정에 액세스할 수도 있습니다.You can also access application settings by using the Azure CLI.

포털Portal

포털에서 설정을 추가 하려면 새 응용 프로그램 설정 을 선택 하 고 새 키-값 쌍을 추가 합니다.To add a setting in the portal, select New application setting and add the new key-value pair.

Azure Portal의 함수 앱 설정입니다.

Azure CLIAzure CLI

az functionapp config appsettings list이 명령은 다음 예제와 같이 기존 응용 프로그램 설정을 반환 합니다.The az functionapp config appsettings list command returns the existing application settings, as in the following example:

az functionapp config appsettings list --name <FUNCTION_APP_NAME> \
--resource-group <RESOURCE_GROUP_NAME>

az functionapp config appsettings set명령은 응용 프로그램 설정을 추가 하거나 업데이트 합니다.The az functionapp config appsettings set command adds or updates an application setting. 다음 예에서는 라는 키와 값을 사용 하 여 설정을 만듭니다 CUSTOM_FUNCTION_APP_SETTING 12345 .The following example creates a setting with a key named CUSTOM_FUNCTION_APP_SETTING and a value of 12345:

az functionapp config appsettings set --name <FUNCTION_APP_NAME> \
--resource-group <RESOURCE_GROUP_NAME> \
--settings CUSTOM_FUNCTION_APP_SETTING=12345

응용 프로그램 설정 사용Use application settings

이 함수 앱 설정 값은 코드에서 환경 변수로 읽을 수도 있습니다.The function app settings values can also be read in your code as environment variables. 자세한 내용은 다음 언어별 참조 항목의 Environment 변수 섹션을 참조하세요.For more information, see the Environment variables section of these language-specific reference topics:

함수 앱을 로컬로 개발 하는 경우 프로젝트 파일의 local.settings.js에 이러한 값의 로컬 복사본을 유지 해야 합니다.When you develop a function app locally, you must maintain local copies of these values in the local.settings.json project file. 자세히 알아보려면 로컬 설정 파일을 참조 하세요.To learn more, see Local settings file.

플랫폼 기능Platform features

함수 앱은에서 실행 되며 Azure App Service 플랫폼에서 유지 관리 됩니다.Function apps run in, and are maintained by, the Azure App Service platform. 따라서 함수 앱은 Azure의 핵심 웹 호스팅 플랫폼 기능 대부분에 액세스할 수 있습니다.As such, your function apps have access to most of the features of Azure's core web hosting platform. 왼쪽 창에는 함수 앱에서 사용할 수 있는 App Service 플랫폼의 다양 한 기능에 액세스할 수 있습니다.The left pane is where you access the many features of the App Service platform that you can use in your function apps.

참고

함수 앱이 소비 호스팅 계획에서 실행될 때 모든 App Service 기능을 사용할 수 있는 것은 아닙니다.Not all App Service features are available when a function app runs on the Consumption hosting plan.

이 문서의 나머지 부분에서는 함수에 유용한 Azure Portal의 다음 App Service 기능에 대해 집중적으로 설명 합니다.The rest of this article focuses on the following App Service features in the Azure portal that are useful for Functions:

App Service 설정을 사용하는 방법에 대한 자세한 내용은 Azure App Service 설정 구성을 참조하세요.For more information about how to work with App Service settings, see Configure Azure App Service Settings.

App Service 편집기App Service editor

App Service 편집기

App Service 편집기는 JSON 구성 파일과 코드 파일을 둘 다 수정하는 데 사용할 수 있는 포털 내 고급 편집기입니다.The App Service editor is an advanced in-portal editor that you can use to modify JSON configuration files and code files alike. 이 옵션을 선택하면 기본 편집기와 함께 별도의 브라우저 탭이 실행됩니다.Choosing this option launches a separate browser tab with a basic editor. 이를 통해 Git 리포지토리와 통합하고 코드를 실행 및 디버깅하며 함수 앱 설정을 수정할 수 있습니다.This enables you to integrate with the Git repository, run and debug code, and modify function app settings. 이 편집기는 기본 제공 함수 편집기와 비교 하 여 함수에 대 한 향상 된 개발 환경을 제공 합니다.This editor provides an enhanced development environment for your functions compared with the built-in function editor.

로컬 컴퓨터에서 함수를 개발 하는 것이 좋습니다.We recommend that you consider developing your functions on your local computer. 로컬로 개발 하 고 Azure에 게시 하는 경우 프로젝트 파일은 포털에서 읽기 전용입니다.When you develop locally and publish to Azure, your project files are read-only in the portal. 자세히 알아보려면 로컬에서 코드 및 테스트 Azure Functions를 참조 하세요.To learn more, see Code and test Azure Functions locally.

콘솔Console

함수 앱 콘솔

포털 내 콘솔은 명령줄에서 함수 앱과 상호 작용하려는 경우에 이상적인 개발자 도구입니다.The in-portal console is an ideal developer tool when you prefer to interact with your function app from the command line. 일반적인 명령에는 배치 파일 및 스크립트 실행과 함께 디렉터리 및 파일의 생성 및 탐색이 포함됩니다.Common commands include directory and file creation and navigation, as well as executing batch files and scripts.

로컬로 개발 하는 경우 Azure Functions Core ToolsAzure CLI를 사용 하는 것이 좋습니다.When developing locally, we recommend using the Azure Functions Core Tools and the Azure CLI.

고급 도구(Kudu)Advanced tools (Kudu)

Kudu 구성

App Service용 고급 도구(Kudu라고도 함)를 사용하면 함수 앱의 고급 관리 기능에 액세스할 수 있습니다.The advanced tools for App Service (also known as Kudu) provide access to advanced administrative features of your function app. Kudu에서 시스템 정보, 앱 설정, 환경 변수, 사이트 확장, HTTP 헤더 및 서버 변수를 관리할 수 있습니다.From Kudu, you manage system information, app settings, environment variables, site extensions, HTTP headers, and server variables. https://<myfunctionapp>.scm.azurewebsites.net/과 같은 함수 앱에 대한 SCM 엔드포인트로 이동하여 Kudu를 시작할 수도 있습니다.You can also launch Kudu by browsing to the SCM endpoint for your function app, like https://<myfunctionapp>.scm.azurewebsites.net/

배포 센터Deployment Center

소스 제어 솔루션을 사용 하 여 함수 코드를 개발 하 고 유지 관리 하는 경우 Deployment Center를 사용 하 여 소스 제어에서 빌드 및 배포할 수 있습니다.When you use a source control solution to develop and maintain your functions code, Deployment Center lets you build and deploy from source control. 업데이트를 수행할 때 프로젝트가 빌드되고 Azure에 배포 됩니다.Your project is built and deployed to Azure when you make updates. 자세한 내용은 Azure Functions 배포 기술(영문)을 참조 하세요.For more information, see Deployment technologies in Azure Functions.

크로스-원본 자원 공유Cross-origin resource sharing

클라이언트에서 악의적인 코드가 실행 되는 것을 방지 하기 위해 최신 브라우저는 웹 응용 프로그램의 요청을 별도의 도메인에서 실행 되는 리소스로 차단 합니다.To prevent malicious code execution on the client, modern browsers block requests from web applications to resources running in a separate domain. CORS (원본 간 리소스 공유) 를 사용 하면 Access-Control-Allow-Origin 헤더에서 함수 앱의 끝점을 호출할 수 있는 원본을 선언할 수 있습니다.Cross-origin resource sharing (CORS) lets an Access-Control-Allow-Origin header declare which origins are allowed to call endpoints on your function app.

포털Portal

함수 앱에 대해 허용 된 원본 목록을 구성할 때 Access-Control-Allow-Origin 헤더는 함수 앱의 HTTP 끝점에서 모든 응답에 자동으로 추가 됩니다.When you configure the Allowed origins list for your function app, the Access-Control-Allow-Origin header is automatically added to all responses from HTTP endpoints in your function app.

함수 앱의 CORS 목록 구성

와일드 카드 ( * )를 사용 하면 다른 모든 도메인은 무시 됩니다.When the wildcard (*) is used, all other domains are ignored.

명령을 사용 az functionapp cors add 하 여 허용 된 원본 목록에 도메인을 추가 합니다.Use the az functionapp cors add command to add a domain to the allowed origins list. 다음 예에서는 contoso.com 도메인을 추가 합니다.The following example adds the contoso.com domain:

az functionapp cors add --name <FUNCTION_APP_NAME> \
--resource-group <RESOURCE_GROUP_NAME> \
--allowed-origins https://contoso.com

명령을 사용 az functionapp cors show 하 여 현재 허용 된 원본을 나열 합니다.Use the az functionapp cors show command to list the current allowed origins.

인증Authentication

함수 앱에 대한 인증 구성

함수가 HTTP 트리거를 사용하는 경우 먼저 호출이 인증되도록 요구할 수 있습니다.When functions use an HTTP trigger, you can require calls to first be authenticated. App Service는 Facebook, Microsoft 및 Twitter와 같은 소셜 공급자를 사용 하 여 Azure Active Directory 인증 및 로그인을 지원 합니다.App Service supports Azure Active Directory authentication and sign-in with social providers, such as Facebook, Microsoft, and Twitter. 특정 인증 공급자를 구성하는 방법에 대한 자세한 내용은 Azure App Service 인증 개요를 참조하세요.For details on configuring specific authentication providers, see Azure App Service authentication overview.

다음 단계Next steps