빠른 시작: Azure App Configuration으로 Azure Functions 앱 만들기

아티클
02/28/2024

이 빠른 시작에서는 Azure App Configuration 서비스를 Azure Functions 앱에 통합하여 코드와 별도로 애플리케이션 설정의 스토리지 및 관리를 중앙 집중화합니다.

필수 조건

활성 구독이 있는 Azure 계정. 체험 계정 만들기
App Configuration 저장소. 저장소를 만듭니다.
Azure 개발 워크로드를 사용하는 Visual Studio.
Visual Studio와 함께 설치되지 않았을 경우 Azure Functions 도구.

키-값 추가

App Configuration 저장소에 다음 키-값을 추가하고 레이블 및 콘텐츠 형식을 기본값으로 둡니다. Azure Portal 또는 CLI를 사용하여 저장소에 키-값을 추가하는 방법에 대한 자세한 내용은 키-값 만들기로 이동합니다.

키	값
TestApp:Settings:Message	Azure App Configuration의 데이터

Functions 앱 만들기

Visual Studio의 Azure Functions 프로젝트 템플릿은 Azure에서 함수 앱에 게시할 수 있는 C# 클래스 라이브러리 프로젝트를 만듭니다. 함수 앱을 사용하면 함수를 논리 단위로 그룹화하여 더 쉽게 리소스를 관리, 배포, 크기 조정 및 공유할 수 있습니다.

Visual Studio 메뉴에서 파일>새로 만들기>프로젝트를 차례로 선택합니다.
새 프로젝트 만들기에서 검색 상자에 함수를 입력하고, Azure Functions 템플릿을 선택한 다음, 다음을 선택합니다.
새 프로젝트 구성에서 프로젝트에 대한 프로젝트 이름을 입력한 다음, 만들기를 선택합니다. 함수 앱 이름은 C# 네임스페이스로 유효해야 하므로 밑줄, 하이픈 또는 기타 영숫자가 아닌 문자는 사용하지 마세요.

새 Azure Functions 애플리케이션 만들기 설정에 대해서는 다음 표의 값을 사용합니다.

격리된 작업자 모델
In Process 모델

설정	값	설명
.NET 버전	.NET 6 격리	이 값은 격리된 작업자 프로세스에서 실행되는 함수 프로젝트를 만듭니다. 격리된 작업자 프로세스는 .NET 및 .NET Framework의 다른 비 LTS 버전을 지원합니다. 자세한 내용은 Azure Functions 런타임 버전 개요를 참조하세요.
함수 템플릿	HTTP 트리거	이 값은 HTTP 요청에 의해 트리거되는 함수를 만듭니다.
스토리지 계정(AzureWebJobsStorage)	스토리지 에뮬레이터	Azure의 함수 앱에는 스토리지 계정이 필요하기 때문에 Azure에 프로젝트를 게시할 때 할당되거나 생성됩니다. HTTP 트리거는 Azure Storage 계정 연결 문자열을 사용하지 않습니다. 다른 모든 트리거 형식에는 유효한 Azure Storage 계정 연결 문자열이 필요합니다.
권한 부여 수준	익명	만들어진 함수를 모든 클라이언트에서 키를 제공하지 않고 트리거할 수 있습니다. 이 권한 부여 설정을 통해 새 함수를 쉽게 테스트할 수 있습니다. 키 및 권한 부여에 대한 자세한 내용은 권한 부여 키 및 HTTP 및 웹후크 바인딩을 참조하세요.

Azure Functions 프로젝트 설정

Important

In Process 모델에 대한 지원은 2026년 11월 10일에 종료됩니다. 전체 지원을 위해 앱을 격리된 작업자 모델로 마이그레이션하는 것이 좋습니다.

설정	값	설명
.NET 버전	.NET 6	이 값은 Azure Functions 런타임 버전 4.x에서 In-Process로 실행되는 함수 프로젝트를 만듭니다. 자세한 내용은 Azure Functions 런타임 버전 개요를 참조하세요.
함수 템플릿	HTTP 트리거	이 값은 HTTP 요청에 의해 트리거되는 함수를 만듭니다.
스토리지 계정(AzureWebJobsStorage)	스토리지 에뮬레이터	Azure의 함수 앱에는 스토리지 계정이 필요하기 때문에 Azure에 프로젝트를 게시할 때 할당되거나 생성됩니다. HTTP 트리거는 Azure Storage 계정 연결 문자열을 사용하지 않습니다. 다른 모든 트리거 형식에는 유효한 Azure Storage 계정 연결 문자열이 필요합니다.
권한 부여 수준	익명	만들어진 함수를 모든 클라이언트에서 키를 제공하지 않고 트리거할 수 있습니다. 이 권한 부여 설정을 통해 새 함수를 쉽게 테스트할 수 있습니다. 키 및 권한 부여에 대한 자세한 내용은 권한 부여 키 및 HTTP 및 웹후크 바인딩을 참조하세요.

Azure Functions 프로젝트 설정

권한 부여 수준을 익명으로 설정했는지 확인합니다. 기본 수준인 Function을 선택하면 함수 엔드포인트에 액세스하도록 요구하는 요청에 함수 키를 제공해야 합니다.

만들기를 선택하여 함수 프로젝트 및 HTTP 트리거 함수를 만듭니다.

App Configuration 저장소에 연결

이 프로젝트는 .NET Azure Functions에서 종속성 주입을 사용하고 추가 구성 원본으로 Azure 앱 구성을 추가합니다. Azure Functions는 in-process 또는 isolated-process 실행을 지원합니다. 요구 사항과 일치하는 것을 선택합니다.

마우스 오른쪽 단추로 프로젝트를 클릭하고, NuGet 패키지 관리를 선택합니다. 찾아보기 탭에서 다음 NuGet 패키지를 검색하여 프로젝트에 추가합니다.
- In Process
- 격리된 프로세스
- Microsoft.Extensions.Configuration.AzureAppConfiguration 버전 4.1.0 이상
- Microsoft.Azure.Functions.Extensions 버전 1.1.0 이상
- Microsoft.Azure.AppConfiguration.Functions.Worker

Azure App Configuration에 연결하기 위한 코드를 추가합니다.

In Process
격리된 프로세스

다음 코드를 사용하여 새 파일 Startup.cs를 추가합니다. FunctionsStartup 추상 클래스를 구현하는 Startup이라는 클래스를 정의합니다. 어셈블리 특성은 Azure Functions 시작 중에 사용되는 형식 이름을 지정하는 데 사용됩니다.

ConfigureAppConfiguration 메서드가 재정의되고 Azure 앱 구성 공급자가 AddAzureAppConfiguration()을 호출하여 추가 구성 소스로 추가됩니다. 이 시점에서 서비스를 등록할 필요가 없으므로 Configure 메서드는 비어 있습니다.

using System;
using Microsoft.Azure.Functions.Extensions.DependencyInjection;
using Microsoft.Extensions.Configuration;

[assembly: FunctionsStartup(typeof(FunctionApp.Startup))]

namespace FunctionApp
{
    class Startup : FunctionsStartup
    {
        public override void ConfigureAppConfiguration(IFunctionsConfigurationBuilder builder)
        {
            string cs = Environment.GetEnvironmentVariable("ConnectionString");
            builder.ConfigurationBuilder.AddAzureAppConfiguration(cs);
        }

        public override void Configure(IFunctionsHostBuilder builder)
        {
        }
    }
}

Program.cs를 열고 다음과 같이 Main() 메서드를 업데이트합니다. AddAzureAppConfiguration()을 호출하여 Azure App Configuration 공급자를 추가 구성 원본으로 추가합니다.

public static void Main()
{
    var host = new HostBuilder()
        .ConfigureAppConfiguration(builder =>
        {
            string cs = Environment.GetEnvironmentVariable("ConnectionString");
            builder.AddAzureAppConfiguration(cs);
        })
        .ConfigureFunctionsWorkerDefaults()
        .Build();

    host.Run();
}

Function1.cs를 열고 다음 네임스페이스가 아직 없으면 추가합니다.

using Microsoft.Extensions.Configuration;

종속성 삽입을 통해 IConfiguration의 인스턴스를 얻는 데 사용되는 생성자를 추가하거나 업데이트합니다.

In Process
격리된 프로세스

private readonly IConfiguration _configuration;

public Function1(IConfiguration configuration)
{
    _configuration = configuration;
}

private readonly IConfiguration _configuration;

public Function1(ILoggerFactory loggerFactory, IConfiguration configuration)
{
    _logger = loggerFactory.CreateLogger<Function1>();
    _configuration = configuration;
}

구성에서 값을 읽도록 Run 메서드를 업데이트합니다.

In Process
격리된 프로세스

[FunctionName("Function1")]
public async Task<IActionResult> Run(
    [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post", Route = null)] HttpRequest req, ILogger log)
{
    log.LogInformation("C# HTTP trigger function processed a request.");

    // Read configuration data
    string keyName = "TestApp:Settings:Message";
    string message = _configuration[keyName];

    return message != null
        ? (ActionResult)new OkObjectResult(message)
        : new BadRequestObjectResult($"Please create a key-value with the key '{keyName}' in App Configuration.");
}

참고 항목

Function1 클래스와 Run 메서드는 정적이어서는 안됩니다. 자동 생성된 경우 static 한정자를 제거합니다.

[Function("Function1")]
public HttpResponseData Run([HttpTrigger(AuthorizationLevel.Anonymous, "get", "post")] HttpRequestData req)
{
    _logger.LogInformation("C# HTTP trigger function processed a request.");

    var response = req.CreateResponse(HttpStatusCode.OK);
    response.Headers.Add("Content-Type", "text/plain; charset=utf-8");

    // Read configuration data
    string keyName = "TestApp:Settings:Message";
    string message = _configuration[keyName];

    response.WriteString(message ?? $"Please create a key-value with the key '{keyName}' in Azure App Configuration.");

    return response;
}

로컬에서 함수 테스트

ConnectionString이라는 환경 변수를 설정하고, App Configuration 스토리지에 대한 액세스 키로 설정합니다. Windows 명령 프롬프트를 사용하는 경우 다음 명령을 실행하고, 명령 프롬프트를 다시 시작하여 변경 내용을 적용합니다.
```
    setx ConnectionString "connection-string-of-your-app-configuration-store"
```
Windows PowerShell을 사용하는 경우 다음 명령을 실행합니다.
```
    $Env:ConnectionString = "connection-string-of-your-app-configuration-store"
```
macOS 또는 Linux를 사용하는 경우 다음 명령을 실행합니다.
```
    export ConnectionString='connection-string-of-your-app-configuration-store'
```
F5를 눌러 함수를 테스트합니다. 메시지가 표시되면 Visual Studio에서 Azure Functions Core(CLI) 도구를 다운로드하여 설치하도록 요구하는 요청을 수락합니다. 또한 도구에서 HTTP 요청을 처리할 수 있도록 방화벽 예외를 사용하도록 설정해야 할 수도 있습니다.
Azure Functions 런타임 출력에서 함수의 URL을 복사합니다.
브라우저의 주소 표시줄에 HTTP 요청에 대한 URL을 붙여 넣습니다. 다음 이미지에서는 함수에서 반환된 로컬 GET 요청에 대한 브라우저의 응답을 보여 줍니다.

리소스 정리

이 문서에서 만든 리소스를 계속 사용하지 않으려면 여기서 만든 리소스 그룹을 삭제하여 요금이 부과되지 않도록 합니다.

Important

리소스 그룹을 삭제하면 다시 되돌릴 수 없습니다. 리소스 그룹 및 포함된 모든 리소스가 영구적으로 삭제됩니다. 잘못된 리소스 그룹 또는 리소스를 자동으로 삭제하지 않도록 합니다. 유지하려는 다른 리소스가 포함된 리소스 그룹 내에서 이 문서에 대한 리소스를 만든 경우 리소스 그룹을 삭제하는 대신 해당 창에서 각 리소스를 개별적으로 삭제합니다.

Azure Portal에 로그인하고 리소스 그룹을 선택합니다.
이름으로 필터링 상자에서 리소스 그룹의 이름을 입력합니다.
결과 목록에서 리소스 그룹 이름을 선택하여 개요를 확인합니다.
리소스 그룹 삭제를 선택합니다.
리소스 그룹 삭제를 확인하는 메시지가 표시됩니다. 리소스 그룹의 이름을 입력하여 확인하고 삭제를 선택합니다.

잠시 후, 리소스 그룹 및 모든 해당 리소스가 삭제됩니다.

다음 단계

이 빠른 시작에서는 새 App Configuration 스토리지를 만들고, App Configuration 공급자를 통해 Azure Functions 앱에서 사용했습니다. 구성을 동적으로 새로 고치도록 Azure Functions 앱을 업데이트하는 방법을 알아보려면 다음 자습서를 계속 진행하세요.

Azure Functions에서 동적 구성을 사용하도록 설정

Azure 관리 ID를 사용하여 App Configuration에 대한 액세스를 간소화하는 방법을 알아보려면 다음 자습서를 계속 진행하세요.

관리 ID를 사용하여 App Configuration에 액세스