Azure Functions local runtime and tools reference

이 글은 로컬 런타임과 Azure Functions를 지원하는 도구에 대한 참고 문서를 제공합니다. 이 도구들을 사용해 로컬 컴퓨터에서 Azure Functions 프로젝트를 개발, 관리, 실행하세요. 이진 이름은 func (또는 Windows에서는 func.exe입니다).

CLI에는 두 가지 버전이 제공됩니다. 버전 선택기를 사용해 어떤 버전을 볼지 선택하세요.

중요합니다

Azure Functions CLI(v5)는 현재 미리 보기로 제공됩니다. 이 미리보기 버전은 아직 Java와 PowerShell을 지원하지 않습니다. 현재 지원되지 않는 언어를 사용하려면 Azure Functions Core Tools v4을 계속 사용하세요.

로컬 Azure Functions 개발에 사용되는 func.exe 두 가지 버전이 있습니다.

v4 v5
API 이름 Azure Functions 핵심 도구 Azure Functions CLI
지원 수준 GA(일반 공급) 미리 보기
설치 공간 모든 네이티브 언어에 대한 모든 명령 및 기능을 포함하는 전체 이진 파일입니다. 작은 기본 설치와 필요에 따라 추가하는 언어별 워크로드 및 기타 기능. 호스트는 자체 워크로드로 배송되므로 CLI를 다시 다운로드하지 않고 최신 호스트 버전을 가져옵니다.
사용하는 경우... 모든 개발 워크플로에 대한 전체 GA 지원이 필요합니다. 로컬 환경을 Azure 호스팅 계획 구성과 동기화된 상태로 유지하는 빠른 시작 템플릿 및 프로필과 같은 새로운 기능을 사용하는 간단한 워크로드 기반 환경을 원합니다.

핵심 도구 사용에 대한 자세한 내용은 Azure Functions Core Tools 사용 참조하세요.

Core Tools 명령은 각각 고유한 작업 세트를 제공하는 다음과 같은 컨텍스트로 구성됩니다.

명령 컨텍스트 설명
func 로컬 컴퓨터에서 함수를 만들고 실행하는 명령입니다.
func azure 게시를 포함하여 Azure 리소스를 사용하는 명령입니다.
func azurecontainerapps 컨테이너화된 함수 앱을 Azure Container Apps 배포하는 명령입니다.
func bundles 확장 번들을 관리하는 명령입니다.
func durable Durable Functions 사용하는 명령입니다.
func extensions 확장을 설치하고 관리하는 명령입니다.
func kubernetes Kubernetes 및 Azure Functions 사용하는 명령입니다.
func settings 로컬 Functions 호스트에 대한 환경 설정을 관리하는 명령입니다.
func templates 사용 가능한 함수 템플릿을 나열하는 명령입니다.

이 문서의 명령을 사용하기 전에 Core Tools를 설치합니다.

중요합니다

Azure Functions CLI(v5)는 현재 미리 보기로 제공됩니다. 이 미리보기 버전은 아직 Java와 PowerShell을 지원하지 않습니다. 현재 지원되지 않는 언어를 사용하려면 Azure Functions Core Tools v4을 계속 사용하세요.

CLI 사용법, 설치 및 워크로드에 대해 더 알고 싶다면 Develop Azure Functions Azure Functions CLI를 로컬로 사용하세요.

기본 CLI 설치에 포함된 다음 내장 명령어들이 포함되어 있습니다:

Command 설명
func init Initialize a new Azure Functions project.
func new 템플릿에서 새 함수를 만드세요.
func run Launching the Azure Functions host runtime locally. func start 하위 호환 별칭입니다.
func quickstart 퀵스타트 템플릿 카탈로그에서 완전한 기능 앱을 탐색하고 스캐폴드를 만드세요.
func profile Inspect and management Azure Functions CLI profiles.
func setup Prepare local Azure Functions CLI dependencies (host runtime, language workers, extension bundles).
func workload 설치된 CLI 워크로드를 관리하세요.

워크로드는 추가적인 최상위 명령을 제공할 수 있습니다. 이 명령들은 기여하는 워크로드를 설치한 후에만 나타납니다.

func init

특정 언어로 새 Functions 프로젝트를 만듭니다.

func init [<PROJECT_FOLDER>]

를 입력 <PROJECT_FOLDER>하면 이 명령어가 이 이름으로 프로젝트를 새 폴더에 생성합니다. 그렇지 않으면 현재 폴더를 사용합니다.

명령어는 func init 버전에 따라 다음과 같은 옵션을 지원합니다:

옵션 설명
--bundles-channel, -c 확장 번들 릴리스 채널. 지원되는 값은 GA (기본값), Preview및 Experimental. 비 .NET 프로젝트에만 적용됩니다.
--configuration-profile 호스트 구성 프로필을 사용하여 프로젝트를 초기화합니다. 이 --configuration-profile 옵션은 현재 미리 보기로 제공됩니다. 자세한 내용은 구성 프로필을 참조하세요.
--csx .NET 함수를 C# 스크립트로 생성합니다. --worker-runtime dotnet에만 유효합니다.
--docker 선택한 --worker-runtime기본 이미지를 사용하여 컨테이너용 도커파일을 생성합니다. 컨테이너화된 함수 앱을 배포하려는 경우 이 옵션을 사용합니다.
--docker-only 기존 프로젝트에 Dockerfile을 추가합니다. local.settings.json지정하거나 설정하지 않은 경우 작업자 런타임을 묻는 메시지를 표시합니다. 컨테이너화된 함수 앱을 배포할 계획이며 프로젝트가 이미 있는 경우 이 옵션을 사용합니다.
--force 프로젝트 내에 이미 파일이 있어도 프로젝트를 초기화합니다. 이 설정은 동일한 이름의 기존 파일을 덮어씁니다. 프로젝트 폴더의 다른 파일은 영향을 받지 않습니다.
--language, -l 언어별 프로젝트를 초기화합니다. 로 설정된 --worker-runtime경우 node 현재 지원됩니다. 옵션은 typescript 및 javascript입니다. 사용 --worker-runtime javascript 하거나 --worker-runtime typescript.
--managed-dependencies 관리되는 종속성을 설치합니다. 현재 PowerShell 작업자 런타임만 이 기능을 지원합니다.
--model, -m 둘 이상의 모델을 사용할 수 있는 경우 대상 언어에 대한 프로그래밍 모델을 설정합니다. 지원되는 옵션은 Python V1 및 V2, Node.jsV3 및 V4입니다. 자세한 내용은 Python 개발자 가이드 및 Node.js 개발자 가이드 참조하세요.
--no-bundle host.json확장 번들을 구성하지 마세요. 비 .NET 프로젝트에만 적용됩니다.
--no-docs "시작" 설명서 파일 생성을 건너뜁니다. Python 프로젝트에 적용됩니다.
--skip-npm-install 프로젝트를 만든 후 실행을 npm install 건너뜁니다. Node.js 프로젝트에 적용됩니다.
--source-control Git 리포지토리를 만들지 여부를 제어합니다. 기본적으로 리포지토리는 만들어지지 않습니다. 이 경우 true리포지토리가 만들어집니다.
--worker-runtime 프로젝트의 언어 런타임을 설정합니다. 지원되는 값은 다음과 같습니다csharp. , dotnet, dotnet-isolated, javascriptnode(JavaScript), powershell및 pythontypescript. Java 경우 Maven 사용합니다. 프로젝트 파일만 사용하여 언어 중립적 프로젝트를 생성하려면 custom을 사용합니다. 설정하지 않으면 초기화 중에 런타임을 선택하라는 메시지가 표시됩니다.
--target-framework 함수 앱 프로젝트의 대상 프레임워크를 설정합니다. --worker-runtime dotnet-isolated에만 유효합니다. 지원되는 값은 net10.0(미리 보기), net9.0, net8.0(기본값), net6.0 및 net48(.NET Framework 4.8)입니다.

참고 항목

--docker 또는 --docker-only 옵션을 사용하는 경우 Core Tools는 C#, JavaScript, Python 및 PowerShell 함수용 Dockerfile을 자동으로 만듭니다. Java 함수의 경우 Dockerfile을 수동으로 만들어야 합니다. 자세한 내용은 컨테이너화된 함수 앱 만들기를 참조하세요.

구성 프로필

중요합니다

구성 프로필에 대한 지원은 현재 미리 보기로 제공됩니다.

이 옵션을 사용하면 --configuration-profile 미리 정의된 프로젝트 구성과 설정 세트를 만듭니다. 구성 프로필을 지정할 때 초기화는 다른 모든 초기화 단계를 건너뛸 수 있습니다.

프로필 값 설명 특정 작업
mcp-custom-handler 사용자 지정 처리기를 사용하여 AI 에이전트 및 기타 MCP 클라이언트가 연결할 수 있는 MCP(모델 컨텍스트 프로토콜) 서버를 호스트하는 프로젝트를 만듭니다. • 특정 사용자 지정 처리기 설정을 "configurationProfile": "mcp-custom-handler" 파일의 요소를 구성 합니다.
• MCP_EXTENSION_ENABLED설정합니다 true.		 
func init [<PATH>] [options]

를 제공 <PATH>하면 프로젝트가 그 폴더에 생성됩니다. 그렇지 않으면 현재 폴더가 사용됩니다.

이 명령어는 func init 다음과 같은 내장 옵션을 지원합니다:

옵션 설명
--stack, -s 프로젝트에 사용할 스택(예: python, , node, dotnet). go func workload list 설치된 워크로드가 기여한 스택을 확인해 보세요.
--name, -n 함수 앱 프로젝트의 이름입니다.
--language, -l 프로그래밍 언어(예: C#, F#, JavaScript, TypeScript, Python). 스택이 두 개 이상의 언어를 지원할 때 사용됩니다. 지원되는 값은 설치된 스택 워크로드에서 계산됩니다.
--force 대상 폴더가 비어 있지 않아도 재초기화하세요. 스캐폴딩 전에 폴더를 지우는 방법(단 .git)

워크로드는 추가 옵션을 제공하며, 이 옵션은 워크로드 이름 func init --help아래에 그룹화되어 있습니다. 스택별 옵션은 워크 로드별 옵션을 참조하세요.

요청된 스택을 제공하는 워크로드가 없으면, CLI는 힌 func workload install 트를 출력하고 0이 아닌 종료 코드로 종료합니다.

작업량별 옵션

init 이 명령어는 다음 작업 로드 중 하나 이상을 설치할 때 확장됩니다:

옵션 설명
--target-framework, -tfm 목표 .NET 프로젝트의 프레임워크(예: net10.0). 기본값: net10.0.

.NET 초기화기는 확장 번들 블록을 작성하지 않으므로 --no-bundles와 --bundles-channel는 적용되지 않습니다.

여러 개의 설치된 워크로드가 같은 옵션을 기여할 경우, 해당 옵션은 한 번 에 func init --help나타납니다.

공유 옵션

현재 공유 옵션은 와 --no-bundles입니다--bundles-channel. host.json 쓰는 기본 확장 번들 ID는 선택한 채널에 따라 다릅니다:

채널 번들 ID
GA(기본값) Microsoft.Azure.Functions.ExtensionBundle
Preview Microsoft.Azure.Functions.ExtensionBundle.Preview
Experimental Microsoft.Azure.Functions.ExtensionBundle.Experimental

기본 버전 범위는 [4.*, 5.0.0)입니다.

func new

템플릿을 기반으로 현재 프로젝트에 새 함수를 만듭니다.

func new

명령어는 func new 버전에 따라 다음과 같은 옵션을 지원합니다:

옵션 설명
--authlevel, -a HTTP 트리거에 대한 권한 부여 수준을 설정합니다. 지원되는 값은 다음과 functionanonymousadmin같습니다. 로컬에서 실행하는 경우 권한 부여가 적용되지 않습니다. 자세한 내용은 권한 부여 수준을 참조하세요.
--csx 버전 1과 포털에서 사용된 동일한 C# 스크립트(.csx) 템플릿을 생성합니다.
--file, -f 새 함수의 대상 파일입니다. Python v2 프로젝트의 경우 함수를 추가할 파일을 지정합니다(기본값은 function_app.py). Node.js v4 프로젝트의 경우 폴더의 출력 파일 이름을 src/functions 지정합니다. 컴파일된 .NET 프로젝트에는 적용되지 않습니다.
--name, -n 함수 이름입니다.
--template, -t 이 func templates list 명령을 사용하여 지원되는 각 언어에 대해 사용 가능한 템플릿의 전체 목록을 확인합니다.

자세한 내용은 함수 만들기를 참조하세요.

func new [<PATH>] [options]

중요합니다

func new 현재 미리보기 초안으로 남아 있습니다. 워크로드-설치 힌트를 출력하고, 템플릿의 워크로드가 설치되고 유선으로 연결될 때까지 0이 아닌 종료 코드로 종료됩니다. 템플릿별 옵션은 템플릿 메타데이터에서 동적으로 하이드레이션되기 때문에, 새로운 템플릿 옵션을 추가하는 데 CLI 릴리스가 필요하지 않습니다.

이 명령어는 func new 다음과 같은 내장 옵션을 지원합니다:

옵션 설명
--name, -n 함수 이름입니다.
--template, -t 함수 템플릿 이름입니다. 사용 가능한 템플릿은 프로젝트 스택에 설치된 <stack>-templates 워크로드에서 나옵니다.
--force 기존 파일을 덮어씁니다.

추가적인 옵션은 선택한 템플릿에 의해 동적으로 기여됩니다. 특정 템플릿의 옵션을 확인하러 달려가세요 func new --template <name> --help .

현재 프로젝트에 템플릿 워크로드가 설치되어 있지 않으면, CLI는 힌트를 출력하여 func workload install.

func logs

Kubernetes 클러스터에서 실행되는 함수에 대한 로그를 가져옵니다.

func logs --platform kubernetes --name <APP_NAME>

이 명령은 다음 func logs 옵션을 지원합니다.

옵션 설명
--platform 함수 앱에 대한 호스팅 플랫폼입니다. 유효한 옵션: kubernetes.
--name Azure 함수 앱 이름입니다.

자세한 내용은 KEDA를 사용하는 Kubernetes의 Azure Functions 참조하세요.

func pack

실행 가능한 상태로 프로젝트 코드를 포함하는 배포 패키지를 만듭니다. 명령 외부의 로컬 컴퓨터에서 앱에 대한 배포 패키지를 수동으로 만들어야 하는 경우 이 메서드를 func azure functionapp publish 사용합니다. 기본적으로 func pack 필요한 경우 프로젝트를 빌드합니다.

Go 함수형 앱의 경우, func pack Azure CLI az functionapp deployment source config-zip 명령어를 사용해 배포할 수 있는 Linux x64 배포 패키지를 구축합니다.

func pack [<FOLDER_PATH>]

기본적으로 func pack 현재 디렉터리를 패키지하고 출력 .zip 파일은 프로젝트의 루트 폴더와 이름이 같습니다. func pack 프로젝트 파일이 포함된 디렉터리에서 실행 합니다. 다른 디렉터리에서 실행 func pack 해야 하는 경우 프로젝트 루트의 경로(예<FOLDER_PATH>: .)로 설정합니다func pack ./myprojectroot. 특정 .zip 파일이 이미 있는 경우 먼저 삭제된 다음 업데이트된 버전으로 바뀝니다.

이 명령은 다음 func pack 옵션을 지원합니다.

옵션 설명
--output, -o 배포 .zip 패키지 파일이 만들어지는 위치의 경로를 설정합니다.
--no-build Project 압축하기 전에 빌드되지 않았습니다. C# 앱의 경우 이진 파일을 이미 생성한 경우에만 사용합니다. Node.js 앱의 경우 둘 다 npm installnpm run build 건너뜁니다. Go 앱은 bin/app 에 이미 Linux x64 바이너리가 있을 때만 사용하세요.
--skip-install Node.js기반 함수 앱을 압축할 때 실행을 npm install 건너뜁니다. 사용자 지정 npm 모듈을 덮어쓰지 않도록 하는 데 사용됩니다.
--build-native-deps Azure 사용된 환경과 일치하는 이미지를 사용하여 로컬로 Python 종속성을 설치합니다. 사용하도록 설정하면 Core Tools는 Docker 컨테이너를 시작하고, 해당 컨테이너 내에서 앱을 빌드하고, 모든 종속성이 복원된 .python_packages.zip 파일을 만듭니다. Azure Linux에 배포할 때 잠재적인 라이브러리 문제를 방지하려면 Windows 실행할 때 이 옵션을 사용합니다.

func run (v1 전용)

참고 항목

이 명령어는 Core Tools 버전 1에만 적용되며 더 이상 지원되지 않습니다. 버전 4에서는 func start 호출하세요.

Azure 포털의 Test 탭을 사용해 함수를 직접 호출합니다.

func run

이 명령은 다음 func run 옵션을 지원합니다.

옵션 설명
--content 함수에 전달되는 인라인 콘텐츠입니다.
--debug 함수를 실행하기 전에 호스트 프로세스에 디버거를 연결합니다.
--file 콘텐츠로 사용할 파일 이름입니다.
--no-interactive 자동화 시나리오에 유용한 입력 메시지를 표시하지 않습니다.
--timeout 로컬 Functions 호스트가 준비될 때까지 대기하는 시간(초)입니다.

예를 들어 HTTP 트리거 함수를 호출하고 콘텐츠 본문을 전달하려면 다음 명령을 실행합니다.

func run MyHttpTrigger --content '{\"name\": \"Azure\"}'

func start

로컬 런타임 호스트를 시작하고 함수 프로젝트를 현재 폴더에 로드합니다.

특정 명령은 런타임 버전에 따라 달라집니다.

func start

이 명령은 다음 func start 옵션을 지원합니다.

옵션 설명
--cert 프라이빗 키가 포함된 .pfx 파일의 경로입니다. --useHttps에서만 지원됩니다.
--cors 공백이 없는 CORS 원본의 쉼표로 구분된 목록입니다.
--cors-credentials 쿠키 및 인증 헤더를 사용하는 원본 간 인증 요청을 허용합니다.
--dotnet-isolated-debug true 설정하면 디버그 중인 .NET 격리된 프로젝트에서 디버거가 연결될 때까지 .NET 작업자 프로세스를 일시 중지합니다.
--enable-json-output 가능하면 콘솔 로그를 JSON으로 내보냅니다.
--enableAuth 권한 부여 요구 사항이 있는 전체 인증 처리 파이프라인을 사용하도록 설정합니다.
--functions 공백으로 구분된 로드할 함수의 목록입니다.
--json-output-file 제공된 경우 , 를 사용할 --enable-json-output때 출력을 작성하는 데 사용되는 파일의 경로입니다.
--language-worker 언어 작업자를 구성하는 인수입니다. 예를 들어 debug 포트 및 기타 필수 인수 제공하여 언어 작업자에 대한 디버깅을 사용하도록 설정할 수 있습니다.
--no-build 실행하기 전에 현재 프로젝트를 빌드하지 않습니다. .NET 클래스 프로젝트에만 해당합니다. 기본값은 false입니다.
--password 암호 또는 .pfx 파일의 암호를 포함하는 파일입니다. 와 함께 --cert만 사용됩니다.
--port, -p 수신 대기할 로컬 포트입니다. 기본값: 7071.
--runtime 시작할 호스트의 버전을 설정합니다. 허용되는 값은 다음과 inproc6같습니다. 및 inproc8default (Out-of-process 호스트를 실행).
--timeout, -t Functions 호스트가 시작할 시간 제한(초)입니다. 기본값: 20초.
--useHttps 에 바인딩하지 https://localhost:{port} 않고 바인딩합니다 http://localhost:{port}. 기본적으로 이 옵션은 컴퓨터에 신뢰할 수 있는 인증서를 만듭니다.
--user-log-level 사용자 로그의 최소 로그 수준을 설정합니다. 유효한 값은 다음과 TraceDebugInformationWarningErrorCritical같습니다. None 이 설정은 시스템 로그에 영향을 주지 않습니다. 격리된 .NET 프로젝트의 경우 이 옵션을 적용하려면 Program.cs 사용하여 builder.Logging.SetMinimumLevel(LogLevel.Debug) 최소 수준을 설정합니다.

프로젝트가 실행되면 개별 함수 엔드포인트를 확인합니다.

func run

Functions 호스트 런타임을 시작하고 현재 폴더에 프로젝트를 불러옵니다.

func run [<PATH>] [options]

func start 는 하위 호환 별칭으로 보존되며 동일한 인수와 옵션을 수용합니다.

이 명령은 다음 func run 옵션을 지원합니다.

옵션 설명
--port, -p 수신 대기할 로컬 포트입니다. 기본값: 7071.
--cors 공백이 없는 CORS 원본의 쉼표로 구분된 목록입니다.
--cors-credentials 쿠키와 Authentication 헤더를 사용하는 교차 오리진 인증 요청을 허용합니다.
--functions 공백으로 구분된 로드할 함수의 목록입니다.
--no-build 프로젝트를 실행하기 전에 만들지 마세요.
--enable-auth 인증 요구 사항을 포함한 전체 인증 처리 파이프라인을 활성화하세요.
--host-version, -v 호스트 런타임 버전(예: 4.1049.0).
--profile 호스트, 워커, 번들 버전을 해결할 때 적용할 수 있는 Azure Functions 프로필. func profile을(를) 참조하세요.
--offline 로컬 설치 워크로드만 사용하고 네트워크 설치는 건너뛰세요.
--output 출력 모드: compact (인터랙티브 TUI), plain (CI / 비-TTY), 또는 json (프로그래밍 소비자 및 AI 에이전트를 위한 NDJSON). 터미널에 따라 자동 감지가 기본값입니다.
--no-tui --output=plain의 별칭입니다. 인터랙티브 TUI를 비활성화합니다.
--log-file 모든 호스트 이벤트를 지정된 로그 파일에 미러링하세요.
--no-azurite 관리형 아주라이트를 비활성화하세요. 호스트는 프로빙 없이 로컬 에뮬레이터를 시작하지 않습니다.

프로젝트가 실행 중일 때, 함수 엔드포인트를 직접 호출하여 동작을 검증합니다.

관리된 아주라이트

프로젝트가 로컬 저장소(예: AzureWebJobsStorage=UseDevelopmentStorage=true) func run 를 사용할 때, 자동으로 실행 중인 Azurite 에뮬레이터를 확인하고, 찾지 못하면 실행을 시작합니다. 에뮬레이터는 종료 시 func run 멈춥니다. Pass --no-azurite 는 옵트아웃하고 Azurite를 직접 관리하세요.

출력 모드

func run 단말자를 기반으로 출력 모드를 자동 선택합니다:

상태 모드
인터랙티브 터미널 (TTY) compact
비인터랙티브 stdout, 리디렉션 출력, 또는 CI 환경 변수 집합 plain
명시적 --output=json json

CLI는 절대 자동으로 선택하지 않습니다 json. compact 만약 요청이 있었지만 stdout가 TTY가 아니면, CLI는 stderr로 plain 다운그레이드되어 한 줄짜리 통지문을 작성합니다. 이 모드는 json 줄마다 하나의 객체인 JSON(NDJSON)을 출력하며, schema_version a는 .1

func quickstart

Azure Functions quickstart 템플릿 카탈로그에서 완전한 함수 앱을 탐색하고 스캐폴드를 제공합니다. 퀵스타트 템플릿은 HTTP API, 큐 트리거 워커, Durable Functions 오케스트레이션과 같은 완전한 샘플 앱입니다. 스택 워크로드는 언어별 리솔버를 기여합니다. 카탈로그는 명령 호출 시점에 가져옵니다.

func quickstart [<PATH>] [options]

를 제공 <PATH>하면 프로젝트가 그 폴더에 생성됩니다. 그렇지 않으면 현재 폴더가 사용됩니다.

이 명령은 다음 func quickstart 옵션을 지원합니다.

옵션 설명
--stack, -s 사용할 스택, pythonnode, , .dotnet
--language, -l 프로그래밍 언어. 지원되는 값은 설치된 퀵스타트 제공자에서 나옵니다.
--template, -t 카탈로그에서 가져온 템플릿 ID, 예를 들어 http-trigger-python-azd. 모든 인터랙티브 프롬프트를 건너뛸 수 있습니다.
--resource, -r 트리거나 결합 자원(예http: , )timerblobeventhubservicebuscosmossqlmcpdurable
--iac , , bicep, 와 terraform같은 인프라-아스코드 유형none별로 필터링하세요.
--search 템플릿 이름과 설명에 적용된 대문자 구분 없는 부분 문자열 필터.
--fetch 카탈로그 가져오기 전략: auto (기본값), git, 또는 http. auto HTTP를 git 탐색하고 다시 HTTP로 전환합니다.
--force 대상 폴더가 비어 있지 않아도 비계를 설치하세요. 스캐폴딩 전에 폴더를 지우는 방법(단 .git)

하위:

하위 명령 설명
func quickstart list 카탈로그에 이용 가능한 템플릿을 나열하세요.
func quickstart info 특정 템플릿에 대한 세부 정보를 보여주세요.

func quickstart list

카탈로그에서 선택 가능한 템플릿을 필터링하여 나열합니다.

func quickstart list [options]
옵션 설명
--stack, -s 사용할 스택, pythonnode, , .dotnet
--language, -l 프로그래밍 언어. 지원되는 값은 설치된 퀵스타트 제공자에서 나옵니다.
--resource, -r 트리거나 결속 자원별로 필터링하세요.
--iac 인프라-아스코드 유형으로 필터링하세요.
--search ID, 템플릿 이름, 리소스 유형, 코드로서의 인프라 유형, 그리고 설명에 대해 대문자 구분 없는 서브문자열 매칭을 수행합니다.
--json 테이블 대신 기계가 읽을 수 있는 JSON을 출력하세요.

func quickstart info

특정 템플릿에 대한 상세 정보를 표시합니다.

func quickstart info <ID> [options]

<ID> 카탈로그의 템플릿 ID입니다. 사용 가능한 신분증을 찾기 위해 사용 func quickstart list 하세요.

옵션 설명
--json 형식화된 출력 대신 기계가 읽을 수 있는 JSON을 출력하세요.

func profile

Azure Functions CLI 프로필을 검사하고 관리합니다. 프로필은 호스트 버전 범위, 확장 번들 버전 범위, 워커 버전 범위와 같은 버전 제약 조건을 인코딩합니다. 또한 다른 프로필로부터의 상속도 정의합니다. 프로필 소스에는 프로젝트-로컬 (.func/profiles/), 사용자 -글로벌 (~/.azure-functions/profiles/), 내장 프로필이 포함됩니다. 호스트를 실행할 때 어떤 프로필의 제약 조건이 적용될지 선택하는 옵션을 사용 func run --profile <name> 하세요.

func profile <subcommand>

하위:

하위 명령 설명
func profile list 프로젝트, 사용자, 내장 소스에서 제공하는 프로필을 나열하세요.
func profile show 프로필 세부 정보를 표시하세요.
func profile set 프로젝트의 기본 프로필을 설정하세요.

func profile list

프로젝트, 사용자 및 내장 소스에서 제공하는 프로필을 나열합니다. 이름, 소스, 호스트 버전, 확장 번들, 상태 테이블을 렌더링합니다.

func profile list [<PATH>] [options]
옵션 설명
--source 쉼표로 구분된 출처 목록은 다음과 같다: project, user, . built-in 기본값은 모든 출처입니다.
--json 테이블 대신 기계가 읽을 수 있는 JSON을 출력하세요.

func profile show

단일 프로필에 대한 세부 정보를 보여주며, 상속값 적용 적용 또는 원시 상태(상속 확장 없이 정의 그대로)를 표시합니다.

func profile show <NAME> [<PATH>] [options]
옵션 설명
--raw 상속된 값 없이 원시 프로필 정의를 보여줍니다.

func profile set

Functions 프로젝트의 기본 프로필을 프로젝트 이름에 입력 .func/config.json하여 설정합니다. 프로필이 프로젝트 프로필 목록에 없다면 추가하세요.

func profile set <NAME> [<PATH>]

func setup

Azure Functions 프로젝트를 실행하기 위해 로컬 머신을 준비합니다. 지정한 스택의 호스트 런타임, 언어 작업자, 확장 번들, 템플릿을 설치하거나 검증합니다. 프로필 기반 버전 제약, 사전 출시 선택 기능, 비인터랙티브 CI 모드, 그리고 체크 전용 모드를 지원합니다.

func setup [<PATH>] [options]

--features 설치할 것이나 검증할 항목을 선택합니다. 각 모델이 해결하는 기능과 작업량은 다음과 같습니다:

특징 설치된 워크로드
node host, bundles, node, node-workernode-templates
python host, bundles, python, python-workerpython-templates
go host, bundles, , go, go-worker
dotnet host, , dotnetdotnet-templates
runtime host, bundles
host host에만 해당

--features 반복 가능하며 쉼표 구분된 값도 허용하므로 단일 호출에서 특징을 결합할 수 있습니다(예: func setup --features node,python). dotnet-isolated 는 의 별칭 dotnet으로 받아들여집니다.

옵션 설명
--features 설치하거나 검증할 부품. 반복 가능하거나 쉼표로 구분된 것. 각 기능이 설치하는 작업 부하는 위 표를 참고하세요.
--profile Azure Functions profile to use for version constraints. 반복. --profiles.
--profiles 쉼표 분리된 Azure Functions 프로필 목록 to version constraints.
--install-policy 설치 정책: latest-compatible (기본값) 또는 if-needed.
--source 워크로드 해결과 설치를 위해 사용할 수 있는 NuGet 패키지 소스.
--prerelease 카탈로그에서 해결할 때 사전 릴리스 워크로드 버전을 허용하세요. 기본값: 워크로드가 미리보기 중일 때는 활성화됨.
--non-interactive 의견을 묻지 마세요.
--yes, -y 설정 질문에 '예'라고 대답하세요.
--check 변경하지 않고 선택한 의존성이 설치되었는지 확인하세요.
--output 출력 모드: plain (기본값) 또는 json (NDJSON).

func workload

Azure Functions CLI에 설치된 워크로드를 관리합니다.

func workload <subcommand>

하위:

하위 명령 설명
func workload list 설치된 워크로드를 나열하세요.
func workload search 워크로드 카탈로그를 검색해 보세요.
func workload install 워크로드를 설치하세요.
func workload update 설치된 워크로드를 업데이트하세요.
func workload uninstall 워크로드를 삭제하세요.
func workload prune 비활성 병행 작업 부하 설치를 제거하세요.

func workload list

설치된 워크로드를 나열합니다. 기본적으로 명령어는 각 워크로드의 로드된 버전(가장 높은 세임버)만 표시합니다. --all-versions 모든 설치 과정을 나란히 볼 수 있습니다.

func workload list [options]
옵션 설명
--all-versions, -a 모든 워크로드의 설치된 버전을 나열하세요. 기본: 로드된 버전만 가능합니다.
--json 테이블 대신 기계가 읽을 수 있는 JSON을 출력하세요.

설정된 워크로드 카탈로그에서 사용 가능한 워크로드 패키지를 검색합니다.

func workload search [<QUERY>] [options]

를 생략 <QUERY>하면 명령어가 카탈로그 내 모든 작업 부하를 나열합니다.

옵션 설명
--source 카탈로그 소스 URL을 검색하세요. 기본값은 설정된 카탈로그입니다.
--prerelease 결과에 사전 출시 버전을 포함하세요. 기본값: 워크로드가 미리보기 중일 때는 활성화됨.
--json 테이블 대신 기계가 읽을 수 있는 JSON을 출력하세요.

func workload install

구성된 카탈로그를 통해 워크로드 패키지 ID(또는 별칭)를 해결하고 설치합니다.

func workload install <ID> [options]

<ID> 워크로드 패키지 ID, 별칭(예: python), 또는 로컬 워크로드 패키지 파일로 가는 경로일 수 있습니다.

옵션 설명
--version, -v 설치할 특정 버전. 기본값: 카탈로그 내 최신 안정 버전.
--source 카탈로그 소스 URL 또는 로컬 디렉터리에서 해석할 수 있습니다. 기본값: 구성된 카탈로그.
--prerelease 카탈로그에서 분리할 때 사전 출시 버전을 허용하세요. 기본값: 워크로드가 미리보기 중일 때는 활성화됨.
--force, -f 동일한 ID와 버전의 기존 설치를 덮어쓰세요. 또한 "대신 업데이트 사용" 프롬프트도 건너뛴습니다.
--exact, -e 별칭 매칭을 비활성화하세요. <ID> 아마도 문자 그대로의 패키지 ID일 겁니다.

이미 워크로드 버전이 설치되어 있으면 CLI가 대신 사용 func workload update 하라고 안내합니다. 비상호작용적 맥락에서는 프롬프트를 거절로 간주합니다.

func workload update

설치된 워크로드에 대해 현장에서 원자 버전 교체를 수행합니다. 업데이트는 나란히 있지 않으며; 나란히 설치 func workload install --force하려면 .

func workload update [<ID>] [options]

단일 워크로드를 업데이트하거나 설치된 모든 워크로드 <ID> 를 업데이트하는 데 대해 전달 --all 합니다. 이 두 가지 옵션 중 정확히 하나를 지정하세요.

옵션 설명
--version, -v 교체할 버전 설치. 기본값: 가장 많이 설치된 버전.
--all 설치된 모든 워크로드를 업데이트하세요. <ID>와 상호 배타적입니다.
--major 메이저 버전 경계를 넘는 것을 허용합니다. 기본값: 전공만 동일합니다.
--source 카탈로그 소스 URL 또는 로컬 디렉터리에서 해석할 수 있습니다. 기본값: 구성된 카탈로그.
--prerelease 카탈로그에서 분리할 때 사전 출시 버전을 허용하세요. 기본값: 워크로드가 미리보기 중일 때는 활성화됨.
--exact, -e 별칭 매칭을 비활성화하세요. <ID> 아마도 문자 그대로의 패키지 ID일 겁니다.

func workload uninstall

설치된 워크로드의 한 버전 또는 전부를 제거합니다.

func workload uninstall <ID> [options]
옵션 설명
--version, -v 삭제할 특정 버전. 기본값: 유일한 설치된 버전.
--all-versions, -a 설치된 모든 버전의 워크로드를 삭제하세요. --version와 상호 배타적입니다.
--exact, -e 별칭 매칭을 비활성화하세요. <ID> 아마도 문자 그대로의 패키지 ID일 겁니다.

func workload prune

비활성 작업 부하 설치를 제거합니다. 각 범위 내 패키지 ID마다 명령어는 가장 높은 버전을 유지하고 이전 버전을 삭제합니다. 이 명령어는 로컬 전용이며 카탈로그에는 전혀 영향을 미치지 않습니다.

func workload prune [<ID>] [options]

를 생략 <ID>하면 이 명령어가 설치된 모든 워크로드를 가지치기합니다.

옵션 설명
--exact, -e 별칭 매칭을 비활성화하세요. <ID> 아마도 문자 그대로의 패키지 ID일 겁니다.

func azure functionapp

컨텍스트에는 func azure functionapp 다음 명령이 포함됩니다.

모든 func azure functionapp 명령은 다음 옵션을 지원합니다.

옵션 설명
--slot 구성된 경우 명명된 특정 배포 슬롯을 대상으로 합니다.
--access-token Azure 인증된 작업을 수행하는 데 사용할 기본 토큰이 아닌 액세스 토큰을 제공합니다.
--access-token-stdin 표준 입력에서 특정 액세스 토큰을 읽습니다. 와 같은 az account get-access-token이전 명령에서 직접 토큰을 읽을 때 이 옵션을 사용합니다.
--management-url Azure 클라우드의 관리 URL을 설정합니다. 기본값은 https://management.azure.com. 함수 앱이 소버린 클라우드에서 실행되는 경우 이 옵션을 사용합니다.
--subscription 기본 Azure 구독을 설정합니다.

func azure functionapp fetch-app-settings

특정 함수 앱에서 설정을 가져옵니다.

func azure functionapp fetch-app-settings <APP_NAME>

자세한 내용은 애플리케이션 설정 다운로드를 참조하세요.

이 명령어는 프로젝트의 local.settings.json 파일에 설정을 다운로드합니다. 화면의 값은 보안을 위해 마스킹됩니다. local.settings.json 파일의 설정을 로컬 암호화로 보호할 수 있습니다.

func azure functionapp list-functions

지정된 함수 앱의 함수를 나열합니다.

func azure functionapp list-functions <APP_NAME>

이 명령은 다음 func azure functionapp list-functions 옵션을 지원합니다.

옵션 설명
--show-keys 반환된 함수 엔드포인트 URL에 함수 수준 액세스 키 값을 포함합니다.

func azure functionapp logstream

Azure 함수 앱의 스트리밍 로그에 로컬 명령 프롬프트를 연결합니다.

func azure functionapp logstream <APP_NAME>

연결의 기본 시간 제한은 2시간입니다. 시간 제한 값(초)을 사용하여 SCM_LOGSTREAM_TIMEOUT이라는 앱 설정을 추가하여 시간 제한을 변경합니다. Flex 소비 또는 소비 계획에서 Linux에 대해 아직 지원되지 않습니다. 이러한 앱의 경우 --browser 옵션을 사용하여 포털에서 로그를 봅니다.

이 명령은 다음 func azure functionapp logstream 옵션을 지원합니다.

옵션 설명
--browser 기본 브라우저에서 함수 앱에 대한 Azure 애플리케이션 Insights 라이브 스트림을 엽니다.

자세한 내용은 Azure Functions 참조하세요.

func azure functionapp publish

Azure 기존 함수 앱 리소스에 Functions 프로젝트를 배포합니다.

func azure functionapp publish <APP_NAME>

자세한 내용은 프로젝트 파일 배포를 참조하세요.

버전에 따라 다음 게시 옵션이 적용됩니다.

옵션 설명
--additional-packages 네이티브 종속성을 빌드할 때 설치할 패키지 목록입니다. 예: python3-dev libevent-dev.
--build, -b Linux 함수 앱에 배포할 때 빌드 작업을 수행합니다. 수락: remote 및 local.
--build-native-deps Python 함수 앱을 게시할 때 .wheels 폴더 생성을 건너뜁니다.
--csx C# 스크립트(.csx) 프로젝트를 게시합니다.
--dotnet-cli-params 컴파일된 C# (.csproj) 함수를 게시하면 핵심 도구에서 호출 dotnet build --output bin/publish합니다. 이 옵션에 전달된 모든 매개 변수는 명령줄에 추가됩니다.
--dotnet-version dotnet-isolated 애플리케이션의 경우 대상 .NET 버전(예: 8.0)을 지정합니다.
--force 특정 시나리오에서 사전 게시 확인을 무시합니다.
--list-ignored-files .funcignore 파일을 기반으로 게시하는 동안 무시되는 파일 목록을 표시합니다.
--list-included-files .funcignore 파일을 기반으로 게시되는 파일 목록을 표시합니다.
--no-build Project 게시하는 동안 빌드되지 않습니다. Python 경우 pip install 실행되지 않습니다.
--nozip 기본 Run-From-Package 모드를 끕니다. 배포 패키지에서 직접 실행하는 대신 서버의 폴더에 파일을 wwwroot 추출합니다.
--overwrite-settings, -y 를 사용할 --publish-local-settings -i때 앱 설정을 덮어쓰라는 프롬프트를 표시하지 않습니다.
--publish-local-settings, -i local.settings.json 설정을 Azure 게시하여 설정이 이미 있는 경우 덮어쓰라는 메시지를 표시합니다. 로컬 스토리지 에뮬레이터를 사용하는 경우 먼저 앱 설정을 실제 스토리지 연결로 변경합니다.
--publish-settings-only, -o 설정만 게시하고 콘텐츠를 건너뜁니다. 기본값은 프롬프트입니다.
--show-keys 로그에 표시되는 URL에 함수 키를 추가합니다.

func azure storage fetch-connection-string

지정된 Azure Storage 계정에 대한 연결 문자열 가져옵니다.

func azure storage fetch-connection-string <STORAGE_ACCOUNT_NAME>

자세한 내용은 스토리지 연결 문자열 를 참조하세요.

func azurecontainerapps deploy

컨테이너화된 함수 앱을 Azure Container Apps 환경에 배포합니다. 기본 호스트 스토리지 계정, 기능 앱, 그리고 환경이 이미 존재해야 합니다. 자세한 내용은 Azure Container Apps Azure Functions 호스팅을 참조하세요.

func azurecontainerapps deploy --name <APP_NAME> --environment <ENVIRONMENT_NAME> --storage-account <STORAGE_CONNECTION> --resource-group <RESOURCE_GROUP> --image-name <IMAGE_NAME> --registry-server <REGISTRY_SERVER> --registry-username <USERNAME> --registry-password <PASSWORD>

다음 배포 옵션이 적용되었습니다.

옵션 설명
--environment 기존 Container Apps 환경의 이름입니다.
--image-build 로컬 Docker 빌드를 건너뛰도록 true 설정합니다.
--image-name 태그 이름을 포함하여 컨테이너 레지스트리에 있는 기존 컨테이너 이미지의 이름입니다.
--location 배포를 위한 지역입니다. 이상적으로 이 지역은 환경 및 스토리지 계정 리소스와 동일합니다.
--name Container Apps 환경에서 함수 앱 배포에 사용되는 이름입니다. 이 이름은 포털에서 함수 앱을 관리할 때도 나타납니다. 이름은 환경에서 고유해야 합니다.
--registry 설정되면 Docker 빌드가 실행되고 이미지가 에 설정된 레지스트리로 푸시됩니다 --registry. --registry는 --image-name과 함께 사용할 수 없습니다. Docker Hub 경우 --registry-username 사용합니다.
--registry-password 프라이빗 레지스트리에서 이미지를 검색하는 데 사용되는 암호 또는 토큰입니다.
--registry-username 프라이빗 레지스트리에서 이미지를 검색하는 데 사용되는 사용자 이름입니다.
--resource-group 함수 관련 리소스를 만들 리소스 그룹입니다.
--storage-account 함수 앱에서 사용할 스토리지 계정에 대한 연결 문자열.
--worker-runtime 함수 앱의 런타임 언어를 설정합니다. 이 매개 변수는 로컬 빌드 중에 언어가 결정되는 경우에만 사용 --image-name 되며 --image-build, 그렇지 않으면 언어가 결정됩니다. 지원되는 값은 dotnet, , dotnetIsolatednode, pythonpowershell및 custom (사용자 지정 처리기의 경우)입니다.

중요합니다

스토리지 연결 문자열 및 기타 서비스 자격 증명은 중요한 암호입니다. 공개적으로 액세스할 수 있는 소스 제어에 사용하고 func azurecontainerapps deploy 저장하지 않는 스크립트 파일을 안전하게 저장합니다.

func deploy

func deploy 명령은 더 이상 사용되지 않습니다. 대신 func kubernetes deploy을 사용합니다.

func bundles add

확장 번들 구성을 host.json 파일에 추가합니다.

func bundles add

이 명령은 다음 func bundles add 옵션을 지원합니다.

옵션 설명
--force, -f 있는 경우 기존 확장 번들 구성을 덮어씁니다.
--channel, -c 확장 번들 릴리스 채널. 지원되는 값은 GA (기본값), Preview및 Experimental.

func bundles download

host.json구성된 확장 번들을 다운로드합니다.

func bundles download

이 명령은 다음 func bundles download 옵션을 지원합니다.

옵션 설명
--force, -f 이미 있는 경우에도 확장 번들의 다시 다운로드를 강제로 실행합니다.

func bundles list

다운로드한 확장 번들을 나열합니다.

func bundles list

func bundles path

다운로드한 확장 번들에 대한 경로를 가져옵니다.

func bundles path

func durable delete-task-hub

Durable Functions 작업 허브의 모든 스토리지 아티팩트가 삭제됩니다.

func durable delete-task-hub

이 명령은 다음 func durable delete-task-hub 옵션을 지원합니다.

옵션 설명
--connection-string-setting 사용할 스토리지 연결 문자열 포함하는 설정의 이름입니다.
--task-hub-name 사용할 지속성 작업 허브의 이름입니다.

자세한 내용은 Durable Functions 설명서 참조하세요.

func durable get-history

지정된 오케스트레이션 인스턴스의 기록을 반환합니다.

func durable get-history --id <INSTANCE_ID>

이 명령은 다음 func durable get-history 옵션을 지원합니다.

옵션 설명
--id 오케스트레이션 인스턴스의 ID입니다. (필수)
--connection-string-setting 사용할 스토리지 연결 문자열 있는 설정의 이름입니다.
--task-hub-name 사용할 지속성 작업 허브의 이름입니다.

자세한 내용은 Durable Functions 설명서 참조하세요.

func durable get-instances

모든 오케스트레이션 인스턴스의 상태를 반환합니다. 이 명령어는 매개변수 top 를 사용하여 페이징을 지원합니다.

func durable get-instances

이 명령은 다음 func durable get-instances 옵션을 지원합니다.

옵션 설명
--continuation-token 반환할 요청의 특정 페이지 또는 섹션을 나타내는 토큰입니다.
--connection-string-setting 사용할 스토리지 연결 문자열 포함하는 앱 설정의 이름입니다.
--created-after 이 날짜 및 시간(UTC) 이후에 만든 인스턴스를 가져옵니다. 모든 ISO 8601 형식의 날짜/시간이 허용됩니다.
--created-before 특정 날짜 및 시간(UTC) 전에 만든 인스턴스를 가져옵니다. 모든 ISO 8601 형식의 날짜/시간이 허용됩니다.
--runtime-status 상태가 특정 상태(예 running: 및 completed)와 failed일치하는 인스턴스를 가져옵니다. 공백으로 구분된 상태를 하나 이상 제공할 수 있습니다.
--top 지정된 요청에서 반환되는 레코드 수를 제한합니다.
--task-hub-name 사용할 Durable Functions 작업 허브의 이름입니다.

자세한 내용은 Durable Functions 설명서 참조하세요.

func durable get-runtime-status

지정된 오케스트레이션 인스턴스의 상태를 반환합니다.

func durable get-runtime-status --id <INSTANCE_ID>

이 명령은 다음 func durable get-runtime-status 옵션을 지원합니다.

옵션 설명
--connection-string-setting 사용할 스토리지 연결 문자열 포함하는 설정의 이름입니다.
--id 오케스트레이션 인스턴스의 ID입니다. (필수)
--show-input 설정하면 응답에 함수의 입력이 포함됩니다.
--show-output 설정하면 응답에 실행 기록이 포함됩니다.
--task-hub-name 사용할 Durable Functions 작업 허브의 이름입니다.

자세한 내용은 Durable Functions 설명서 참조하세요.

func durable purge-history

지정된 임계값보다 오래된 오케스트레이션에 대한 오케스트레이션 인스턴스 상태, 기록 및 Blob Storage를 제거합니다.

func durable purge-history

이 명령은 다음 func durable purge-history 옵션을 지원합니다.

옵션 설명
--connection-string-setting 사용할 스토리지 연결 문자열 포함하는 설정의 이름입니다.
--created-after 이 날짜/시간(UTC) 이후에 만든 인스턴스의 기록을 삭제합니다. ISO 8601 형식의 모든 날짜/시간 값이 허용됩니다.
--created-before 이 날짜/시간(UTC) 이전에 만든 인스턴스의 기록을 삭제합니다. ISO 8601 형식의 모든 날짜/시간 값이 허용됩니다.
--runtime-status 상태가 특정 상태(예completed: , terminatedcanceled및 )와 failed일치하는 인스턴스의 기록을 삭제합니다. 공백으로 구분된 상태를 하나 이상 제공합니다. 포함하지 --runtime-status않으면 상태와 관계없이 인스턴스 기록이 삭제됩니다.
--task-hub-name 사용할 Durable Functions 작업 허브의 이름입니다.

자세한 내용은 Durable Functions 설명서 참조하세요.

func durable raise-event

지정된 오케스트레이션 인스턴스에 이벤트를 발생합니다.

func durable raise-event --event-name <EVENT_NAME> --event-data <DATA>

이 명령은 다음 func durable raise-event 옵션을 지원합니다.

옵션 설명
--connection-string-setting 사용할 스토리지 연결 문자열 포함하는 설정의 이름입니다.
--event-data 인라인 또는 JSON 파일에서 이벤트에 전달할 데이터입니다. 파일의 경우 파일의 경로 접두사에 와 같은 @부호가@path/to/file.json 있습니다. (필수)
--event-name 발생할 이벤트의 이름입니다. (필수)
--id 오케스트레이션 인스턴스의 ID입니다. (필수)
--task-hub-name 사용할 Durable Functions 작업 허브의 이름입니다.

자세한 내용은 Durable Functions 설명서 참조하세요.

func durable rewind

지정된 오케스트레이션 인스턴스를 되감습니다.

func durable rewind --id <INSTANCE_ID> --reason <REASON>

이 명령은 다음 func durable rewind 옵션을 지원합니다.

옵션 설명
--connection-string-setting 사용할 스토리지 연결 문자열 포함하는 설정의 이름입니다.
--id 오케스트레이션 인스턴스의 ID입니다. (필수)
--reason 오케스트레이션을 되감는 이유입니다. (필수)
--task-hub-name 사용할 Durable Functions 작업 허브의 이름입니다.

자세한 내용은 Durable Functions 설명서 참조하세요.

func durable start-new

지정된 오케스트레이터 함수의 새 인스턴스를 시작합니다.

func durable start-new --id <INSTANCE_ID> --function-name <FUNCTION_NAME> --input <INPUT>

이 명령은 다음 func durable start-new 옵션을 지원합니다.

옵션 설명
--connection-string-setting 사용할 스토리지 연결 문자열 포함하는 설정의 이름입니다.
--function-name 시작할 오케스트레이터 함수의 이름입니다. (필수)
--id 오케스트레이션 인스턴스의 ID를 지정합니다. (필수)
--input 인라인 또는 JSON 파일에서 오케스트레이터 함수에 입력합니다. 파일의 경우 파일 경로 앞에 앰퍼샌드(예: 앰퍼샌드)@를 접두사로 추가합니다 @path/to/file.json. (필수)
--task-hub-name 사용할 Durable Functions 작업 허브의 이름입니다.

자세한 내용은 Durable Functions 설명서 참조하세요.

func durable terminate

지정된 오케스트레이션 인스턴스를 종료합니다.

func durable terminate --id <INSTANCE_ID> --reason <REASON>

이 명령은 다음 func durable terminate 옵션을 지원합니다.

옵션 설명
--connection-string-setting 사용할 스토리지 연결 문자열 포함하는 설정의 이름입니다.
--id 오케스트레이션 인스턴스의 ID를 지정합니다. (필수)
--reason 오케스트레이션을 종료하는 이유입니다. (필수)
--task-hub-name 사용할 Durable Functions 작업 허브의 이름입니다.

자세한 내용은 Durable Functions 설명서 참조하세요.

func extensions install

.NET 이외 프로젝트 또는 C# 스크립트 프로젝트에 Functions 확장을 수동으로 설치합니다.

func extensions install --package Microsoft.Azure.WebJobs.Extensions.<EXTENSION> --version <VERSION>

이 명령은 다음 func extensions install 옵션을 지원합니다.

옵션 설명
--configPath, -c extensions.csproj 파일을 포함하는 디렉터리의 경로입니다.
--csx C# 스크립팅(.csx) 프로젝트를 지원합니다.
--force, -f 기존 확장의 버전을 업데이트합니다.
--output, -o 확장에 대한 출력 경로입니다.
--package, -p 특정 확장 패키지의 식별자입니다. 지정되지 않으면 func extensions sync와 마찬가지로 참조된 모든 확장이 설치됩니다.
--source, -s NuGet.org를 사용하지 않는 경우의 NuGet 피드 원본입니다.
--version, -v 확장 패키지 버전입니다.

다음 예제에서는 로컬 프로젝트에 Event Hubs 확장 버전 5.0.1을 설치합니다.

func extensions install --package Microsoft.Azure.WebJobs.Extensions.EventHubs --version 5.0.1

이러한 고려 사항은 다음을 사용할 func extensions install때 적용됩니다.

  • 컴파일된 C# 프로젝트(In-Process 및 격리된 작업자 프로세스 모두)의 경우 표준 NuGet 패키지 설치 방법(예: />)을 대신 사용합니다.

  • Core Tools를 사용하여 확장을 수동으로 설치하려면 .NET SDK 설치되어 있어야 합니다.

  • 가능하면 확장 번들을 대신 사용해야 합니다. 확장을 수동으로 설치해야 하는 몇 가지 이유는 다음과 같습니다.

    • 번들에서 사용할 수 없는 특정 버전의 확장에 액세스해야 합니다.
    • 번들에서 사용할 수 없는 사용자 지정 확장에 액세스해야 합니다.
    • 단일 번들에서 사용할 수 없는 특정 확장 조합에 액세스해야 합니다.

  • 확장을 수동으로 설치하려면 먼저 번들을 정의하는 extensionBundle 파일에서 개체를 제거 해야 합니다. 확장 번들을 host.json 파일에 이미 설정한 경우에는 아무 작업도 수행되지 않습니다.

  • 확장을 처음 설치할 때 extensions.csproj라는 .NET 프로젝트 파일이 앱 프로젝트의 루트에 추가됩니다. 이 파일은 함수에 필요한 NuGet 패키지 세트를 정의합니다. 이 파일에서 NuGet 패키지 참조로 작업할 수 있지만 Core Tools를 사용하면 이 C# 프로젝트 파일을 수동으로 편집하지 않고도 확장을 설치할 수 있습니다.

func extensions sync

함수 앱에서 필요한 모든 확장 프로그램을 설치합니다.

이 명령은 다음 func extensions sync 옵션을 지원합니다.

옵션 설명
--configPath, -c 파일을 포함하는 extensions.csproj 디렉터리의 경로.
--csx C# 스크립팅(.csx) 프로젝트를 지원합니다.
--output, -o 확장에 대한 출력 경로입니다.

누락 extensions.csproj 된 파일을 재생성합니다. 파일에 확장 묶음이 정의 host.json 되어 있을 때는 아무런 조치도 취하지 않습니다.

func kubernetes deploy

Functions 프로젝트를 Kubernetes 클러스터에 사용자 지정 Docker 컨테이너로 배포합니다.

func kubernetes deploy

이 명령은 프로젝트를 사용자 지정 컨테이너로 빌드하고 Kubernetes 클러스터에 게시합니다. 사용자 지정 컨테이너에는 Dockerfile이 있어야 합니다. Dockerfile을 사용하여 앱을 만들려면 명령과 함께 --docker 옵션을 사용합니다func init.

이 명령은 다음 func kubernetes deploy 옵션을 지원합니다.

옵션 설명
--dry-run 실행 없이 배포 템플릿을 표시합니다.
--config-map-name 배포에 사용할 함수 앱 설정 이 있는 기존 구성 맵의 이름입니다. --use-config-map가 필요합니다. 기본 동작은 Values 파일의 개체를 기반으로 설정을 만드는 것입니다.
--cooldown-period 배포가 0으로 축소되기 전에 모든 트리거 후의 쿨다운 기간(초)이 더 이상 활성화되지 않으며 기본값은 300초입니다.
--ignore-errors 리소스가 오류를 반환한 후 배포를 계속합니다. 기본 동작은 오류 발생 시 중지하는 것입니다.
--image-name Pod 배포에 사용할 이미지의 이름과 함수를 읽을 이미지의 이름입니다.
--keda-version 설치할 KEDA 버전을 설정합니다. 유효한 옵션은 v1 및 v2(기본값)입니다.
--keys-secret-name 액세스 키를 저장하는 데 사용할 Kubernetes Secrets 컬렉션의 이름입니다.
--max-replicas HPA(Horizontal Pod Autoscaler)의 크기를 조정할 최대 복제본 수를 설정합니다.
--min-replicas HPA의 크기를 조정하지 않는 최소 복제본 수를 아래에 설정합니다.
--mount-funckeys-as-containervolume 액세스 키를 컨테이너 볼륨으로 탑재합니다.
--name Kubernetes의 배포 및 기타 아티팩트에서 사용되는 이름입니다.
--namespace 배포할 Kubernetes 네임스페이스를 설정합니다. 기본 네임스페이스로 설정됩니다.
--no-docker 이미지 대신 현재 디렉터리에서 함수를 읽습니다. 이미지 파일 시스템을 탑재해야 합니다.
--registry 설정하면 Docker 빌드가 실행되고 이미지가 해당 이름의 레지스트리로 푸시됩니다. --registry는 --image-name과 함께 사용할 수 없습니다. Docker의 경우 사용자 이름을 사용합니다.
--polling-interval HTTP가 아닌 트리거를 검사하기 위한 폴링 간격(초)으로, 기본값은 30초입니다.
--pull-secret 프라이빗 레지스트리 자격 증명에 액세스하는 데 사용되는 비밀입니다.
--secret-name 배포에 사용할 함수 앱 설정 이 있는 기존 Kubernetes Secrets 컬렉션의 이름입니다. 기본 동작은 Values 파일의 개체를 기반으로 설정을 만드는 것입니다.
--show-service-fqdn IP 주소를 사용하는 기본 동작 대신 Kubernetes FQDN을 사용하여 HTTP 트리거의 URL을 표시합니다.
--service-type Kubernetes Service의 유형을 설정합니다. 지원되는 값은 , ClusterIP및 NodePort (기본값)입니다LoadBalancer.
--use-config-map ConfigMap 개체(v1) 대신 Secret 개체(v1)를 사용하여 함수 앱 설정을 구성합니다. 맵 이름은 .를 사용하여 --config-map-name설정됩니다.
--use-git-hash-version Git 해시를 컨테이너 이미지의 버전으로 사용합니다.
--write-configs 배포하는 대신 Kubernetes 구성을 YAML 파일로 출력합니다.
--config-file 를 사용할 --write-configs때 출력 파일 경로입니다. 기본값: functions.yaml.
--hash-files 이미지 버전을 확인하기 위해 해시할 파일입니다.
--image-build 로 false설정하면 Docker 빌드를 건너뜁니다.
--key-secret-annotations 키 비밀에 추가할 주석(형식) key1=val1,key2=val2 입니다.

Core Tools는 로컬 Docker CLI를 사용하여 이미지를 빌드하고 게시합니다. Docker가 이미 로컬에 설치되어 있는지 확인합니다. docker login 명령을 실행하여 계정에 연결합니다.

Azure Functions Azure Container Apps 또는 Azure Functions 컨테이너화된 함수 호스팅을 지원합니다. Azure Functions Kubernetes 클러스터 또는 AKS(Azure Kubernetes Service) 직접 컨테이너 실행을 공식적으로 지원하지 않습니다. 자세한 내용은 Azure Functions 참조하세요.

func kubernetes delete

Kubernetes 클러스터에서 Functions 배포를 삭제합니다.

func kubernetes delete --name <APP_NAME>

이 명령은 다음 func kubernetes delete 옵션을 지원합니다.

옵션 설명
--name Kubernetes의 배포 및 기타 아티팩트 이름입니다. (필수)
--namespace Kubernetes 네임스페이스를 설정합니다. 기본값은 네임스페이 default 스입니다.
--registry 컨테이너 레지스트리의 이름입니다.
--image-name Pod 배포에 사용할 이미지입니다.
--keda-version KEDA 버전을 설정합니다. 유효한 옵션은 (v1기본값)입니다v2.

func kubernetes install

Kubernetes 클러스터에 KEDA 설치

func kubernetes install

kubectl 구성 파일에 정의된 클러스터에 KEDA를 설치합니다.

이 명령은 다음 func kubernetes install 옵션을 지원합니다.

옵션 설명
--dry-run 실행 없이 배포 템플릿을 표시합니다.
--keda-version 설치할 KEDA의 버전을 설정합니다. 유효한 옵션은 v1 및 v2(기본값)입니다.
--namespace 특정 Kubernetes 네임스페이스에 설치됩니다. 설정되지 않으면 기본 네임스페이스가 사용됩니다.

자세한 내용은 Kubernetes에서 KEDA 및 함수 관리를 참조하세요.

func kubernetes remove

구성 파일에 정의된 Kubernetes 클러스터에서 KEDA를 kubectl 제거합니다.

func kubernetes remove

구성 파일에 정의된 클러스터에서 KEDA를 kubectl 제거합니다.

이 명령은 다음 func kubernetes remove 옵션을 지원합니다.

옵션 설명
--namespace 특정 Kubernetes 네임스페이스에서 제거합니다. 설정되지 않으면 기본 네임스페이스가 사용됩니다.

자세한 내용은 Kubernetes에서 KEDA 제거를 참조하세요.

func settings add

local.settings.json 파일의 Values 컬렉션에 새 설정을 추가합니다.

func settings add <SETTING_NAME> <VALUE>

앱 설정의 이름으로 바꿉 <SETTING_NAME> 습니다.

이 명령은 다음 func settings add 옵션을 지원합니다.

옵션 설명
--connectionString 컬렉션 대신 컬렉션에 ConnectionStrings 이름-값 쌍을 추가합니다 Values . 컬렉션은 특정 프레임워크에 ConnectionStrings 필요한 경우에만 사용합니다. 자세한 내용은 local.settings.json 파일을 참조하세요.

func settings decrypt

Values 파일의 컬렉션에서 암호화된 값을 해독합니다.

func settings decrypt

또한 이 명령은 ConnectionStrings 컬렉션의 연결 문자열 값을 해독합니다. local.settings.json에서 명령어는 로 설정 IsEncryptedfalse됩니다. 민감한 정보가 노출될 위험을 줄이기 위해 로컬 설정을 암호화하세요 local.settings.json. Azure 애플리케이션 설정은 항상 암호화된 상태로 저장됩니다.

func settings delete

Values의 컬렉션에서 기존 설정을 제거합니다.

func settings delete <SETTING_NAME>

<SETTING_NAME>을 앱 설정의 이름으로 바꾸고, <VALUE>를 설정의 값으로 바꿉니다.

이 명령은 다음 func settings delete 옵션을 지원합니다.

옵션 설명
--connectionString 컬렉션 대신 컬렉션에서 ConnectionStrings 이름-값 쌍을 제거합니다 Values .

func settings encrypt

local.settings.json 파일의 컬렉션에 있는 Values 개별 항목의 값을 암호화합니다.

func settings encrypt

또한 이 명령은 컬렉션의 연결 문자열 값을 암호화합니다 ConnectionStrings . local.settings.json에서는 명령어가 로 설정 IsEncryptedtrue되며, 이는 로컬 런타임이 설정을 사용하기 전에 복호화하도록 지정합니다. 민감한 정보가 노출될 위험을 줄이기 위해 로컬 설정을 암호화하세요 local.settings.json. Azure 애플리케이션 설정은 항상 암호화된 상태로 저장됩니다.

func settings list

local.settings.json 파일Values설정 목록을 출력합니다.

func settings list

출력에는 컬렉션의 ConnectionStrings 연결 문자열도 포함됩니다. 기본적으로 이 명령어는 보안을 위해 값을 가립니다. 이 --showValue 옵션을 사용하여 실제 값을 표시합니다.

이 명령은 다음 func settings list 옵션을 지원합니다.

옵션 설명
--showValue, -a 출력에 마스크되지 않은 실제 값을 표시합니다.

func templates list

사용 가능한 함수(트리거) 템플릿을 나열합니다.

이 명령은 다음 func templates list 옵션을 지원합니다.

옵션 설명
--language, -l 반환된 템플릿을 필터링할 언어입니다. 기본적으로 모든 언어를 반환합니다.

글로벌 옵션

대부분의 코어 툴 명령어는 다음과 같은 옵션을 지원합니다:

옵션 설명
--script-root 함수 앱의 루트 디렉터리를 설정하고 명령에 대한 작업 디렉터리를 변경합니다.
--verbose 자세한 로깅에 자세한 정보 표시 출력을 사용하도록 설정합니다. 모든 명령어가 이 옵션을 지원하는 것은 아닙니다.
--offline 외부 네트워크 호출 없이 오프라인 모드로 실행됩니다. func start, func init, 명령 func new 어가 이 옵션을 지원합니다. 환경 변수를 FUNCTIONS_CORE_TOOLS_OFFLINE 통해서도 설정할 수 있습니다.
--version, -v Azure Functions Core Tools의 버전을 표시합니다.
--help, -h 도움말 정보를 표시합니다.
--pause-on-error 프로세스를 종료하기 전에 추가 입력을 위해 일시 중지합니다. 이 옵션은 통합 개발 환경(IDE)에서 Core Tools를 실행할 때 유용합니다.

대부분의 명령어는 다음과 같은 옵션을 지원합니다:

옵션 설명
--help, -h 명령에 대한 도움말 표시.
--version Display the Azure Functions CLI version. 자세한 빌드 정보를 위해 함께 --verbose 사용 --version 하세요.
--verbose 자세한 정보 출력을 사용하도록 설정합니다. 모든 하위 명령으로 전파됩니다. 루트에서 하위 명령어 없이 전달되면 상세한 빌드, 런타임, 운영체제, 아키텍처 정보를 출력합니다.

사용 가능한 작업 부하

현재 카탈로그를 보러 달려가 func workload search 세요. 현재 이용 가능한 업무량은 다음과 같습니다:

Name 설명
host func run에서 사용하는 Azure Functions 호스트 런타임입니다.
bundles 모든 바인딩 확장 기능을 활성화하는 확장 번들을 설치하세요. 이 워크로드는 .NET가 아닌 모든 스택에 사용하세요. .NET 프로젝트는 이 작업을 사용하지 않습니다. 대신 프로젝트 내에서 확장을 직접 참조합니다.
dotnet Azure Functions CLI tooling for .NET (C#, F#) projects. 또한 . 템플릿도 func quickstart기여합니다. .NET는 별도의 워커 워크로드가 필요하지 않습니다. 워커가 컴파일된 프로젝트 자체의 일부이기 때문입니다.
dotnet-templates .NET 격리 작업자 프로젝트를 위한 함수 스캐폴드 템플릿.
python Azure Functions CLI tooling for Python projects. 또한 . 템플릿도 func quickstart기여합니다.
python-worker Functions 호스트에서 사용하는 Python 언어 작업자입니다.
python-templates Python용 함수 스캐폴드 템플릿(v1 및 v2 프로그래밍 모델).
node Azure Functions Node.js 프로젝트용 CLI 도구(자바스크립트, TypeScript). 또한 . 템플릿도 func quickstart기여합니다.
node-worker Functions 호스트가 사용하는 Node.js 언어 작업자입니다.
node-templates Node.js용 함수 스캐폴드 템플릿(JavaScript, TypeScript).
go Azure Functions CLI tooling for Go projects. 또한 . 템플릿도 func quickstart기여합니다.
go-worker 함수 호스트가 사용하는 Go 언어 작업자입니다.

참고 항목

모든 Functions 언어 스택이 현재 워크로드로 제공되는 것은 아닙니다. Java와 PowerShell 스택은 현재 Azure Functions CLI에서 지원되지 않습니다.

  • Last updated on