.NET 런타임

개요

Cloud Run 함수는 운영체제 버전과 부가기능 패키지, 언어 지원, 함수를 지원하고 호출하는 함수 프레임워크 라이브러리로 구성된 환경에서 실행됩니다. 이 환경은 언어 버전으로 식별되며, 런타임이라고 합니다.

일반적인 런타임과 각 .NET 런타임이 사용하는 Ubuntu 버전에 대한 자세한 내용은 Cloud Run Functions 실행 환경을 참조하세요.

Cloud Run Functions에서 .NET를 시작하려면 빠른 시작을 참조하세요.

템플릿 패키지

템플릿 패키지를 사용하여 새 함수를 만들 수 있습니다. 사용하려면 다음 단계를 따르세요.

  1. .NET SDK를 설치합니다.

  2. 템플릿 패키지를 설치합니다.

    dotnet new install Google.Cloud.Functions.Templates

C#(기본값), F#, Visual Basic과 같은 3가지 함수 유형의 템플릿이 제공됩니다. 템플릿에서 새 프로젝트를 만들 때는 -lang f#을 지정하여 F# 프로젝트를 만들거나 -lang vb를 지정하여 Visual Basic 프로젝트를 만듭니다. 자세한 내용은 다음을 참고하세요.

.NET Functions Framework 버전 선택

.NET Functions Framework의 여러 버전은 다양한 런타임을 지원합니다. 버전 1은 .NET Core 3.1 이상을 지원하며, 템플릿 기본값은 .NET Core 3.1입니다. 버전 2는 .NET 6 이상을 지원하며 템플릿 기본값은 .NET 6입니다.

.NET용 함수 프레임워크 버전 1을 사용하여 기존 프로젝트를 업그레이드하려면 프로젝트 파일을 수정하거나 (Visual Studio를 사용하여) Google.Cloud.Functions로 시작하는 모든 종속 항목을 최신 버전으로 업데이트한 후 대상 프레임워크를 .NET 6으로 설정합니다.

런타임 선택

Cloud Run Functions는 런타임 지원 페이지에 나열된 여러 버전의 .NET을 지원합니다. 함수를 배포할 때 프로젝트 파일(MyFunction.csproj 등)의 대상 프레임워크에 해당하는 .NET 런타임을 지정해야 합니다. .NET 런타임을 지정하려면 다음 안내를 따르세요.

gcloud

Google Cloud CLI를 사용하는 경우 --runtime 매개변수를 사용하여 런타임을 지정합니다. --entry-point 플래그는 정규화된 클래스 이름(FQN)을 지정합니다. 예를 들면 다음과 같습니다.

gcloud functions deploy NAME --entry-point FQN --runtime dotnet6 --trigger-http FLAGS...

FLAGS...는 함수를 처음 배포하는 동안 전달되는 인수를 나타냅니다. 필수 인수 및 선택적 인수에 대한 자세한 내용은 Google Cloud CLI를 사용하여 배포를 참조하세요.

콘솔

Google Cloud 콘솔을 사용하는 경우 자세한 안내는 Google Cloud 콘솔 빠른 시작을 참조하세요.

함수 준비

Google Cloud 콘솔에서 직접 함수를 준비하거나 로컬 머신에 작성하여 업로드할 수 있습니다. .NET 개발용 로컬 머신을 준비하려면 .NET 개발 환경 설정을 참조하세요.

함수를 호출하는 라이브러리는 .NET 함수 프레임워크입니다.

Cloud Run Functions에서 신속하게 .NET을 시작하려면 빠른 시작을 참조하세요.

소스 코드 구조

Cloud Run Functions에서 함수 정의를 찾으려면 각 런타임에 소스 코드에 대한 특정 구조화 요구사항이 있어야 합니다. 자세한 내용은 Cloud Run Functions 작성을 참고하세요.

종속 항목 지정

프로젝트 파일에 종속 항목을 추가하여 함수의 종속 항목을 지정할 수 있습니다. 자세한 내용은 .NET의 종속 항목 지정을 참조하세요.

다음 단계